Updating Qwwwik
Current version: 2.4
Updating Qwwwik is short and sweet. Follow these instructions:
Backup before updating
Backup first. If your server supports ZIP archiving, admin backup provides a utility to ZIP your content files for download to your hard drive. Otherwise they can be backed up by downloading them via FTP. It's just a precaution.
The principle is that none of the content files you have created in making the website are in the new version (or any version). A version update only replaces the original 'system' files in the previous version. As long as you upload files only, not folders, your content files, images, style sheets etc, remain untouched.
To update, do ALL of (1) to (5):
(1) Download
Unzip the ZIP file qwwwik.zip to your hard drive [ enquire ]. It contains a folder named cms which is effectively the website's 'root' folder and is where the folders and files are.
(2) Logout
If you haven't already, logout of admin.
(3) Upload
Do not upload ANY folder, only files.
Upload ALL the files in every folder in the new version, including all the files directly in the cms folder.
The only exceptions are if you have edited yourself a corresponding file, like, for example /inc/tracking.php, in which case don't upload the new version but check to see if your version needs editing, then upload it.
(4) Re-install and setup
To avoid the risk of downtime, immediately after you have uploaded all the files, go to /admin/install.php and install – the same process as the original installation. Then Submit setup. This is important: it verifies the update and updates the settings file. You don't need to change the password (unless you want to) and won't lose any content, but backup first anyway.
After updating and running install, any folder or file not in the update can then be deleted.
(5) Last but not least ...
The style sheets 'default styles' and 'default styles minified' may have been updated. Unless you have edited the style sheet yourself separately, 'Edit styles' in admin and update to the latest style sheet with 'Get styles' and 'Update styles', choosing either 'Default styles' or 'Default minified'. Then go to /admin/setup and 'Submit setup' to encourage browsers to 'flush the cache'. Setup adds a new timestamp parameter to the style sheet URL to make browsers think it's a new file to replace the cached version. The file is new (and may not have been changed) but it has the same filename, hence the parameter added on.
This may work immediately, or it may not, but an updated style sheet will show soon enough.
It is best not to edit the main 'current styles'. If you want to edit styles do it in 'extra styles' which overrides the main style sheet leaving it untouched. That is why there is an extra style sheet 'extra styles'. Of course if you have created an entirely new theme, that's different: you are on your own!