User guide

Moving and changing existing installations

    Changing the folder name Zenphoto is installed in

    If you did not install Zenphoto in the root of your webspace but in a separate folder (called "zenphoto" for example) just rename it.
    After that you need to do one of these things:

    1. Re-run setup (you might need to unprotect the setup files)
    2. Or manually edit your .htaccess file and change the RewriteBase at the beginning to the current folder name. #1 would do that for you.

    Moving on the same server

    1. Unprotect the setup scripts.
      1. Physical move: If you installed Zenphoto in a subfolder named for example Zenphoto and just want to move it to the root or another folder, just copy the complete content (all files and folders) of the folder to the new location.
      2. Domain change: If you installed Zenphoto in a subfolder and would like it to be the root of your domain you can also just link the domain to that folder and it will be the "root". The same way you can also link a new domain to your install.
    2. Now run setup (zp-core/setup.php). This will correct the rewritebase in your .htaccess file to the new location (you can also do this manually within the file).
    3. Now access your site/admin backend and everything should be as usual.

    Wrong URLs after moving

    If you first installed Zenphoto within and later decide to move it directly into the root you need to run setup (/zp-core/setup.php) again. This will correct the rewrite base within the .htaccess file.

    You need to do the same if you want to keep Zenphoto within a subfolder but would like to rename it to /gallery for example.

    Moving to a new server

    1. Copy the root index.php and the zp-core folder to the new server. Make sure it is the same release version as the old install. Do not run setup yet.
    2. Copy all customized themes or plugins from the old to the new location.
    3. Copy the albums and the cache folder from the old to the new location and if you used Zenpage also the uploaded folder.
    4. Export the database of the old install using the database backup tool on the admin overview page. (if you are still on a very old version, use tools like phpMyAdmin for this)
    5. Copy the backup folder with its content to the root of your new installation.
      Now run setup (zp-core/setup.php). It will provide the option to import that database backup when you have to set your user/password details.
    6. Now access your site/admin backend and everything should be as usual. 


    Code examples are released under the GPL v2 or later license


    Related items