使用相冊簡碼(Gallery ShortCode)

以下內容中的中括號[]，為了不造成誤判所以均使用全形，在正式使用時，請用半形。

使用相冊簡碼(Using the gallery shortcode)

在 2.5，相冊功能允許在您的系統上來選擇增加圖片相冊(Image Gallery)到文章或插頁中。

這個〔gallery〕簡碼是使用在文章或插頁中，來顯示附加到文章或插頁的圖片縮圖相冊(Thumbnail Gallery)。它可以使用如下最簡單的形式：

〔gallery〕

它有幾個選項可以用來指定使用這個語法：

〔gallery option1="value1" option2="value2"〕

下面基本的選項都受到了支援：

columns

指定欄位的數目。相冊將包含一個斷列標籤於每列(由左至右謂之列)的結尾，並且會計算適當的欄位寬度。其預設值為 3 個欄位。假如欄位設定為 0 ，將不會包含斷列。例如，顯示一個欄位數目為 4 的相冊：

〔gallery columns="4"〕

id

指定文章的ID。該相冊將會顯示附加於那篇文章的相冊。預設的行為是，假如未指定ID則顯示附加於目前文章的圖片。例如，顯示附加文章ID為 1 的圖片：

〔gallery id="1"〕

(▼於 ID 為 10 的文章中使用文章 ID 為 1 的相冊。)

size

指定顯示縮圖的圖片大小。有效值包括"thumbnail"、"medium"與"full"。其預設值為"thumbnail"。例如，顯示一個中型大小圖片的相冊：

〔gallery size="medium"〕

底下是一些可用的進階選項：

orderby

指定縮圖的排序順序。其預設為"menu_order ASC, ID ASC"。

itemtag

在相冊中用來括住每個項目的標籤名稱。預設是"dl"標籤。

icontag

在相冊中用來括住每個縮圖圖示的標籤名稱。預設是"dt"標籤。

captiontag

用來括住每個標題的標籤名稱。預設是"dd"標籤。例如，改變相冊的標記為使用 div、span 與 p 標籤：

〔gallery itemtag="div" icontag="span" captiontag="p"〕