FlatPress Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Upgrading Flatpress ======

There are a couple of ways to upgrade a Flatpress installation. But you should consider, what kind of upgrade you want to do and how many entries and attachments already exist in your blog.

==== General advice ====
**Before changing anything at your FlatPress instance, always do a backup of the whole FlatPress folder.** Thus, if anything goes wrong, you can just delete the complete blog and copy it back from your backup.

===== Options for upgrading =====

  - Upgrade of single files, for example security updates
  - Upgrading the complete blog to a new version by moving the content
  - Upgrading the complete blog including a full backup
  - Upgrading to the newest language pack
  - Upgrading a theme
  - Upgrading a plugin


===== Upgrading single files =====

This is the easiest way with the least efforts. Just overwrite the files in question with the new ones, after that clear the cache. This method is suitable for security updates or small bugfixes from the developer version (from SVN) or for changes of the theme files. An upgrade of single files has to be tested for each individual case and is only recommended for experienced webmasters.


===== Upgrade by moving the contents =====

This is a very interesting option for updating an existing blog without loss of content. The method requires full webspace access and a good FTP software. This method is not recommended for installations that reside in the root directory of your webspace. The blog should be installed into its own subdirectory, for example "/flatpress".

  - Create a directory named "new"
  - transfer the new Flatpress version into the directory "new"
  - Rename the current Flatpress directory to "old"
  - Rename the "new" directory to the name, the "old" directory had before
  - Adjust permissions for "fp-content" directory to 777
  - Run setup the usual way (including language selection, menus and plugins)
  - Copy the Flatpress data from "old/fp-content/" to your new installation
  - Rebuild the Index in Adminstration Panel - Maintain

**Important Note:** //For security reasons, it is recommended to delete both the "Setup" directory and the file "setup.php" from your web space!//

In case something went wrong, you can reactivate your previous installation by just renaming the directories accordingly.


===== Upgrade including full backup =====

This should be the preferred upgrade method and is suitable for any Flatpress installation. It does not matter, whether the blog resides in your webspace root directory or within a subdirectory. In addition, you have a [[en:doc:basic:backup|full backup]] of your webspace.

  - Download your complete blog using your FTP software
  - Delete blog contents from the webspace
  - Transfer the current Flatpress version to your webspace
  - Change permissions for "fp-content" directory to 777
  - Run setup the usual way (including language selection, menus and plugins)
  - Transfer Flatpress data from your backup to your new installation
  - Rebuild Index in Administration Panel - Maintain 


**Important Note:** //For security reasons, it is recommended to delete both the "Setup" directory and the file "setup.php" from your web space!//

Depending on the blog's size and your internet connection, this can take some time. It is recommendable to create an "index.html" file that tells your visitors, that you are currently doing an update. Here is an example procedure:

  - transfer index.html to your webspace
  - follow steps 1 - 4 (see above)
  - delete index.html
  - follow step 5
  - transfer index.html to your webspace
  - follow step 6
  - delete index.html and clear the cache.

Following this procedure, you have any time for doing the backup and the upgrade, and no visitor can upset your plan with comments or whatever. 


===== Upgrading a language pack =====

In case you are using the German language pack, you can upgrade by transferring the files to your webspace. The files just need to have the permissions to overwrite them. You can upgrade the language pack without going out of service.



===== Upgrading a theme =====

As first step, you should change the Flatpress theme to Leggero standard theme. This way, the theme-to-be-upgraded is not accessed by visitors on your webspace and thus can be altered and overwritten. After successfully transferring the updated theme files, you can switch back to your new theme.


Within your Flatpress installation, the themes can be found in path: ''/fp-interface/themes/...theme name...''

  - Change to Leggero standard theme
  - Backup of the current theme by renaming or downloading
  - Transfer the new theme to your webspace
  - Clear the cache (recommended)
  - Change to new theme


===== Upgrading a Plugin =====

When upgrading a plugin, you should follow basically the same procedure as if upgrading a theme. It is recommended to deactivate the plugin-to-be-updated in plugin administration panel, before doing the upgrade.

  - Deactivate plugin
  - Backup of current plugin by renaming or downloading
  - Transfer new plugin
  - Activate plugin
  - if necessary, configure and change according to your needs.

If you have problems after upgrading a plugin, be it error messages or malfunction, deactivate the new plugin, replace it with the old one and ask for help in the Flatpress Forum.

===== Editor's Note: =====

This article is currently under development. It just describes the procedures in a simplistic way and will be refined in future :-)