ゲームウィキ.jp ヘルプ

ゲームウィキ.jp ご利用ガイド

ショートコードの使い方

ショートコードの使い方について紹介します。

データベース管理で使用するショートコード

シンプルな一覧表を出すだけなどの使用であれば覚えなくてもコピー&ペーストで実現できますが、ショートコードを利用すれば1つのデータだけ表示させたり、見た目の整った表を作成したりすることができます。

ショートコード 説明
[gwdb ① {②}{③}/] ①:データベース名
②:取得する項目名(パイプ(|)区切り)
③:条件(パイプ(|)区切り)
データベース管理機能で登録したデータを検索して表示します。検索結果が複数件存在する、もしくは取得する項目が複数ある場合には表形式でデータを表示します。検索結果が1件かつ取得項目が1つのみの場合はデータをそのまま表示します。
[gwdb_filter ① {②}/] ①:データベース名
②:絞り込みに使用する項目名(パイプ(|)区切り)
「gwdb」のショートコードと組み合わせて使用します。「gwdb」のショートコードで表示されるデータ一覧に絞り込み機能を付与します。

取得する項目の設定

特定の項目だけデータを取得したい場合、「項目名」を指定するとデータベースから該当する項目のデータを取得します。

記述例

「サンプル」データベースの項目「ID」「名称」を取得します。

例:[gwdb サンプル {ID|名称}/]

すべての項目を取得する場合

データベースに定義されているすべての項目を取得する場合は、項目名の部分にアスタリスク(*)を指定します。

例:[gwdb サンプル {*}/]

条件の記述方法

指定した項目の中でも特定のデータを取得したい場合、「条件」を指定するとデータベースから条件に合致するデータのみを取得することが可能です。
条件は以下のように記載します。

(項目名):(演算子)(値)

記述例1

「サンプル」データベースから「属性」が「火」のデータを取得します。

例:[gwdb サンプル {*}{属性:=火}/]

記述例2

「サンプル」データベースから「属性」が「火」の「名称」に「モンスター」を含むデータを取得します。

例:[gwdb サンプル {*}{属性:=火|名称:like(モンスター)}/]

使用可能な演算子

以下の演算子が使用可能です。複数条件指定する際はパイプで区切ってください。

演算子 意味
= 指定した値と等しい
<> 指定した値と等しくない
> 指定した値より大きい
< 指定した値より小さい
>= 指定した値以上
<= 指定した値以下
like(***) 指定した値(***)を含む
in(A,B,C,…) 指定した値のいずれかと等しい

コード発行機能から一覧表を作成する

「データ検索・項目表示設定」機能で検索したデータ一覧の内容をショートコードを利用して記事内に表示する方法を紹介します。

表示したいデータを検索する

この例では、データベース名「サンプル」から「ID」が「10000」以上、「名称」に「ヤミ」を含むデータを検索します。

また、不要な「メイン画像」「登録日」「更新日」は表示項目からチェックを外します。

検索結果が表示されます。

発行されたコードを記事本文に追加する

検索結果から発行されたコードを確認します。
コードには「ショートコード」「HTML」の2種類の表記が存在します。
それぞれの利用方法やメリットについて紹介します。

ショートコードを利用する

ショートコードのみを使用する形式です。
「コード発行」タブを開いて「ショートコード」にチェックを付けます。検索結果一覧を表示するためのショートコードが表示されているのでコピーします。

コピーしたショートコードを記事本文に貼り付けます。貼り付ける際は
「ウィジェット」>「ショートコード」のブロックを使用してください。

プレビュー機能で記事本文にデータ一覧が表示されていることを確認します。

ショートコードを記述するブロックについて

記事本文にショートコードを貼り付ける場合、「ショートコード」ブロックを利用してください。ほかのブロックでは動作しない恐れがあります。

ショートコードを利用するメリット
  • オプション設定で表の調整が可能
  • 手軽にデータ一覧表の作成が可能

HTMLを利用する

HTMLとショートコードを組み合わせた形式です。
「コード発行」タブを開いて「ショートコード」にチェックを付けます。
検索結果一覧を表示するためのショートコードが表示されているのでコピーします。

