Contao 4.13 Update Quick List

  1. On original site
    • Zip and download public_html folder (or just the necessary files)
    • Download database
    • look through all "domains" options to see if there are any special settings, domains, subdomains, mx records, etc...
    • in the contao Back end - lock out client users
  2. Setup new account in WHM  - client.brightcloudstudioserver.com
  3. Use Terminal to set the base url to web
    • ****** Step based on the following: https://andrewstevens.consulting/walk-throughs/install-contao-4.html. ****
  4. Go to brightcloud namecheap account and create A record to connect to temp domain in brightcloudstudioserver.com
  5. Open new site account
    1. Upload files to tmp folder
    2. update SSL/TSL Status - setup https for the domain
    3. use database wizzard to create new database and db user
    4. open phpmyadmin and upload old site database
    5. upgrade php to 8.1
  6. Install Contao and migrate files
    1. upload contao-manager.phar to public_html/web and change to contao-manager.phar.php
    2. navigate to the site/contao-manager.phar.php
    3. Create account
    4. run install
        • Server Configuration: You should point to the php binary for the version being used. We now use PHP 8.1, so the line would read “/opt/cpanel/ea-php81/root/usr/bin/php”.
        • Uncheck “Use the Composer Resolver Cloud” option. Our servers have enough memory.

          **NOTE** - Sometimes you don't have enough time to change the option. Finish the install and then can change this in the following file:

          /public_html/contao-manager/manager.json

          Add the following

          "php_cli": "\/opt\/cpanel\/ea-php81\/root\/usr\/bin\/php",
          "disable_cloud": true

    5. link database, **don't update DB yet!**
    6. migrate the following:
      1. Files
      2. Templates
      3. Isotope images (if applicable)
      4. public_html/system/config/localconfig.php
      5. parts of public_html/web/.htaccess -> just any site specific redirects, and add in the url_suffix redirect (info here)
        • RewriteCond %{REQUEST_FILENAME} !-f
          RewriteCond %{REQUEST_FILENAME} !-d
          RewriteRule ^(.*)\.html$ /$1 [L,R=301]
    7. Create the following:
      1. public_html/config/config.yml
        • contao:
          url_suffix: ''
          image:
          imagine_service: 'contao.image.imagine.gd'
        • Image info and url info
    8. Install Modules from Contao Manager
      1. Review public_html/composer.json on the original site
        1. Add leads if not there
      2. Use Contao Manager to install the non custom modules
      3. Update public_html/composer.json with custom module code (Info Here)
      4. Refresh Contao manager and apply updates
    9. update database using the contao install tool or maintenance -> database migrator
    10. maintenance -> rebuild production cache
    11. contao Back end
      1. update templates
        1. fe_page -> be sure to add back in "<?= $this->jsonLdScripts ?>" at the bottom so that the page search crawl will work
    12. maintenance -> purge Data
    13. maintenance -> Update the search index -> Start Crawl
    14. Setup Leads with contact form (if applicable)
    15. Unlock Client users
    16. Review Site
    17. Review error log public_html/var/logs
  7. Make site live
    1. In Cpanel, update any subdomains, dns, domains, etc..
    2. Make sure any site specific redirects in public_html/web/.htaccess have been updated (info here) - (should have been done above)
    3. if the old site is on the same server as the new:
      1. In WHM update the old site url to something else
      2. In WHM Update the new site to the correct url
      3. Cpanel - Resetup SSL Certificate
      4. Contao back end
        1. check that you are on correct site by seeing the version at the bottom (4.14)
        2. maintenance -> purge Data
        3. maintenance -> Update the search index -> Start Crawl
    4. if the old site is on a different server than the new:
      1. In WHM Update the new site to the correct url
      2. Go to clients DNS and update the A Record
      3. Cpanel - Resetup SSL Certificate
      4. Contao back end
        1. check that you are on correct site by seeing the version at the bottom (4.14)
        2. maintenance -> purge Data
        3. maintenance -> Update the search index -> Start Crawl
  8. Double check site
    1. be sure to verify that the .html redirect is working