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

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

「ギャラリーショートコードの使い方」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(2.9: include, exclude オプション追加 /link オプション追加(バージョン不明)、未翻訳)
(全体を和訳。英語版の誤記を修正。2.9.2ソースよりinclude優先を確認して追記。)
1行目: 1行目:
 
{{NeedTrans}}
 
{{NeedTrans}}
  
In [[Version 2.5|WordPress 2.5]], the [[用語集#Gallery|Gallery]] feature allows the option to add an image gallery to a Post or [[Pages|Page]] on your WordPress blog.
+
[[Version 2.5|WordPress 2.5]]から、[[用語集#Gallery|ギャラリー]]機能により固定ページや記事に画像ギャラリーを追加できるようになりました。
  
The <code>[gallery]</code> [[ショートコード API|shortcode]] is used in a Post or Page to display a thumbnail gallery of images attached to that post.  It can be used in its simplest form like this:
+
<code>[gallery]</code> [[ショートコード API|ショートコード API]]を使って投稿に添付された画像のサムネイルギャラリーを表示することができます。最もシンプルな書き方は以下の通りです。
  
 
  [gallery]
 
  [gallery]
  
There are several options that may be specified using this syntax:
+
以下の書き方でいくつかオプションを指定することができます。
  
 
  [gallery option1="value1" option2="value2"]
 
  [gallery option1="value1" option2="value2"]
  
You can also print a gallery directly in a template like so:
+
テンプレートファイル内で直接ギャラリーを出力することもできます。
  
 
   <?php echo do_shortcode('[gallery option1="value1"]'); ?>
 
   <?php echo do_shortcode('[gallery option1="value1"]'); ?>
  
This works too:
+
以下のように記述しても良いです。
  
 
   <?php
 
   <?php
22行目: 22行目:
 
   ?>
 
   ?>
  
== Options ==
+
== 設定 ==
  
The following basic options are supported:
+
以下の設定が利用できます。
  
; columns : specify the number of columns.  The gallery will include a break tag at the end of each row, and calculate the column width as appropriate.  The default value is 3.  If columns is set to 0, no row breaks will be included.  For example, to display a 4 column gallery:
+
; columns : カラム数を指定します。各々の行の後には改行タグが挿入され、カラムの幅は適切に調整されます。初期値は 3 です。0 にすると改行タグは挿入されません。例えば、4カラムのギャラリーなら以下のように指定します。
  
 
  [gallery columns="4"]
 
  [gallery columns="4"]
  
; id : specify the post ID.  The gallery will display images which are attached to that post.  The default behaviour if no ID is specified is to display images attached to the current post.  For example, to display images attached to post 123:
+
; id : 投稿IDを指定します。指定された投稿に添付されている画像のギャラリーを表示します。ID の指定がない場合は、現在の投稿がギャラリーの対象になります。例えば、投稿のIDが123の画像ギャラリーを表示するなら以下のように指定します。
  
 
  [gallery id="123"]
 
  [gallery id="123"]
  
; size : specify the image size to use for the thumbnail display.  Valid values include "thumbnail", "medium", "large" and "full".  The default is "thumbnail". The size of the images for "thumbnail", "medium" and "large" can be configured in WordPress admin panel under Settings > Media. For example, to display a gallery of medium sized images:
+
; size : ギャラリーとして表示するサムネイル画像のサイズを指定します。指定できる値は "thumbnail", "medium", "large", "full" です。初期値は "thumbnail" です。"thumbnail(サムネイルのサイズ)", "medium(中サイズ)", "large(大サイズ)" の画像サイズは管理画面の 設定 > メディア で指定できます。例えば、"medium(中サイズ)" の画像ギャラリーを表示するなら以下のように指定します。
  
 
  [gallery size="medium"]
 
  [gallery size="medium"]
  
Some advanced options are available:
+
さらに高度な設定をすることもできます。
  
; orderby : specify the sort order used to display thumbnails.  The default is "menu_order ASC, ID ASC". "RAND" (random) is also supported.
+
; orderby : 画像の表示順序を指定します。初期値は "menu_order ASC, ID ASC" です。"RAND" (ランダム)も指定できます。
  
; itemtag : the name of the XHTML tag used to enclose each item in the gallery.  The default is "dl".
+
; itemtag : ギャラリーの各項目(画像とキャプション)を囲む XHTML タグの名前を指定します。初期値は "dl" です。
  
; icontag : the name of the XHTML tag used to enclose each thumbnail icon in the gallery.  The default is "dt".
+
; icontag : ギャラリーの各画像を囲む XHTML タグを指定します。初期値は "dt" です。
  
; captiontag: the name of the XHTML tag used to enclose each caption.  The default is "dd".  For example, to change the gallery markup to use div, span and p tags:
+
; captiontag: 各キャプションを囲む XHTML タグを指定します。初期値は "dd" です。
  
; link: you can set it to "file" so each image will link to the image file. The default value links to the attachment's permalink.
+
例えば、ギャラリーのマークアップを div, span, p タグに変更するなら以下のように指定します。
  
; include: comma separated attachment IDs, [gallery include="23,39,45"] will show only the images from these attachments.
+
[gallery itemtag="div" icontag="span" captiontag="p"]
  
; exclude: comma separated attachment IDs, [gallery exclude="21,32,43"] excludes the images from these attachments. Please note that '''include''' and '''exclude''' cannot be used together.
+
; link: "file" を指定すると各画像は画像ファイルへリンクされます。初期値はメディアのパーマリンクへのリンクです。
  
  [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 が優先されます。
  
 
== 変更履歴 ==
 
== 変更履歴 ==

2010年4月12日 (月) 21:47時点における版

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

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"]

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

orderby 
画像の表示順序を指定します。初期値は "menu_order ASC, ID ASC" です。"RAND" (ランダム)も指定できます。
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最新版との差分