Articles

WordPress.org

by admin

Languages: English – Italiano – 日本語 Português do Brasil – Русский – (Add your language)

The Gallery feature allows you to add one or more image galleries to your posts and pages using a simple Shortcode. WordPress 2.5 以降、3.5 までは、ギャラリー ショートコードは最も基本的な形でよく使用されました。 



3.5以降では、ギャラリーショートコードはデフォルトで画像IDを含んでいます。 このように、




このスタイルのギャラリー ショートコードは 3.5 の新機能ではなく、以前は include 属性を使用できたことに注意してください。 しかし、3.5 で導入された新しいメディア ワークフローを使用すると、より簡単に生成および管理できます。 


ショートコードで ID を指定すると、必ずしも投稿に「添付」されていない画像、つまり、投稿またはページ内からアップロードされていない画像をギャラリーに含めることができます。 この柔軟性により、任意の数の画像を含む任意の数のギャラリーを作成および埋め込むことができます！


注意: ショートコードの「基本」バージョンを投稿またはページで使用する場合、その投稿またはページに「添付」されている画像のみが表示されます。


Usage


この構文を使用して指定できるオプションはいくつかあります:




また、次のようにテンプレートで直接ギャラリーを印刷することもできます:


 <?php echo do_shortcode(''); ?>


これも使えます:


 <?php $gallery_shortcode = ''; print apply_filters( 'the_content', $gallery_shortcode ); ?>


Options


次の基本オプションがサポートされています： 


orderby サムネイルをどう並べるかを設定することができます。 デフォルトは “menu_order “です。 オプションです。 


    

  •  menu_order – メディア追加ポップアップのギャラリータブでイメージを並べ替える
    • 

  •  title – メディアライブラリのイメージのタイトルで並べ替える
    • 

  •  post_date – 日付/時間で並べ替える
    • 

  •  rand – ランダムに並べる
    • 

  •  ID
    • 



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


 


 columnsは、列の数を指定します。 ギャラリーでは、各行の最後に改行タグが含まれ、列の幅が適切に計算されます。 デフォルト値は3です。columnsに0を指定すると、行の区切りは含まれません。 例えば、4列のギャラリーを表示する場合。 




 idに投稿IDを指定します。 ギャラリーはその投稿に添付されたイメージを表示します。 IDを指定しない場合のデフォルトの動作は、現在の投稿に添付されたイメージを表示します。 例：投稿123に添付されたイメージを表示する場合。 




 size サムネイル表示に使用する画像サイズを指定します。 指定可能な値は、”thumbnail”, “medium”, “large”, “full” および add_image_size() で登録された画像サイズである。 デフォルトは “thumbnail” である。 thumbnail」「medium」「large」の画像サイズは、WordPress管理画面の「設定 > メディア」で設定することができます。 例えば、中サイズの画像を集めたギャラリーを表示する場合。 




いくつかの高度なオプションがあります:


 itemtag ギャラリーの各アイテムを囲むために使用されるXHTMLタグの名前です。 icontag ギャラリーの各サムネイル アイコンを囲むために使用される XHTML タグの名前です。 デフォルトは “dt “です。 captiontag 各キャプションを囲むために使用されるXHTMLタグの名前です。 デフォルトは “dd “です。 例えば、div、span、pタグを使用するようにギャラリーのマークアップを変更する場合。 




 link 画像のリンク先を指定します。 デフォルト値は、添付ファイルのパーマリンクにリンクします。 オプションです。 


    

  •  file – イメージファイルに直接リンク
    • 

  •  none – リンクなし
    • 



 


 include comma separated attachment IDs to show only the images from these attachments.カンマで区切られた添付ファイルIDを含む。 


 


 exclude カンマで区切られた添付ファイルIDを指定すると、これらの添付ファイルからのイメージを除外して表示します。 なお、includeとexcludeは同時に使用できません。 




Developers – Things to consider


ID が明示されていないギャラリーに対するデフォルトの期待動作は、親として投稿が割り当てられているすべての画像を追加することです。 言い換えると、この投稿編集画面の「メディアを追加」ボタン/リンクを使用してアップロードされたすべての画像を追加します。 これは、その投稿に後から追加されたすべての添付ファイルもギャラリーの一部と解釈されることを意味します。 


 引数が提供されなかった場合、これがデフォルトのフォールバックになるはずです: …lorem ipsum…


$attachments = get_children( array('post_parent' => $attr,'post_status' => 'inherit','post_type' => 'attachment','post_mime_type' => 'image','order' => $attr,'orderby' => $attr,) );


 そして shortcode_atts() （または他の場所）で extract() を使うのは止めてください。 IDE はそれをバックトレースすることができません。