wp_get_attachment_link с версии 2.5.0

Описание

Выводит html код ссылки на вложение (прикрепленный к посту файл) или страницу, содержащую вложения.

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

1. Прикрепленную к посту картинку указанного размера (в параметрах);
2. Медиа-иконку указанного размера, символизирующую вложенный файл;
3. Заголовок вложения;
4. Любой другой указанный заголовок.

wp_get_attachment_link() используется в: the_attachment_link().

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

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

<?php wp_get_attachment_link($id, $size, $permalink, $icon, $text); ?>

Параметры

$id (число)

ID вложения, ссылку на которое нужно получить.
По умолчанию: ID текущего вложения (внутри цикла вложений)

$size (строка/массив)

Размер изображения. Может быть:

• Строкой — thumbnail, medium, large или full;
• Массивом — массивом из двух значений означающих ширину и высоту картинки в пикселях (пр. array(32,32)). С версии 2.5. этот параметр не влияет на размер медиа иконок, которые всегда показываются в оригинальном размере.

По умолчанию: 'thumbnail'

$permalink (логический)

false — Прямая ссылка на вложение. true — ссылка на вложение в структуре сайта (как прикрепленный файл к посту).
По умолчанию: false

$icon (логический)

Использовать медиа иконку, для отображения вложения — true. Не использовать иконку — false - по умолчанию.
По умолчанию: false

$text (строка)

Текст ссылки, который будет вести на вложение. По умолчанию этим текстом становится название вложения.
По умолчанию: null

Примеры

1. Покажем вложение среднего размера.
По умолчанию размер картинок в WordPress - это "thumbnail", "medium", "large" или "full" (картинки которые загружаются). Конкретные размеры выставляются в настройках WordPress настройки > медиа.

<?php
    $id = 9; // ID вложения
    echo wp_get_attachment_link($id, 'medium');
 ?>

2. Этот пример выведет ссылку на вложение, в структуре WordPress:

<?php
    $id = 9;
    echo wp_get_attachment_link($id, 'thumbnail', true);
 ?>

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

3. Выставим свой текст ссылки:

<?php
    $id = 9;
    echo wp_get_attachment_link($id, '' , false, false, 'my link text');
 ?>

4. Этот пример выведет ссылку с текстом заголовка поста, которая будет вести на файл вложения.

<?php
    $id = 9;
    echo wp_get_attachment_link($id, '' , false, false, ' ');
 ?>

5. WordPress может использовать иконки, представляющие прикрепленный файл (вложение). Для картинок показываются миниатюры, для других файлов показываются картинки, соответствующие типу файла (например audio.jpg, который находится в папке: wp-includes/images/crystal/)

Следующий пример покажет вам, как можно изменить каталог откуда WordPress будет получать такие иконки, например изменим его на: wp-content/themes/yourtheme/images. Создайте каталог и скопируйте туда картинки-иконки и чтобы изменить путь до каталога в WordPress скопируйте этот код в файл темы functions.php:

add_filter('icon_dir', 'my_theme_icon_dyrectory');
function my_theme_icon_dyrectory($icon_dir) {
   return TEMPLATEPATH . '/images';
}

add_filter('icon_dir_uri', 'my_theme_icon_uri');
function my_theme_icon_uri($icon_dir) {
   return get_bloginfo('stylesheet_directory').'/images';
}

wp_get_attachment_link()

function wp_get_attachment_link( $id = 0, $size = 'thumbnail', $permalink = false, $icon = false, $text = false ) {
	$id = intval( $id );
	$_post = & get_post( $id );

	if ( empty( $_post ) || ( 'attachment' != $_post->post_type ) || ! $url = wp_get_attachment_url( $_post->ID ) )
		return __( 'Missing Attachment' );

	if ( $permalink )
		$url = get_attachment_link( $_post->ID );

	$post_title = esc_attr( $_post->post_title );

	if ( $text )
		$link_text = esc_attr( $text );
	elseif ( $size && 'none' != $size )
		$link_text = wp_get_attachment_image( $id, $size, $icon );
	else
		$link_text = '';

	if ( trim( $link_text ) == '' )
		$link_text = $_post->post_title;

	return apply_filters( 'wp_get_attachment_link', "<a href='$url' title='$post_title'>$link_text</a>", $id, $size, $permalink, $icon, $text );
}

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

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

Продвижение сайта начинается с его полного аудита и последующей комплексной работы над ним. Раскрутка сайтов в Твери отличатся от продвижения в каком либо другом городе, поэтому лучше заказывать раскрутку у компаний специализирующихся на определенном городе.