Система уведомлений

Описание

Notification System плагин создаёт и поддерживает систему уведомлений для пользователей на WordPress-сайте.

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

Админка

Уведомления — это записи кастомного типа notification. Имеется стандартный интерфейс для кастомного типа постов, с меню в консоли сайта.

Администратор может создавать, редактировать и удалять уведомления. Одна таксономия доступна: Channel. Администратор может добавлять, редактировать и удалять термины таксономии. Чтобы ограничить уведомления некоторым пользователям, добавьте login пользователей в виде списка, разделённого запятыми.

Фронтенд

Плагин создаёт страницу /notifications «на лету» — она не существует в базе. Информация на этой странице видима только залогиненным пользователям (ограничена разрешениями в REST API Controller).

Плагин создаёт окно попапа, если url содержит хеш #notifications, например: http://my.site.org/some-url#notifications. Это лёгкий способ показать всплывающее окно с уведомлениями где угодно. Просто создаёте ссылку вида <a href="http://my.site.org#notifications">Notifications</a> и клик по этой ссылке откроет попап с уведомлениями.

Залогиненные пользователи могут просматривать уведомления и фильтровать их по каналам.

Кнопка Показать Ещё обеспечивает пагинацию в списке уведомлений.

Для пользователей, кто имеет привилегию ‘edit_posts’, показываются дополнительные кнопки: Создать, Обновить и Удалить. Всплывающее окно показывает соответствующие поля. Все уведомления могут быть отредактированы прямо с фронтенда.

Администраторам сайта

Добавьте кастомную ссылку к меню, с таким url #notifications. Используйте любую метку навигации, пробел или пустую метку. Сохраните меню. На фронтенде сайта, вы увидите новый раздел меню с иконкой и счётчиком непрочитанных уведомлений. По клику на этот пункт меню откроется всплывающее окно с уведомлениями.

Разработчики

Создайте элемент(ы) с классом ‘unread-notifications-count’. Лучшее место для таких элементов — где-то в шапке или в меню. Они могут быть обновлены плагинов по кастомному событию JS ‘update_unread_counts’. Пример:

const count = 5;
document.dispatchEvent(
    new CustomEvent(
        'update_unread_counts',
        { 'detail': count }
    )
);

Из кода php, счётчики могут быть обновлены для текущего пользователя с помощью действия ‘update_unread_counts’. Пример:

do_action( 'update_unread_counts' );

Подготовлен к переводу

Плагин подготовлен к переводу. Все строки выводятся через функции gettext. Имеется .pot файл в папке /language со всеми строками.

Код

Код php соответствует уровню php 5.6.
Код js соответствует уровню ES6.

Весь код проверен анализатором кода, и соответствует стандартам кодирования WordPress.