WordPress中文开发手册

Galleries

图片库是在WordPress网站上展示图片的最佳方式。 默认情况下,WordPress会在媒体上传器中包含“创建图库”功能,从而可以创建一个简单的图库。

注意:添加图库之前,您必须在媒体库中拥有图像。 否则,您需要将图像上传到库中,并可以进行图库创建。

图库短码

画廊功能允许您使用简单的短码将一个或多个图像画廊添加到您的帖子和页面。

画廊短码的基本形式是:

[gallery]

提示:如果您使用

短代码而不使用您的帖子或页面中的ids参数,则只显示“附加到该帖子或页面”的图像。

如果您需要添加ID的多个图像,请使用以下示例短代码

``

//Note: 10, 205, 552 and 607 are the IDs of respected image.
``

提示:注意:找到图库的图像的正确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('
'); ?>

如果您需要过滤短码,以下示例将为您提供一些提示

// 注意:'the_content'过滤器用于在从数据库检索并在打印到屏幕之前过滤帖子的内容
 <?php $gallery_shortcode = '
';
    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('
'); ?>

“columns”选项指定库中的列数。 默认值为3。如果要增加列数,请使用以下短代码。

[gallery columns="4"]

如果您需要在模板文件上打印,请使用do_shortcode()函数;

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

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()