The following is a list of recommended namespaces for various classes when developing within the Contao framework. None of these are mandatory though.
| Namespace | Resource |
|---|---|
App\ContaoManager | Contao Manager related classes (e.g. the Manager Plugin) |
App\Controller\ContentElement | Content element fragment controllers |
App\Controller\FrontendModule | Front end module fragment controllres |
App\Cron | Cron jobs |
App\EventListener | Symfony event listeners, Contao hooks & callbacks |
App\Model | Database models |
App\Widget | Form widgets |
As it is customary within the Symfony environment, classes of certain namespaces should also be named with a namespace specific suffix:
| Namespace | Suffix | Example |
|---|---|---|
App\Controller | Controller | App\Controller\ExampleController |
App\Cron | Cron | App\Cron\ExampleCron |
App\EventListener | Listener | App\EventListener\ExampleListener |
App\Model | Model | App\Model\ExampleModel |
| … | … | … |