[Shum1kh1n / Helgring] Message Notice Pro

[Shum1kh1n / Helgring] Message Notice Pro

✦ Служебные BB-коды • Предупреждения • Автоматические личные уведомления • Права доступа • Настройка оформления ✦

[Shum1kh1n / Helgring] Message Notice Pro — дополнение для XenForo 2.3.x, предназначенное для создания заметных информационных, предупредительных и служебных блоков в сообщениях форума. Оно добавляет 14 BB-кодов с собственными заголовками, цветами и иконками, позволяет настраивать доступ к их использованию и просмотру, а также автоматизирует часть взаимодействия модераторов с пользователями при вынесении предупреждений.
Дополнение полезно там, где важная информация должна отличаться от обычного текста: в правилах и инструкциях, технической поддержке, объявлениях администрации, пояснениях разработчиков и модераторских замечаниях. Вместо разрозненного оформления используется единая система служебных блоков, которую можно адаптировать к внешнему виду форума.

Основные возможности

14 специальных BB-кодов. Информация, вопросы, ответы, важные объявления, предупреждения, безопасность, советы, заметки, материалы для скачивания, сообщения об успехе и ошибках.
Автоматические личные уведомления. Когда администратор или модератор впервые добавляет mwarning или awarning при редактировании чужого сообщения, дополнение может создать личную переписку с автором сообщения.
Подробное содержимое warning-ЛС. Уведомление формируется с причиной предупреждения, ссылкой на исходный пост, названием темы, именем сотрудника и первоначальной и отредактированной версиями сообщения.
Выбор отправителя. В настройках можно указать ID пользователя, от имени которого будут отправляться служебные ЛС. Если указанный отправитель недоступен или не проходит проверку, используется сотрудник, выполняющий редактирование.
Управление warning-переписками. Новые диалоги можно автоматически закрывать или оставлять открытыми. Изменение настройки не меняет состояние уже созданных переписок.
Отображение автора предупреждения. Для служебного блока может подставляться имя администратора или модератора и соответствующее обозначение роли; при обработке предусмотрена поддержка параметра автора в BB-коде.
Гибкая настройка оформления. 28 свойств стиля: отдельные параметры цвета и иконки для 14 типов блоков.
Система разрешений. Отдельные права на использование BB-кодов и просмотр их содержимого; проверка использования на этапе сохранения сообщений форума и личных переписок.
Поддержка локализации. Тексты интерфейса вынесены во фразы XenForo, предусмотрены XML-файлы русского языка для импорта и дальнейшей настройки перевода.

Полный список BB-кодов
В дополнении зарегистрированы 14 активных типов блоков. Их назначение:

minformation — информация. Обычные информационные сообщения, пояснения и справочные сведения.
mquestion — вопрос. Выделение вопросов и пунктов, на которые требуется ответ.
manswer — ответ. Оформление решений, ответов и разъяснений.
mwarning — предупреждение модератора. Замечания по содержимому сообщения или соблюдению правил.
awarning — предупреждение администрации. Отдельный тип административного предупреждения.
mimportant — важная информация. Правила, ключевые объявления и сведения, требующие повышенного внимания.
mnote — примечание. Дополнительные пояснения к основному материалу.
msecurity — безопасность. Рекомендации и предупреждения, связанные с безопасностью.
mdownload — скачивание. Информация о файлах, загрузках и дополнительных материалах.
mtip — совет. Полезные рекомендации и практические подсказки.
mexample — пример. Образцы оформления, применения и выполнения действий.
mdeveloper — разработчику. Технические примечания и пояснения.
merror — ошибка. Сообщения о неполадках и ошибочных действиях.
msuccess — успешно. Подтверждения завершённых действий и положительных результатов.

Простейший пример использования:

Код:

[mimportant]Пожалуйста, ознакомьтесь с правилами раздела перед публикацией сообщения.[/mimportant]

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

Как работают модераторские предупреждения
Автоматическое личное уведомление связано не с любым сообщением, содержащим warning-тег, а с конкретным действием: администратор или модератор редактирует чужой пост и впервые добавляет в него mwarning или awarning. Если предупреждающий тег уже присутствовал до редактирования, условие создания нового ЛС не выполняется.

