ギャラリー

ギャラリー（Galleries） - img1

画像ギャラリーは、WordPressサイトで写真を展示する最良の方法です。WordPressは、メディアアップローダーにデフォルトでギャラリー作成機能をバンドルしており、シンプルなギャラリーを作成できます。

注意: ギャラリーを追加する前に、メディアライブラリに画像が必要です。そうでない場合は、画像をライブラリにアップロードし、ギャラリー作成を進める必要があります。

ギャラリーショートコード

ギャラリー機能を使用すると、シンプルなショートコードを使って投稿やページに1つ以上の画像ギャラリーを追加できます。

ギャラリーショートコードの基本形式は: 

  1. [gallery]

投稿やページでids引数を使用せずに[gallery]ショートコードを使用すると、その投稿やページに「添付」された画像のみが表示されます。

IDを持つ複数の画像を追加する必要がある場合は、次のサンプルショートコードを使用してください。 

  1. //Note: 10, 205, 552 and 607 are the IDs of respected image.
  2. [gallery ids="10, 205, 552, 607"]

注意: ギャラリーの画像の適切なIDを見つけてください。メディアライブラリに移動し、該当する画像をクリックすると、URLにIDが表示されます。

テンプレートファイルからショートコードを使用するには、do_shortcode()関数を使用します。次のコードをテンプレートファイルに挿入してください: 

  1. <?php echo do_shortcode( [gallery] ); ?>

IDを持つショートコードを使用する必要がある場合は、次のコードをテンプレートファイルに挿入してください: 

  1. <?php echo do_shortcode( [gallery ids="10, 205, 552, 607"] ); ?>

使用法

以下の構文を使用して指定できるオプションが多数あります: 

  1. [gallery option1="value1" option2="value2"]

テンプレートファイルにギャラリーを直接印刷したい場合は、次のように[do_shortcode()](https://developer.wordpress.org/reference/functions/do_shortcode/)関数を使用します: 

  1. <?php echo do_shortcode( '[gallery option1="value1"]' ); ?>

ショートコードをフィルタリングする必要がある場合、次の例がいくつかのヒントを提供します。 

  1. // Note: 'the_content' filter is used to filter the content of the
  2. // post after it is retrieved from the database and before it is
  3. // printed to the screen.
  4. <?php
  5. $gallery_shortcode = '[gallery id="' . intval( $post->post_parent ) . '"]';
  6. print apply_filters( 'the_content', $gallery_shortcode );
  7. ?>

サポートされているオプション

ギャラリーショートコードは、以下にリストされている基本オプションをサポートしています:

並べ替え

‘orderby’はサムネイルの表示順を指定します。デフォルトの順序は‘menu_order’です。

  • menu_order: メディアポップアップのギャラリータブで画像の順序を変更できます。
  • title: メディアライブラリ内の画像のタイトルで並べ替えます。
  • post_date: 日付/時間でソートします。
  • rand: ランダムに並べ替えます。
  • ID: 投稿IDを指定します。

順序

orderはサムネイルを表示するためのソート順を指定します; ASCまたはDESC。例えば、IDでDESCにソートするには: 

  1. [gallery order="DESC" orderby="ID"]

テンプレートファイルに印刷する必要がある場合は、do_shortcode()関数を使用します; 

  1. <?php echo do_shortcode( '[gallery]' ); ?>

列

列オプションは、ギャラリー内の列の数を指定します。デフォルト値は3です。

ギャラリーの列数を増やしたい場合は、次のショートコードを使用します。 

  1. [gallery columns="4"]

テンプレートファイルに印刷する必要がある場合は、do_shortcode()関数を使用します; 

  1. <?php echo do_shortcode(' [gallery columns="4"] '); ?>

ID

ギャラリーショートコードのIDオプションは、特定の投稿IDを持つ画像を読み込みます。

特定の投稿IDを持つ添付画像を表示したい場合は、次のコード例に従ってください。 

  1. // Note: remove each space between brackets and 'gallery' and brackets and `123"`.
  2. //Here "123" stands for the post IDs. If you want to display more than
  3. //one ID, separate the IDs by a comma `,`.
  4. [ gallery id="123" ]

テンプレートファイルでIDを持つギャラリーを印刷するには、次のように‘do_shortcode’関数を使用します: 

  1. // Note: remove each space between brackets and 'gallery' and brackets and `123"`.
  2. <?php echo do_shortcode(' [ gallery id="123" ] '); ?>

サイズ

サイズは、サムネイル表示に使用する画像サイズを決定します。有効な値には「thumbnail」、「medium」、「large」、「full」およびadd_image_size()で登録されたその他の追加画像サイズが含まれます。デフォルト値は「thumbnail」です。「thumbnail」、「medium」および「large」の画像サイズは、WordPress管理パネルの設定 > メディアで構成できます。

例えば、中サイズの画像のギャラリーを表示するには: 

  1. [gallery size="medium"]

ギャラリーショートコードには、いくつかの高度なオプションも利用可能です。

itemtag

ギャラリー内の各アイテムを囲むために使用されるHTMLタグの名前。デフォルトは「dl」です。

icontag

ギャラリー内の各サムネイルアイコンを囲むために使用されるHTMLタグの名前。デフォルトは「dt」です。

captiontag

各キャプションを囲むために使用されるHTMLタグの名前。デフォルトは「dd」です。

デフォルトを変更することが許可されています。 

  1. [gallery itemtag="div" icontag="span" captiontag="p"]

リンク

画像がリンクする場所を指定します。デフォルト値は添付ファイルのパーマリンクにリンクします。オプション:

  • file – 画像ファイルに直接リンク
  • none – リンクなし

例: 

  1. [gallery link="file"]

含める

含めるは、これらの添付ファイルからのみ画像を表示するために、カンマ区切りの添付IDの「配列」を挿入することを許可します。 

  1. [gallery include="23,39,45"]

除外

除外は、これらの添付ファイルから画像を表示しないために、カンマ区切りの添付IDの「配列」を挿入することを許可します。含めると除外は一緒に使用できないことに注意してください。 

  1. [gallery exclude="21,32,43"]

参考文献

技術的な詳細については、以下のリンクを参照してください。