ZenPhoto

NOTE: We do not support and do not recommend installations or upgrading done with helper scripts like SimpleScripts or similar some providers make available. If you have any problems after using these please contact your provider.

1. Installation
2. Upgrading
3. Requirements

Installation

1. Download the latest version of Zenphoto.
2. Extract the files and upload them to your web directory via FTP.
3. Create a MySQL database if you haven’t already one.
4. Navigate to your gallery. EXAMPLE: www.yoursite.org/zenphoto/zp-core/setup.php. Setup will run automatically the first time you visit the gallery. Make sure everything checks out then click GO!
5. ENJOY!

Upgrading

With anything after ZenPhoto 1.1.3, upgrading is super easy!

Important note: In 1.1 and later, the /zen directory has been renamed
to /zp-core. Also with 1.2.6 the zp-config.php files is now stored in the zp-data folder. Keep that in mind if upgrading from older versions.

1. Backup your MySQL database.
2. Be sure to backup customized themes or plugins or any other customized file before replacing anything!
3. Remove the “zen” or “zp-core” folder and the files in the home dir (index.php, rss.php etc.) within your installation taking note of the database credentials in your zp-config file, you will need it in step 4
4. Download the latest version and upload it to your server. Do not replace your albums or cache folder!
5. Make sure the .htaccess file is writeable.
6. Once the files are uploaded, go to www.yoursite.org/zenphoto/ (if you have installed Zenphoto within the folder zenphoto). Setup.php will run. (If it somehow does not, please navigate directly to www.yoursite.org/zenphoto/zp-core/setup.php.)
7. Make sure everything checks out, and click go!
8. Follow the instructions.
9. You’re done! Enjoy.

NOTE: If you are upgrading to a nightly build or svn version to help testing, always upload the complete package, never just indiviual files, unless you have been told to by the developers.

Requirements

Server requirements

To operate Zenphoto efficiently, you need (our setup script will also tell you about possible problems):

• A web server with at least 15Mb of free space (plus free space for images and cache files)
• Apache*(it may work without problems on other server systems like IIS or lighttpd but has not been tested officially)
  
• PHP 4.4.8 or greater (PHP 5.2+ recommended*), with the GD graphics library (usually built-in) — It may work with older PHP versions as low as 4.0.6 or 4.1.0 but we haven’t tested it with versions lower than 4.4.8. You also should have the following PHP extensions and settings:
  • safe mode off
  • magic_quotes off
  • gettext extension (if you plan to use Zenphoto’s translation/multilingual capabilites)
  • mbstring extension (recommended if you are using a none English language with lots of special characters)
    
• MySQL 4 or greater (MySQL 5 recommended*):
  • Required user account rights: Select, Create, Insert, Drop, Update, Delete, Index
  • UTF-8 table and field collations (recommended)

*Zenphoto is developed and mostly tested on this environment.

Browser requirements

To use certain AJAX/JavaScript driven features in the admin backend like album and image sorting and the on-the-fly inline editing we recommend to use one of the following browsers:

• Firefox 2 or newer
• Internet Explorer 7 or newer
• Safari 3 or newer
• Google Chrome

It might work with older or other browsers as well but has not been tested.

Please also visit the Troubleshooting Zenphoto guide