Базовый модуль для My-engine CMS

Этот сайт работает на My-engine #CMS. Но, при попытке создания блога, я столкнулся с некоторыми проблемами, часть из которых я описал в статьях Создание этого блога. Поскольку сам движок мне понравился, я решил не делать блог с нуля а написать модуль, расширяющий функционал этого движка в нужном мне направлении.

Загрузка

Скачать модуль last update - 2020-12-28 15:18:31

• md5 -- 698c6154f2977bac4bea9d2ec135daf7
• sha1 -- b11409e88fe123889ac31a6a65083c5df4213592

Установка

Внимание! Если вы переименовали директорию /admin -- разместите в ней файл с именем admin.trigger. Он может быть с любым содержимым, в том числе, и пустым.

Модуль можно установить таким же образом, как и другие модули этой #CMS: через Панель управления. Также можно просто распаковать архив и поместить директорию kff_basic в корневую директорию /modules движка.

При первом запуске системы с установленным модулем, скорее всего, будут возникать серверные ошибки из-за некоторых архитектурных конфликтов модуля и движка. Для их устранения следует скачать файл fixUpdate.php, загрузить его в корневую папку сайта, и запустить из браузера -- YOUR.DOMAIN/fixUpdate.php. После этого система будет готова к работе с модулем без конфликтов.

После захода в Панель управления модуль будет отображаться в ней:

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

Настройки Basic

Настройки содержат в себе 3 таба: Модули, Подмодули, Настройки.

Модули

Содержит в себе перечень модулей согласно фильтра. Есть возможность как редактирования данных каждого из модулей, так и включения / отключения его без удаления из директории /modules.

Отключение любого из модулей производится присвоением значения 1 параметру disabled. Также можно редактировать любые другие данные:

Нажатие на кнопку Настройки переведет на страницу с индивидуальными настройками модуля, если таковая имеется (файл admin.php в директории модуля).

Подмодули

В этом табе можно подключать / удалять подмодули -- такие же модули CMS, но в своей работе зависящие от Basic. Для оптимизации их работы в них используются общие блоки кода. Основным из них на данный момент является подмодуль Blog. О нём и его настройках будет отдельная информация.

Отключение чекбокса возле любого из подмодулей приведёт к удалению его кода из директории /modules. Для исключения случайного удаления система спросит подтверждение действия:

Кнопка Настройки также переведёт в индивидуальные настройки подмодуля.

Дополнительно

Помимо управления существующими модулями и поддержки подмодулей Basic выполняет некоторые другие полезные вспомогательные функции:

1. В модуле интегрирован Логгер, выводящий внизу страницы для администратора лог, в котором можно выводить промежуточную информацию работы скриптов (в т.ч. и тесты).
2. Модуль оптимизирует внешний вид Панели управления CMS под мобильные устройства:
3. В модуле интегрирован фреймворк UIkit и добавлена возможность через таб Настройки автоматического переопределения внешнего вида элементов форм.
4. Модуль позволяет создавать навигационные меню, работающие без перезагрузки страниц (AJAX). Также на его базе можно легко создавать и одностраничные приложения (SPA).

UPD 22.11.2020

Реализована возможность использования модуля при изменённом имени директории ПУ.

UPD 05.12.2020

Модуль переведён на версию движка My-Engine v.5.1.25.

UPD 09.12.2020

Модуль переведён на версию движка My-Engine v.5.1.26.