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

No one assigned

    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