Site protection

Image hotlinking protection

Although Zenphoto has an option for image protection it does only protect from getting the (full) image link from your gallery site itself but not prevent real hotlinking from outside. Everyone who knows how Zenphoto stores images can find out the direct link with ease.

You can change the location for your albums by modifying the zp-config.php file. There is commentary in the file that will guide you in making such a change. Please carefully note the comments, specially for "external" album folders. Also note that server filesystem permissions settings may prevent you from making these changes.

So, to really protect your images from hotlinking you need to use .htaccess (if you server supports this). Here is a little generator tool for this: We additionally (...)

Installation problems

Notes about deprecated functions

In the process of adding features and improving Zenphoto we occasionally find we need to change the way something worked in the past. Thus we may make some theme functions obsolete. When this happens we try to maintain the old function name to keep un-migrated themes working. But we move these functions to a plugin named "deprecated-functions" so that sites which are up-to-date do not have the overhead of having them loaded each page refresh. This plugin will cause an error notification upon use of the function so that you will know your theme needs to be updated. Generally this notification will explain what needs to be updated.

These messages can be annoying once you know that theme modification is needed. So, the plugin also has options that let you disable the message on those functions that you recognize need replacing. Disable the message and your theme will work as it did in the prior release. But NOTE: The implementation of (...)

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 (...)


A plugin to generate preview thumbs from pdf, eps,ai (Adobe Illustrator) and tiff file formats. Ghostscript is required to be installed on the server.

Content macros

Note: The example macros in this text contain a space after the first and before the last bracket. This is to avoid them being executed. On real usages there should be none.


Zenphoto 1.4.5 introduced the content macros. The overall concept follows the shortcodes Wordpress features. A simple content macro looks like this (spaces to avoid execution only!):


This is one of the default ones (later more) and will print the Zenphoto version number.

Content macros are added directly as text to fields. They work in the following places:

  • Codeblock content
  • Gallery description
  • Image description
  • Album description
  • Zenpage article content
  • Zenpage page content

If you need them to work on other places you can use the function applyMacros( (...)

Zenphoto 1.4.5 release is on its way

Implementation has closed for the 1.4.5 release. You can preview it from the Development Builds link on the Download page of our Website. The release notes can be found here:

Theme Developers especially should study the developer's notes and prepare upgrades to your themes.

We welcome all parties to test this release in any way you are able. Use the GitHub issues for anything you find.


Zenphoto is a bugfix release. Multiple minor errors are corrected.

A Cross Site Reference Forgery security hole has been closed. Thanks to Daniel Yang for reporting the issue to us.

As usual we recommend all users upgrade for the latest updates and fixes. For more detailed info about the fixes please review the GitHub issues list. presents contributor profile pages!

Zenphoto is a smaller CMS with a small community but from all over the world. We made these new pages for these reasons: 

  • Showcasing your contributions
  • Easier maintenance of author credits as we don’t have to change multiple entries if a user name or website link changes
  • And we do admit: A bit curiosity about activity and number of contributors overall

We value and welcome all contributions to the project. Be it as an officially committed team member, by providing bug fixes to releases or creating third party solutions. Therefore we do list people that haven’t contributed for years. 

So what is it? 

On each extension or theme entry on our site you now see a credit box on the right (example) that lists all developers/authors that contributed this. If we know it shows the real name and the screename. Each name is linked to an specific page for this developer that we (...)

Nirvana - Gallery3 to Zenphoto migration

A Python script to migrate from Menalto Gallery 3 to Zenphoto.

  • Migrates photos, comments, tags and tag associations.
  • Recurses into nested albums.
  • Adequately Unicode-friendly given recent Python modules. 


Zenphoto is a bugfix release. Multiple minor errors are corrected.

As usual we recommend all users upgrade for the latest updates and fixes. For more detailed info about the fixes please review the GitHub issues list.