Skip to content

UPGRADE-1.4.0.md

Latest commit

 

History

History
72 lines (60 loc) · 2.68 KB

UPGRADE-1.4.0.md

File metadata and controls

72 lines (60 loc) · 2.68 KB
Raw

Upgrading Zikula

  1. Introduction
  2. Requirements
  3. Test Environment
  4. Before upgrading
  5. Upgrading
  6. Notes
Introduction ------------ Zikula Core 1.4.0 introduces a lot of forward compatibility for new features that will come in Zikula 1.5.0.

For more information visit http://zikula.org/ and read our user manual.

Requirements ------------ Before upgrading Zikula it's important to ensure that the hosting server environment meets the requirements of the new core release. Zikula Core 1.4.0 has the following requirements
Minimum Recommended
PHP 5.3.3 5.5
Test Environment ---------------- The Zikula team strongly recommend having a duplicate testing environment of the live site in which all changes including upgrades are tested on before application to the live site. Before upgrading ---------------- Prior to any upgrade ensure that a reliable backup of all files and the database is taken.

Zikula makes use of composer to manage and download all dependencies. Composer must be run prior to installing a site using Zikula. Run composer self-update && composer update.

If you store Composer in the root of the Zikula Core checkout, please rename it from composer.phar to composer to avoid your IDE reading the package contents.

Upgrading --------- The following process should be followed for all upgrades even smaller point releases.
  • Before uploading the new files please delete the plugins/, lib/, system/, themes/ and ztemp/ folders entirely (replace any custom themes afterwards).
  • Delete your config/config.php and config/personal_config.php keeping a note of your database settings.
  • Upload new files.
  • Copy your newconfig/config.php and config/personal_config.php and update config/personal_config.php with your database settings.
  • Copy app/config/parameters.yml to app/config/custom_parameters.yml and update values with your database settings. Also set installed to true.
  • Make app/cache and app/logs writable.
  • Run http://yoursiteurl/upgrade.php and follow any on-screen prompts.
  • Go to the ExtensionsModule and install the ZikulaRoutesModule.
 Notes ----- - As of 1.4.0 `ztemp` is now located in the `app/cache//ztemp` location automatically.