PearCMS Docs v2.4
Документация / Модули / Что такое модуль

Что такое модуль

Модуль в PearCMS — это самостоятельный пакет с собственным роутером, контроллерами, миграцией и панелью прав. Сейчас в комплекте 27+ модулей; их можно включать/выключать без удаления данных.

Актуально для v2.4 Обновлено 1 июля 2026

Что такое модуль #

Модуль — это каталог в modules/<Name>/ с фиксированной структурой. У него есть:

  • Публичный фасад (<Name>.php) — точка входа для маршрутов /<name>/* на сайте
  • Админ-роутер (<Name>Router.php) — диспетчер /s-panel/<name>/*
  • FlagsPanel — декларация прав для каждого action
  • migration.sql / uninstall.sql — DDL для своих таблиц и сидинг роутов/меню
  • module.json — манифест: имя, версия, зависимости, иконка

Конвенция именования: PascalCase для папки и namespace (App\Modules\Banner), snake-case для таблиц (banner__items), kebab-case для URL (/s-panel/banner).

Каталог встроенных модулей #

МодульНазначение
ChatВнутренний мессенджер админов: групповые чаты, реакции, закреплённые сообщения
SocialСоциальные интеграции, боты, рассылка
BannerБаннеры на публичной части (с расписанием и таргетингом)
CalandaryКалендарь событий и блокировок
MNewsНовости/блог
MGalleryФотогалереи
OtzivОтзывы клиентов
PersonalCabinetЛичный кабинет пользователя на сайте
Support / SupportOnlineТикет-система и онлайн-чат поддержки
TaskCoreМенеджер задач для команды
StoreMarketМагазин/каталог товаров
KassaКасса и заказы
CBookingsAuto/Buy/Home/Moto/RecordСемейство модулей бронирования (аренда машин, мотов, жилья и т. п.)
CmsBoardВнутренняя доска объявлений
CmsModules / CmsThemesМагазин модулей и тем
CmsVersionПроверка обновлений и self-update CMS
LoadingПрелоадер сайта
CookieCookie-баннер
MetricaИнтеграции с Яндекс.Метрикой / Google Analytics
CapchaКапча на формы
FundraisingСборы и пожертвования
VayherПартнёрские интеграции

Установка стороннего модуля #

Модули распространяются в виде ZIP-архивов. Пошагово:

  1. В админке: Модули (/s-panel/modules) → «Загрузить».
  2. Выберите ZIP — сервер распакует его в modules/<Name>/ и автоматически прогонит миграцию модуля (она же создаёт нужные таблицы в БД).
  3. В таблицу module_settings добавится запись enabled=1.

Если модуль платный — у него внутри есть проверка ключа, который вводится при первой активации. Подробнее — на странице «Менеджер модулей».

Дальше — «Анатомия модуля», где разберём внутреннюю структуру по файлам.