Шоткод [gallery] доступен с версии WordPress 2.5. Он добавляет в запись (Post) или постоянную страницу (Page) блога WordPress галерею изображений, прикрепленных к этой записи или странице, т.е. загруженных в библиотеку WordPress из встроенного редактора (см. Изображения и медиафайлы в 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"]