Troubleshooting guide

We have restructured the troubleshooting guide a bit recently. This collector articlce is now obsolete. Please now use the category Troubleshooting itself to find related articles.


A plugin to generate a file download list. This download folder can be relative to your Zenphoto root (foldername) or external to it (../foldername). By default the uploaded folder is chosen so you can use the file manager to manage these files.

You can also override that folder by using the printdownloadList() function parameters directly. Additionally you can set a downloadlink to a specific file directly by using printDownloadLink(path-to-file);.

The file names and the download path of the items are stored with the number of downloads in the database's plugin_storage table.

The download link is something like: number of the download.

So the actual download source is not public. The list itself is generated (...)


Overrides of the publish handling such that only a user with ADMIN_RIGHTS or MANAGE_ALL_object rights may mark an object published.



This plugin provides a facility to periodically run the Zenphoto backup utility. Use it to insure that database backups are done on a regular basis.

NOTE: The website must be visited for this plugin to be able to check if it is time to run. Inacative sites may not get backed up as frequently as the interval specifies. Of course, if the site is inactive, there probably is little need to do the backup in the first place.

Backups are run under the master administrator authority.



Use this plugin to handle filetypes that are not otherwise provided for by Zenphoto as "images".

Default thumbnail images may be created in the plugins/class-AnyFile folder. The naming convention is suffixDefault.png. If no such file is found, the class object default thumbnail will be used.

The plugin is an extension of TextObject. For more details see the class-textobject plugin.



Plugin handler for certain standard document formats. These are displayed by a WEBdocs provider e.g. Google Docs viewer. The item is displayed in an iFrame sized based on the image size option. Of course, your site must be accessable by the provider and your viewer must have the required account credentials for this to work.

The plugin is an extension of TextObject. For more details see the class-textobject plugin.



This plugin deals with functions that have either been altered* or removed** from mainstream Zenphoto completely.
* Altered functions have deprecated parameters.
** Removed functions are not maintained and they are not guaranteed to function correctly with the current version of Zenphoto.

The default settings cause an E_USER_NOTICE error to be generated when the function is used. The text of the error message will tell you how to replace calls on the deprecated function. The error message can be disabled to allow your scripts to continue to run. Visit the deprecated-functions plugin options. Find the function and uncheck the box by the function.

A utility button is provided that allows you to search themes and plugins for uses of functions which have been deprecated. Use it to be proactive in replacing or changing these items.



Sends new users an e-mail message urging the user to change his password. It contains a link allowing them to do a password reset.



Interface to federated login handlers

The plugin will use a federated login such as Google Accounts as a logon server. If the logon succeeds it will log that user onto Zenphoto. An attempt will be made to match the user to an existing Zenphoto user. If such is found, then the user is logged in as that Zenphoto user. If not, a Zenphoto user will be created and logged in.

The default privileges for a created user are obtained from the viewers group. (The user will belong to that group.) This will be the case whether or not the user_groups plugin is enabled. If you want to be able to specify unique default priviledges you will have to use the user_groups plugin at least until you have defined your default group.

You may also find the user_expiry plugin useful in conjunction with this plugin. Since users may arbitrarily be created from those visitors who login with their federated credentials you may want to "age" these users and (...)


Places security information in a security log.

The logged data includes:

  • the ip address of the client browser
  • the type of entry
  • the user/user name
  • the success/failure
  • the authority granting/denying the request
  • Additional information, for instance on failure, the password used