Skip to main content
Version: Thelia 3

Reference documentation

Technical reference for Thelia's core systems.

Core systems​

Events​

Thelia uses Symfony's event dispatcher so modules can react to actions across the system. Events keep components decoupled from each other.

See the Events reference for the complete list of available events.

Forms​

Thelia's form system is built on Symfony Forms. It handles validation, CSRF protection, and template rendering.

See the Forms reference for form creation and handling.

Internationalization​

Thelia supports multiple languages and locales. This section covers how to translate your modules and templates.

See Internationalization for the i18n documentation.

Emails and PDF​

Transactional emails and order documents (invoice, delivery slip) are Twig themes rendered through the same parser as the rest of the site.

See Emails and PDF for the theme reference and the preview commands.

CLI commands​

Thelia provides console commands for common operations such as cache management, module handling, and database operations.

See the CLI reference for all available commands.

Quick reference​

TopicDescription
EventsSystem events and event listeners
FormsForm creation and validation
InternationalizationMulti-language support
Emails and PDFEmail and PDF Twig themes
CLI CommandsConsole commands

Legacy references​

These sections document the Smarty data layer kept for the transitional legacy back-office. Prefer API resources in new code.

TopicDescription
LoopsSmarty loop reference (legacy data layer)
Smarty PluginsSmarty plugins for the legacy back-office theme