画廊

画廊

图像库是在WordPress网站上展示图片的最佳方法。WordPress捆绑 创建画廊 默认情况下，媒体上传器中的功能使您可以创建一个简单的图库。

注意：在添加画廊之前，您必须在媒体库中有图像。否则，您需要将图像上传到库中，并可以在Gallery Creation上进行。

画廊快捷代码

这 画廊 功能使您可以使用简单的快捷代码在帖子和页面中添加一个或多个图像库。

画廊短代码的基本形式是：

[gallery]

如果您需要添加与ID的多个图像，请使用以下示例快捷代码

//Note: 10, 205, 552 and 607 are the IDs of respected image.
[gallery ids="10, 205, 552, 607"]

要使用模板文件中的快捷代码，请使用 do_shortcode（） 功能。将以下代码插入模板文件：

<?php echo do_shortcode( [gallery] ); ?>

如果您需要使用带有IDS的短代码，请在模板文件中插入以下代码：

<?php echo do_shortcode( [gallery ids="10, 205, 552, 607"] ); ?>

用法

可以使用以下语法指定可能的选项：

[gallery option1="value1" option2="value2"]

如果要直接在模板文件上打印图库，请使用` do_shortcode（）`函数如下：

<?php echo do_shortcode( '[gallery option1="value1"]' ); ?>

如果您需要过滤快捷代码，以下示例为您提供了一些技巧

// Note: 'the_content' filter is used to filter the content of the
// post after it is retrieved from the database and before it is 
// printed to the screen.
<?php
$gallery_shortcode = '[gallery id="' . intval( $post->post_parent ) . '"]';
print apply_filters( 'the_content', $gallery_shortcode );
?>

支持的选项

画廊短代码支持下面列出的基本选项：

订单

“ Orderby”指定缩略图显示的顺序。默认订单是“菜单_order”。

• 菜单_erd：您可以在添加媒体弹出的“画廊”选项卡中重新排序图像
• 标题：媒体库中图像标题的订单
• post_date：按日期/时间排序
• 兰德：随机订购
• ID：指定帖子ID

命令

订单指定用于显示缩略图的排序顺序；ASC或DESC。例如，按ID和DESC进行排序：

[gallery order="DESC" orderby="ID"]

如果需要在模板文件上打印它，请使用 do_shortcode（） 功能;

<?php echo do_shortcode( '[gallery]' ); ?>

列

列选项指定图库中的列数。默认值为3。
如果要增加厨房中的列数，请使用以下快捷代码。

[gallery columns="4"]

如果您需要在模板文件上打印它，请使用 do_shortcode（） 功能;

<?php echo do_shortcode(' [gallery columns="4"] '); ?>

IDS

图库中的IDS选项使用特定的发布ID加载图像。

如果要显示带有特定帖子ID的附件图像，请按照以下代码示例。

// Note: remove each space between brackets and 'gallery' and brackets and `123"`.
//Here "123" stands for the post IDs. If you want to display more than
//one ID, separate the IDs by a comma `,`.
[ gallery id="123" ]

使用“ do_shortCode”功能在模板文件上使用ID打印图库，如下：

// Note: remove each space between brackets and 'gallery' and brackets and `123"`.
<?php echo do_shortcode(' [ gallery id="123" ] '); ?>

尺寸

大小确定用于缩略图显示的图像大小。有效的值包括“缩略图”，“中等”，“大”，“完整”以及任何其他带有的其他图像大小 add_image_size（）。默认值是“缩略图”。可以在设置>媒体下的WordPress管理面板中配置“缩略图”，“中”和“大”的图像大小。

例如，显示一个中等大小图像的画廊：

[gallery size="medium"]

画廊的短代码也可以找到一些高级选项。

itemtag

HTML标签的名称用于将每个项目包装在画廊中。默认值为“ DL”。

ICONTAG

HTMLTAG的名称用于将每个缩略图图标封闭在画廊中。默认值为“ DT”。

字幕图

HTML标签的名称用于封闭每个字幕。默认值为“ DD”。

允许您更改默认值。

[gallery itemtag="div" icontag="span" captiontag="p"]

关联

指定您希望图像链接的位置。默认值链接到附件的 永久链接。选项：

• 文件 – 直接链接到图像文件
• 没有 – 没有链接

例子：

[gallery link="file"]

包括

Include允许您插入逗号分隔的附件ID的“数组”，以仅显示这些附件中的图像。

[gallery include="23,39,45"]

排除

排除呼唤您插入逗号分隔的附件ID的“数组”，以不显示这些附件中的图像。请注意，包括和排除不能一起使用。

[gallery exclude="21,32,43"]

参考

有关更多技术详细信息，请参考以下链接

• 画廊快捷代码
• 函数do_shortcode（）