get_the_permalink()

Извлекает полный постоянный адрес (пермалинк) для текущей записи или ID записи
Функция WordPress
INT 3.9.0
WordPress Icon
Содержание
  1. Описание функции
  2. Примеры использования
  3. Получение полной ссылки на текущий пост или пост по ID
  4. Изменение параметра ‘leavename’ для сохранения имени поста или страницы
  5. Получение ссылки на пост по ID
  6. Получение ссылки на текущий пост
  7. Получение ссылки на пост с сохранением имени
  8. Получение ссылки на страницу с сохранением имени
  9. Вопросы и ответы
  10. Как получить полный постоянный адрес для текущего поста или ID поста?
  11. Как использовать функцию get_the_permalink() для получения постоянного адреса?
  12. Как изменить постоянный адрес, возвращаемый функцией get_the_permalink()?
  13. Как получить постоянный адрес для определенного поста, отличного от текущего?
  14. Как использовать функцию get_the_permalink() для получения постоянного адреса страницы?
  15. Как получить постоянный адрес без имени поста или страницы?
  16. Как использовать функцию get_the_permalink() для получения постоянного адреса в пользовательском шаблоне?
  17. Связанные элементы

Описание функции

Функция get_the_permalink() возвращает полную постоянную ссылку для текущего поста или поста с указанным идентификатором.

Функция используется для получения ссылки на пост, которая может быть использована для вывода ссылки на пост или для сохранения в переменной для дальнейшего использования.

Использование

get_the_permalink( int|WP_Post $post, bool $leavename = false ): string|false

Функция get_the_permalink() принимает два параметра:

  • $post (int|WP_Post) (необязательный) — Идентификатор поста или объект поста. По умолчанию используется глобальная переменная $post.
  • $leavename (bool) (необязательный) — Определяет, нужно ли сохранять имя поста или страницы в ссылке. По умолчанию: false.

Функция возвращает строку с постоянной ссылкой на пост. Если пост не существует, возвращается false.


/**
 * Пример использования функции get_the_permalink()
 */
$post_id = 123; // Идентификатор поста
// Получаем пост по его идентификатору
$post = get_post( $post_id );
// Проверяем, существует ли пост
if ( $post ) {
  // Получаем постоянную ссылку на пост
  $permalink = get_the_permalink( $post );
  
  // Выводим ссылку на пост
  echo 'Ссылка на пост: <a href="' . esc_url( $permalink ) . '">' . esc_html( $permalink ) . '</a>';
} else {
  echo 'Пост не существует.';
}

Примеры использования

Получение полной ссылки на текущий пост или пост по ID


$post_id = 123; // ID поста
$permalink = get_the_permalink($post_id);
echo $permalink;

В данном примере мы используем функцию get_the_permalink() для получения полной ссылки на пост с ID 123. Результат будет выведен с помощью функции echo.

Изменение параметра ‘leavename’ для сохранения имени поста или страницы


$post_id = 123; // ID поста
$leavename = true; // сохранить имя поста или страницы
$permalink = get_the_permalink($post_id, $leavename);
echo $permalink;

В данном примере мы используем функцию get_the_permalink() с параметром $leavename равным true, чтобы сохранить имя поста или страницы в ссылке. Результат будет выведен с помощью функции echo.

Получение ссылки на пост по ID


$post_id = 123; // ID поста
$permalink = get_the_permalink($post_id);
echo $permalink;

В данном примере мы используем функцию get_the_permalink() для получения ссылки на пост с ID 123. Результат будет выведен с помощью функции echo.

Получение ссылки на текущий пост


$permalink = get_the_permalink();
echo $permalink;

В данном примере мы используем функцию get_the_permalink() без параметров, чтобы получить ссылку на текущий пост. Результат будет выведен с помощью функции echo.

Получение ссылки на пост с сохранением имени


$post_id = 123; // ID поста
$leavename = true; // сохранить имя поста
$permalink = get_the_permalink($post_id, $leavename);
echo $permalink;

В данном примере мы используем функцию get_the_permalink() с параметром $leavename равным true, чтобы сохранить имя поста в ссылке. Результат будет выведен с помощью функции echo.

