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

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

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

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

the_date( $format, $before, $after, $echo )

Параметры:

• $format (строка, необязательный): Формат даты. По умолчанию формат даты зависит от настроек WordPress.

• $before (строка, необязательный): Текст, который будет выведен перед датой.
• $after (строка, необязательный): Текст, который будет выведен после даты.
• $echo (булево, необязательный): Выводить дату или вернуть её. Значение по умолчанию — true (выводить).

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

• Если $echo равно true, функция выводит дату публикации. Если $echo равно false, функция возвращает дату как строку.

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

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

Пример 1: Вывод даты публикации поста

if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        echo '<h2>' . get_the_title() . '</h2>';
        the_date();
        the_content();
    }
}

В этом примере the_date() используется для вывода даты публикации каждого поста. Заголовок поста выводится с помощью функции get_the_title(), а содержимое — с помощью the_content().

Пример 2: Вывод даты с кастомным форматом

if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        echo '<h2>' . get_the_title() . '</h2>';
        the_date('F j, Y');
        the_content();
    }
}

Здесь the_date() используется с параметром 'F j, Y', который задаёт формат даты (например, «January 1, 2024»).

Пример 3: Добавление текста до и после даты

if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        echo '<h2>' . get_the_title() . '</h2>';
        the_date('', '<p>Опубликовано: ', '</p>');
        the_content();
    }
}

В этом примере параметры '<p>Опубликовано: ' и '</p>' добавляют текст до и после даты публикации.

Пример 4: Получение даты без вывода

if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        echo '<h2>' . get_the_title() . '</h2>';
        $date = the_date('F j, Y', '', '', false);
        echo '<p>Дата публикации: ' . $date . '</p>';
        the_content();
    }
}

Здесь параметр false используется для получения даты в переменную $date без её вывода. Затем дата выводится с дополнительным текстом.

Пример 5: Использование the_date() в заголовке

if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        echo '<h2>' . get_the_title() . ' - ' . get_the_date() . '</h2>';
        the_content();
    }
}

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

Пример 6: Фильтр the_date

add_filter( 'the_date', 'add_time_tag', 25, 4 );
function add_time_tag( $the_date, $format, $before, $after ) {
    return '<time>' . $the_date . '</time>';
}

В этом примере используется фильтр для добавления тэга time там где выводиться дата.

Заключение

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