• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

ギャラリーショートコードの使い方

提供: WordPress Codex 日本語版
2010年4月12日 (月) 22:30時点におけるKz (トーク | 投稿記録)による版 (設定: 英語版からorderの内容がorderbyに混在していた記述を分離。galleryショートコードのorderbyはRAND(大文字)だが、内部で呼んでるget_postsはrand(小文字)なので正しく動作しない気)

移動先: 案内検索

このページ「ギャラリーショートコードの使い方」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

WordPress 2.5から、ギャラリー機能により固定ページや記事に画像ギャラリーを追加できるようになりました。

[gallery] ショートコード APIを使って投稿に添付された画像のサムネイルギャラリーを表示することができます。最もシンプルな書き方は以下の通りです。

[gallery]

以下の書き方でいくつかオプションを指定することができます。

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

テンプレートファイル内で直接ギャラリーを出力することもできます。

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

以下のように記述しても良いです。

 <?php
    $gallery_shortcode = '[gallery id="' . intval( $post->post_parent ) . '"]';
    print apply_filters( 'the_content', $gallery_shortcode );
 ?>

設定

以下の設定が利用できます。

columns 
カラム数を指定します。各々の行の後には改行タグが挿入され、カラムの幅は適切に調整されます。初期値は 3 です。0 にすると改行タグは挿入されません。例えば、4カラムのギャラリーなら以下のように指定します。
[gallery columns="4"]
id 
投稿IDを指定します。指定された投稿に添付されている画像のギャラリーを表示します。ID の指定がない場合は、現在の投稿がギャラリーの対象になります。例えば、投稿のIDが123の画像ギャラリーを表示するなら以下のように指定します。
[gallery id="123"]
size 
ギャラリーとして表示するサムネイル画像のサイズを指定します。指定できる値は "thumbnail", "medium", "large", "full" です。初期値は "thumbnail" です。"thumbnail(サムネイルのサイズ)", "medium(中サイズ)", "large(大サイズ)" の画像サイズは管理画面の 設定 > メディア で指定できます。例えば、"medium(中サイズ)" の画像ギャラリーを表示するなら以下のように指定します。
[gallery size="medium"]

さらに高度な設定をすることもできます。

order 
画像の表示順序を指定します。初期値は "ASC" です。
orderby 
画像の表示順序のキーとなる項目を指定します。スペース区切りで複数指定できます。初期値は "menu_order ID" です。"RAND" (ランダム)も指定できますがその場合、order の指定は無視されます。
itemtag 
ギャラリーの各項目(画像とキャプション)を囲む XHTML タグの名前を指定します。初期値は "dl" です。
icontag 
ギャラリーの各画像を囲む XHTML タグを指定します。初期値は "dt" です。
captiontag
各キャプションを囲む XHTML タグを指定します。初期値は "dd" です。

例えば、ギャラリーのマークアップを div, span, p タグに変更するなら以下のように指定します。

[gallery itemtag="div" icontag="span" captiontag="p"]
link
"file" を指定すると各画像は画像ファイルへリンクされます。初期値はメディアのパーマリンクへのリンクです。
[gallery link="file"]
include
表示したい添付画像のIDをコンマで区切って指定します。[gallery include="23,39,45"] と指定すると、指定したIDの画像のみ表示されます。
exclude
表示したくない添付画像のIDをコンマで区切って指定します。[gallery exclude="21,32,43"] と指定すると、指定したIDの画像は表示されません。

include と exclude は同時に指定しないでください。同時に指定した場合は include が優先されます。

変更履歴

  • 2.9 : include, exclude オプション追加
  • 2.5 : 新規機能

最新英語版: WordPress Codex » Gallery Shortcode最新版との差分