Galleries · WordPress開發手冊

圖片庫是在WordPress網站上展示圖片的最佳方式。默認情況下，WordPress會在媒體上傳器中包含“創建圖庫”功能，從而可以創建一個簡單的圖庫。 >[warning] 注意：添加圖庫之前，您必須在媒體庫中擁有圖像。否則，您需要將圖像上傳到庫中，并可以進行圖庫創建。 ## 圖庫短碼畫廊功能允許您使用簡單的短碼將一個或多個圖像畫廊添加到您的帖子和頁面。畫廊短碼的基本形式是： ``` [gallery] ``` >[info] 提示：如果您使用`[gallery]`短代碼而不使用您的帖子或頁面中的ids參數，則只顯示“附加到該帖子或頁面”的圖像。如果您需要添加ID的多個圖像，請使用以下示例短代碼 `` [gallery ids="10, 205, 552, 607"] //Note: 10, 205, 552 and 607 are the IDs of respected image. `` >[info] 提示：注意：找到圖庫的圖像的正確ID。轉到媒體庫，然后點擊尊重的圖像，ID將顯示在URL上。要使用模板文件中的短代碼，請使用do_shortcode（）函數。將以下代碼插入到您的模板文件中： ``` echo do_shortcode( [gallery] ); ``` 如果需要使用帶有ID的短代碼，請在模板文件中插入以下代碼： ``` echo do_shortcode( [gallery ids="10, 205, 552, 607"] ); ``` ## 用法有可能使用以下語法指定的選項： ``` [gallery option1="value1" option2="value2"] ``` 如果要直接在模板文件上打印圖庫，請使用`do_shortcode()`函數，如下所示： ``` <?php echo do_shortcode('[gallery option1="value1"]'); ?> ``` 如果您需要過濾短碼，以下示例將為您提供一些提示 ``` // 注意：'the_content'過濾器用于在從數據庫檢索并在打印到屏幕之前過濾帖子的內容 <?php $gallery_shortcode = '[gallery id="' . intval( $post->post_parent ) . '"]'; print apply_filters( 'the_content', $gallery_shortcode ); ?> ``` ## 支持的選項 Gallery Shortcodes支持下列基本選項： ## 排序 ‘orderby’ 指定縮略圖顯示的順序。默認順序是“menu_order”。 - menu_order: 您可以在“添加媒體”彈出窗口的“圖庫”選項卡中重新排列圖像 - title:按照媒體庫中圖片的標題排序 - post_date: 按日期/時間排序 - rand: 隨機訂購 - ID: 指定帖子ID 指定用于顯示縮略圖的排序順序; ASC或DESC。例如，按ID和DESC排序： ``` [gallery order="DESC" orderby="ID"] ``` 如果需要在模板文件上打印，請使用do_shortcode()函數; ``` <?php echo do_shortcode(' [gallery order="DESC" orderby="ID"]'); ?> ``` ## 列 “columns”選項指定庫中的列數。默認值為3。如果要增加列數，請使用以下短代碼。 ``` [gallery columns="4"] ``` 如果您需要在模板文件上打印，請使用do_shortcode()函數; ``` <?php echo do_shortcode(' [gallery columns="4"] '); ?> ``` ## IDs 圖庫短代碼上的ID選項加載具有特定帖子ID的圖像。如果要使用特定的帖子ID顯示附加的圖像，請按照以下代碼示例。 ``` //注意：刪除括號和“gallery”和括號之間的每個空格，“123”`。 //這里“123”表示帖子ID。如果要顯示多個ID，請使用逗號（，）`分隔ID。 [ gallery id="123" ] ``` Use ‘do_shortcode’ function to print the gallery with IDs on template files like below: ``` // 注意：刪除括號和“gallery”和括號之間的每個空格，“123”。 <?php echo do_shortcode(' [ gallery id="123" ] '); ?> ``` ## Size 尺寸決定要用于縮略圖顯示的圖像大小。有效值包括“thumbnail”，“medium”，“large”，“full”以及使用add_image_size()注冊的任何其他附加圖像大小。默認值為“thumbnail”。 “縮略圖”，“中”和“大”圖像的大小可以在“設置”>“媒體”中的WordPress管理面板中進行配置。例如，要顯示中等大小的圖像庫： ``` [gallery size="medium"] ``` Gallery的縮寫也有一些高級選項。 ## itemtag HTML標簽的名稱，用于將每個項目包含在庫中。默認值為“dl”。 ## icontag HTMLtag的名稱用于將每個縮略圖圖標包圍在圖庫中。默認值為“dt”。 ## captiontag 用于附加每個標題的HTML標簽的名稱。默認值為“dd”。您可以更改默認值。 ``` [gallery itemtag="div" icontag="span" captiontag="p"] ``` ## Link 指定要連接圖像的位置。默認值鏈接到附件固定鏈接。選項： - file - 直接鏈接到圖像文件 - none - 無鏈接例： ``` [gallery link="file"] ``` ## Include 包含允許您插入逗號分隔的附件ID的“數組”，以僅顯示這些附件的圖像。 ``` [gallery include="23,39,45"] ``` ## Exclude 排除cal你插入一個“數組”的逗號分隔的附件ID，不顯示這些附件的圖像。請注意，包含和排除不能一起使用。 ``` [gallery exclude="21,32,43"] ``` ## References For more technical details take a reference from below links Gallery Shortcode Function do_shortcode()