Skip to content

Исправить терминологию: заменить «контроллер» на «комплексный компонент» в разделе о наследовании шаблонов #67

@Trionikl

Description

@Trionikl

Заголовок:
Исправить терминологию: заменить «контроллер» на «комплексный компонент» в разделе о наследовании шаблонов

Описание:

На странице документации по компонентам используется устаревшая/неточная терминология, которая создаёт путаницу с современной архитектурой 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), то его шаблон сначала ищется в составе шаблона родительского компонента, а потом — в собственных шаблонах…»

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions