Функция previous_image_link() в WordPress предназначена для вывода ссылки на предыдущее изображение, связанное с текущим постом. Это удобно для пользователей, которые просматривают изображения, так как они могут легко перемещаться между ними.
previous_image_link( string|int[] $size = ‘thumbnail’, string|false $text = false )Описание
Функция previous_image_link() генерирует HTML-тег <a>, который ведет на предыдущее изображение в последовательности вложений. Обычно её используют на страницах вложений для улучшения навигации.
Параметры функции
$size(string|array) — Размер изображения, который вы хотите использовать. Принимает имя зарегистрированного размера или массив с шириной и высотой. По умолчанию: ‘thumbnail’.$text(string|false) — Текст ссылки (анкор). По умолчанию: false, что означает, что будет использоваться заголовок изображения.
Возвращаемое значение
null— Функция не возвращает значения, а выводит готовый HTML-тег<a>.
Пример 1: Вывод ссылки на предыдущее изображение
В этом примере создадим простую ссылку на предыдущее изображение, используя стандартный размер ‘thumbnail’:
<div class="alignleft"><?php previous_image_link(); ?></div>
Этот код выведет ссылку на предыдущее изображение, выровненную по левому краю. Если текущее изображение является первым в галерее, ссылка не будет отображаться.
Пример 2: Использование с пользовательским текстом
Вы также можете указать собственный текст для ссылки, например, «Предыдущее изображение»:
<div class="alignleft">
<?php previous_image_link('medium', 'Предыдущее изображение'); ?>
</div>
В этом случае ссылка будет вести на предыдущее изображение, и текст ссылки будет «Предыдущее изображение». Используется размер изображения ‘medium’.
Пример 3: Использование произвольных размеров
Если вам нужно указать произвольные размеры изображения, это можно сделать, передав массив ширины и высоты:
<div class="alignleft">
<?php previous_image_link(array(150, 100), 'Смотрим назад'); ?>
</div>
Здесь мы указали размер 150×100 пикселей для изображения, а текст ссылки — «Смотрим назад». Учтите, что это не создаст новое изображение, а браузер будет изменять размеры оригинала.
Пример 4: Использование заголовка изображения в качестве текста ссылки
Если вы хотите использовать заголовок изображения в качестве текста ссылки, просто передайте false в качестве первого параметра:
<div class="alignleft">
<?php previous_image_link(false); ?>
</div>
Эта функция выведет ссылку на предыдущее изображение, используя заголовок текущего изображения как текст ссылки.
Пример 5: Произвольный текст в качестве текста ссылки
Для указания произвольного текста в качестве текста ссылки, установите первый параметр в false, а второй — в нужный текст:
<div class="alignleft">
<?php previous_image_link(false, 'Назад к предыдущему'); ?>
</div>
Таким образом, ссылка будет вести на предыдущее изображение, а текст будет «Назад к предыдущему».
Заключение
Функция previous_image_link() является мощным инструментом для улучшения пользовательского опыта при просмотре изображений в WordPress. Она позволяет легко перемещаться к предыдущему изображению, что делает навигацию по галереям более интуитивной. Вы можете адаптировать параметры этой функции под свои нужды, выбирая размеры изображений и текст ссылок, что дает вам большую гибкость в дизайне вашей галереи.