thelia/backoffice-default-template

There is no license information available for the latest version (2.6.2) of this package.

Legacy Smarty back-office template for Thelia

2.6.2 2026-08-12 14:33 UTC

Requires

• thelia/installer: ~1.1

Unknown License

Published on Packagist.org on 2026-08-14 08:12 UTC

README

Legacy Smarty back-office template for Thelia, historically named "default". It is kept for compatibility with existing installs and third-party modules that still ship Smarty admin templates.

The default back office of Thelia 3 is now thelia/backoffice-default-twig-template. Use this package only if you need the Smarty admin.

It ships both the Smarty templates (*.html, *.tpl, hooks, assets) and the PHP back-office bundle hosting the legacy admin controllers, forms, routing and form registry.

What this package provides

templates/backOffice/default/
├── BackOfficeDefaultBundle.php           Symfony bundle entry point
├── Routing/                              Custom route loader (#[Route] scanning)
├── DependencyInjection/Compiler/         CompilerPass merging admin forms
├── Controller/Admin/                     46 legacy admin controllers (Thelia\Controller\Admin\*)
├── Form/                                 100+ admin forms (Thelia\Form\*)
├── Config/Resources/
│   ├── routing/admin.xml                 334 legacy /admin/* routes
│   └── parameters/forms_admin.php        119 admin form registry entries
├── *.html, *.tpl, admin-layout.tpl, …    Smarty templates
├── assets/, components/, I18n/, …

Why these PHP classes live here

The admin controllers and forms used to live in core/lib/Thelia/Controller/Admin/ and core/lib/Thelia/Form/. Moving them to the back-office template package decouples the core from the legacy Smarty admin layer while keeping third-party modules working: the namespaces Thelia\Controller\Admin\* and Thelia\Form\* are preserved through Composer PSR-4 path mapping.

Activation

The bundle activates automatically when:

1. The package is installed (composer require thelia/backoffice-default-template).
2. The bundle is registered in config/bundles.php (handled by the Flex recipe in thelia/thelia-recipes).
3. The application's config/routes.yaml imports the bundle's attribute routes:

   bo_default_admin_attributes:
       resource: .
       type: bo_default_attribute

   This entry is also installed by the Flex recipe.

The admin form registry (Thelia.parser.forms) is merged with the bundle's admin entries only when active-admin-template equals default (DB config). This means third-party admin templates (e.g. default-twig) can coexist without registry collision.

Compatibility

• The Thelia\Form\BaseForm, FormInterface, EmptyForm, Exception\, Definition\AdminForm, Definition\FrontForm, Image\ and all front forms remain in the core, since 87 % of third-party modules inherit BaseForm and the Selection module inherits Form\Image\ImageModification.
• The Thelia\Controller\Admin\BaseAdminController, AbstractCrudController, AbstractSeoCrudController, AdminController remain in the core for the same reason (~80 % of modules inherit from one of them, and AdminController is inherited by BetterSeo, ColissimoLabel, SEOne).

Maintenance

• Adding or removing an admin form: update Config/Resources/parameters/forms_admin.php.
• Adding or removing an admin route: update Config/Resources/routing/admin.xml or use #[Route] on the controller and let BackOfficeDefaultAttributeLoader pick it up.
• Adding or removing an admin controller: drop the file in Controller/Admin/ (PSR-4 will pick it up via Thelia\Controller\Admin\* mapping).

PHPStan and php-cs-fixer scan this directory like any other PHP source.

Upgrade notes

From a pre-0.1 Thelia 3 install

Early Thelia 3 installs (before this package was tagged 0.1.0) shipped the back-office attribute route loader entry directly inside config/routes.yaml:

bo_default_admin_attributes:
    resource: .
    type: bo_default_attribute

Starting with 0.1.0, the Flex recipe installs the same entry under config/routes/bo_default.yaml instead. If both files exist after upgrading, Symfony will throw a 500 at boot time:

Do not add the "bo_default_attribute" loader twice in . (which is being imported from "config/routes.yaml").

The fix is to delete the stale legacy entry. Either remove config/routes.yaml entirely if it only contained that block, or strip just the bo_default_admin_attributes key if you have other top-level routes there.