Global variables July 23, 2008 / Updated: December 08, 2022

This list of common global variables Zenphoto uses internally can be useful for developing extra theme functions or plugins.

The usage of these is aimed at the more web developing experienced user as they primarily are to be used with the object model.

General Zenphoto globals

$_zp_active_languages

The list of installed locales

$_zp_admin_album_list

Used to cache the list of albums that an admin may administer

$_zp_authority

Cache of the admin users

$_zp_albums

Cache for the current album loop

$_zp_album_folder

Contains the album folder name (when it is internal to the Zenphoto installation.)

$_zp_all_tags

Cache of the tags used in a gallery. (Used in the Tag Strings case only, contains multiple copies of a tag.)

$_zp_comments

Cache for the current comment loop

$_zp_comment_error

Contains the error from the last comment post

$_zp_comment_stored

Saves comment context from a post for restoration

$_zp_conf_vars

Holds configuration information from the zp-config.php file. May be overridden by the $_zp_options array.

$_zp_count_tags

Cache of the tags with occurrence counts.

$_zp_current_admin_obj

An array containing the credentials of the currently logged in administrator

$_zp_current_album

The current active album object

$_zp_current_album_restore

Saved album

$_zp_current_comment

The current comment

$_zp_current_context

Contains the 'context' Zenphoto is operating in

$_zp_current_context_restore

Saved context

$_zp_current_image

The current active image object

$_zp_current_image_restore

Saved image

$_zp_current_search

The current active search

$_zp_dynamic_album

If not NULL, contains the current dynamic album

$_zp_error

Set true if Zenphoto has encountered an error

$_zp_exifvars

The list of EXIF fields that Zenphoto handles

$_zp_flash_player

If set, the multimedia player object ("flash" for historic reasons)

$_zp_gallery

The gallery object. This is the base object of Zenphoto site itself.

$_zp_gallery_albums_per_page

A cache of the number of albums that go on the index.php page

$_zp_gallery_page

The basename of the page loaded by the root index.php. (e.g. album.php, image.php, etc.)

$_zp_images

Cache for the current image loop

$_zp_languages

An array of locale, language name pairs

$_zp_loggedin

Contains the privileges of the current admin. (It is 0 if no one is logged in.)

$_zp_login_error

Contains the error indication from the last login

$_zp_null_account

Used only in Admin. Set to true if the admin user/password must be set.

$_zp_object_cache

Part of the object query cache

$_zp_object_update_cache

Part of the object query cache

$_zp_optionDB_hasownerid

Used for transitioning to a single option table

$_zp_options

The current set of Options

$_zp_page

The current gallery/album page

$_zp_phoogle

If set, the google maps object

$_zp_plugin_scripts

Plugins register the global initialization needed by plugins

$_zp_pre_authorization

Cache of Authorizations

$_zp_query_count

Count of queries

$_zp_sortable_list

Object for sorting albums

$_zp_supported_images

The list of valid image file suffixes

$_zp_supported_videos

The list of valid video (and music) file suffixes

$_zp_themeroot

The WEBPATH to the current theme

$_zp_unique_tags

Cache of the Unique tags.

$_zp_use_tag_table

An indicator of whether we are using Tag Tables or Tag Strings.

$_zp_xternal_album_folder

If not NULL contains the path to the album folder external to the Zenphoto instalation.

$_zp_zip_list

Used when making a zip archive

Zenpage CMS-plugin globals

$_zp_current_zenpage_news

The current active news article object

$_zp_current_category

The current active news category. Note: Before 1.4 this is just the name of the category, afterwards this contains the object of the category

$_zp_zenpage_total_pages

The total number of news pages for the news article loop

$_zp_zenpage_total_articles

The total number of news articles

$_zp_current_zenpage_page

The current active page object