[2220] Latest edit on
2011-03-17 09:49:29 by
BrianKoontz [updated for 1.3.1]
Additions:
Significant changes were made in 1.2, so you're advised to scan through the 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
Deletions:
Significant changes were made in 1.2, so you're advised to scan through the 1.2 installation notes prior to upgrading.
Upgrading from 1.2 or earlier
Additions:
<b>Upgrading from 1.1.x to 1.3.1</b><br/>
Deletions:
<b>Upgrading from 1.1.x to 1.3.1<b><br/>
Additions:
<b>Upgrading from 1.1.x to 1.3.1<b><br/>
<p><p>
<b>Upgrading from 1.2 to 1.3.1</b><br/>
Deletions:
Upgrading from 1.1.x to 1.3.1
Upgrading from 1.2 to 1.3.1
Additions:
Installation and upgrade notes for Wikka 1.3.1
These are instructions you should follow if you wish to upgrade an existing wiki running on Wikka 1.2 or earlier to 1.3.1. If you are installing Wikka for the first time, please refer to this page instead.
<h3>Important notes</h3>
Upgrading from 1.1.x to 1.3.1
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>
Upgrading from 1.2 to 1.3.1
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.
Also, the 1.3.1 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.
Upgrading from 1.1.6.7 or earlier
Significant changes were made in 1.2, so you're advised to scan through the 1.2 installation notes prior to upgrading.
Upgrading from 1.2 or earlier
To upgrade from a previous 1.2 or earlier install, simply overwrite all existing files from the installation with a fresh 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 on potential issues related to upgrading from previous versions is always welcome. Please report any bug, issue or feature suggestion for 1.3.1 in the tracker.
Deletions:
Installation and upgrade notes for Wikka 1.2
These are instructions you should follow if you wish to upgrade an existing wiki running on Wikka 1.1.X to 1.2. If you are installing Wikka for the first time, please refer to this page instead.
<h3>Important note</h3>
This version of WikkaWiki incorporates new support for modularized themes. A new file hierarchy is being 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>
Upgrading from 1.1.6.7 or ealier
To upgrade from a previous 1.1.6.7 or earlier install, simply overwrite all existing files from the installation with a fresh 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.
1. Themes
Wikka 1.2 introduces support for themes. All files required by the default theme (including stylesheets) can now be found under templates/default.
After upgrading from 1.1.X, the legacy css/ directory will no longer be used by WikkaWiki. Provided you have saved anything of importance in that directory, you may safely delete the contents of this directory after upgrading.
2. Menus
A new menu/navigation system has been implemented. If you have customized your navigation links in your wikka.config.php file, the upgrader should convert these links to the new format. If for some reason the upgrade wizard does not convert your links correctly, you will need to manually adjust the menu items under the config/ directory. Navigation links are no longer maintained in wikka.config.php. Additional information on the new menu system can be found here.
3. Stylesheets
Wikka 1.2 uses a new, more flexible default page layout. If you wish to patch your 1.1.X stylesheet to work under 1.2, you should follow these conversion rules:
| 1.1.X | 1.2 | Notes |
|---|
n/a
| div#page | new wrapper introduced in 1.2 |
| div.header | div#header | replaced class with id |
n/a
| ul#main_menu | new style hook introduced in 1.2 |
| div.content | div#content | replaced class with id |
| div.footer | div#footer | replaced class with id |
n/a
| ul#options_menu | new style hook introduced in 1.2 |
n/a
| div#comments | new wrapper introduced in 1.2 |
| div.commentheader | div#commentheader | replaced class with id |
| div.commentform | div#commentform | replaced class with id |
| div.smallprint | div#smallprint | replaced class with id |
Further information on the default page template used as of 1.2 can be found
here.
Feedback on potential issues related to upgrading from previous versions is always welcome. Please report any bug, issue or feature suggestion for 1.2 in the tracker.
[2216] The oldest known version of this page was created on
2011-03-17 09:36:19 by
BrianKoontz [Cloned from Installing12]
Installation and upgrade notes for Wikka 1.2
These are instructions you should follow if you wish to upgrade an existing wiki running on Wikka 1.1.X to 1.2. If you are installing Wikka for the first time, please refer to
this page instead.
Important note
This version of WikkaWiki incorporates new support for modularized themes. A new file hierarchy is being introduced, and the old css/ directory is going away. It is imperative that you make a backup of your css/ and templates/ directory BEFORE attempting to upgrade, if you have customized your site theme! Failure to do so will most likely result in a loss of part or all of your theme changes. It's always good practice to back up both your Wikka install directory and your database prior to any upgrades.
Users running previous versions of Wikka are strongly recommended to
upgrade or
install a fresh package.
Upgrading via the web-based wizard takes only a few minutes.
Upgrading from 1.1.6.7 or ealier
To upgrade from a previous 1.1.6.7 or earlier install, simply overwrite all existing files from the installation with a fresh
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.
1. Themes
Wikka 1.2 introduces support for
themes. All files required by the default theme (including stylesheets) can now be found under
templates/default.
After upgrading from 1.1.X, the legacy
css/ directory will no longer be used by
WikkaWiki. Provided you have saved anything of importance in that directory, you may safely delete the contents of this directory after upgrading.
2. Menus
A new
menu/navigation system has been implemented. If you have customized your navigation links in your
wikka.config.php file, the upgrader should convert these links to the new format. If for some reason the upgrade wizard does not convert your links correctly, you will need to manually adjust the menu items under the
config/ directory. Navigation links are no longer maintained in
wikka.config.php. Additional information on the new menu system can be found
here.
3. Stylesheets
Wikka 1.2 uses a new, more flexible
default page layout. If you wish to patch your 1.1.X stylesheet to work under 1.2, you should follow these conversion rules:
| 1.1.X | 1.2 | Notes |
|---|
n/a
| div#page | new wrapper introduced in 1.2 |
| div.header | div#header | replaced class with id |
n/a
| ul#main_menu | new style hook introduced in 1.2 |
| div.content | div#content | replaced class with id |
| div.footer | div#footer | replaced class with id |
n/a
| ul#options_menu | new style hook introduced in 1.2 |
n/a
| div#comments | new wrapper introduced in 1.2 |
| div.commentheader | div#commentheader | replaced class with id |
| div.commentform | div#commentform | replaced class with id |
| div.smallprint | div#smallprint | replaced class with id |
Further information on the default page template used as of 1.2 can be found
here.
Feedback
Feedback on potential issues related to upgrading from previous versions is always welcome. Please report any bug, issue or feature suggestion for 1.2 in the
tracker.
CategoryEN
