Расширение модуля тема 26 из 27

Подмодули

Подмодуль — отдельный блок функций со своими настройками, который администратор включает и выключает на вкладке «Модули» настроек модуля. Так устроены 5 встроенных подмодулей — от интеграции с Битрикс24 до входа через соцсети; так же проект добавляет свой подмодуль, не меняя код модуля.

в этой теме 4
  1. Где лежат подмодули проекта
  2. Создание подмодуля
  3. Как подмодуль работает после создания
  4. Пример подмодуля

Где лежат подмодули проекта

Свои подмодули размещаются в каталоге сайта /local/bik.rest/modules/. Обновление модуля этот каталог не затрагивает. Встроенные подмодули перечислены в теме Настройки модуля.

Создание подмодуля

  1. Создайте каталог /local/bik.rest/modules/.
  2. Создайте в нём PHP-файл с именем, отражающим назначение подмодуля (например, CustomModule.php).
  3. В файле опишите класс — наследник абстрактного класса AbstractModule — и определите его методы: setID, setDescription, setTitle, setIcon, setTabs, setOptions.
  4. За основу возьмите пример ниже.
  5. Созданный подмодуль появится в Настройки -> Настройки модулей -> BIK.REST -> Модули.

Как подмодуль работает после создания

  • setID — уникальный идентификатор, setTitle — заголовок страницы и пункта меню, setDescription — описание подмодуля.
  • Вкладки (setTabs) и поля (setOptions) задают страницу настроек подмодуля: поле ввода, список или многострочное поле.
  • Подмодуль можно включать и выключать по необходимости; после включения документация Swagger обновляется.
  • Значения настроек читаются стандартным способом Битрикса: \Bitrix\Main\Config\Option::get('bik.rest', 'код из setName').

Пример подмодуля

php
<?php
namespace BIK\Rest\Modules;

use BIK\Rest\Admin\Core\IconCollection;
use BIK\Rest\Admin\Core\PageOption;
use BIK\Rest\Admin\Core\PageOptionList;
use BIK\Rest\Admin\Core\PageTabList;

class CustomModule extends AbstractModule
{
    /*
     * Уникальный идентификатор
     */
    public static function setID(): string
    {
        return 'custom_module';
    }

    /*
     * Описание модуля
     */
    public static function setDescription(): string
    {
        return 'Описание модуля';
    }

    /*
     * Заголовок страницы и пункта меню
     */
    public static function setTitle(): string
    {
        return 'Интеграция Custom Module';
    }

    /*
     * Иконка пункта меню
     *
     * Функция должна возвращать css класс иконки; если иконка не требуется, можно вернуть пустую строку
     * Класс IconCollection включает в себя набор css классов стандартных иконок, которые используются в Bitrix
     */
    protected static function setIcon(): string
    {
        return IconCollection::CLOUDS_MENU_ICON;
    }

    /*
     * Вкладки
     *
     * Функция должна возвращать объект PageTabList
     * Для добавления вкладки необходимо создать объект класса PageTabList и вызвать метод add, передав в качестве аргумента ID вкладки и её заголовок
     */
    protected static function setTabs(): PageTabList
    {
        $list = new PageTabList();

        $list
            ->add("base", "Основное");

        return $list;
    }

    /*
     * Список конфигураций
     *
     * Каждая вкладка может содержат список своих конфигураций
     * Функция должна возвращать объект PageOptionList
     *
     * Для добавления конфигурации необходимо создать объект класса PageOptionList и вызвать метод add
     * Метод add принимает в качестве первого аргумента ID таба, указанный ранее в методе setTabs, и вторым аргументом - объект класса PageOption
     *
     * Объект PageOption
     * setTitle - задает заголовок конфигурации, обязательный метод
     * setInputType - задает тип поля, можно использовать PageOption::INPUT, PageOption::SELECT, PageOption::TEXTAREA, обязательный метод
     * setName - задает уникальный идентификатор, обязательный метод
     * setHint - задает подсказку, необязательный метод
     * setDefaultValue - задает значение по умолчанию, необязательный метод
     * setSelectOptions - задает список option для типа select(PageOption::SELECT), обязательный метод
     *
     * К значениям созданных конфигураций можно получить доступ так: \Bitrix\Main\Config\Option::get('bik.rest', 'уникальный идентификатор из setName');
     */
    protected static function setOptions(): PageOptionList
    {
        $optionList = new PageOptionList();

        return $optionList
            ->add("base",
                (new PageOption())
                    ->setTitle('Хост')
                    ->setInputType(PageOption::INPUT)
                    ->setName('cs_host')
            )
            ->add("base",
                (new PageOption())
                    ->setTitle('Логин')
                    ->setInputType(PageOption::INPUT)
                    ->setName('cs_login')
            )
            ->add("base",
                (new PageOption())
                    ->setTitle('Пароль')
                    ->setInputType(PageOption::INPUT)
                    ->setName('cs_password')
            )
            ->add("base",
                (new PageOption())
                    ->setTitle('Создавать лиды на основе инфоблока "Формы обратной связи"')
                    ->setInputType(PageOption::INPUT)
                    ->setName('cs_enable_from_feedback')
                    ->setDefaultValue(0)
                    ->setSelectOptions([
                        0 => 'Нет',
                        1 => 'Да',
                    ])
            )
            ->add("base",
                (new PageOption())
                    ->setTitle('Свойство для размещения названия отправляемой формы')
                    ->setInputType(PageOption::INPUT)
                    ->setName('cs_lead_from_uf_form_name')
            )
            ->add("base",
                (new PageOption())
                    ->setTitle('Свойство для размещения кода Ройстат')
                    ->setInputType(PageOption::INPUT)
                    ->setDefaultValue('UF_CRM_XXXXXXXXX')
                    ->setName('cs_lead_uf_roistat')
            );
    }
}

Подключим BIK.REST-API к вашему сайту

Оставьте заявку — установим и настроим модуль, ответим на вопросы по API.

c заботой о вас, мы используем cookie на своем сайте, чтобы интернет был чистым и прекрасным