-
Notifications
You must be signed in to change notification settings - Fork 18
Description
Заголовок:
Исправить терминологию: заменить «контроллер» на «комплексный компонент» в разделе о наследовании шаблонов
Описание:
На странице документации по компонентам используется устаревшая/неточная терминология, которая создаёт путаницу с современной архитектурой D7.
URL: https://docs.1c-bitrix.ru/pages/framework/components.html
Цитата:
«Если компонент вызывается в составе контроллера, то его шаблон сначала ищется в составе шаблона контроллера, а потом — в собственных шаблонах…»
Проблема:
В современном Битрикс термин «контроллер» (Controller) зарезервирован под классы \Bitrix\Main\Engine\Controller (MVC-контроллеры для ajax/endpoints), тогда как в цитированном тексте речь идёт о комплексном компоненте (complex component, например bitrix:catalog, bitrix:news), который выступает родителем для простых компонентов.
Это приводит к недопониманию:
- Разработчики ищут информацию про Controller (PHP-классы), а находят описание механизма
IncludeComponentс 4-м параметром$component. - Терминология противоречит официальному словарю ядра D7, где родительский объект компонента называется
parentComponent.
Предлагаемое решение:
Заменить слово «контроллер» на «комплексный компонент» или «родительский компонент» во всём разделе.
Пример исправленного текста:
«Если компонент вызывается в составе комплексного компонента (complex component), то его шаблон сначала ищется в составе шаблона родительского компонента, а потом — в собственных шаблонах…»