Skip to main content
page last edited on 5 October 2022

Directory structure

Version: 5.5.0

Generally, we strive to adhere to the Symfony directory structure.

Additional directories:

  • assets - regular location for resources storage with a specific folder structure inside;
  • classes - the core code for code generation (see Modules system);
  • docs - support documentation, changelog;
  • Includes - shared code (legacy);
  • lib - libraries (legacy);
  • modules - add-ons code (see [Modules system);
  • service-tool - internal app for the X-Cart maintenance (add-ons installation and de-installation, updates, etc.);
  • sql - basic data for installation;
  • templates - regular location for templates storage with a specific folder structure inside.

Assets и Templates

Assets and templates are divided into zones and interfaces. Generally, there are three interfaces (web, mail, pdf) and two zones (admin and customer). The common zone is a parent for all other zones. The mail and pdf zones override the web zone.

[todo перенести в отдельный док, это слишком подробная информация для этого раздела]

The general assets and templates folder structure:

{assets,templates}/
web/
admin/
common/
customer/
mail/
admin/
common/
customer/
pdf/
admin/
common/
customer/

If you need to find, e.g., the body.twig template for the webinterface and admin zone, the search order will be as follows:

  • templates/web/admin/body.twig
  • templates/web/common/body.twig

If you need to find the body.twig template for the mailinterface and admin zone, the search order will be as follows:

  • templates/mail/admin/body.twig
  • templates/mail/common/body.twig
  • templates/web/common/body.twig

The search will also be done through the resources’ and add-on templates’ paths in the following way. First, it will search through the skin add-ons following the skin inheritance, then through the rest of the add-ons taking dependencies into account, and the last in the core.

Suppose you have two skins (XCExample-SkinChild and XCExample-SkinParent) and two add-ons (XCExample-Module1 and XCExample-Module2). The search for the body.twig template for the mail interface and admin zone, in this case, will be done as follows:

  • modules/XCExample/SkinChild/templates/mail/admin/body.twig
  • modules/XCExample/SkinParent/templates/mail/admin/body.twig
  • modules/XCExample/Module2/templates/mail/admin/body.twig
  • modules/XCExample/Module1/templates/mail/admin/body.twig
  • templates/mail/admin/body.twig
  • modules/XCExample/SkinChild/templates/mail/common/body.twig
  • modules/XCExample/SkinParent/templates/mail/common/body.twig
  • modules/XCExample/Module2/templates/mail/common/body.twig
  • modules/XCExample/Module1/templates/mail/common/body.twig
  • templates/mail/common/body.twig
  • modules/XCExample/SkinChild/templates/web/common/body.twig
  • modules/XCExample/SkinParent/templates/web/common/body.twig
  • modules/XCExample/Module2/templates/web/common/body.twig
  • modules/XCExample/Module1/templates/web/common/body.twig
  • templates/web/common/body.twig