Функция the_attachment_link() в WordPress используется для отображения ссылки на страницу вложения или на сам файл вложения, включая изображения и другие типы медиа. Она автоматически генерирует HTML-код ссылки, который может содержать изображение или текст в зависимости от типа вложения. Эта функция полезна для вывода ссылок на файлы, прикрепленные к посту, с возможностью гибкой настройки.
the_attachment_link( int|WP_Post $post, bool $fullsize = false, bool $deprecated = false, bool $permalink = false )Описание параметров
- $post (int|WP_Post): Опциональный параметр, который принимает ID поста или объект поста. Если этот параметр не указан, будет использован текущий пост в цикле.
- $fullsize (bool): Указывает, должно ли быть использовано изображение в полном размере. По умолчанию —
false, то есть отображается миниатюра. - $deprecated (bool): Устаревший параметр, не используется. По умолчанию —
false. - $permalink (bool): Указывает, должна ли ссылка вести на страницу вложения (
true) или напрямую на файл вложения (false). По умолчанию —false.
Как работает the_attachment_link()
Эта функция выводит HTML ссылку на файл вложения или на страницу этого файла. Если вложение — изображение, оно будет отображено в виде изображения, а для остальных типов вложений выводится название файла. Если вложение не найдено или его не удается получить по указанным параметрам, функция выведет текст «Missing Attachment».
Пример 1: Ссылка на изображение в полном размере
<?php
the_attachment_link( 10, true );
?>
Этот пример выведет ссылку на прикрепленное изображение с ID 10 в полном размере. Ссылка будет вести на сам файл изображения:
<a href="/wp-content/uploads/2024/10/sample-image.png">
<img src="/wp-content/uploads/2024/10/sample-image.png" class="attachment-full size-full" alt="Sample Image">
</a>
Пример 2: Ссылка на миниатюру изображения с переходом на страницу вложения
<?php
the_attachment_link( 15, false, false, true );
?>
Этот пример выводит ссылку на миниатюру изображения с ID 15, при этом ссылка ведет на страницу вложения, а не на сам файл:
<a href="/attachment-page">
<img src="/wp-content/uploads/2024/10/sample-thumbnail.png" class="attachment-thumbnail size-thumbnail" alt="Sample Thumbnail">
</a>
Пример 3: Ссылка на не изображение
Если вложение не является изображением, функция выведет ссылку с названием вложения:
<?php
the_attachment_link( 20 );
?>
Этот пример выведет ссылку на вложение с ID 20 в виде текста:
<a href="/wp-content/uploads/2024/10/sample-document.pdf">Sample Document</a>
Рекомендации
Для большинства случаев, где нужно только получить ссылку, лучше использовать функцию wp_get_attachment_link(), которая возвращает ссылку в виде строки, а не выводит её сразу.
Заключение
Функция the_attachment_link() предоставляет простой способ отображения ссылки на вложения в постах WordPress. Она поддерживает различные типы вложений, от изображений до документов, и предлагает гибкие параметры для отображения полноразмерных изображений или миниатюр с опцией перехода на страницу вложения или на файл напрямую.