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