Справочник » Функции WordPress »

Шорткод [gallery]

Шорткод [gallery] добавляет в запись (Post) или постоянную страницу (Page) блога WordPress галерею изображений. Начиная с WordPress 3.5, в галерею можно добавить любые изображения из библиотеки файлов сайта. 

При добавлении галереи  из встроенного редактора (кнопка Добавить медиафайл, см. Изображения и медиафайлы в WordPress), WordPress вставляет шорткод [gallery] с указанием списка id изображений в параметре ids.

Если id изображений в шорткоде [gallery] не указаны, будет выводиться галерея изображений, прикрепленных к данной записи или странице, т.е. загруженных в библиотеку WordPress из встроенного редактора.

По умолчанию [gallery] выводит миниатюры изображений по три в строке.

Добавление галереи в шаблон

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

или

<?php
  $gallery_shortcode = '[gallery id="' . intval( $post->post_parent ) . '"]';
  print apply_filters( 'the_content', $gallery_shortcode );
  ?>

Параметры

по
умолчанию
columns 3 - количество колонок (в конце строки добавляется тег <br/>) Если равно 0, тег <br/> не добавляется.
id id текущей страницы id страницы, галерею которой нужно вывести.
size "thumbnail" размер изображения в галерее: "thumbnail" (миниатюра) , "medium" (средний) , "large" (крупный) (эти размеры можно изменять на административной странице Параметры-Медиафайлы) или "full" (полный).
orderby "menu_order ASC, ID ASC" порядок сортировки. "menu_order" -порядок меню; "RAND" - случайно; ...
itemtag "dl" XHTML-тег, в который помещается каждый элемент в галерее.
icontag "dt" XHTML-тег, в который помещается каждая миниатюра в галерее.
captiontag "dd" XHTML-тег, в который помещается каждая надпись к изображению (можно изменить на div, span and p)
link постоянная ссылка на вложение на что ссылка. Опции "file" - файл и "post" - запись-страница вложения
include все изображения список id включаемых изображений через запятую:
[gallery include="20,24,25"]
exclude - список id исключаемых изображений через запятую:

*** include и exclude нельзя использовать одновременно.

Пример:

[gallery size="medium" itemtag="div" icontag="span" captiontag="p" link="file"]

Дополнительно: в разделе "Функции WordPress" также:

Добавить комментарий