Плагин Private Message (PM)

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

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

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

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

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

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

1. Загрузите файлы плагина в папку

   /engine/plugins/pm/

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

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

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

msg_per_page

title_length

message_length

localsource

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

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

3.1. Таблица

prefix_pm

id

from_id

to_id

subject

message

date

viewed

folder

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. Основные шаблоны

inbox.tpl

outbox.tpl

read.tpl

write.tpl

reply.tpl

set.tpl

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

{{ pm_inbox_link }}

{{ pm_outbox_link }}

{{ pm_set_link }}

{{ pm_read_link }}

{{ pm_del_link }}

{{ pm_write_link }}

{{ pm_reply_link }}

{{ pm_send_link }}

{{ entries }}

{{ pagination }}

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

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

• pm::sendMsg()

  - отправка сообщения

• PMCoreFilter::showUserMenu()

  - отображение счетчика сообщений в меню пользователя

6.2. Хуки (hooks)

• usermenu

  - добавление счетчика сообщений в профиль

• core.userMenu

  - фильтр для меню пользователя

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

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

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

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