Хук post_updated_messages в WordPress позволяет изменять сообщения, отображаемые после обновления или добавления записи. Этот хук дает возможность разработчикам дополнить стандартные сообщения или полностью их заменить.
apply_filters( ‘post_updated_messages’, array[] $messages )Параметры
- $messages (array): Массив сообщений об обновлении постов, разделенный на подмассивы для разных типов контента, таких как ‘post’, ‘page’ и ‘attachment’.
Пример структуры массива $messages для постов:
$messages['post'] = array(
0 => '', // Не используется, сообщения начинаются с индекса 1.
1 => __( 'Post updated.' ) . $view_post_link_html,
2 => __( 'Custom field updated.' ),
3 => __( 'Custom field deleted.' ),
4 => __( 'Post updated.' ),
5 => isset( $_GET['revision'] ) ? sprintf( __( 'Post restored to revision from %s.' ), wp_post_revision_title( (int) $_GET['revision'], false ) ) : false,
6 => __( 'Post published.' ) . $view_post_link_html,
7 => __( 'Post saved.' ),
8 => __( 'Post submitted.' ) . $preview_post_link_html,
9 => sprintf( __( 'Post scheduled for: %s.' ), '<strong>' . $scheduled_date . '</strong>' ) . $scheduled_post_link_html,
10 => __( 'Post draft updated.' ) . $preview_post_link_html,
);
Использование
Для изменения сообщений, отображаемых при обновлении постов, вы можете использовать следующий код:
add_filter( 'post_updated_messages', 'custom_post_updated_messages' );
function custom_post_updated_messages( $messages ) {
// Изменяем сообщения здесь
return $messages;
}
Пример 1: Дополнение сообщения при публикации поста
Данный код добавляет дополнительное сообщение к стандартному тексту, который отображается при публикации записи:
add_filter('post_updated_messages', function($messages) {
$messages['post'][6] .= ' Дополнительное сообщение.';
return $messages;
});
В этом примере к сообщению «Запись опубликована» добавляется текст «Дополнительное сообщение.»
Пример 2: Изменение сообщения о восстановлении записи
Вы можете изменить сообщение, отображаемое при восстановлении записи из ревизии:
add_filter('post_updated_messages', function($messages) {
if ( isset($_GET['revision']) ) {
$messages['post'][5] = sprintf(__('Запись восстановлена из ревизии от %s.'), wp_post_revision_title((int) $_GET['revision'], false));
}
return $messages;
});
Этот код меняет сообщение о восстановлении поста, добавляя информацию о дате и времени ревизии.
Пример 3: Кастомизация сообщений для страниц
Также вы можете настраивать сообщения для других типов контента, таких как страницы:
add_filter('post_updated_messages', function($messages) {
$messages['page'][6] = 'Страница успешно опубликована! Не забудьте проверить её.';
return $messages;
});
В этом примере сообщение о публикации страницы изменяется на более персонализированное.
Заключение
Хук post_updated_messages — это мощный инструмент для разработчиков WordPress, позволяющий настраивать сообщения, отображаемые после обновления или добавления контента. С его помощью можно улучшить взаимодействие пользователей с администраторской панелью, добавляя необходимую информацию и делая сообщения более информативными.