Функция the_permalink() в WordPress: Получение и вывод URL поста

В этой статье мы рассмотрим функцию the_permalink() в WordPress, которая используется для получения и вывода URL текущего поста или страницы. Эта функция часто используется для создания ссылок на посты и страницы в шаблонах.

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

Функция the_permalink() в WordPress выводит URL текущего поста или страницы. Она обычно используется внутри цикла WordPress для создания ссылок на посты и страницы.

the_permalink( $post )

Параметры:

• $post (WP_Post|int|null) (необязательный): Объект поста или ID поста, для которого нужно получить URL. Если не указан, используется текущий пост.

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

• Функция выводит URL текущего поста или страницы.

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

Рассмотрим несколько примеров использования функции the_permalink().

Пример 1: Создание ссылки на текущий пост

if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        echo '<a href="' . the_permalink() . '">' . the_title() . '</a>';
    }
}

В этом примере the_permalink() используется для создания ссылки на текущий пост. Заголовок поста (the_title()) выводится внутри ссылки.

Пример 2: Создание ссылки на определенный пост по ID

$post_id = 42; // ID поста
echo '<a href="' . the_permalink( $post_id ) . '">Ссылка на пост</a>';

Здесь the_permalink() используется для получения URL определенного поста по его ID.

Пример 3: Использование the_permalink() с изображением

if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        echo '<a href="' . the_permalink() . '">';
        the_post_thumbnail('thumbnail');
        echo '</a>';
    }
}

Здесь the_permalink() используется для создания ссылки на пост, в которую завернуто изображение поста (the_post_thumbnail()).

Пример 4: Вывод URL поста в комментарии

if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        echo '<p>Прочитать полный пост можно по <a href="' . the_permalink() . '">этой ссылке</a>.</p>';
    }
}

В этом примере the_permalink() используется для создания ссылки на полный пост в тексте комментария.

Пример 5: Использование в шаблоне с кнопкой

if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        echo '<h2>' . the_title() . '</h2>';
        echo '<p><a href="' . the_permalink() . '" class="button">Читать далее</a></p>';
    }
}

Здесь the_permalink() используется для создания кнопки «Читать далее», которая ведет на полный пост.

Пример 6: Получение URL поста без вывода

if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        $url = get_permalink();
        echo '<a href="' . $url . '">' . the_title() . '</a>';
    }
}

В этом примере вместо the_permalink() используется функция get_permalink(), которая возвращает URL текущего поста без его вывода. Это может быть полезно, если необходимо выполнить дополнительную обработку URL перед выводом.

Заключение по the_permalink

Функция the_permalink() в WordPress является ключевым инструментом для получения и вывода URL текущего поста или страницы. Её использование упрощает создание ссылок и улучшает навигацию на сайте.