Migration from 7.x to 8.x

TV+ v8 uses files for all configurations. So you can use your VCS (version control system) to manage changes, to deploy your configuration and so on. Also theming related things aren’t inside DataStructure anymore. We have now different configuration files for every part from data to template configuration. Every part have his own place (directory) where it lies. So you will have the possibility to use a base theme which you extend with your own theme without redefining the data structure or the mapping.

Important

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

Steps to do for migration

  1. Backup your database and files!
  2. Update your TemplaVoilà! Plus (TV+) installation
  3. Go to the new TV+ Control Center which will be inside the “Admin Tools” section
  4. Press the yellow “Start Update Script” button
  5. Press the “Update configuration to TemplaVoilà! Plus 8” button
  6. Follow the migration process
  7. You are done, check the generated extension and its files, put them into your VCS
  8. Update your TypoScript userFunc entry (main_page to renderPage)
page = PAGE
page {
    typeNum = 0
    10 = USER
    10.userFunc = Tvp\TemplaVoilaPlus\Controller\Frontend\FrontendController->renderPage
}

Server migration

While running the migration and creating your theme extension a file called “ServerMigration.json”, residing inside the folder Configuration/TVP of your theme, was generated. It includes informations on how the server database needs to migrated to use this theme (updating the TV+ fields inside pages and tt_content table). So you do not need to run the complete migration process on server again. After you migrate all testing/staging/production servers you can remove this file.

  1. Backup your database and files!
  2. Run your deployment process.
  3. Go to the new TV+ Control Center which will be inside the “Admin Tools” section
  4. Press the yellow “Start Update Script” button
  5. Press the yellow “Server Migration” button
  6. Follow the short instructions
  7. You are done, if you have TypoScript inside database do not forgett to update it on server

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