Функция the_permalink() в WordPress: использование, параметры и примеры

# THE_PERMALINK() │ WP 1.2.0

Функция the_permalink() выводит ссылку (URL) на пост, который сейчас обрабатывается в цикле WordPress.

Эта функция может использоваться только внутри цикла WordPress. Цикл — это механизм, который обрабатывает и выводит посты на странице.

### Время выполнения

- 1 раз — 0.002275 сек (очень медленно)
- 50000 раз — 5.62 сек (быстро)

### Хуки функции

- the_permalink

### Возвращаемое значение

- null (ничего).

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

```php
the_permalink( $post );

Параметры

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

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

Пример 1: Вывод ссылки на пост в виде простого т��кста

Чтобы вывести адрес текущего поста, используйте следующий код:

Пример 2: Вывод HTML-ссылки на текущий пост

Ссылка будет выглядеть так:

постоянная ссылка

Пример 3: Вывод ссылки на текущий пост с заголовком

Чтобы вывести ссылку с заголовком поста, воспользуйтесь этим кодом:

Изменения

• С версии 1.2.0 — введена функция.
• С версии 4.4.0 — добавлен параметр $post.

Код функции the_permalink

Функция находится в файле wp-includes/link-template.php:

function the_permalink( $post = 0 ) {
    /**
     * Фильтрует отображение постоянной ссылки для текущего поста.
     *
     * @since 1.5.0
     * @since 4.4.0 Добавлен параметр $post.
     *
     * @param string      $permalink Постоянная ссылка для текущего поста.
     * @param int|WP_Post $post      ID поста, объект WP_Post или 0. По умолчанию 0.
     */
    echo esc_url( apply_filters( 'the_permalink', get_permalink( $post ), $post ) );
}

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

• Постоянные ссылки (чистые дружелюбные URL)
• edit_bookmark_link()
• edit_comment_link()
• get_attachment_link()
• get_pagenum_link()
• get_permalink()
• get_sample_permalink()
• get_tag_link()
• get_term_link()
• get_the_permalink()
• wp_get_shortlink()

Цикл WordPress

Некоторые функции, используемые в цикле:

• get_the_author()
• get_the_content()
• the_excerpt()
• the_date()
• the_title()

Посты, страницы и т.д.

Связанные функции для работы с постами и страницами:

• edit_post_link()
• get_delete_post_link()
• get_post_time()
• get_the_date()
• the_title()

Ссылки (URL)

Некоторые полезные функции для работы с URL:

• admin_url()
• get_home_url()
• site_url()