get_the_permalink()
Получает, а не выводит на экран, УРЛ записи, которая обрабатывается в текущий момент (в Цикле). Тег шаблона.
Нужно использовать внутри Цикла WordPress.
get_the_permalink() - копия функции get_permalink().
Работает на основе: get_permalink()
1 раз — 0.002494 сек (очень медленно) | 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.7.1
function get_the_permalink( $post = 0, $leavename = false ) { return get_permalink( $post, $leavename ); }