Обзор

Плагин Woo2iiko имеет многоуровневую систему уведомлений для информирования администраторов о важных событиях, ошибках и статусе операций. Уведомления отображаются в административной панели WordPress и могут дублироваться в Telegram.

Уведомления в административной части

Принципы работы

• Доступны всем пользователям с ролью «Администратор»
• Не персонализированы - видны всем админам одновременно
• Маркируются названием плагина для идентификации

Формат уведомлений

<div class="alert alert-info alert-dismissible" role="alert">
    <strong>Woo2iiko:</strong> Текст уведомления
    <button class="close" type="button" data-dismiss="alert" aria-label="Close">
        <span aria-hidden="true">×</span>
    </button>
</div>

Особенности работы

1. Исторические уведомления:

   • Могут отображать уже устраненные проблемы
   • Закройте уведомление для проверки - если оно не появится снова, ошибка решена

2. Ограничение количества:

   • Одновременно показывается не более 5 уведомлений
   • Доступна кнопка «Убрать все уведомления»

3. Типы сообщений:

   • Критические ошибки
   • Предупреждения
   • Информационные сообщения
   • Уведомления о успешных операциях

Telegram уведомления

Настройка

Плагин поддерживает отправку уведомлений через Telegram бота для оперативного получения информации.

Шаги настройки:

1. Создание бота:

   • Напишите @BotFather в Telegram
   • Используйте команду /newbot для создания бота
   • Скопируйте токен бота

2. Получение Chat ID:

   • Напишите сообщение вашему боту
   • Перейдите по ссылке: https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
   • Найдите «chat»:

3. Настройка в плагине:

   • В админке Woo2iiko → Настройки → Уведомления
   • Включите Telegram уведомления
   • Вставьте токен бота и Chat ID

Типы Telegram уведомлений

• Заказы: Уведомления о новых заказах и изменениях статуса
• Фоновые процессы: Сообщения о запуске и завершении фоновых задач
• Ошибки: Критические ошибки и предупреждения

Формат сообщений

Telegram сообщения используют HTML разметку для форматирования:

<strong>Woo2iiko:</strong> Заказ #123 успешно экспортирован в iiko
<i>Время:</i> 2025-01-15 14:30:25

События для уведомлений

Уведомления о заказах

• Создание нового заказа
• Изменение статуса заказа
• Ошибки экспорта в iiko
• Успешная передача заказа

Уведомления о синхронизации

• Запуск импорта номенклатуры
• Завершение импорта с результатами
• Ошибки подключения к API iiko
• Обновление стоп-листов

Системные уведомления

• Запуск фоновых процессов
• Завершение длительных операций
• Предупреждения о производительности
• Ошибки конфигурации

Настройки уведомлений

В административной панели

// Включение уведомлений в админке
iiko_get_option('iiko_show_notification', 'yes');

// Отправка ошибок на email
iiko_get_option('iiko_send_error_to_mail', 'no');

Настройки Telegram

• Включение: tg_enable_notifications
• Токен бота: tg_token
• Chat ID: tg_user_id
• Заказы: tg_orders_notifications
• Фоновые процессы: tg_bg_notifications

Управление уведомлениями

Просмотр уведомлений

Уведомления отображаются в верхней части админки WordPress:

1. Перейдите в административную панель
2. Уведомления появляются в области над контентом
3. Каждое уведомление можно закрыть индивидуально
4. Используйте кнопку «Убрать все» для массового закрытия

Фильтрация и приоритезация

• Критические ошибки: Отображаются немедленно
• Предупреждения: Могут быть отложены
• Информационные: Показываются по расписанию

Устранение неполадок

Проблема: Уведомления не приходят

Решения:

• Проверьте настройки в админке
• Убедитесь, что пользователь имеет роль администратора
• Проверьте логи на наличие ошибок

Проблема: Telegram сообщения не отправляются

Решения:

• Проверьте токен бота на корректность
• Убедитесь, что Chat ID правильный
• Проверьте, что бот добавлен в чат
• Проверьте логи плагина

Проблема: Слишком много уведомлений

Решения:

• Настройте фильтры уведомлений
• Отключите неважные типы сообщений
• Настройте расписание для информационных уведомлений

API для разработчиков

Добавление собственного уведомления

use iiko\notification\Notice;

// Уведомление в админку
Notice::add_notification('Ваше сообщение', 'info', 'custom_action');

// Уведомление в Telegram
use iiko\notification\Telegram;
Telegram::notify('Ваше сообщение в Telegram');

Хуки для кастомизации

// Хук перед отправкой уведомления
do_action('iiko_before_send_notification', $message, $type);

// Хук для фильтрации Telegram сообщений
add_filter('iiko_telegram_message', function($message) {
    return $message . '\n\nОтправлено из Woo2iiko';
});

Лучшие практики

Рекомендации по настройке

1. Включите Telegram уведомления для критических событий
2. Настройте фильтры для избежания спама
3. Регулярно проверяйте уведомления в админке
4. Настройте email для архивных уведомлений

Мониторинг и обслуживание

• Проверяйте статус уведомлений еженедельно
• Очищайте старые уведомления регулярно
• Обновляйте токены ботов при необходимости
• Мониторьте логи на наличие ошибок

Рекомендация

Используйте Telegram уведомления для оперативного реагирования на важные события, а админку - для детального мониторинга всех операций. :::</parameter