How do I upgrade/update to the latest CMSimple_XH version?

[meister50]

Hello Community,

a German translation is available: Wie kann ich auf das neuste CMSimple_XH upgraden/updaten?

Update: if you're already running a CMSimple_XH version with the same minor version number (e.g. 1.5.1 -> 1.5.3), the update is usually pretty easy (note that the upgrade to CMSimple_XH 1.5.4 is slightly less simple):

1. make a backup of your website
2. download the update package for this minor version, unzip it, and upload all files to your server
3. check, if everything works as it should

Some update packages install newer versions of jQuery4CMSimple. These will overwrite the existing plugin config.php to cater for the new version numbers of the jQuery/jQueryUI files. If you have "autoload" enabled, you have to set that again after the update.

Upgrade: if you're running an older version, things are not as straight forward, particularly if you're running a version, that's not UTF-8 encoded (typically all versions before CMSimple_XH 1.2, as well as CMSimple "classic", CMSimple SE, CMSimple LE):

1. install the new version in a test environment (on your local machine or in a subfolder of your webspace)
2. copy the content/ folder, secondary language folders, the template(s), the plugins and all images and downloads from your old installation to the new one. If your old version didn't have pagedata.php files, delete these files from the new version.
3. manually reconfigure Settings->CMS and Settings->Website and redo any modifications you've made under Settings->Language (to ease this step you can use the language and config defaults)
4. if Settings->Language->Meta->Codepage is not equal to 'utf-8', make it so, install Utf8migrator_XH and use it to convert all files to UTF-8 (it's important to specify the current encoding of the files!).
5. thoroughly check the site -- if you're lucky, and everything works as it should, you just can replace the old site with the new one (but anyway: keep a backup of the old site!)

Troubleshooting:

• links to CMSimple pages don't work anymore: that's probably caused by non ASCII characters in the page heading, which are encoded differently for ANSI resp. UTF-8. How to keep the old links working, is described in the XH wiki.
• A plugin doesn't work as it should: some plugins don't reliably work with UTF-8 encoding (e.g. Genizforum). It's probably best to replace those plugins with UTF-8 encoded alternatives. If this is not possible, try to contact the plugin's author for help, or ask here in the forum

Any comments and additions are welcome!

Christoph

Thanks. This is very helpful. Appreciate it!

Angie

[roze]

I have the version:

CMSimple_XH 1.5.3 Released: 2012-03-19

And I want to update to the latest version CMSimple_XH 1.6.5

Can I use this update: CMSimple_XH-1.6.5.zip 2015-01-26 2.5 MB

[cmb]

CMSimple_XH 1.5.3 Released: 2012-03-19

And I want to update to the latest version CMSimple_XH 1.6.5

Can I use this update: CMSimple_XH-1.6.5.zip 2015-01-26 2.5 MB

Not in the sense that you can simply upload it over an existing installation. You have to do an upgrade (aka. migration) as described in http://cmsimpleforum.com/viewtopic.php?f=4&t=4868 (section "Upgrading from an earlier UTF-8 encoded CMSimple_XH version"). You can use -1.6.5.zip instead of the mentioned -1.6.zip.

[roze]

thanx