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)
• Remove old project entirely
• Paste in updated files
• Follow setup instructions from docs/setup
• Transfer text/media content from backup to new project manually

Option 2 - Replace only files that have changed

• Backup content (do not skip this step)
• Copy files from new release to current project EXCEPT:
  • content/* (do not replace)
  • site/accounts/* (do not replace)
• Copy documentation from new release to current project:
  • content/docs/*
• If update is minor release then everything should work as usual
• If update is major release then some settings may be reset and some content may be turned off
• To fix reset settings:
  • Open local file site/config/config.php and configure following new docs
  • 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
  • Login to panel localhost:8000/panel
  • Review settings in all pages and save
  • Some shortcodes might have changed, see docs/shortcodes
  • All pages must be reviewed manually to check for changes in settings
• Deploy to production