Получение ссылки на страницу с сохранением имени


$page_id = 123; // ID страницы
$leavename = true; // сохранить имя страницы
$permalink = get_the_permalink($page_id, $leavename);
echo $permalink;

В данном примере мы используем функцию get_the_permalink() с параметром $leavename равным true, чтобы сохранить имя страницы в ссылке. Результат будет выведен с помощью функции echo.

Вопросы и ответы

Как получить полный постоянный адрес для текущего поста или ID поста?

Функция get_the_permalink() используется для получения полного постоянного адреса (permalink) для текущего поста или ID поста. Она возвращает строку с URL-адресом permalink или false, если пост не существует.

Для получения постоянного адреса с помощью функции get_the_permalink() необходимо передать параметр $post, который может быть ID поста или объектом WP_Post. Если параметр не указан, будет использован глобальный объект $post.

Пример использования функции get_the_permalink() для получения постоянного адреса:


$post_id = 123;
$permalink = get_the_permalink($post_id);
echo $permalink;

Как изменить постоянный адрес, возвращаемый функцией get_the_permalink()?

По умолчанию, функция get_the_permalink() возвращает полный постоянный адрес без изменений. С помощью параметра $leavename можно изменить это поведение.

Если параметр $leavename установлен в true, функция get_the_permalink() сохранит имя поста или страницы в постоянном адресе. По умолчанию, этот параметр установлен в false.

Пример использования функции get_the_permalink() с параметром $leavename:


$post_id = 123;
$permalink = get_the_permalink($post_id, true);
echo $permalink;

Как получить постоянный адрес для определенного поста, отличного от текущего?

Для получения постоянного адреса для определенного поста, отличного от текущего, можно использовать функцию get_the_permalink(). Эта функция принимает два параметра: $post (ID или объект поста) и $leavename (флаг, указывающий, нужно ли сохранять имя поста или страницы).


$post_id = 123; // ID поста
$permalink = get_the_permalink($post_id);

Для получения постоянного адреса страницы можно использовать функцию get_the_permalink() без указания параметров. Функция автоматически получит пост текущей страницы.


$permalink = get_the_permalink();

Как получить постоянный адрес без имени поста или страницы?

Для получения постоянного адреса без имени поста или страницы можно использовать функцию get_the_permalink() с параметром $leavename установленным в true.


$permalink = get_the_permalink(null, true);

Для получения постоянного адреса в пользовательском шаблоне можно использовать функцию get_the_permalink() с указанием ID или объекта поста в качестве параметра.


$post = get_post(123); // Получение объекта поста по ID
$permalink = get_the_permalink($post);

Функция get_the_permalink() возвращает постоянный адрес для текущего поста или поста с указанным ID. Она может быть использована для получения постоянного адреса страницы, а также для получения адреса без имени поста или страницы. Функция полезна при разработке пользовательских шаблонов и позволяет получить постоянный адрес с помощью минимального кода.

Связанные элементы

  • Функция get_permalink(): возвращает URL-адрес постоянной ссылки для указанного поста или идентификатора поста.
  • Функция get_post_permalink(): возвращает URL-адрес постоянной ссылки для указанного поста или объекта поста.
  • Функция the_permalink(): выводит URL-адрес постоянной ссылки для текущего поста или идентификатора поста.
  • Функция get_page_link(): возвращает URL-адрес постоянной ссылки для указанной страницы или идентификатора страницы.
  • Функция get_attachment_link(): возвращает URL-адрес постоянной ссылки для указанного вложения или идентификатора вложения.
  • Функция get_term_link(): возвращает URL-адрес постоянной ссылки для указанного термина или идентификатора термина.
  • Функция get_author_posts_url(): возвращает URL-адрес постоянной ссылки на страницу автора для указанного автора или идентификатора автора.
  • Функция get_category_link(): возвращает URL-адрес постоянной ссылки на страницу категории для указанной категории или идентификатора категории.
  • Функция get_tag_link(): возвращает URL-адрес постоянной ссылки на страницу метки для указанной метки или идентификатора метки.
  • Хук post_link: позволяет изменить URL-адрес постоянной ссылки перед его выводом.
Обсуждение