Документация по компонентам не содержит информации о размещении в /local/components/ #69
Description
Описание проблемы
На странице Размещение компонента отсутствует критически важная информация о возможности размещения пользовательских компонентов в папке /local/components/.
Чего не хватает
В разделе «Размещение компонента» указаны только стандартные пути ядра (/bitrix/components/), но не упомянута папка /local/components/, которая с версии главного модуля 14.0.1 (2014 г.) является рекомендуемым местом для компонентов сторонних разработчиков.
Почему это важно
Приоритет загрузки: При обработке папок у /local всегда приоритет выше, чем у /bitrix/
Сохранность при обновлениях: Компоненты в /local/ не затираются при обновлении системы
Стандарт разработки: Это современный стандарт для пользовательских компонентов (namespace-разработка)
Предлагаемое дополнение
Добавить раздел о размещении в /local/components/ с примером структуры:
Text
Copy
/local/components/test.aira/mycomponent/
├── component.php (или class.php)
├── .parameters.php
├── .description.php
└── templates/
└── .default/
└── template.php
Источники
В старой документации эта информация есть:
Размещение в системе и подключение компонента
Папка /local
Ожидаемый результат
Раздел о размещении компонентов должен содержать информацию о:
/local/components/ как рекомендуемом пути для собственных компонентов
Пространствах имён (namespace) для компонентов в /local/
Приоритете загрузки /local/ над /bitrix/