WP_ADMIN_NOTICE() │ WP 6.4.0 – Использование функции wp_admin_notice() в WordPress

# WP_ADMIN_NOTICE() │ WP 6.4.0

Функция wp_admin_notice() выводит уведомление для администраторов сайта в панели управления WordPress.

## Производительность

- Если вы вызываете функцию 1 раз, то это займет около 0.0004721 секунды.
- При вызове 50,000 раз время составит около 1.71 секунды.

## Хуки

Функция использует хук:
- wp_admin_notice

## Возврат

Функция ничего не возвращает (null).

## Как использовать

Функция вызывается следующим образом:

```php
wp_admin_notice( $message, $args );

Параметры

• $message (строка, обязательный) — сообщение, которое будет отображаться.
• $args (массив) — дополнительные аргументы для уведомления.

По умолчанию массив пустой.

Дополнительные аргументы

• type (строка, необязательный) — тип уведомления. Например, 'error', 'success', 'warning', 'info'. По умолчанию — пустая строка.
• dismissible (логическое, необязательный) — определяет, мож��о ли скрыть уведомление. По умолчанию — false.
• id (строка, необязательный) — значение для атрибута ID уведомления. По умолчанию — пустая строка.
• additional_classes (массив строк, необязательный) — массив классов для добавления к уведомлению. По умолчанию — пустой массив.
• attributes (массив строк, необязательный) — дополнительные атрибуты для блока уведомления. По умолчанию — пустой массив.
• paragraph_wrap (логическое, необязательный) — нужно ли оборачивать сообщение в теги <p>. По умолчанию — true.

Примеры

Пример 1: Вывод уведомления о том, что сайт не работает через HTTPS

Давайте проверим, работает ли сайт через HTTPS. Если нет, выведем уведомление об этом. Используем дополнительные аргументы, чтобы настроить вывод.

add_action( 'all_admin_notices', static function () {
    if ( ! is_ssl() ) {
        wp_admin_notice(
            'Ваш сайт НЕ работает через https, это небезопасно!',
            [
                'type'               => 'warning',
                'dismissible'        => true,
                'id'                 => 'my-note-id',
                'additional_classes' => [ 'my-note-class-1', 'my-note-class-2' ],
            ]
        );
    }
} );

Результат

Это позволит отобразить следующее сообщение в панели управления:

    
Ваш сайт не работает через https, это небезопасно!
    
        Скрыть это уведомление.
    

Изменения

С версии 6.4.0 — функция была введена.

Код функции

function wp_admin_notice( $message, $args = array() ) {
    /**
     * Срабатывает перед выводом уведомления для администраторов.
     *
     * @param string $message Сообщение для уведомления.
     * @param array  $args    Аргументы для уведомления.
     */
    do_action( 'wp_admin_notice', $message, $args );

    echo wp_kses_post( wp_get_admin_notice( $message, $args ) );
}

Связанные функции

• Панель администратора

  • get_submit_button()
  • submit_button()
  • wp_get_admin_notice()

• Административное меню

  • add_menu_page()
  • add_meta_box()
  • add_options_page()
  • add_submenu_page()
  • add_theme_page()

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