Как добавить собственные уведомления в админке WordPress

Опубликовано: ADv Дата 06.01.2017 в рубрике Код за плагин, Плагины WP Комментировать

Вы желаете добавить уведомления в админке в WordPress? Админ.уведомления используются ядром WordPress, темами и плагинами для того, чтобы отображать предупреждения, уведомления и важную для пользователей информацию на экране. В этой статье мы покажем вам как можно добавить уведомления в админке WordPress.

Зачем и когда нужно использовать админ.уведомления в WordPress?

WordPress использует уведомления в админке для информирования пользователей об ошибках, предупреждениях и сообщениях об успешном завершении задачи.

Также эти уведомления используют владельцы сайтов, авторы плагинов и разработчики тем.

Если вы работаете над клиентским сайтом, и клиент плохо знаком с WordPress, то с помощью уведомлений вы можете отображать полезную информацию по всему сайту.

Однако, мы не рекомендуем ими злоупотреблять, потому как уведомления могут начать раздражать.

Давайте же посмотрим как можно добавить свои собственные админ.уведомления в WordPress.

Способ 1: Добавляем собственные уведомления в WordPress вручную

Этот способ потребует от вас добавления кода на свой сайт.

Для начала вам нужно будет добавить следующий код в файл functions.php вашей темы или в плагин для сайта WordPress:

function general_admin_notice(){
    global $pagenow;
    if ( $pagenow == 'options-general.php' ) {
         echo '<div class="notice notice-warning is-dismissible">
             <p>Это уведомление появится на странице настроек.</p>
         </div>';
    }
}
add_action('admin_notices', 'general_admin_notice');

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

Если вы изучите код, то увидите, что мы использовали переменную $pagenow для определения текущей страницы.

После этого мы добавили условие, которое проверяет, совпадает ли текущая страница с той, где нам нужно отобразить уведомление.

Если так, тогда мы отображаем уведомление, обрамленное в элемент <div>. Этот div использует CSS классы, уже определенные в таблице стилей WordPress, для различных типов уведомлений.

Вам нужно использовать класс notice, а затем добавлять notice-error, notice-warning, notice-success или notice-info.

При необходимости можно применить класс is-dismissible, который добавляет кнопку для закрытия уведомления.

Помимо проверки текущей страницы, вы можете добавлять любые условия для отображения уведомлений.

Например, вам нужно вывести уведомления только пользователям с ролью автора на сайте.

Вот как это можно сделать:

function author_admin_notice(){
    global $pagenow;
    if ( $pagenow == 'index.php' ) {
    $user = wp_get_current_user();
    if ( in_array( 'author', (array) $user->roles ) ) {
    echo '<div class="notice notice-info is-dismissible">
          <p>Нажмите на <a href="edit.php">Записи</a> для того, чтобы начать статью.</p>
         </div>';
    }
}
}
add_action('admin_notices', 'author_admin_notice');

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

Вот так это будет выглядеть на сайте.

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

Способ 2: Добавляем админ.уведомления с помощью плагина

Этот способ проще и не требует добавления код. Однако, он не такой гибкий как предыдущий.

Первым делом вам потребуется установить и активировать плагин KJM Admin Notices.

После активации переходим на страницу Настройки » KJM Admin Notices для настройки плагина.

Сначала отмечаем опцию активации KJM Admin Notices. Вторая опция добавляет произвольный тип записей, где можно будет добавлять и редактировать собственные админ.уведомления.

Плагин также позволит вам отправлять письма зарегистрированным пользователям, когда вы опубликуете новое уведомление. Нужно поставить галочку рядом с ‘Send Email’, если вы решите использовать эту функцию.

Также можно включить комментарии для ваших уведомлений, что позволит пользователям отвечать на уведомления путем публикации комментариев. Для включения этой функции ставим галочку рядом с ‘Allow Comments’.

Не забудьте сохранить проделанные изменения.

Давайте создадим первое админ.уведомление.

Переходим на страницу Notices » Add Notice. Вы увидите страницу как для создания новой записи.

Начать стоит с указания названия для уведомления, затем добавляем самое уведомление в редакторе записей. Можно выбрать категорию для уведомлений в блоке справа.

Далее, указываем роль пользователя, для которой уведомление будет отображаться.