the_permalink() — выводит постоянную ссылку на текущий пост

  1.2.0     wp-includes / link-template.php  /  Кодекс WordPress

Раньше эта функция работала только внутри цикла WordPress и выводился ссылку на текущий пост в цикле, теперь же вы можете передать в качестве параметра ID или объект определённого поста, URL которого нужно вывести.

  • Работает на основе get_permalink(),
  • очищает результат перед выводом при помощи esc_url().
the_permalink( $post = 0 )

Параметры

$post
(целое число|объект WP_Post) ID или объект поста, ссылку на который нужно получить, по умолчанию — текущий пост в цикле. Параметр появился в WordPress 4.4.0

Примеры

<a href="<?php the_permalink() ?>">читать далее</a>

Фильтр срабатывает непосредственно перед очисткой функцией esc_url().

add_filter( 'the_permalink', 'true_change_permalink', 25, 2 );
 
function true_change_permalink( $permalink, $post ) {
 
	// например никогда не выводим ссылку на пост с ID = 5
	if( 5 == $post->ID ) {
		$permalink = '#';
	}
	return $permalink;
 
}
Кодекс WordPress: Цикл: get_children(), get_delete_post_link(), get_edit_post_link(), get_extended(), get_next_posts_link(), get_permalink(), get_post(), get_post_class(), get_post_type(), get_posts(), get_previous_posts_link(), get_queried_object_id(), get_query_var(), get_search_query(), get_the_author(), get_the_content(), get_the_date(), get_the_excerpt(), get_the_ID(), get_the_time(), get_the_title(), has_excerpt(), has_post_thumbnail(), have_posts(), next_posts_link(), paginate_links(), post_class(), previous_posts_link(), query_posts(), setup_postdata(), the_author(), the_content(), the_date(), the_excerpt(), the_ID(), the_permalink(), the_post(), the_search_query(), the_time(), the_title(), the_title_attribute(), wp(), WP_Query, wp_reset_postdata(), wp_reset_query()

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школах Epic Skills и LoftSchool.

Если вам нужна помощь с сайтом или разработка с нуля на WordPress / WooCommerce — пишите. Я и моя команда будем рады вам помочь!

Комментарии — 9

Комментирование этого поста более не доступно.