get_attachment_link

Получает УРЛ прикрепленного к посту медиафайла. Получает УРЛ на страницу файла, а не на сам файл.

Если включено ЧПУ (человеко-понятные УРЛы), то эта функция выведет примерно такую ссылку:
http://site.ru/путь_к_посту/название_поста/название_вложения.

Если ЧПУ отключено, то УРЛ будет такой: http://site.ru/?attachment_id=n, где n — ID вложения.

Чтобы изменить результат функции (изменить УРЛ), можно использовать фильтр attachment_link.

Если нужно получить прямую ссылку на вложение (без связи его с постом, к которому оно прикреплено), то используйте функцию wp_get_attachment_url( $id ). Но имейте ввиду, что wp_get_attachment_url() выводит готовую html ссылку, а не просто УРЛ.

Хуки из функции:
attachment_link

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

<?php $attachment_page = get_attachment_link( $id ); ?>
$id(число)
ID вложения, УРЛ которого нужно получить.
По умолчанию: id текущего вложения

Примеры

#1. Базовый пример.

Так как этот тег получает УРЛ а не выводит ссылку, то для построения ссылки будем использовать echo команду PHP:

<?php
$attachment_id = 1; // ID вложения
$attachment_page = get_attachment_link( $attachment_id );
?>
<a href="<?php echo $attachment_page; ?>"><?php echo get_the_title($attachment_id) ?></a>

Код из


wp-includes/link-template.php

WP 4.7.2

<?php
function get_attachment_link( $post = null, $leavename = false ) {
	global $wp_rewrite;

	$link = false;

	$post = get_post( $post );
	$parent = ( $post->post_parent > 0 && $post->post_parent != $post->ID ) ? get_post( $post->post_parent ) : false;
	if ( $parent && ! in_array( $parent->post_type, get_post_types() ) ) {
		$parent = false;
	}

	if ( $wp_rewrite->using_permalinks() && $parent ) {
		if ( 'page' == $parent->post_type )
			$parentlink = _get_page_link( $post->post_parent ); // Ignores page_on_front
		else
			$parentlink = get_permalink( $post->post_parent );

		if ( is_numeric($post->post_name) || false !== strpos(get_option('permalink_structure'), '%category%') )
			$name = 'attachment/' . $post->post_name; // <permalink>/<int>/ is paged so we use the explicit attachment marker
		else
			$name = $post->post_name;

		if ( strpos($parentlink, '?') === false )
			$link = user_trailingslashit( trailingslashit($parentlink) . '%postname%' );

		if ( ! $leavename )
			$link = str_replace( '%postname%', $name, $link );
	} elseif ( $wp_rewrite->using_permalinks() && ! $leavename ) {
		$link = home_url( user_trailingslashit( $post->post_name ) );
	}

	if ( ! $link )
		$link = home_url( '/?attachment_id=' . $post->ID );

	/**
	 * Filters the permalink for an attachment.
	 *
	 * @since 2.0.0
	 *
	 * @param string $link    The attachment's permalink.
	 * @param int    $post_id Attachment ID.
	 */
	return apply_filters( 'attachment_link', $link, $post->ID );
}

Комментарии:


Оставить комментарий

Your email address will not be published. Required fields are marked *