Skip to content

Commit

Permalink
[DOCS] Add README
Browse files Browse the repository at this point in the history
  • Loading branch information
nhovratov committed Dec 20, 2024
1 parent d34f2ba commit 8496ecd
Showing 1 changed file with 33 additions and 0 deletions.
33 changes: 33 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Mask to Content Blocks migration

This TYPO3 extension helps you migrate your Mask elements on TYPO3 v13 to TYPO3 CMS Content Blocks, the official TYPO3
extension to define Content Types.

You need a running TYPO3 instance with your loaded Mask elements.

Install this extension via composer:

```
composer req nhovratov/mask-to-content-blocks
```

Then run the migration command. This migration will create the Content Blocks into the same extension, where your Mask
elements are currently loaded.

```
bin/typo3 mask-to-content-blocks:migrate
```

Next, remove Mask and this extension:

```
composer remove mask/mask nhovratov/mask-to-content-blocks
```

## Final steps

This migration command is no guarantee that everything will work perfectly. Check the generated Content Blocks by
yourself and see, if everything is fine. Also, any TypoScript overrides need migration from `lib.maskElement` to
`lib.contentBlock`. Test your frontend template and backend preview. They might need slight adjustments.

For more information, visit the manual migration guide in the Content Blocks documentation: https://docs.typo3.org/permalink/friendsoftypo3-content-blocks:migrations-mask

0 comments on commit 8496ecd

Please sign in to comment.