Create your own content elements and page templates. Easy to use, even without programming skills, because of the comfortable drag and drop user interface. All content is stored in structured database tables.
Mask is a TYPO3 extension for creating content elements and extending page templates. It’s possible to add new fields to any element. Fields can have several types, for example: text, file, relations, rich text, ...
Download Mask with composer by running the command composer require mask/mask or install via extension manager.
It is important to add Mask as a dependency in your ext_emconf.php and/or composer.json, so you can override the
generated TCA. Before you start using Mask, you must define various paths. Add the snippet below to your
LocalConfiguration.php in the EXTENSIONS section:
'mask' => [
'loader_identifier' => 'json',
'backend' => 'EXT:sitepackage/Resources/Private/Mask/Backend/Templates/',
'backendlayout_pids' => '0,1',
'content' => 'EXT:sitepackage/Resources/Private/Mask/Frontend/Templates/',
'json' => 'EXT:sitepackage/Configuration/Mask/mask.json',
'content_elements_folder' => 'EXT:sitepackage/Configuration/Mask/ContentElements',
'backend_layouts_folder' => 'EXT:sitepackage/Configuration/Mask/BackendLayouts',
'layouts' => 'EXT:sitepackage/Resources/Private/Mask/Frontend/Layouts/',
'layouts_backend' => 'EXT:sitepackage/Resources/Private/Mask/Backend/Layouts/',
'partials' => 'EXT:sitepackage/Resources/Private/Mask/Frontend/Partials/',
'partials_backend' => 'EXT:sitepackage/Resources/Private/Mask/Backend/Partials/',
'preview' => 'EXT:sitepackage/Resources/Public/Mask/',
],
Adjust the paths to your sitepackage extension and activate Mask. When you visit the Mask backend, you will have the option to create all missing files and folders defined here. This is also great to have in version control so others will have this already set up when checking out.
Alternatively, leave the configuration empty and visit the Mask module. There will be an Auto-Configuration form, that will generate all the above configuration for you automatically, if you provide a key of a loaded extension.
Mask requires fluid_styled_content so go to your static includes in the template module and include it there.
After that also include the Mask static TypoScript.
That's it. Now you can start creating your own content elements!
| Mask Version | TYPO3 Version | Release Date | Status | More Info |
|---|---|---|---|---|
| v7.1 | v10, v11 | 2021-12-14 | regular maintenance | JsonSplitLoader, new API |
| v7.0 | v10, v11 | 2021-05-12 | discontinued | VueJS based Mask Backend |
| v6 | v10, v11.1 | 2020-10-08 | critical bugfixes | Palettes, Groups and more |
| v5 | v10 | 2020-04-18 | discontinued | Please update to v7 |
| v4 | v9 | 2018-10-04 | discontinued | |
| v3 | v8 | 2017-05-23 | discontinued | |
| v2 | v7 | 2016-05-10 | discontinued | |
| v1 | v6, v7 | 2015-08-12 | discontinued |
- Mask stores the content in columns in database tables – not as XML (Flexform)
- Mask reuses existing database fields to conserve the database
- Mask works only with existing features of the TYPO3 core: backend layouts, Fluid, TypoScript
- Silent TCA migrations allow for easy TYPO3 upgrades to new major versions
- Mask allows repeating content with IRRE technology
- Mask supports multi-language projects
- Mask supports workspaces and versioning
- The Mask backend is a single page application based on VueJS for even more comfort
- Read how to install, configure and use mask in the official documentation
- Join the "#ext-mask" channel on TYPO3 Slack and ask the mask community.
- Visit our website to find more information about mask
- First check out the master branch and verify that the issue is not yet solved
- Have a look at the existing issues, to prevent duplicates
- If not found, report the bug in our issue tracker