previous_image_link()
Выводит ссылку на предыдущую картинку прикрепленную к посту. Возвращает HTML код ссылки.
Работает на основе: get_previous_image_link(), adjacent_image_link()
Хуков нет.
Возвращает
null.
Использование
<?php previous_image_link( $size, $text ); ?>
- $size(строка/массив)
- Размер картинки ссылку на которую нужно вывести. Может быть:
'medium','large','fullsize'.
По умолчанию: 'thumbnail' - $text(строка)
- Текст ссылки (анкор).
По умолчанию: false
Примеры
#1 Выровняем ссылку по левому краю
<div class="alignleft"><?php next_image_link() ?></div>
#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( 37, 37 ) ); ?>
Имейте ввиду, что указав произвольные размеры, картинка не будет реально уменьшена. Размеры будут заданы в коде и браузер уменьшит/увеличит оригинальный размер, путем растяжения или сжатия картинки-оригинала.
#4 Заголовок картинки в качества текста ссылки
Для этого нужно первый аргумент определить как false или 0.
<?php previous_image_link( false ); ?> <?php previous_image_link( 0 ); ?>
#5 Произвольный текст в качестве текста ссылки
Для этого нужно установить первый параметр в false, а во втором параметре указать нужный текст ссылки, например, 'Предыдущая картинка':
<?php previous_image_link( false, 'Предыдущая картинка' ); ?>
Список изменений
| С версии 2.5.0 | Введена. |
Код previous_image_link() previous image link WP 6.6.1
function previous_image_link( $size = 'thumbnail', $text = false ) {
echo get_previous_image_link( $size, $text );
}