the_permalink()WP 1.2.0

Выводит УРЛ поста.

Обычно используется внутри Цикла WordPress, однако если указать параметр $post (для какого поста нужно получить ссылку), то можно использовать за пределами цикла.

Работает на основе: get_permalink()
1 раз — 0.002275 сек (очень медленно) | 50000 раз — 5.62 сек (быстро) | PHP 7.1.2, WP 4.7.3
Хуки из функции

Возвращает

null.

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

<?php the_permalink( $post ); ?>
$post(число/объект)
ID или объект записи (поста), ссылку на который нужно получить. С версии WP 4.4.
По умолчанию: ID текущего поста в цикле

Примеры

0

#1 Выведем ссылку на пост в виде простого текста, а не html ссылки

Адрес этого поста: <?php the_permalink(); ?>
0

#2 Выведем html ссылку на текущий пост

Текстом ссылки будет: "постоянная ссылка":

<a href="<?php the_permalink(); ?>">постоянная ссылка</a>
0

#3 Выведем ссылку на текущий пост

Текстом ссылки будет заголовок поста.

Это стандартный способ вывода ссылки на пост внутри Цикла:

<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><?php the_title(); ?></a>

Список изменений

С версии 1.2.0 Введена.
С версии 4.4.0 Added the $post parameter.

Код the_permalink() WP 6.4.3

function the_permalink( $post = 0 ) {
	/**
	 * Filters the display of the permalink for the current post.
	 *
	 * @since 1.5.0
	 * @since 4.4.0 Added the `$post` parameter.
	 *
	 * @param string      $permalink The permalink for the current post.
	 * @param int|WP_Post $post      Post ID, WP_Post object, or 0. Default 0.
	 */
	echo esc_url( apply_filters( 'the_permalink', get_permalink( $post ), $post ) );
}