Разработка модулей и компонентов для 1С-Битрикс

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

cat issue.md

Когда нужен свой модуль

  • Готовый модуль почти подходит, но нужного сценария в нём нет.
  • Половина логики сайта живёт в init.php, и никто не помнит, что там.
  • Кто-то поправил файлы ядра. После обновления правки пропали.
  • Менеджер каждый день вручную делает то, что можно повесить на агента.
  • Нужен свой раздел в админке с правами доступа и журналом операций.

cat todo.md

Что входит

  • Модули на D7 с установщиком: настройки, права, языковые файлы и удаление по согласованным правилам.
  • Свои компоненты и шаблоны к штатным компонентам.
  • Обработчики событий вместо правок ядра.
  • Агенты для выгрузок, очистки и пересчёта по расписанию.
  • Страницы в админке: списки, журналы, отчёты.
  • Таблицы на ORM D7 и миграция нужных данных.
  • Перенос разрозненного кода из init.php в отдельный модуль.
  • Проверка основных сценариев на копии сайта и краткая инструкция.

cat boundaries.md

Что в эту работу не входит

  • Изменение файлов ядра Битрикса и обход лицензионных ограничений.
  • Дизайн всего сайта. Вёрстка нужна только для интерфейсов создаваемого модуля.
  • Исправление ошибок стороннего модуля, если его можно заменить обработчиками или отдельной доработкой.
  • Регулярная поддержка после сдачи. Её объём обсуждаем отдельно.

cat result.md

Что получите

Отдельный модуль или компонент, который устанавливается на сайт и выполняет согласованные сценарии. Настройки и права доступны в админке, если они предусмотрены задачей. Код ядра остаётся нетронутым, поэтому обновление Битрикса не затирает разработку.

Передаю исходный код и инструкцию по установке, а для фоновых операций и обменов добавляю журнал либо понятное сообщение об ошибке. Объём документации и правила удаления данных согласуем до начала работы.

cat options.md

Готовый модуль, доработка или разработка с нуля

Настроить готовое решение

Подходит, если оно закрывает сценарий штатными настройками. Проверяю совместимость с версией Битрикса, шаблоном и соседними модулями.

Добавить свою логику рядом

Нужна, когда готовый модуль даёт события или API. Свой код выношу в отдельный модуль, чтобы обновление готового решения не удалило доработку.

Разработать с нуля

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

cat estimate.md

Сроки и стоимость

  • Понятный объём

    Описываю состав модуля, оцениваю работу целиком и согласую порядок сдачи.

  • Крупная разработка

    Делю на этапы: сначала основной сценарий, затем дополнительные интерфейсы и автоматизация.

Оценку составляю после описания сценариев: на неё влияют интеграции, работа с существующими данными, состояние кода сайта и проверка интерфейсов на вашем шаблоне.

cat workflow.md

Этапы разработки

  1. Разбираю процесс

    Как работаете сейчас, какой результат нужен и кто будет пользоваться модулем.

  2. Фиксирую поведение

    Описываю поля, действия, ограничения и реакцию на ошибки. Предлагаю состав решения.

  3. Разрабатываю на копии

    Создаю установщик и код, проверяю согласованные сценарии. Крупные задачи показываю по частям.

  4. Передаю и устанавливаю

    Отдаю код и инструкцию. На рабочем сайте перед установкой делаю резервную копию.

  5. Проверяю после установки

    Прохожу основные сценарии и смотрю журналы ошибок.

cat requirements.md

Что понадобится от вас

  • Описание одного полного сценария: исходные данные, действие и ожидаемый результат.
  • Примеры записей или файлов, с которыми должен работать модуль.
  • Доступ к админке и копии сайта. Доступ к серверу нужен, если задача затрагивает cron, очереди или файлы.
  • Сотрудник, который проверит результат со стороны вашего процесса.
  • Список обязательных ограничений: роли пользователей, расписание, формат хранения данных.

module --help

Вопросы о разработке

Можно доработать модуль из Маркетплейса?

Сначала смотрю его события и API. Если точки расширения есть, выношу логику в отдельный модуль. Прямые правки чужого кода могут пропасть при его обновлении.

Почему нельзя оставить весь код в init.php?

Для пары строк обработчика это допустимо. У отдельного модуля есть установщик, настройки, права и понятное место для кода, поэтому сопровождать его проще.

Что произойдёт с данными при удалении модуля?

Правила согласуем заранее. Таблицы и записи можно сохранить или удалить вместе с модулем; это отдельно проверяется на копии.

Модуль можно будет установить на другой сайт?

Да, если совпадают технические требования и не используются привязки к конкретному шаблону. Перенос данных и настроек оценивается отдельно.

После обновления Битрикса модуль продолжит работать?

Отсутствие правок ядра снижает риск конфликта, но совместимость зависит и от используемых API. Крупные обновления проверяют на копии перед рабочим сайтом.

mail zelenkindev

Обсудить модуль

Пишите — отвечу сразу.

  • MAX

    QR-код: https://max.ru/u/f9LHodD0cOKhBt_X5KaDCt4SgZkqN6JkUnj_2fzv5KGWZyBjRqqFa8wa36E
    Наведите камеру телефона
    Открыть в MAX
  • Telegram

    QR-код: https://t.me/zelenkins
    Наведите камеру телефона
    Открыть в Telegram

man zelenkindev

Горячие клавиши

/
поиск по модулям
?
эта справка
Esc
закрыть