В этой статье мы рассмотрим функцию 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 текущего поста или страницы. Её использование упрощает создание ссылок и улучшает навигацию на сайте.