Сотрудник форума редактирует сообщение другого пользователя и добавляет предупреждающий блок с пояснением.
После сохранения дополнение определяет автора сообщения, текст предупреждения и данные редактирования.
Формируется личная переписка, в которую включаются причина, ссылка на сообщение, исходный текст и изменённый вариант.
В качестве отправителя используется назначенный пользователь либо сотрудник, выполняющий действие, если отдельный отправитель не задан или недоступен.
Если включён параметр автоматического закрытия, закрывается именно созданная переписка; существующие диалоги не изменяются.

Такой сценарий позволяет пользователю получить контекст предупреждения в личном сообщении, а администрации — не составлять одинаковые объяснения вручную. Это не замена штатной системе предупреждений XenForo и не отдельная система штрафных баллов.

Оформление и свойства стиля

Индивидуальные цвета и иконки. Для каждого из 14 типов служебных блоков предусмотрена пара свойств оформления; всего 28.
Единая визуальная система. Блоки различаются назначением, но используют общую структуру вывода, отступы, заголовки и иконки.
Изоляция CSS. Используется класс .message-notice вместо общего .notice, чтобы снизить риск влияния на чужие элементы интерфейса.
Совместимость со стилями. Оформление прежней тестовой ветки проверено со стилем XTR Zenith на XenForo 2.3 и в мобильном представлении. Для других тем рекомендуется проверка на собственном форуме.

Права доступа и безопасность

Право использования. Разрешение message_notice_use определяет, может ли пользователь добавлять специальные BB-коды.
Право просмотра. Разрешение message_notice_view определяет доступ к содержимому служебных блоков.
Гости форума. Если блоки должны отображаться незарегистрированным посетителям, право просмотра необходимо отдельно выдать группе гостей.
Проверка при сохранении. Для обычных сообщений форума и личных сообщений предусмотрена серверная проверка попытки добавить или изменить запрещённый служебный BB-код.
Редактирование без потери содержимого. Пользователь может исправлять окружающий текст, не меняя уже существующий защищённый блок.
Штатные ограничения личных переписок. Дополнение не должно предоставлять модераторам дополнительные права обхода стандартных проверок ответа и редактирования XenForo.

Ограничение: серверная проверка добавления BB-кодов в текущей ветке реализована для сообщений форума и личных переписок. Для других типов контента аналогичная защита не заявлена как полностью проверенная.

Для кого предназначено дополнение

Администраторам форумов — для оформления важных объявлений, правил, технических уведомлений и организации прав доступа.
Модераторам — для наглядных замечаний и автоматической отправки пользователям контекста предупреждения.
Разработчикам дополнений — для инструкций, технических примеров, предупреждений и сведений о безопасности.
Авторам руководств и материалов — для отделения советов, вопросов, ответов и важных примечаний от остального текста.
Владельцам сообществ — для единого оформления информационных блоков в разных разделах форума.

Основные преимущества

Наглядность. Разные категории сообщений узнаются по оформлению и заголовку.
Меньше ручной работы. Повторяющиеся уведомления об определённых модераторских изменениях формируются автоматически.
Гибкая настройка. Цвета и иконки изменяются через свойства стиля, а параметры ЛС — через настройки дополнения.
Прозрачность предупреждений. Пользователь получает контекст изменения, включая сравнение первоначального и отредактированного текста.
Контроль доступа. Использование и просмотр служебных блоков разделены по разрешениям.
Обычные механизмы XenForo. Используются BB-коды, шаблоны, фразы, свойства стиля и система личных переписок платформы.

Что входит в комплект

