Skip to content

Naming Conventions

Это перевод английского документа docs/naming-conventions.md. Английская версия является source of truth. Если перевод противоречит английскому документу, английский документ имеет приоритет.

Проект следует каноническим OpenCart naming conventions, если architecture review явно не одобрил отклонение.

Theme Directory

Имя директории темы:

shop3

Канонический OpenCart path:

catalog/view/theme/shop3/

Custom Prefix

Custom project entities используют prefix:

shop3_

Не использовать слитные имена:

  • shop3latest
  • shop3checkout
  • shop3banner

Использовать underscore-separated names:

  • shop3_latest
  • shop3_checkout
  • shop3_banner

Applies To

Prefix shop3_ применяется к custom:

  • controllers;
  • modules;
  • routes;
  • config keys;
  • language keys;
  • settings;
  • helper names;
  • future extensions.

Canonical Examples

Route:

extension/module/shop3_latest

Controller file:

catalog/controller/extension/module/shop3_latest.php

Controller class:

ControllerExtensionModuleShop3Latest

Language key:

module_shop3_latest_status

Config key:

module_shop3_latest_status

Twig template:

shop3_latest.twig

Review Notes

Если implementation вводит non-canonical naming, unnecessary abstraction, architecture drift или unsafe OpenCart practice, это нужно фиксировать в PR Notes или OPS Notes и предпочитать canonical OpenCart approach.