Тег шаблона: previous_image_link
Описание
Выводит ссылку на страницу предыдущего изображения, прикрепленного к текущей записи. Анкором ссылки по умолчанию является миниатюра изображения.
Использование
<?php previous_image_link( $size, $text ); ?>
Параметры
$size
(строка) (необязательный) - размер картинки, которая будет анкором ссылки на страницу с полным изображением. возможные значения: thumbnail, medium, large, fullsize или массив с указанными размерами изображения ('array(30,30)'). при заданном значении '0' или при boolean значении 'false' анкором ссылки на страницу предыдущего изображения будет текстовой заголовок этого изображения. при любом заданном значении параметра $text все значения параметра $size будут считаться только как '0' или 'false'.
По умолчанию: 'thumbnail'.
$text
(строка) (необязательный) - текстовой анкор ссылки на страницу предыдущего изображения.
По умолчанию значения нет.
Примеры
1. По умолчанию
<?php previous_image_link(); ?>
Данный код выведет ссылку на страницу предыдущего изображения с анкором из миниатюры этого изображения.
2. Размер изображения
<?php previous_image_link( 'thumbnail' ); ?> <?php previous_image_link( 'medium' ); ?> <?php previous_image_link( 'large' ); ?> <?php previous_image_link( 'fullsize' ); ?>
Данный код показывает, как использовать изменение размеров картинки, которая будет служить анкором для ссылки на страницу предыдущего изображения.
3. Собственный размер
<?php previous_image_link( array( 30, 30 ) ); ?>
Анкором ссылки на страницу предыдущего изображения будет картинка с размерами 30 на 30 пикселей.
4. Текстовые анкоры
<?php previous_image_link( false ); ?> <?php previous_image_link( 0 ); ?> <?php previous_image_link( false, '' ); ?> <?php previous_image_link( 0, '' ); ?>
Данные примеры выведут текстовые ссылки на страницу предыдущего изображения с анкором из заголовка этого изображения.
5. Свой анкор ссылки
<?php previous_image_link( 0, 'Предыдущее изображение' ); ?> <?php previous_image_link( 'thumbnail', 'Предыдущее изображение' ); ?> <?php previous_image_link( false, 'Предыдущее изображение' ); ?> <?php previous_image_link( '', 'Предыдущее изображение' ); ?>
Все эти примеры являются равнозначными и все они выведут текстовую ссылку на страницу предыдущего изображения с анкором ссылки "Предыдущее изображение".
Лог изменений
Функция добавлена в версии 2.5.0
Параметры $size и $text были добавлены в версии 2.8.0
Исходный файл
Функция previous_image_link() находится в wp-includes/media.php
Связанные теги\функции
the_ID, the_title, the_title_rss, the_title_attribute, single_post_title, the_content, the_content_feed, the_excerpt, the_excerpt_rss, [[wp_link_pages]], posts_nav_link, next_post_link, next_posts_link, previous_post_link, previous_posts_link, next_image_link, previous_image_link, sticky_class, the_category, the_category_rss, the_tags, the_meta
Комментарии
Комментариев пока еще нет.
Написать комментарий