All text is available under the terms of the GNU Free Documentation License. For the latest version of this document, see Wikibooks.

Zoph/Upgrading

Upgrading Zoph is a relatively simple process; it consists of moving the php, javascript, language and image files into your web root (beware that you may want to keep your config.inc.php) and running an SQL script that makes the database changes. More details about this process and special instructions per version are described below.

Contents

Zoph 0.7 to 0.8

Copy php/* to the location of your installation. Make sure that you also copy the js and img subdirectories. If you use the translations in Zoph, make sure to also copy the lang directory.

Copy bin/zophImport.pl into the directory where you installed it, if you followed the installation instructions it is probably /usr/local/bin, otherwise, find out with which zophImport.pl.

Updating the Database

If you are upgrading from an older version than 0.7, please run the older database updates first.

Execute zoph-update-0.8.sql:

mysql -u zoph_admin -p zoph < sql/zoph_update-0.8.sql

The database upgrade script makes the following changes:

Configuration updates

(see Zoph/Configuration for details):

New options

Group access rights

As of Zoph 0.7.4, you have to make your users members of a group and then assign viewing rights for albums to the group, instead of to the users directly. After the update to 0.7.4, you will have no groups and therefore your users will not be allowed to see any photos, you should create one or more groups, make your user member of one or more of them and assign viewing rights to the groups. If you'd rather stay with your current per-user viewing rights, you can use the user_to_group.php script in the contrib directory: this will create a new group for each user and assign the currently defined access rights for each user the newly created groups. To use this script:

  1. Make a backup of your current Zoph database;
  2. Copy the users_to_group.php script into your Zoph php directory;
  3. Log in to Zoph with an admin user;
  4. Did I mention making a backup?
  5. Change the part after the last / in your browser into user_to_group.php;

After this, you can remove the zoph_album_permissions table in Zoph, as it is no longer used.

Zoph 0.7.x to 0.8 update

If you have previously upgraded to a feature release (0.7.1, 0.7.2, 0.7.3 or 0.7.4), you need to edit zoph-update-0.8.sql. You should comment out the changes that have already been applied to your system. For example, if you are upgrading from 0.7.1 to 0.8, you will need to prepend the changes for 0.7.1 with a #, since you have already applied those changes when you updated to 0.7.1. After that, you can follow the instructions for 0.7 to 0.8

Zoph 0.7.5 or 0.8 pre-release to 0.8

If you are upgrading from 0.7.5 or or a 0.8 pre-release to 0.8, you don't need to run any database scripts, there are no database changes in this upgrade.

Follow the instructions for 0.7 to 0.8, but skip the database upgrades.

Zoph 0.7 to Zoph 0.7.0.x

Copy php/* to the location of your installation. Make sure to also copy the php/lang subdirectory.

You can upgrade directly from 0.6 to 0.7.0.x, simply use the zoph-0.7.0.x.tar.gz and execute the instructions for the 0.6 to 0.7 upgrade.

Older versions

For upgrades from an older version of Zoph: Zoph/Upgrading/Archive