the_attachment_link с версии 2.0.0

Описание

Выводит html код ссылки на прикрепленный к посту файл (вложение) или страницу этого файла в структуре шаблона.

Ссылка будет показана, если страница содержит:

1. Прикрепленную к посту картинку;
2. Заголовок вложения (текст). Для вложений типа отличного от картинки.

the_attachment_link() работает на базе wp_get_attachment_link().

Функция выводит на экран html код ссылки или сообщение "Missing Attachment", если по каким-то причинам не удалось получить ссылку на вложение, или вложение не подходит по указанным параметрам.

Использование

<?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 ); ?>

2. Выведем ссылку на вложение, которая будет вести на страницу вложения, в структуре движка:

<?php the_attachment_link( 4, false, false, true); ?>

Получим: http://site.ru/путь_к_посту/название_поста/название_вложения

the_attachment_link()

function the_attachment_link( $id = 0, $fullsize = false, $deprecated = false, $permalink = false ) {
	if ( !empty( $deprecated ) )
		_deprecated_argument( __FUNCTION__, '2.5' );

	if ( $fullsize )
		echo wp_get_attachment_link($id, 'full', $permalink);
	else
		echo wp_get_attachment_link($id, 'thumbnail', $permalink);
}

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.

Сегодня так много компаний, которые предлагают услуги создания сайта любой сложности. Однако не каждая их них сможет действительно ответить сполна перед заказчиком. Качественное создание сайтов в Перми можно заказать у компании saitosfera.ru