Хаки - это модули расришения для AlterCPA. Работа с ними осуществляется в разделе "Управление - Хаки и модули". В этом разделе вы можете просмотреть доступные хаки от разработчиков AlterCPA, создать свой хак и изменить любые его настройки.
Установка и настройка хака
Скачанные и доступные к установке хаки отображаются в разделе "Хаки и модули". Перед использованием, модуль необходимо установить по кнопке "Установить". В этот момент происходит подготовка базы данных для установленного хака.
После установки, вы можете произвести базовые настройки хака и активировать его. Некоторые хаки после активации могут предоставить вам дополнительные возможности для настройки. Базовая конфигурация хака выполняется по кнопке "Настройки". После активации, хак подключается к системе.
Важно! Рекомендуется активировать хаки сторонних разработчиков на тестовых полигонах, а не на работающей системе. После активации, повреждённый хак может обрушить работу сети.
Создание нового хака
Вы можете самостоятельно создавать свои хаки, или загружать хаки сторонних разработчиков через встроенный интерфейс.
Для создания своего хака, воспользуйтесь формой над списком в разделе управления. Укажите название папки будущего хака. В качестве названия можно использовать маленькие символы латиницы и цифры. Название всегда должно начинаться с буквы. Запрещается использование заглавных букв и символов, в том числе дефиса и знака подчёркивания.
После создания, в хак будут автоматически добавлены файл инициализации и основной рабочий файл хака. Вы можете изменить их по своему усмотрению через встроенный редактор или по FTP.
Для установки хаков от сторонних разработчиков, вам необходимо сперва создать новый пустой хак с таким же названием. Совпадение названий строго обязательно. Если сомневаетесь в названии, откройте архив и посмотрите название функции в файле запуска.
Загрузка и обновление хака от сторонних разработчиков выполняется по кнопке "Импорт". Выберите ранее созданную папку с хаком, выберите архив хака на своём компьютере и нажмите "Импорт". Обновление настроек хака будет выполнено в течение минуты.
Вы можете предавать свои созданные хаки другим пользователям AlterCPA. Для этого нажмите на "Экспорт" в списке хаков и отправьте скачанный файл. Обязательно уточните название хака для установки!
Структура хака
Все хаки располагаются в в папке hack вашей сети. Каждый хак может включать в себя следующие файлы и папки:
start.php- файл запуска хака. Содержит функцию инициализации и критично необходимые функции самого хака. Возвращает список настроек хака.main.php- основной файл хака. Супер-класс, отвечающий за загрузку библиотек, подключение файлов стилей, скриптов, шаблонов и модулей. Может быть расширен любыми нужными функциями.lib- библиотеки хака.mod- модули хака.lang- языковые файлы.tpl- файлы HTML-шаблонов.img,css,js- файлы стилизации хака.delivery- коннекторы служб доставки.adv- коннекторы рекламных сетей.params.json- файл базовых параметров настройки, как у стилей.schema.php- схема базы данных.update.json- настройка обновления хака.
В хаке обязательно должен присутствовать файл start.php, все остальные файлы не являются обязательными. Даже если вы создаёте исключительно модификацию языковых файлов, используйте файл запуска, добавленный по умолчанию.
Удаление хаков
В интерфейсе не предусмотрено удаление хаков через простую кнопку. Данная задача может быть нетривиальной. Хаки могут оставлять после себя конфигурации, таблицы, файлы и папки. Рекомендуется просто отключать хаки из системы. При необходимости, вы можете удалить папку с хаком из папки hack вашей сети.