the_permalink()
Виводить УРЛ посту.
Зазвичай використовується всередині Цикл WordPress , проте якщо вказати параметр $post (для якого посту потрібно отримати посилання), то можна використовувати за межами циклу.
Працює на основі:
get_permalink()
get_permalink()
1 раз – 0.002275 сек
(дуже повільно) | 50000 разів – 5.62 сек
(швидко) |
PHP 7.1.2, WP 4.7.3
(дуже повільно) | 50000 разів – 5.62 сек
(швидко) |
PHP 7.1.2, WP 4.7.3
Хуки з функції
Повертає
null.
Використання
<?php the_permalink( $post ); ?>
-
$post
(число/об’єкт) -
ID або об’єкт запису (поста), посилання на який потрібно отримати. З WP версії 4.4.
За замовчуванням: ID поточного поста в циклі
Приклади
#1 Виведемо посилання на пост у вигляді простого тексту, а не html посилання
Адреса цієї посади: <?php the_permalink(); ?>
#2 Виведемо html посилання на поточну посаду
Текст посилання буде: “постійне посилання”:
<a href="<?php the_permalink(); ?>">постійне посилання</a>
#3 Виведемо посилання на поточну посаду
Текст посилання буде заголовок посту.
Це стандартний спосіб виведення посилання на пост усередині Цикл:
<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><?php the_title(); ?></a>
список змін
| З версії 1.2.0 | Введено. |
| З версії 4.4.0 | Added $post parameter. |
Код the_permalink() the permalink WP 6.0.2
function the_permalink( $post = 0 ) {
/**
* Filters display of permalink for current post.
*
* @ Since 1.5.0
* @since 4.4.0 Added `$post` parameter.
*
* @param string $permalink The permalink для поточного повідомлення.
* @param int|WP_Post $post Post ID, WP_Post об'єкт, або 0. Default 0.
*/
echo esc_url( apply_filters( 'the_permalink', get_permalink( $post ), $post ) );
}