the_attachment_link()
Виводить html тег A посилання на прикріплений до посту файл (вкладення) або сторінку цього файлу шаблону.
Виведе повідомлення “Missing Attachment”, якщо з якихось причин не вдалося отримати посилання на вкладення або вкладення не підходить за вказаними параметрами.
Посилання буде показано, якщо сторінка містить:
- Прикріплену до поста картинку;
- Заголовок вкладення (текст). Для вкладень типу відмінного від картинки.
Працює на основі:
1 раз – 0.00291 сек
(дуже повільно) | 50000 разів – 5.22 сек
(швидко) |
PHP 7.1.2, WP 4.7.3
1 раз – 0.00291 сек
(дуже повільно) | 50000 разів – 5.22 сек
(швидко) |
PHP 7.1.2, WP 4.7.3
Хуків немає.
Повертає
null. Виводить дані на екран.
Використання
<?php the_attachment_link( $id, $fullsize, $deprecated, $permalink); ?>
-
$id
(число) -
ID вкладення, посилання на яке потрібно отримати.
За замовчуванням: ID поточного вкладення (всередині циклу вкладень) -
$fullsize
(логічний) -
Параметр для вкладень-картинок. Можливо:
false— буде виведено посилання на мініатюру картинки (створена WordPress), якщо мініатюри немає, буде виведено посилання на оригінальний розмір зображення;
true– Виведе посилання на повнорозмірне зображення.
Типово: false -
$deprecated
(масив) -
(параметр заборонено з версії 2.3) Максимальна ширина і висота картинки або іконки, якщо картинка має розмір сторони більше, ніж зазначений у цьому параметрі, посилання не виводиться.
За замовчуванням: не використовується -
$permalink
(логічний) -
Який використовувати УРЛ для посилання:
true– УРЛ у структурі двигуна;
false– Просто, УРЛ на файл. За замовчуванням.
Типово: false
Приклади
#1 Виведемо посилання на прикріплену картинку повного розміру, яка посилатиметься на сам файл картинки:
<?php the_attachment_link( 4, true ); ?>
Отримаємо:
<a href="https://wp-doc.com/wp-content/uploads/2022/09/yandex.png"> <img width="73" height="24" src="https://wp-doc.com/wp-content/uploads/2022/09/yandex.png" class="attachment-full size-full" alt=""> </a>
#2 Виведемо посилання вкладення, яка вестиме сторінку вкладення, у структурі движка:
<?php the_attachment_link( 4, false, false, true); ?>
Отримаємо:
<a href="/yandex"> <img width="73" height="24" src="https://wp-doc.com/wp-content/uploads/2022/09/yandex.png" class="attachment-thumbnail size-thumbnail" alt=""> </a>
список змін
| З версії 2.0.0 | Введено. |
Код the_attachment_link() the attachment link WP 6.0.2
function the_attachment_link( $id = 0, $fullsize = false, $deprecated = false, $permalink = false ) {
if ( ! empty( $deprecated ) ) {
_deprecated_argument( __FUNCTION__, '2.5.0');
}
if ( $fullsize ) {
echo wp_get_attachment_link($id, 'full', $permalink);
} else {
echo wp_get_attachment_link( $id, 'thumbnail', $permalink );
}
}