WPTRT Admin Notices

Ребята из команды, которые делают ревью тем на wp.org, представили своё отличное решение WPTRT Admin Notices для показа уведомлений в админке WordPress.

WPTRT Admin Notices — это класс, который позволяет авторам тем и плагинов добавлять уведомления для пользователей консоли WordPress.

Основной целью данного проекта является предоставление стандартизированного метода создания уведомлений в стилистике WordPress.

Уведомления, созданные с использованием этого класса, автоматически удаляются.

Внешний вид

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

$my_theme_notices = new \WPTRT\AdminNotices\Notices();

// Добавляем уведомление.
$my_theme_notices->add( (string) $id, (string) $title, (string) $content, (array) $options );

// Загружаем.
$my_theme_notices->boot();

Экземпляр класса Notices создается при помощи $my_theme_notices = new \WPTRT\AdminNotices\Notices(). А для добавления нового уведомления используется метов add().

Аргументы этого метода:

Аргумент $options — это массив, который может содержать следующие опциональные настройки:

Примеры

Вы можете добавить этот сниппет в уже существующий код темы или плагина.

Для начала необходимо инициализировать объект Notices:

use WPTRT\AdminNotices\Notices;
$my_theme_notices = new Notices();

Затем добавить простое уведомление с настройками по умолчанию:

$my_theme_notices->add(
    'my_theme_notice',                           // Уникальный ID.
    esc_html__( 'Notice Title', 'textdomain' ),  // Заголовок.
    esc_html__( 'Notice content', 'textdomain' ) // Содержимое.
);

Код из примера выше создает новое уведомление, которое будет показано на всех страницах консоли WordPress.

Когда уведомление будет закрыто, создастся запись в таблице wp_options с ключом wptrt_notice_dismissed_my_theme_notice.

Для большей кастомизации уведомления добавьте аргумент $options:

$my_theme_notices->add(
    'my_notice',                                  // Уникальный ID.
    esc_html__( 'Notice Title', 'textdomain' ),   // Заголовок.
    esc_html__( 'Notice content', 'textdomain' ), // Содержимое.
    [
        'scope'         => 'user',       // Хранить статус уведомления в метаданных пользователя.
        'screens'       => [ 'themes' ], // Показывать только на экране "Темы" screen.
        'type'          => 'warning',    // Тип уведомления предупреждение (оранжевый цвет).
        'alt_style'     => true,         // Использовать альтернативные цвета.
        'option_prefix' => 'my_theme',   // Изменить префикс меты для хранения статуса уведомления.
    ]
);

Код из примера выше создаст новое уведомление, которое будет показываться только на экране «Темы» консоли WordPress.

Когда уведомление будет закрыто, создастся запись в таблице wp_usermeta с ключём my_theme_my_notice.

Класс Notices может быть использован для добавления множества уведомлений.

После добавления нескольких уведомлений вызовите метод boot, чтобы они вывелись в консоли WordPress:

$my_theme_notices->boot();

Если собрать всё вышесказанное в одну кучу, то полный пример будет выглядеть примерно так:

$my_theme_notices = new \WPTRT\AdminNotices\Notices()
$my_theme_notices->add( 'my_theme_notice', __( 'Title', 'textdomain' ), __( 'Content', 'textdomain' ) );
$my_theme_notices->boot();

Autoloading

Если вам нужен будет автозагрузик классов, то можно использовать либо Composer, либо простой autoloader из самого проекта WPRTR.

Composer

В командной строке пишем:

composer require wptrt/admin-notices

WPTRT Autoloader

Если хотите подключить загрузчик от WPTRT, используйте следующий код:

include get_theme_file_path( 'path/to/autoload/src/Loader.php' );

$loader = new \WPTRT\Autoload\Loader();
$loader->add( 'WPTRT\\AdminNotices\\Notice', get_theme_file_path( 'path/to/admin-notices/src' ) );
$loader->register();

Ссылки

• WPTRT Admin Notices

Notify WordPress