vestnik.dispatcher ставится вместе с компонентом. Он слушает системные события MODX, к которым привязан, приводит их данные к плейсхолдерам и передаёт в Vestnik. Без привязки к событию и без правила плагин ничего не делает.
Как пользоваться
- Привяжите плагин к событию: Элементы → Плагины → vestnik.dispatcher → Системные события → отметьте нужные (например,
OnWebLogin,OnDocPublished) → Сохранить. После установки плагин привязан кOnUserActivateиOnManagerLogin. - Создайте правило, где «Ключ события» — точное имя события MODX, например
OnUserActivate(с учётом регистра). - Используйте в шаблоне плейсхолдеры события (таблица ниже).
Плейсхолдеры
| Событие MODX | Плейсхолдеры |
|---|---|
| Любое (всегда) | [[+event]], [[+site_name]], [[+site_url]] |
OnUserActivate, OnUserSave, OnUserRemove, OnUserFormSave, OnWebLogin, OnManagerLogin | [[+user_id]], [[+username]], [[+email]], [[+fullname]] |
OnDocPublished, OnDocFormSave | [[+resource_id]], [[+pagetitle]], [[+longtitle]], [[+url]] |
Кроме того, в шаблон попадают все скалярные свойства события под своими именами.
Частые ошибки
- Ключ события в правиле не совпадает с именем события MODX (регистр важен) — правило не сработает.
- Сохранение пользователя в менеджере вызывает
OnUserFormSave, а неOnUserSave. - Ничего не приходит — включите
vestnik_debug_mode: в журнале ошибок MODX появятся строки[Vestnik]о том, сработало ли событие и сколько правил совпало. В этом режиме все письма уходят наvestnik_debug_email, без него не отправляются.