get_attachment_link() WP 2.0.0

Отримує УРЛ сторінки медіафайлу на сайті (фронті).

Якщо включено ЧПУ (людино-зрозумілі УРЛи), то функція виведе таке посилання:

http://example.com/ярлик_поста/назва_вкладення

Якщо ЧПУ відключено, то УРЛ буде таким (ID – це ID вкладення):

http://example.com/?attachment_id=ID

Використовуйте wp_get_attachment_url( $id ) , коли потрібно отримати URL-адресу на сам файл.

Основа для:
get_permalink()

Хуки з функції
$attachment_page = get_attachment_link($id);
$id
(число)
ID вкладення, УРЛ якого потрібно отримати.


За замовчуванням: id поточного додавання

Приклади

0

#1 Отримаємо посилання на вкладення

// файл не прикріплений до посту
echo get_attachment_link(104); //> http://example.com/screenshot_4-3

// файл прикріплений до посту
echo get_attachment_link(105); //> http://example.com/conditional-fields/vkladka-s-nastrojkoj
0

#2 Виведемо посилання на вкладення

Так як функція отримує УРЛ, а не виводить посилання, то для побудови посилання будемо використовувати echo команду PHP:

<?php
$attachment_id = 1; // ID вкладення
$ attachment_link = get_attachment_link ($ attachment_id);
?>
<a href="<?php echo $attachment_page; ?>"><?php echo get_the_title($attachment_id) ?></a>

нотатки

  • Global. WP_Rewrite. $wp_rewrite WordPress rewrite component.

список змін

З версії 2.0.0Введено.

Код get_attachment_link() WP 6.0.2

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

	$link = false;

	$post = get_post($post);
	$force_plain_link = wp_force_plain_post_permalink( $post );
	$parent_id = $post->post_parent;
	$parent = $parent_id? get_post($parent_id): false;
	$parent_valid = true; // Default for no parent.
	if (
		$parent_id &&
		(
			$post->post_parent === $post->ID ||
			! $parent ||
			! is_post_type_viewable( get_post_type( $parent ) )
		)
	) {
		// Post is either its own parent або parent post unavailable.
		$parent_valid = false;
	}

	if ($force_plain_link ||! $parent_valid) {
		$link = false;
	} elseif ( $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
	 * @since 5.6.0 Використовуючи empty string will now disable
	 * view attachment page link on the media modal.
	 *
	 * @param string $link The attachment's permalink.
	 * @param int $post_id Attachment ID.
	 */
	return apply_filters( 'attachment_link', $link, $post->ID );
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *