If you've been using the Mask extension to create custom content elements in TYPO3, it's time to consider migrating to Content Blocks. This shift ensures your site remains compatible with future TYPO3 versions and respects to modern best practices.
.jpg)
Why Migrate?
Future Compatibility: Content Blocks are set to become an integral part of TYPO3's core, making them a sustainable choice.
Standardization: They offer a clean, standardized way to define content elements, enhancing site structure and maintainability.
Migration Options
Automatic Migration: Utilize the Mask to Content Blocks migration tool for a swift transition.
Manual Migration: For customized elements, manually recreate them using the Content Blocks extension.
Steps for Automatic Migration
1. Install Necessary Extensions:
composer require friendsoftypo3/content-blocks
composer require nhovratov/mask-to-content-blocks
2. Execute Migration Command:
bin/typo3 mask-to-content-blocks:migrate
3. Remove Unnecessary Extensions:
composer remove mask/mask nhovratov/mask-to-content-blocks
4. Test & Validate:
Ensure migrated elements work properly.
Steps for Manual Migration
1. Install Content Blocks:
composer require friendsoftypo3/content-blocks
2. Create a New Content Block:
bin/typo3 content-blocks:make your_theme/element_name
3. Match CType & Field Prefix:
Align with Mask settings for smooth transition.
4. Move Templates & Configurations:
Transfer Fluid templates & setup.
5. Final Testing:
Verify everything works as expected.
Conclusion
Migrating from Mask to Content Blocks modernizes your TYPO3 setup, ensuring long-term compatibility. Use the automatic method for ease or manual for full control.