get_permalink() │ WP 1.0.0
Получает постоянную ссылку на запись, для дальнейшего использования в php.
Может быть использована за пределами Цикла WordPress , для этого нужно указывать первый параметр - ID поста, ссылку на который нужно получить.
Получает URL для любого типа записи : post, page и произвольный тип записи .
Заметка: Если не указать параметр ID и использовать эту функция за пределами Цикла WordPress на страницах архивов (категории, архив по дате, архив по авторам и т.д.), функция вернет ссылку на последнюю статью выводимую в Цикле текущей страницы, а не ссылку на текущую страницу.
Заметка: Не выводит ссылку на экран, а возвращает её в переменную.
(очень медленно) | 50000 раз — 1.63 сек (быстро) | PHP 7.4.8, WP 5.6.2
Возвращает
Строку|false. URL поста. false, если поста не существует.
Использование
$url = get_permalink( $post, $leavename );
$post(число/объект)
ID или объект записи (поста), ссылку на который нужно получить.По умолчанию: 0 (ID текущего поста)
$leavename(логический)
Не заменять имя поста в ссылке, т.е. не заменять тег %postname% на имя поста.По умолчанию: false
Примеры
#1 Получим ссылку на текущую запись
Получить ссылку на пост (внутри Цикла WordPress). Так как функция не выводит данные, то нужно использовать php команду echo :
Постоянная ссылка на пост:<br />
<?php echo get_permalink(); ?>
#2 Использование со вторым параметром
Оставляем тег %postname% неизменным, например у нас в ЧПУ стоит структура %post_id%/%postname% , тогда функция сработает так:
<?php echo get_permalink(185, true ); ?>
// выведет: http://example.com/185/%postname%
#3 Получаем ссылки на определенные посты
Выведем список, в котором получим ссылки на страницы с ID 1 и 10.
Информация о блоге:
<ul>
<li><a href="<?php echo get_permalink(1); ?>">О блоге</a></li>
<li><a href="<?php echo get_permalink(10); ?>">Об авторе</a></li>
</ul>
Добавить свой пример
Код get_permalink() get permalink
WP 6.7.1
function get_permalink( $post = 0, $leavename = false ) {
$rewritecode = array(
'%year%',
'%monthnum%',
'%day%',
'%hour%',
'%minute%',
'%second%',
$leavename ? '' : '%postname%',
'%post_id%',
'%category%',
'%author%',
$leavename ? '' : '%pagename%',
);
if ( is_object( $post ) && isset( $post->filter ) && 'sample' === $post->filter ) {
$sample = true;
} else {
$post = get_post( $post );
$sample = false;
}
if ( empty( $post->ID ) ) {
return false;
}
if ( 'page' === $post->post_type ) {
return get_page_link( $post, $leavename, $sample );
} elseif ( 'attachment' === $post->post_type ) {
return get_attachment_link( $post, $leavename );
} elseif ( in_array( $post->post_type, get_post_types( array( '_builtin' => false ) ), true ) ) {
return get_post_permalink( $post, $leavename, $sample );
}
$permalink = get_option( 'permalink_structure' );
/**
* Filters the permalink structure for a post before token replacement occurs.
*
* Only applies to posts with post_type of 'post'.
*
* @since 3.0.0
*
* @param string $permalink The site's permalink structure.
* @param WP_Post $post The post in question.
* @param bool $leavename Whether to keep the post name.
*/
$permalink = apply_filters( 'pre_post_link', $permalink, $post, $leavename );
if (
$permalink &&
! wp_force_plain_post_permalink( $post )
) {
$category = '';
if ( str_contains( $permalink, '%category%' ) ) {
$cats = get_the_category( $post->ID );
if ( $cats ) {
$cats = wp_list_sort(
$cats,
array(
'term_id' => 'ASC',
)
);
/**
* Filters the category that gets used in the %category% permalink token.
*
* @since 3.5.0
*
* @param WP_Term $cat The category to use in the permalink.
* @param array $cats Array of all categories (WP_Term objects) associated with the post.
* @param WP_Post $post The post in question.
*/
$category_object = apply_filters( 'post_link_category', $cats[0], $cats, $post );
$category_object = get_term( $category_object, 'category' );
$category = $category_object->slug;
if ( $category_object->parent ) {
$category = get_category_parents( $category_object->parent, false, '/', true ) . $category;
}
}
/*
* Show default category in permalinks,
* without having to assign it explicitly.
*/
if ( empty( $category ) ) {
$default_category = get_term( get_option( 'default_category' ), 'category' );
if ( $default_category && ! is_wp_error( $default_category ) ) {
$category = $default_category->slug;
}
}
}
$author = '';
if ( str_contains( $permalink, '%author%' ) ) {
$authordata = get_userdata( $post->post_author );
$author = $authordata->user_nicename;
}
/*
* This is not an API call because the permalink is based on the stored post_date value,
* which should be parsed as local time regardless of the default PHP timezone.
*/
$date = explode( ' ', str_replace( array( '-', ':' ), ' ', $post->post_date ) );
$rewritereplace = array(
$date[0],
$date[1],
$date[2],
$date[3],
$date[4],
$date[5],
$post->post_name,
$post->ID,
$category,
$author,
$post->post_name,
);
$permalink = home_url( str_replace( $rewritecode, $rewritereplace, $permalink ) );
$permalink = user_trailingslashit( $permalink, 'single' );
} else { // If they're not using the fancy permalink option.
$permalink = home_url( '?p=' . $post->ID );
}
/**
* Filters the permalink for a post.
*
* Only applies to posts with post_type of 'post'.
*
* @since 1.5.0
*
* @param string $permalink The post's permalink.
* @param WP_Post $post The post in question.
* @param bool $leavename Whether to keep the post name.
*/
return apply_filters( 'post_link', $permalink, $post, $leavename );
}