Плагин Private Message (PM)

1. Общая информация

Плагин Private Message (PM) предназначен для обмена личными сообщениями между пользователями на сайте, работающем на NextGeneration CMS (NGCMS).

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

• Отправка и получение личных сообщений
• Хранение входящих и исходящих сообщений
• Настройки уведомлений
• Поддержка BBCode и смайлов
• Пагинация сообщений

2. Установка и настройка

2.1. Установка плагина

1. Загрузите файлы плагина в папку /engine/plugins/pm/
2. Активируйте плагин через админ-панель NGCMS
3. Настройте необходимые параметры

2.2. Настройки плагина

Доступные параметры (настраиваются через админку):

3. Структура базы данных

Плагин использует следующие таблицы:

3.1. Таблица prefix_pm

3.2. Изменения в таблице uprefix_users

Добавляются следующие поля:

• pm_all - общее количество входящих сообщений
• pm_unread - количество непрочитанных сообщений
• pm_sync - флаг синхронизации счетчиков
• pm_email - настройка email-уведомлений

4. Функционал плагина

4.1. Входящие сообщения (Inbox)

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

4.2. Исходящие сообщения (Outbox)

• Просмотр отправленных сообщений
• Удаление сообщений из исходящих

4.3. Чтение сообщений

• Отображение полного текста сообщения
• Поддержка форматирования (BBCode, смайлы)
• Кнопка ответа (для входящих сообщений)

4.4. Написание сообщений

• Форма отправки новых сообщений
• Автодополнение имени получателя
• Возможность сохранения копии в исходящих
• Поддержка BBCode и смайлов

4.5. Настройки

• Включение/отключение email-уведомлений

5. Шаблоны и интерфейс

5.1. Основные шаблоны

5.2. Основные переменные в шаблонах

6. API и интеграция

6.1. Основные функции

• pm::sendMsg() - отправка сообщения
• PMCoreFilter::showUserMenu() - отображение счетчика сообщений в меню пользователя

6.2. Хуки (hooks)

• usermenu - добавление счетчика сообщений в профиль
• core.userMenu - фильтр для меню пользователя

7. Возможные улучшения

• Добавление групповых сообщений
• Вложения к сообщениям
• Черновики сообщений
• Поиск по сообщениям
• Улучшенная пагинация и фильтрация
• Поддержка markdown вместо BBCode
• Push-уведомления
• Добавление CSRF-защиты

8. Заключение

Плагин Private Message предоставляет базовый функционал личных сообщений для NGCMS. Он хорошо интегрируется в систему, но требует доработок для современных стандартов (безопасность, UX).