Получение постоянной ссылки с помощью get_the_permalink()

# Получение постоянной ссылки (GET_THE_PERMALINK)

Функция get_the_permalink() получает URL (постоянную ссылку) поста, который в данный момент обрабатывается в цикле. Это шаблонная функция.

Функция get_the_permalink() является копией функции get_permalink().

## Использование функции

- Время выполнения: 
  - 1 раз — 0.002494 секунды (очень медленно)
  - 50000 раз — 7.14 секунды (быстро)
- PHP: 7.1.11, WP: 4.9.8

## Хуки

Функция не имеет хуков.

## Возврат значения

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

## Применение

```php
get_the_permalink( $post, $leavename );

Параметры

• $post (int/WP_Post): ID поста или объект поста, ссылку на который мы хотим получить. По умолчанию используется глобальный объект $post.

• $leavename (true/false): Если истинно (true), имя поста в ссылке не будет заменено, т.е. тег %postname% не будет заменён на имя поста. По умолчанию — false.

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

Пример 1: Получение ссылки на текущий пост в цикле

Читать далее...

Пример 2: Получить ссылку на конкретный пост

$url = get_the_permalink( 23 ); // http://site.com/post-name/

Пример 3: Второй параметр: $LEAVENAME

Результат зависит от структуры постоянной ссылки. Если структура следующая: %post_id%/%postname%.html, тогда:

$url = get_the_permalink( 23 );
echo get_the_permalink( 1, true );
// вывод: http://domain.com/1/%postname%.html

Примечания

• Для дополнительной информации см. get_permalink().

Изменения

Функция была введена с версии 3.9.0.

Код функции

Функция определена в файле wp-includes/link-template.php.

function get_the_permalink( $post = 0, $leavename = false ) {
    return get_permalink( $post, $leavename );
}

Связанные функции

• Функции, использующие постоянные ссылки:

  • edit_bookmark_link()
  • edit_comment_link()
  • get_attachment_link()
  • get_pagenum_link()
  • get_permalink()
  • get_sample_permalink()
  • get_tag_link()
  • get_term_link()
  • the_permalink()
  • wp_get_shortlink()

• Функции, связанные с постами и страницами:

  • edit_post_link()
  • get_delete_post_link()
  • get_edit_post_link()
  • get_post_field()
  • get_post_status()
  • get_post_time()
  • get_the_content()
  • get_the_date()
  • get_the_excerpt()
  • get_the_ID()
  • get_the_modified_date()
  • get_the_modified_time()
  • get_the_time()
  • get_the_title()
  • get_the_title_rss()
  • has_excerpt()
  • post_password_required()
  • register_post_status()
  • single_post_title()
  • the_author()
  • the_content()
  • the_date()
  • the_excerpt()
  • the_excerpt_rss()
  • the_ID()
  • the_modified_date()
  • the_time()
  • the_title()
  • the_title_attribute()