Шорткод [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" также:
- URL и другая информация о блоге
- Функции, подключающие шаблоны
- Циклы WordPress
- wp_list_categories
- Вход в систему
- wp_list_pages - список ссылок на страницы
- Функции даты и времени в WordPress
- wp_link_pages - ссылки на страницы статьи с nextpage
- Функции для работы с метками
- Функции action, filter, plugin и локализация
- Произвольные поля (custom fields)
- Функции для работы с типами данных (записей)
- Функция wp_insert_post - обновление/добавление записи заданного типа
- Административные меню
- Функции для работы с пользователями и ролями пользователей