DEPRECATION WARNING

This documentation is not using the current rendering mechanism and will be deleted by December 31st, 2020. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Migration from TemplaVoilà! 1.8/1.9/2.0 to TemplaVoilà! Plus 7.x

In short, it is very simple to migrate from old TemplaVoilà! to TemplaVoilà! Plus. You can do it after you migrated from TYPO3 6.2 LTS to the newer TYPO3 v7 LTS or TYPO3 v8 LTS, but without droping the tables.

Important

Do backups as the “Plus” may eat all your database tables and files.

Steps to work

  1. Backup your database and files!
  2. Deactivate old TemplaVoilà! in Extension Manager but do not remove it yet neither its database tables
  3. Install and Activate TemplaVoilà! Plus from TYPO3 Extension Repository (TER)
  4. Press the Update Button in Extension manager for the TemplaVoilà! Plus extension
  5. Press the “Migrate TemplaVoilà 1.8/1.9/2.0” Button
  6. Start the migration process
  7. Wait a while, till it finishes, it may take a long time on bigger systems
  8. After this was done you may need to do the same with the “Update DataStructure from TYPO3 v6.2 LTS to v7 LTS”
  9. (This Update script has a own version number, you may recheck it from time to time, you can run it as often you like)
  10. After this was done and you are using TYPO3 v7 LTS you may need to do the same with the “Update DataStructure from TYPO3 v7 LTS to v8 LTS”
  11. (This Update script has a own version number, you may recheck it from time to time, you can run it as often you like)
  12. Do _not_ run the “Convert to Static Data Structure” task, if you don’t know what it will do. It isn’t needed for updating to TemplaVoilà! Plus
  13. Now the automatic part is done
  14. Look now through all your TypoScript scripts and replace all occurences of tx_templavoila with tx_templavoilaplus
  15. You may also switch your PAGE object definition to
page = PAGE
page {
    typeNum = 0
    10 = USER
    10.userFunc = Ppi\TemplaVoilaPlus\Controller\FrontendController->main_page
}

Now your system should be ready. If all works you can remove the old TemplaVoilà! extension and its database tables from your system. If you have issues, ask on slack channel or on github