10 09/2014

wordpress gallery shortcode

最后更新: Wed Sep 10 2014 12:39:11 GMT+0800

注意:后台 Settings - Media 中,可以设置 Thumbnail size 默认的缩略图大小。

默认

由id 为 729,732,731,720 的图片组成相册。

[gallery ids="729,732,731,720"]

在 php 模版文件中

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

orderby

  • menu_order - you can reorder the images in the Gallery tab of the Add Media pop-up
  • title - order by the title of the image in the Media Library
  • post_date - sort by date/time
  • rand - order randomly
  • ID

order

ASC 或者 DESC

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

columns 列

0 表示不分列。分列实际上是通过 br style=”clear:both” 来实现的。

[gallery columns="4"]

注意:自己的主题中需要加 css 处理

.gallery-columns-3 dt,.gallery-columns-3 dl {display:inline-block;}

id

注意这个是 上传时关联的 post 的 id!也就是说,某篇文章的 所有附件图片。

[gallery id="123"]

size

“thumbnail”, “medium”, “large”, “full” ,默认是 thumbnail

[gallery size="medium"]

自定义标签

itemtag

the name of the XHTML tag used to enclose each item in the gallery. The default is “dl”.替换掉 dl

icontag

the name of the XHTML tag used to enclose each thumbnail icon in the gallery. The default is “dt”.替换掉 dt

captiontag

the name of the XHTML tag used to enclose each caption. The default is “dd”. For example, to change the gallery markup to use div, span and p tags 替换dd

默认点击图片链接到 image.php 页面 而不是图片文件本身。下面这句 直接链接到 图片文件本身

[gallery link="file"] 

include

只显示这些 图片id(IDs)

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

exclude

不包括这些 图片id(IDs)

via Gallery_Shortcode