Установочный ZIP. Файлы дополнения под src/addons/Shum1kh1n/MessageNoticePro и внешние ресурсы styles/Shum1kh1nMessageNoticePro.
14 BB-кодов и шаблоны оформления. Обработчики, макросы, LESS и свойства стиля.
Параметры ACP и разрешения. Выбор отправителя уведомлений, закрытие новых переписок, права использования и просмотра.
Фразы XenForo. Возможность перевода через стандартный раздел языков и фраз; XML русского языка доступен в Complete-комплекте.
Документация и история изменений. В Complete-комплекте находятся README, CHANGELOG, инструкция по тестированию, сведения о структуре и особенности миграции.
Исходники и графика. Complete-комплект содержит исходные файлы, релизные материалы и отдельные изображения для публикации ресурса.

Основная информация о релизе

Название: [Shum1kh1n / Helgring] Message Notice Pro
Версия: 1.2.2; Version ID: 1020270
Требования: XenForo 2.3.0+
Автор и сопровождающий форка: Shum1kh1n
Происхождение: форк Message Notice от Skaiman
Add-on ID: Shum1kh1n/MessageNoticePro
Namespace PHP: Shum1kh1n\MessageNoticePro
Ресурсы оформления: styles/Shum1kh1nMessageNoticePro
Статус проверки: локальная проверка сборки выполнена; миграция с установленного старого ID на XF 2.3 пока требует отдельного подтверждения.
Author URL: https://forum.helgring.ru/members/1/
Support URL: https://forum.helgring.ru/

Установка на новый форум

Создайте резервную копию базы данных и файлов форума и проверьте соответствие версии XenForo требованиям дополнения.
Скачайте установочный ZIP — не Complete-комплект целиком.
Установите пакет штатным механизмом XenForo либо перенесите содержимое upload в корень форума и выполните установку обнаруженного дополнения в ACP.
Настройте права групп message_notice_use и message_notice_view, включая разрешения для гостей, если им необходимо читать блоки.
Задайте отправителя предупреждений и поведение новых личных переписок в параметрах дополнения.
Проверьте вывод BB-кодов, права пользователей, работу модераторских уведомлений, журнал ошибок и целостность файлов.

Важно при обновлении с 1.2.1
В версии 1.2.2 изменён идентификатор дополнения: Helgring/MessageNoticePro → Shum1kh1n/MessageNoticePro. Это не обычное обновление существующего дополнения с тем же ID. Сам по себе новый номер версии не обеспечивает перенос настроек между разными идентификаторами.

Не удаляйте старую установку ради установки новой без проверенного сценария миграции.
Не включайте одновременно конфликтующие экземпляры старого и нового дополнения.
Сначала проверьте переход на копии форума с установленной 1.2.1 и резервной копией базы данных и файлов.
После переноса убедитесь, что сохранены настройки, права, свойства стиля, отображение старых BB-кодов и работа личных уведомлений.
До успешной интеграционной проверки миграции нового Vendor ID не применяйте этот вариант установочного ZIP на основном форуме.

Изменения версии 1.2.2

Проверка права использования служебных BB-кодов при сохранении сообщений форума и личных переписок.
Исправления поведения предупреждений и сохранение редактирования текста вокруг неизменённых защищённых блоков.
Исключение лишних обходов стандартных ограничений личных переписок и массового изменения их статуса по заголовку.
Изоляция CSS-класса .message-notice.
Перенос Add-on ID, namespace PHP и внешних стилей в структуру Shum1kh1n.
Обновление addon.json, build.json, hashes.json, универсальной H-иконки и релизной документации.

Функциональные исправления проверены на тестовой ветке 1.2.1 TEST PATCH. Отдельная проверка переноса уже установленной 1.2.1 на новый Add-on ID на XenForo 2.3 ещё требуется.

Происхождение и сопровождение
Message Notice Pro — сопровождаемый форк оригинального дополнения Message Notice от Skaiman. Доработки, адаптация, сопровождение, фирменное оформление и актуальная релизная документация выпускаются под брендом Shum1kh1n / Helgring. В поставку включены сведения о происхождении проекта.

Скриншоты
Ниже сохранены вложения из первоначальной публикации. Перед сохранением описания убедитесь, что вложения доступны в редактируемом ресурсе и по-прежнему отражают актуальный интерфейс; при необходимости замените их новыми снимками версии 1.2.2.