Получение времени последнего изменения поста в WordPress: функция get_lastpostmodified()

# Получение времени последнего изменения поста в WordPress

## Что такое get_lastpostmodified()

Функция get_lastpostmodified() в WordPress позволяет узнать дату и время последнего изменения любого поста на вашем сайте. Она возвращает отметку времени (timestamp), которая может быть использована для различных нужд, таких как отображение последнего обновления поста.

### Как работает функция

Функция работает с учетом часового пояса вашего сервера. Это значит, что вы сможете получать время изменения поста в разных форматах: по серверному времени, по времени блога или в формате GMT.

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

Функция возвращает строку с датой и временем в формате Y-m-d H:i:s. Если произошла ошибка, будет возвращено false.

## Синтаксис использования

Вот как выглядит синтаксис функции:

```php
get_lastpostmodified( $timezone, $post_type );

• $timezone (строка) — часовой пояс, используемый для отметки времени.
  • Примеры значений: 'server', 'blog', 'gmt' (по умолчанию используется 'server').
• $post_type (строка) — тип поста, для которого нужно получить информацию. По умолчанию используется 'any'.

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

Вот несколько примеров, как можно использовать функцию get_lastpostmodified():

// Получаем дату последнего изменения поста в серверном времени
echo get_lastpostmodified( 'server', 'any' ); 
// вывод: 2016-04-05 17:56:29.000000

// Получаем дату последнего изменения записей типа 'post'
echo get_lastpostmodified( 'blog', 'post' ); 
// вывод: 2016-03-05 01:46:44

// Получаем дату последнего изменения в GMT
echo get_lastpostmodified( 'gmt', 'post' ); 
// вывод: 2016-03-04 20:46:44

Обработка данных

Перед тем как функция вернет значение, оно обрабатывается специальным фильтром. Это позволяет другим разработчикам изменять значение, если это необходимо.

Код функции

Вот как выглядит код функции get_lastpostmodified():

function get_lastpostmodified( $timezone = 'server', $post_type = 'any' ) {
$lastpostmodified = apply_filters( 'pre_get_lastpostmodified', false, $timezone, $post_type );

if ( false !== $lastpostmodified ) {
    return $lastpostmodified;
}

$lastpostmodified = _get_last_post_time( $timezone, 'modified', $post_type );
$lastpostdate     = get_lastpostdate( $timezone, $post_type );

if ( $lastpostdate > $lastpostmodified ) {
    $lastpostmodified = $lastpostdate;
}

return apply_filters( 'get_lastpostmodified', $lastpostmodified, $timezone, $post_type );

}

Изменения в функции

Функция get_lastpostmodified() была добавлена в версию 1.2.0, а в версии 4.4.0 был добавлен аргумент $post_type.

Заключение

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