get_the_permalink()
Отримує, а не виводить на екран, УРЛ записи, що обробляється в даний момент (у циклі). Шаблон тег.
Потрібно використовувати всередині циклу WordPress .
get_the_permalink() – копія функції get_permalink() .
Працює на основі:
get_permalink()
get_permalink()
1 раз – 0.002494 сек
(дуже повільно) | 50000 разів – 7.14 сек
(швидко) |
PHP 7.1.11, WP 4.9.8
(дуже повільно) | 50000 разів – 7.14 сек
(швидко) |
PHP 7.1.11, WP 4.9.8
Хуків немає.
Повертає
Строку|false
. Рядок, посилання на запис або false, якщо посилання отримати не вдалося.
Використання
$link = get_the_permalink ($ id, $ leavename);
-
$id
(число/об’єкт) -
ID або об’єкт запису, посилання на яке потрібно отримати.
За замовчуванням $post -
$leavename
(об’єкт/логічний) -
Залишати чи ні ім’я запису (склад). Якщо вказати true то конструкція
%postname%
буде замінено на ім’я поста, тобто. поверне приблизно це:
http://wp-kama.ru/%postname%
За замовчуванням: false
Приклади
#1 Приклад використання
Отримаємо посилання на поточний пост у циклі:
<a href="<?php echo get_the_permalink(); ?>">Читати далі...</a>
#2 Отримаємо посилання певного запису
$url = get_the_permalink(23); // поверне: http://example.com/post-name/
#3 Другий параметр: $leavename
Результат залежить від структури ЧПК. Припустимо, що у нас така структура: %post_id%/%postname%.html
, тоді:
$url = get_the_permalink(23); echo get_the_permalink(1, true); // Виведе: http://wp-kama.ru/1/%postname%.html
нотатки
- Дивіться: get_permalink()
список змін
З версії 3.9.0 | Введено. |
Код get_the_permalink() get the permalink WP 6.0.2
function get_the_permalink( $post = 0, $leavename = false ) { return get_permalink($post, $leavename); }