Функция the_modified_date() предназначена для отображения даты, когда пост был последний раз изменен. Она работает аналогично функции the_modified_time(), которая выводит дату и время последнего изменения поста. Оба метода основываются на функции get_the_modified_date().
<?php the_modified_date( string $format = '', string $before = '', string $after = '', bool $echo = true ); ?>
Параметры:
- $format (string, необязательный) — Формат даты, который будет отображен. Используется форматирование, поддерживаемое PHP (например,
'F j, Y'дляJuly 20, 2024). По умолчанию используется формат даты, установленный в настройках WordPress. - $before (string, необязательный) — Текст, который будет показан перед датой. По умолчанию пустой.
- $after (string, необязательный) — Текст, который будет показан после даты. По умолчанию пустой.
- $echo (bool, необязательный) — Если
true, функция выводит дату на экран; еслиfalse, возвращает дату как строку. По умолчаниюtrue.
Пример 1: Вывод даты последнего изменения поста
Чтобы вывести дату последнего изменения поста в стандартном формате, используйте следующий код:
<p>Пост был изменен: <?php the_modified_date(); ?></p>Этот код отобразит дату последнего изменения поста в формате, установленном в настройках WordPress.
Пример 2: Указание собственного формата даты
Если вы хотите указать собственный формат даты, например, Формат: Месяц День, Год, используйте следующий код:
<div>Пост был изменен: <?php the_modified_date('F j, Y'); ?></div>Этот пример выведет дату последнего изменения поста в формате July 20, 2024.
Пример 3: Вывод даты и времени последнего изменения поста
Для отображения даты и времени последнего изменения поста используйте:
<p>Изменен: <?php the_modified_date('F j, Y в G:i'); ?></p>Этот код покажет дату и время последнего изменения в формате February 7, 2023 в 14:42.
Пример 4: Вставка HTML-тегов в формат даты
Чтобы вставить HTML-теги в формат даты, экранируйте их с помощью обратного слэша:
<p>Изменен: <?php the_modified_date('j<\s\p\a\np>M</\s\p\a\n> Y'); ?></p>Этот код отобразит дату в формате 25<span>дек</span> 2024.
Важные замечания
- Функция
the_modified_date()должна использоваться внутри цикла WordPress, чтобы корректно отображать данные о посте. - Если пост еще не был изменен после публикации, функция отобразит дату публикации поста.
Заключение
Функция the_modified_date() является мощным инструментом для отображения актуальности контента на вашем сайте. Она предоставляет гибкость в отображении даты последнего изменения, что помогает улучшить прозрачность и актуальность информации для ваших пользователей.