Upgrade Guide¶
Mask tries to minimize breaking changes between each version. But sometimes small changes have to be done, which require actions to be performed.
From v6 or lower¶
When upgrading to v7 you might experience an error in the Mask module:
The requested resource "/module/tools/MaskMask" was not found.. This can be
fixed by clearing the browser cache (CTRL + F5). The error is caused by a
changed way of how the module is registered.
From v5 or lower¶
richtextConfiguration has to be removed¶
Because of a changed loading order
of the RTE configuration it is required to remove the richtextConfiguration entry from mask.json or else all of your
RTE fields will have the TYPO3 default RTE config set.
New in version 6.2.0.
Mask provides the UpgradeWizard RemoveRichtextConfiguration.php to remove all entries at once.
Important
This upgrade wizard is only available in Mask v6. The reason is that since v7 the richtext configuration can be edited in mask directly. If you are planning to update to v7, first update to v6, run the upgrade wizard and then continue updating to v7.
Command with TYPO3 CLI:
./typo3/sysext/core/bin/typo3 upgrade:run removeRichtextConfiguration
Or with typo3_console:
./typo3cms upgrade:run removeRichtextConfiguration
Another way is to go to the Upgrade module and open the Upgrade Wizard. There you will find Remove "richtextConfiguration" in mask.json.
Click on Execute to start the upgrade.
From v3 or lower¶
New template name format¶
Since version v4 Mask is based on the FLUIDTEMPLATE content object. This requires all template files to be named in UpperCamelCase.
Before: my_element.html
After: MyElement.html
New in version 6.2.0.
If you have a lot of templates you can rename them with the UpgradeWizard ConvertTemplatesToUppercase.php.
Command with TYPO3 CLI:
./typo3/sysext/core/bin/typo3 upgrade:run convertTemplatesToUppercase
Or with typo3_console:
./typo3cms upgrade:run convertTemplatesToUppercase
Another way is to go to the Upgrade module and open the Upgrade Wizard. There you will find Convert Mask templates to uppercase..
Click on Execute to start the upgrade.