Wiki source for Installing136
===== Installation and upgrade notes for Wikka 1.3.6 =====
These are instructions you should follow if you wish to upgrade an existing wiki running on Wikka 1.2 or earlier to 1.3.6. If you are installing Wikka for the first time, please refer to [[WikkaInstallation | this page]] instead.
""<div style="float:left; margin: 20px 0; padding: 0 15px 10px 15px; width:97%; background-color:#FEE; border:1px solid #EDD">
<h3>Important notes</h3>
<b>Requirements</b><br/>
This release has been tested with MySQL 5.5 and PHP 5.4. Please note that if you are using a version of PHP < 5.4, breadcrumbs must be disabled (<tt>'enable_breadrumbs' => '0'</tt> in <tt>wikka.config.php</tt>).
<p><p>
<b>Upgrading from 1.1.x to 1.3.6</b><br/>
As of 1.2, WikkaWiki incorporates new support for modularized themes. A new file hierarchy has been introduced, and the old <tt>css/</tt> directory is going away. <strong>It is imperative that you make a backup of your <tt>css/</tt> and <tt>templates/</tt> directory BEFORE attempting to upgrade, if you have customized your site theme!</strong> Failure to do so will most likely result in a loss of part or all of your theme changes. <em>It's always good practice to back up both your Wikka install directory and your database prior to any upgrades.</em>
<p><p>
Since 1.1.6.6 WikkaWiki has supported a <tt>plugins/</tt> directory that is guaranteed not to be modified by the installer/updater. While it's important to backup any customized themes or actions, you should really be putting these into the <tt>plugins/</tt> directory.
<p><p>
<b>Upgrading from 1.2 to 1.3.6</b><br/>
Some CSS changes have been made to the themes, so as always, please make a backup of your <tt>default</tt>, <tt>light</tt>, and/or <tt>kubric</tt> themes if you have customized them.
<p><p>
Also, the 1.3.6 installer now backs up the standard installed files in <tt>config/</tt>, as these have changed significantly. If you have modified your menus, you will have to manually merge your changes into the new installed <tt>config/</tt> files.
</div>""
>>==See also:==
~-[[WhatsNew136 | What's new in 1.3.6]]
~-[[Changelog | Changelog for 1.3.6]]
~- [[InstallingPlugins | How to use the plugins folder]]
>>Users running previous versions of Wikka are recommended to **[[UpgradeNotes | upgrade]]** or **[[WikkaInstallation | install a fresh package]]**. [[UpgradeNotes | Upgrading]] via the web-based wizard takes only a few minutes.
====Upgrading from 1.1.6.7 or earlier====
Significant changes were made in 1.2, so you're advised to scan through the [[Installing12 | 1.2 installation notes]] prior to upgrading. **Please be sure to read the important upgrade notice at the top of this page before proceeding.**
====Upgrading from 1.2====
To upgrade from a previous 1.2 or earlier install, simply overwrite all existing files from the installation with a fresh [[WhatsNew12 | 1.2 download]]. The upgrader will be invoked so you can verify existing DB and/or config settings. **Please be sure to read the important upgrade notice at the top of this page before proceeding.**
====Feedback====
We have moved our repository and issues tracker to github. Links to the previous SVN repository and tracker will at some point fail to resolve. Feedback on potential issues related to upgrading from previous versions is always welcome. Please report any bug, issue or feature suggestion for 1.3.6 in the [[https://github.com/wikkawik/WikkaWiki/issues | issues tracker]].
----
CategoryEN
These are instructions you should follow if you wish to upgrade an existing wiki running on Wikka 1.2 or earlier to 1.3.6. If you are installing Wikka for the first time, please refer to [[WikkaInstallation | this page]] instead.
""<div style="float:left; margin: 20px 0; padding: 0 15px 10px 15px; width:97%; background-color:#FEE; border:1px solid #EDD">
<h3>Important notes</h3>
<b>Requirements</b><br/>
This release has been tested with MySQL 5.5 and PHP 5.4. Please note that if you are using a version of PHP < 5.4, breadcrumbs must be disabled (<tt>'enable_breadrumbs' => '0'</tt> in <tt>wikka.config.php</tt>).
<p><p>
<b>Upgrading from 1.1.x to 1.3.6</b><br/>
As of 1.2, WikkaWiki incorporates new support for modularized themes. A new file hierarchy has been introduced, and the old <tt>css/</tt> directory is going away. <strong>It is imperative that you make a backup of your <tt>css/</tt> and <tt>templates/</tt> directory BEFORE attempting to upgrade, if you have customized your site theme!</strong> Failure to do so will most likely result in a loss of part or all of your theme changes. <em>It's always good practice to back up both your Wikka install directory and your database prior to any upgrades.</em>
<p><p>
Since 1.1.6.6 WikkaWiki has supported a <tt>plugins/</tt> directory that is guaranteed not to be modified by the installer/updater. While it's important to backup any customized themes or actions, you should really be putting these into the <tt>plugins/</tt> directory.
<p><p>
<b>Upgrading from 1.2 to 1.3.6</b><br/>
Some CSS changes have been made to the themes, so as always, please make a backup of your <tt>default</tt>, <tt>light</tt>, and/or <tt>kubric</tt> themes if you have customized them.
<p><p>
Also, the 1.3.6 installer now backs up the standard installed files in <tt>config/</tt>, as these have changed significantly. If you have modified your menus, you will have to manually merge your changes into the new installed <tt>config/</tt> files.
</div>""
>>==See also:==
~-[[WhatsNew136 | What's new in 1.3.6]]
~-[[Changelog | Changelog for 1.3.6]]
~- [[InstallingPlugins | How to use the plugins folder]]
>>Users running previous versions of Wikka are recommended to **[[UpgradeNotes | upgrade]]** or **[[WikkaInstallation | install a fresh package]]**. [[UpgradeNotes | Upgrading]] via the web-based wizard takes only a few minutes.
====Upgrading from 1.1.6.7 or earlier====
Significant changes were made in 1.2, so you're advised to scan through the [[Installing12 | 1.2 installation notes]] prior to upgrading. **Please be sure to read the important upgrade notice at the top of this page before proceeding.**
====Upgrading from 1.2====
To upgrade from a previous 1.2 or earlier install, simply overwrite all existing files from the installation with a fresh [[WhatsNew12 | 1.2 download]]. The upgrader will be invoked so you can verify existing DB and/or config settings. **Please be sure to read the important upgrade notice at the top of this page before proceeding.**
====Feedback====
We have moved our repository and issues tracker to github. Links to the previous SVN repository and tracker will at some point fail to resolve. Feedback on potential issues related to upgrading from previous versions is always welcome. Please report any bug, issue or feature suggestion for 1.3.6 in the [[https://github.com/wikkawik/WikkaWiki/issues | issues tracker]].
----
CategoryEN
