the_attachment_link() WP 2.0.0
Выводит html тег A ссылки на прикрепленный к посту файл (вложение) или страницу этого файла в шаблона.
Ссылка будет показана, если страница содержит:
-
Прикрепленную к посту картинку;
- Заголовок вложения (текст). Для вложений типа отличного от картинки.
Функция выводит на экран
html код ссылки или сообщение "Missing Attachment", если по каким-то причинам не удалось получить ссылку на вложение, или вложение не подходит по указанным параметрам.
Работает на основе:
wp_get_attachment_link()
✈ 1 раз = 0.00291с = очень медленно | 50000 раз = 5.22с = быстро | PHP 7.1.2, WP 4.7.3
Хуков нет.
Использование
<?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="/wp-content/uploads/2011/03/yandex.png"> <img width="73" height="24" src="/wp-content/uploads/2011/03/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="/wp-content/uploads/2011/03/yandex.png" class="attachment-thumbnail size-thumbnail" alt=""> </a>
Список изменений
С версии 2.0.0 | Введена. |
Подскажите а как удалить эти страницы вложений или вообще их отключить?
Используй такой хук. Он удаляет правила ЧПУ связанные со страницами вложений. После вставки кода, например, в файл functions.php нужно сбросить правила ЧПУ. Для этого нужно просто зайти в
Настройки > Постоянные ссылки
.при наведении на картинку товара что бы была ссылка на сам товар,пожалуйста,уже не знаю куда обратиться