Update

Notes

• Kirby does not provide a standard process to update themes
• There are two ways to update a theme
  • Replace all files
  • Replace only files that have changed
• Both options are manual
• Critical changes are introduced by the following files
  • site/kirby/*
  • site/blueprints/*
• If any of these files change some settings will be reset
• Critical changes are usually introduced as major releases

Option 1 - Replace all files

• Backup content (do not skip this step)
• Replace all files from old project with files from new release
• Follow instructions from docs/setup
• Populate content again manually

Option 2 - Replace only files that have changed

• Backup content
• Copy files from new release to project directory EXCEPT:
  • /content/ (do not replace)
  • /site/accounts/ (do not replace)
• Copy documentation from new release to project directory:
  • /content/docs/
• If the new release is a minor change everything should work as usual
• If the new release is a major change some settings will be lost and some content may not be visible
• To fix lost settings:
  • Open local file /site/config/config.php and configure again
  • If previous version lacked multi-language support
    • Open local directory /content/*
      • Add language code to all content files default.en.txt (use default language)
      • Add language code to all media files image.jpg.en.txt (use default language)
      • Default language is set at site/config/config.php
  • Start a local development server
  • Launch browser and login via "localhost:8000/panel"
  • Review settings in all pages and save
  • Some shortcodes might have changed, see /docs/shortcodes
  • All pages must be reviewed manually
• Deploy to production