コピーしたHTMLを記事本文に貼り付けます。貼り付ける際は「フォーマット」>「カスタムHTML」のブロックを使用してください。

プレビュー機能で記事本文にデータ一覧が表示されていることを確認します。

HTMLを記述するブロック

記事本文にHTMLを貼り付ける場合、「カスタムHTML」ブロックを利用してください。ほかのブロックでは動作しない恐れがあります。

HTMLを利用するメリット

  • HTML記法を利用するため、柔軟なカスタマイズが可能
  • 一覧表示以外にも様々な応用が可能

無効なコンテンツと表示される場合

一度記事を保存し、再度開いた際に「このブロックには、想定されていない無効なコンテンツが含まれています。」と出ることがあります。その場合は「HTMLに変換」ボタンをクリックしてください。

※この画面が表示されている場合でも記事の表示には問題ございません

上級者向け設定

オプション設定

データ検索用のショートコードではオプションが利用可能です。
オプションを利用することにより、表示される結果の見せ方を変更することができます。
オプションはショートコード内の「項目」毎に記載します。

利用可能なオプション一覧

オプション 説明
:link 検索結果のデータに対して個別記事が作成されている場合、データを個別記事へのリンクとして表示します。
:alias(①) ①:名前
①に入力した名前へ項目名を変更します。
:asc 項目名の昇順に一覧のデータを並べ替えます。
:desc 項目名の降順に一覧のデータを並べ替えます。
:left 項目のデータを左端揃えで表示します。
:center 項目のデータを中央揃えで表示します。
:right 項目のデータを右端揃えで表示します。
:top 項目のデータを上段に表示します。
:middle 項目のデータを中段に表示します。
:bottom 項目のデータを下段に表示します。
:hidden 項目を一覧に表示しません。
「:asc」「:desc」と組み合わせることで
表示しない項目でソートが可能です。
:img(①,②,③) ①:横幅
②:縦幅
③:代替テキスト(任意)
項目が「画像」型の場合に使用可能なオプションです。主に画像のサイズを調整するために使用します。横幅、立幅には「px」や「%」等のHTMLで使用可能な指定方法が利用できます。
:br このオプションを付与した項目と右隣に記載した項目を改行区切りで1つの列にまとめて表示します。

オプションの使用例

オプションを使用するとショートコードのみで以下のような一覧作成することも可能です。ぜひゲームに適した一覧表を作成してください!

例:[gwdb サンプル{ID:center|アイコン:br:center:img(50px,50px):link|名称:center:link|説明文}{ID:>=10000}/]

ソート可能なデータ一覧を作成する

いつでも項目別にソートが可能な一覧表を作成することが可能です。
ショートコードのみを使用する場合とHTMLを利用する場合で方法が異なります。

ショートコード

ショートコードの検索条件の後にソート用の記述「{sort}」を追記します。

例:[gwdb サンプル{ID|名称|アイコン}{ID:>=10000}{sort}/]

検索条件を指定しない場合は以下のように記述します(条件部分に空の{}が必要です)。

例:[gwdb サンプル{ID|名称|アイコン}{}{sort}/]

HTML

HTMLでtableタグへ「class=”tablesorter”」を追加し、theadタグのtr内のタグはtdに変更してください。以下は記述例です。

データ一覧に絞り込み機能を追加する

[gwdb/]と[gwdb_filter/]の2つのショートコードを組み合わせることで
データ一覧に絞り込み機能を追加することが可能です。
以下は作成例です。

例:[gwdb_filter サンプル{属性}/]

絞り込み機能が表示された一覧が作成されます。

データ件数について

[gwdb/]で取得するデータが大量に存在する場合、画面の表示が遅くなる可能性があります。
取得結果を条件である程度を絞った状態でご利用ください。

絞り込み対象の項目について

絞り込みに使う項目はデータ間で内容が重複する項目を使用が使用されることを想定しています。
文章を含んだ項目の絞り込みには適しておりませんのでご注意ください。
例:キャラクターの「属性」や「レア度」など