ACK_DISPLAY_ERRORS
public
mixed
ACK_DISPLAY_ERRORS
= 2
public
mixed
ACK_DISPLAY_ERRORS
= 2
public
mixed
ADMIN_IMAGES_STEP
= 5
Defines the bitmask for load order priority of admin plugins
public
mixed
ADMIN_PLUGIN
= 4096
public
mixed
ADMIN_RIGHTS
= 1
public
mixed
ALBUM_FOLDER_EMPTY
= \getAlbumFolder('')
public
mixed
ALBUM_FOLDER_SERVERPATH
= \getAlbumFolder(\SERVERPATH)
public
mixed
ALBUM_FOLDER_WEBPATH
= \getAlbumFolder(\WEBPATH)
public
mixed
ALBUM_MENU_COUNT
= \getOption('print_album_menu_count')
public
mixed
ALBUM_MENU_SHOWSUBS
= \getOption('print_album_menu_showsubs')
Defines the name of the albums folder
public
mixed
ALBUMFOLDER
= 'albums'
public
mixed
ALL_ALBUMS_RIGHTS
= \VIEW_ALL_RIGHTS
public
mixed
ALL_NEWS_RIGHTS
= \VIEW_ALL_RIGHTS
public
mixed
ALL_PAGES_RIGHTS
= \VIEW_ALL_RIGHTS
Defines the name of the backup folder
public
mixed
BACKUPFOLDER
= 'backup'
public
mixed
BASEPATH
= true
public
mixed
CACHE_HASH_LENGTH
= \strlen(\sha1(\strval(\HASH_SEED)))
Defines the name of the image cache folder
public
mixed
CACHEFOLDER
= 'cache'
Defines if the server file system is case insensitive
public
mixed
CASE_INSENSITIVE
= \file_exists(\dirname(__FILE__) . '/VERSION.PHP')
public
mixed
CHMOD_VALUE
= \fileperms(\dirname(__FILE__)) & 0666
Defines the bitmask for load order priority of class plugins
public
mixed
CLASS_PLUGIN
= 8192
public
mixed
COMMENT_BODY_REQUIRED
= 16
public
mixed
COMMENT_DATACONFIRMATION
= 64
public
mixed
COMMENT_EMAIL_REQUIRED
= 1
public
mixed
COMMENT_MATHQUIZ
= 256
public
mixed
COMMENT_NAME_REQUIRED
= 2
public
mixed
COMMENT_SEND_EMAIL
= 32
public
mixed
COMMENT_TEXTQUIZ
= 128
public
mixed
COMMENT_WEB_REQUIRED
= 4
public
mixed
COMMENTS_PER_PAGE
= \max(1, \getOption('comment_form_comments_per_page'))
Defines the name of the shared "common" folder within/for core extensions
public
mixed
COMMON_FOLDER
= \PLUGIN_FOLDER . '/common'
Defines the name of the config file
public
mixed
CONFIGFILE
= 'zenphoto.cfg.php'
public
mixed
COOKIE_PATH
= \WEBPATH
public
mixed
COOKIE_PERSISTENCE
= $persistence
public
mixed
CUSTOM_OPTION_PREFIX
= '_ZP_CUSTOM_'
Defines the name of the zp-data folder outside the core folder
public
mixed
DATA_FOLDER
= 'zp-data'
public
mixed
DATA_MOD
= \fileperms(\SERVERPATH . '/' . \DATA_FOLDER . '/' . \CONFIGFILE) & 0777
public
mixed
DATABASE_DESIRED_VERSION
= '5.7.0'
public
mixed
DATABASE_DESIRED_VERSION
= '0.0.0'
public
mixed
DATABASE_MARIADB_DESIRED_VERSION
= '10.1.0'
public
mixed
DATABASE_MARIADB_DESIRED_VERSION
= '0.0.0'
public
mixed
DATABASE_MARIADB_MIN_VERSION
= '5.5.0'
public
mixed
DATABASE_MARIADB_MIN_VERSION
= '0.0.0'
public
mixed
DATABASE_MIN_VERSION
= '5.5.3'
public
mixed
DATABASE_MIN_VERSION
= '0.0.0'
public
mixed
DATABASE_PREFIX
= $mysql_prefix
public
mixed
DATABASE_SOFTWARE
= $_zp_conf_vars['db_software']
public
mixed
DATABASE_SOFTWARE
= 'Database setup'
public
mixed
DATE_FORMAT
= \trim(\strval(\getOption('date_format')))
public
mixed
DATETIME_DISPLAYFORMAT
= \DATETIME_FORMAT
public
mixed
DATETIME_FORMAT
= \DATE_FORMAT . ' ' . \TIME_FORMAT
set to true to log 404 error processing debug information.
public
mixed
DEBUG_404
= isset($_zp_conf_vars['debug_404']) && $_zp_conf_vars['debug_404'] || \TEST_RELEASE
set to true to supplies the calling sequence with zp_error messages
public
mixed
DEBUG_ERROR
= isset($_zp_conf_vars['debug_error']) && $_zp_conf_vars['debug_error'] || \TEST_RELEASE
set to true to log start/finish of exif processing. Useful to find problematic images.
public
mixed
DEBUG_EXIF
= isset($_zp_conf_vars['debug_exif']) && $_zp_conf_vars['debug_exif']
set to true to log filter application sequence.
public
mixed
DEBUG_FILTERS
= isset($_zp_conf_vars['debug_filters']) && $_zp_conf_vars['debug_filters']
set to true to log image processing debug information.
public
mixed
DEBUG_IMAGE
= isset($_zp_conf_vars['debug_image']) && $_zp_conf_vars['debug_image']
set to true to flag image processing errors.
public
mixed
DEBUG_IMAGE_ERR
= isset($_zp_conf_vars['debug_image_err']) && $_zp_conf_vars['debug_image_err'] || \TEST_RELEASE
used for examining language selection problems
public
mixed
DEBUG_LOCALE
= isset($_zp_conf_vars['debug_locale']) && $_zp_conf_vars['debug_locale']
public
mixed
DEBUG_LOG_SIZE
= \getOption('debug_log_size')
set to true to log admin saves and login attempts
public
mixed
DEBUG_LOGIN
= isset($_zp_conf_vars['debug_login']) && $_zp_conf_vars['debug_login']
set to true to log plugin load sequence.
public
mixed
DEBUG_PLUGINS
= isset($_zp_conf_vars['debug_plugins']) && $_zp_conf_vars['debug_plugins']
public
mixed
EDITOR_SANITIZE_LEVEL
= 1
public
mixed
EDITOR_SANITIZE_LEVEL
= 4
public
mixed
EDITOR_SANITIZE_LEVEL
= 4
public
mixed
ELFINDER_PHP_ROOT_PATH
= \dirname(__FILE__)
public
mixed
ENT_SUBSTITUTE
= \defined('ENT_IGNORE') ? \ENT_IGNORE : 8
public
mixed
EXACT_TAG_MATCH
= \getOption('exact_tag_match')
set to true to log the "EXPLAIN" of SELECT queries in the debug log
public
mixed
EXPLAIN_SELECTS
= isset($_zp_conf_vars['explain_selects']) && $_zp_conf_vars['explain_selects']
Defines the bitmask for load order priority of feature plugins
public
mixed
FEATURE_PLUGIN
= 2048
public
mixed
FILE_MOD
= \CHMOD_VALUE & 0666
public
mixed
FILESYSTEM_CHARSET
= $data
public
mixed
FILESYSTEM_CHARSET
= 'UTF-8'
public
mixed
FOLDER_MOD
= \CHMOD_VALUE | 0311
public
mixed
FULLIMAGE_WATERMARK
= \getOption('fullsizeimage_watermark')
public
mixed
FULLWEBPATH
= \SERVER_HTTP_HOST . \WEBPATH
public
mixed
GALLERY_SECURITY
= @$data['gallery_security']
public
mixed
GALLERY_SESSION
= @$data['album_session']
public
mixed
GD_FREETYPE
= (bool) $this->info['FreeType']
public
mixed
GD_FREETYPE_SAMPLE
= 'The quick brown fox jumps over the lazy dog'
public
mixed
GD_FREETYPE_SAMPLE_CHARS
= strlen('GD_FREETYPE_SAMPLE')
public
mixed
GETID3_HELPERAPPSDIR
= $helperappsdir . DIRECTORY_SEPARATOR
public
mixed
GETID3_INCLUDEPATH
= \dirname(__FILE__) . \DIRECTORY_SEPARATOR
public
mixed
GETID3_INCLUDEPATH
= \SERVERPATH . '/' . \ZENFOLDER . '/' . \PLUGIN_FOLDER . '/class-video/getid3/'
public
mixed
GETID3_LIBXML_OPTIONS
= \LIBXML_NOENT | \LIBXML_NONET | \LIBXML_NOWARNING
public
mixed
GETID3_OS_ISWINDOWS
= \stripos(\PHP_OS, 'WIN') === 0
public
mixed
GETID3_TEMP_DIR
= $temp_dir
public
mixed
GOOGLE_SITEMAP
= \getOption('sitemap_google')
public
mixed
GRAPHICS_LIBRARY
= $_zp_cachefile_suffix['Library']
public
mixed
HASH_SEED
= \getOption('extra_auth_hash_text')
public
mixed
HTACCESS_VERSION
= '1.4.12'
public
mixed
IM_SUFFIX
= \getOption('mod_rewrite_image_suffix')
public
mixed
IMAGE_CACHE_SUFFIX
= \getOption('image_cache_suffix')
public
mixed
IMAGE_SORT_DIRECTION
= \getOption('image_sortdirection')
public
mixed
IMAGE_SORT_TYPE
= \getOption('image_sorttype')
public
mixed
IMAGE_WATERMARK
= \getOption('fullimage_watermark')
public
mixed
IMAGEMAGICK_REQUIRED_VERSION
= '6.3.8'
public
mixed
IMAGICK_REQUIRED_VERSION
= '3.0.0'
public
mixed
IP_TIED_COOKIES
= \getOption('IP_tied_cookies')
public
mixed
LIST_RIGHTS
= \NO_RIGHTS
public
mixed
LOCAL_CHARSET
= $data
public
mixed
LOCAL_CHARSET
= 'UTF-8'
public
mixed
LOCALE_TYPE
= 0
public
mixed
LOGS_MOD
= \DATA_MOD
public
mixed
MANAGED_OBJECT_RIGHTS_EDIT
= 1
public
mixed
MANAGED_OBJECT_RIGHTS_UPLOAD
= 2
public
mixed
MANAGED_OBJECT_RIGHTS_VIEW
= 4
public
mixed
MAX_SIZE
= \getOption('image_max_size')
public
mixed
MEMBERS_ONLY_COMMENTS
= \getOption('comment_form_members_only')
public
mixed
MENU_TRUNCATE_INDICATOR
= \getOption('menu_truncate_indicator')
public
mixed
MENU_TRUNCATE_STRING
= \getOption('menu_truncate_string')
public
mixed
METATAG_LOCALE_TYPE
= 0
public
mixed
MOD_REWRITE
= \getOption('mod_rewrite')
Defines the mutex folder
public
mixed
MUTEX_FOLDER
= '.mutex'
public
mixed
NEWS_POSITION_NORMAL
= 0
public
mixed
NEWS_POSITION_STICK_TO_TOP
= 9
public
mixed
NEWS_POSITION_STICKY
= 1
public
mixed
NO_WATERMARK
= '!'
public
mixed
OBJECT_CACHE_DEPTH
= 150
used in sorting the images within and album
public
mixed
OFFSET_PATH
= 1
This script is used to create dynamic albums from a search.
public
mixed
OFFSET_PATH
= 1
admin-edit.php editing of albums.
public
mixed
OFFSET_PATH
= 1
user_groups log--tabs
public
mixed
OFFSET_PATH
= 1
provides the Options tab of admin
public
mixed
OFFSET_PATH
= 1
provides the Plugins tab of admin
public
mixed
OFFSET_PATH
= 1
This template is used to reload metadata from images. Running it will process the entire gallery, supplying an album name (ex: loadAlbums.php?album=newalbum) will only process the album named.
public
mixed
OFFSET_PATH
= 2
provides the TAGS tab of admin
public
mixed
OFFSET_PATH
= 1
Theme file editor
public
mixed
OFFSET_PATH
= 1
provides the Themes tab of admin
public
mixed
OFFSET_PATH
= 1
public
mixed
OFFSET_PATH
= 1
provides the Upload tab of admin
public
mixed
OFFSET_PATH
= 1
provides the Options tab of admin
public
mixed
OFFSET_PATH
= 1
admin.php is the main script for administrative functions.
public
mixed
OFFSET_PATH
= 1
public
mixed
OFFSET_PATH
= 1
public
mixed
OFFSET_PATH
= 1
public
mixed
OFFSET_PATH
= 0
public
mixed
OFFSET_PATH
= 2
public
mixed
OFFSET_PATH
= 1
public
mixed
OFFSET_PATH
= 2
public
mixed
OFFSET_PATH
= 2
Used for changing permissions on a mass basis
public
mixed
OFFSET_PATH
= 2
Used for setting theme/plugin default options
public
mixed
OFFSET_PATH
= 2
Used for setting theme/plugin default options
public
mixed
OFFSET_PATH
= 2
public
mixed
OFFSET_PATH
= 3
Database quick reference
public
mixed
OFFSET_PATH
= 3
Detailed Gallery Statistics
public
mixed
OFFSET_PATH
= 3
This plugin shows statistical graphs and info about your gallery's images and albums
Displays which HTTP headers your site sends
public
mixed
OFFSET_PATH
= 3
Displays locale information of the system
public
mixed
OFFSET_PATH
= 3
Maintenance mode utility based on the former site_upgrade plugin
public
mixed
OFFSET_PATH
= 3
Displays the PHP configuration information
public
mixed
OFFSET_PATH
= 3
Use this utility to reset your album thumbnails to either "random" or from an ordered field query
public
mixed
OFFSET_PATH
= 3
GDPR data export tool
public
mixed
OFFSET_PATH
= 3
This template is used to generate cache images. Running it will process the entire gallery, supplying an album name (ex: loadAlbums.php?album=newalbum) will only process the album named.
public
mixed
OFFSET_PATH
= 3
Passing clear=on will purge the designated cache before generating cache images
This template is used to generate cache images. Running it will process the entire gallery, supplying an album name (ex: loadAlbums.php?album=newalbum) will only process the album named.
public
mixed
OFFSET_PATH
= 3
Passing clear=on will purge the designated cache before generating cache images
Zenphoto site cloner
public
mixed
OFFSET_PATH
= 4
public
mixed
OFFSET_PATH
= 4
provides the Comments tab of admin
public
mixed
OFFSET_PATH
= 1
public
mixed
OFFSET_PATH
= 3
Check for use of deprecated functions
public
mixed
OFFSET_PATH
= 4
Detailed Gallery Statistics
public
mixed
OFFSET_PATH
= 3
This plugin shows statistical graphs and info about your gallery's images and albums
This plugin is dependent on the css of the gallery_statistics utility plugin!
public
mixed
OFFSET_PATH
= 3
public
mixed
OFFSET_PATH
= 3
The Matomo statistis page if widgets are defined
public
mixed
OFFSET_PATH
= 3
public
mixed
OFFSET_PATH
= 4
public
mixed
OFFSET_PATH
= 4
public
mixed
OFFSET_PATH
= 3
public
mixed
OFFSET_PATH
= 4
public
mixed
OFFSET_PATH
= 3
This is the "rewrite rules" tab
public
mixed
OFFSET_PATH
= 3
Collects and analyzes searches
public
mixed
OFFSET_PATH
= 4
public
mixed
OFFSET_PATH
= 3
Sitemap Tools
public
mixed
OFFSET_PATH
= 3
Tool to generate sitemaps
public
mixed
OFFSET_PATH
= 3
public
mixed
OFFSET_PATH
= 3
public
mixed
OFFSET_PATH
= 3
public
mixed
OFFSET_PATH
= 3
public
mixed
OFFSET_PATH
= 3
public
mixed
OFFSET_PATH
= 3
user_groups plugin--tabs
public
mixed
OFFSET_PATH
= 4
user_groups plugin--tabs
public
mixed
OFFSET_PATH
= 4
public
mixed
OFFSET_PATH
= 3
zenpage admin-categories.php
public
mixed
OFFSET_PATH
= 4
zenpage admin-edit.php
public
mixed
OFFSET_PATH
= 4
zenpage admin-news-articles.php
public
mixed
OFFSET_PATH
= 4
zenpage admin-pages.php
public
mixed
OFFSET_PATH
= 4
public
mixed
OPEN_IMAGE_CACHE
= !\getOption('protected_image_cache')
public
mixed
OPTION_TYPE_CHECKBOX
= 1
public
mixed
OPTION_TYPE_CHECKBOX_ARRAY
= 6
public
mixed
OPTION_TYPE_CHECKBOX_UL
= 7
public
mixed
OPTION_TYPE_CLEARTEXT
= 9
public
mixed
OPTION_TYPE_COLOR_PICKER
= 8
public
mixed
OPTION_TYPE_CUSTOM
= 2
public
mixed
OPTION_TYPE_NOTE
= 10
public
mixed
OPTION_TYPE_PASSWORD
= 11
public
mixed
OPTION_TYPE_RADIO
= 4
public
mixed
OPTION_TYPE_RICHTEXT
= 12
public
mixed
OPTION_TYPE_SELECTOR
= 5
public
mixed
OPTION_TYPE_TEXTAREA
= 3
Generates the HTML for custom options (e.g. theme options, plugin options, etc.) Note: option names may not contain '.', '+', nor '%' as PHP POST handling will replace these with an underscore.
public
mixed
OPTION_TYPE_TEXTBOX
= 0
public
mixed
PHP_INT_MAX
= 2147483647
public
mixed
PHP_INT_MIN
= ~PHP_INT_MAX
Defines the name of the core extensions folder
public
mixed
PLUGIN_FOLDER
= 'zp-extensions'
Defines the bitmask for load order priority of standard plugins
public
mixed
PLUGIN_PRIORITY
= 1023
public
mixed
PLUGINS_PER_PAGE
= \max(1, \getOption('plugins_per_page'))
public
mixed
PLUGINS_PER_PAGE
= \max(1, \getOption('plugins_per_page'))
public
mixed
PRIMARY_INSTALLATION
= true
public
mixed
PROTOCOL
= 'http'
public
mixed
PROTOCOL
= 'http'
public
mixed
RECORD_LIMIT
= 5
public
mixed
SAFE_MODE
= \false
public
mixed
SAFE_MODE_ALBUM_SEP
= ''
public
mixed
SEARCH_CACHE_DURATION
= \getOption('search_cache_duration')
public
mixed
SEARCH_DURATION
= 3000
public
mixed
SEO_FULLWEBPATH
= \FULLWEBPATH
public
mixed
SEO_FULLWEBPATH
= \seo_locale::localePath(\true)
public
mixed
SEO_WEBPATH
= \WEBPATH
public
mixed
SEO_WEBPATH
= \seo_locale::localePath()
public
mixed
SERVER_HTTP_HOST
= \PROTOCOL . "://" . $_SERVER['HTTP_HOST']
public
mixed
SERVER_PROTOCOL
= 'http'
public
mixed
SERVERCACHE
= \SERVERPATH . '/' . \CACHEFOLDER
public
mixed
SERVERPATH
= $const_serverpath
public
mixed
SERVERPATH
= $_zp_setup_serverpath
public
mixed
SERVERPATH
= $_zp_setup_serverpath
public
mixed
SETUPLOG
= $_zp_setup_serverpath . '/' . \DATA_FOLDER . '/setup.log'
public
mixed
SITE_LOCALE
= 'en_US'
public
mixed
SITEMAP_CHUNK
= \getOption('sitemap_processing_chunk')
public
mixed
SITEMAP_LOCALE_TYPE
= 0
Defines sort flag case
public
mixed
SORT_FLAG_CASE
= 0
Defines if sorting should be natural order
public
mixed
SORT_NATURAL
= 0
Defines the name of the html cache folder
public
mixed
STATIC_CACHE_FOLDER
= "cache_html"
Defines if symlinks are supported on the server
public
mixed
SYMLINK
= \function_exists('symlink') && \strpos(@\ini_get("suhosin.executor.func.blacklist"), 'symlink') === \false
Enables test release mode, supports the markRelease plugin
public
mixed
TEST_RELEASE
= isset($_zp_conf_vars['test_release']) && $_zp_conf_vars['test_release'] || \preg_match('~-[^RC]~', \ZENPHOTO_VERSION)
public
mixed
TEXT_INPUT_SIZE
= 48
public
mixed
TEXT_INPUT_SIZE_SHORT
= 30
public
mixed
TEXTAREA_COLUMNS
= 50
public
mixed
TEXTAREA_COLUMNS_SHORT
= 32
Defines the bitmask for load order priority of theme plugins
public
mixed
THEME_PLUGIN
= 1024
Defines the name of the themes folder
public
mixed
THEMEFOLDER
= 'themes'
public
mixed
THUMB_WATERMARK
= \getOption('Image_watermark')
public
mixed
TIME_FORMAT
= \trim(\strval(\getOption('time_format')))
public
mixed
UPLOAD_ERR_BLOCKED
= -2
Initialize globals for Admin
public
mixed
UPLOAD_ERR_QUOTA
= -1
Defines name of the non albums upload folder
public
mixed
UPLOAD_FOLDER
= 'uploaded'
public
mixed
USE_CAPTCHA
= 8
Defines the user 3rd party plugin folder outside the Zenphoto core folder
public
mixed
USER_PLUGIN_FOLDER
= 'plugins'
public
mixed
USER_RIGHTS
= \NO_RIGHTS
public
mixed
USERS_PER_PAGE
= \max(1, \getOption('users_per_page'))
public
mixed
USERS_PER_PAGE
= \max(1, \getOption('users_per_page'))
public
mixed
UTF8_IMAGE_URI
= \getOption('UTF8_image_URI')
Defines the name of the core utlitlites folder
public
mixed
UTILITIES_FOLDER
= 'utilities'
public
mixed
VIEW_ALL_RIGHTS
= \ALL_ALBUMS_RIGHTS | \ALL_PAGES_RIGHTS | \ALL_NEWS_RIGHTS
public
mixed
VIEW_FULLIMAGE_RIGHTS
= \NO_RIGHTS
public
mixed
VIEW_GALLERY_RIGHTS
= \NO_RIGHTS
public
mixed
VIEW_SEARCH_RIGHTS
= \NO_RIGHTS
public
mixed
WATERMARK_FULL
= 4
public
mixed
WATERMARK_IMAGE
= 1
public
mixed
WATERMARK_THUMB
= 2
public
mixed
WEBPATH
= $const_webpath
public
mixed
WEBPATH
= $const_webpath
Defines the name of the Zenphoto core folder (zp-core)
public
mixed
ZENFOLDER
= 'zp-core'
Some global variable setup
public
mixed
ZENPAGE_COMBINEWS
= \false
public
mixed
ZENPHOTO_LOCALE
= \setMainDomain()
Defines the Zenphoto version
public
mixed
ZENPHOTO_VERSION
= '1.6.5'
public
mixed
ZP_ALBUM
= 2
public
mixed
ZP_ALBUM_LINKED
= 64
public
mixed
ZP_ARTICLES_PER_PAGE
= \getOption("zenpage_articles_per_page") >= 1 ? \getOption("zenpage_articles_per_page") : 1
public
mixed
ZP_COMBINEWS
= \false
public
mixed
ZP_COMMENT
= 8
public
mixed
ZP_IMAGE
= 4
public
mixed
ZP_IMAGE_LINKED
= 128
public
mixed
ZP_INDEX
= 1
Defines the date of the current session for use as a last modified date within the page header()
public
mixed
ZP_LAST_MODIFIED
= \gmdate('D, d M Y H:i:s') . ' GMT'
public
mixed
ZP_NEWS_ENABLED
= \false
public
mixed
ZP_PAGES_ENABLED
= \false
public
mixed
ZP_READ_MORE
= \getOption("zenpage_read_more")
public
mixed
ZP_SEARCH
= 16
public
mixed
ZP_SEARCH_LINKED
= 32
public
mixed
ZP_SHORTEN_LENGTH
= \getOption('zenpage_text_length')
public
mixed
ZP_SHORTENINDICATOR
= $shortenindicator = \getOption('zenpage_textshorten_indicator')
public
mixed
ZP_ZENPAGE_NEWS_ARTICLE
= 512
public
mixed
ZP_ZENPAGE_NEWS_CATEGORY
= 1024
public
mixed
ZP_ZENPAGE_NEWS_DATE
= 2048
public
mixed
ZP_ZENPAGE_NEWS_PAGE
= 256
public
mixed
ZP_ZENPAGE_PAGE
= 4096
public
mixed
ZP_ZENPAGE_SINGLE
= 8192
Print the footer <div> for the bottom of all admin pages.
printAdminFooter([string $addl = '' ]) : mixed
additional text to output on the footer.
datepickerJS() : mixed
Print the header for all admin pages. Starts at <DOCTYPE> but does not include the </head> tag, in case there is a need to add something further.
printAdminHeader(string $tab[, string $subtab = NULL ]) : mixed
the album page
the sub-tab if any
printSortableHead() : mixed
Print the html required to display the ZP logo and links in the top section of the admin page.
printLogoAndLinks() : mixed
Print the nav tabs for the admin section. We determine which tab should be highlighted from the $_GET['page']. If none is set, we default to "home".
printTabs() : mixed
getSubtabs() : mixed
printSubtabs() : mixed
setAlbumSubtabs(mixed $album) : mixed
Roughly fixes outdated usages of old admin "tab" globals and joins them with the actual globals.
handleDeprecatedMenuGlobals() : mixed
and also throws deprecation notices about this.
Used for checkbox and radiobox form elements to compare the $checked value with the $current.
checked(mixed $checked, mixed $current) : mixed
Echos the attribute checked="checked
customOptions(mixed $optionHandler[, mixed $indent = "" ][, mixed $album = NULL ][, mixed $showhide = false ][, mixed $supportedOptions = NULL ][, mixed $theme = false ][, mixed $initial = 'none' ][, mixed $extension = NULL ]) : mixed
processCustomOptionSave(mixed $returntab[, mixed $themename = NULL ][, mixed $themealbum = NULL ]) : mixed
Set defaults for standard theme options incase the theme has not done so
standardThemeOptions(string $theme, mixed $album) : mixed
Encodes for use as a $_POST index
postIndexEncode(string $str) : mixed
Decodes encoded $_POST index
postIndexDecode(string $str) : string
Prints radio buttons from an array
generateRadiobuttonsFromArray(string $currentvalue, string $list, string $option[, bool $behind = false ][, mixed $class = 'checkboxlabel' ][, mixed $disabled = NULL ]) : mixed
The current selected value
the array of the list items form is localtext => buttonvalue
the name of the option for the input field name
set true to have the "text" before the button
Creates the body of an unordered list with checkbox label/input fields (scrollable sortables)
generateUnorderedListFromArray(array<string|int, mixed> $currentValue, array<string|int, mixed> $list, string $prefix, string $alterrights, bool $sort, bool $localize[, string $class = NULL ][, mixed $extra = NULL ]) : mixed
list of items to be flagged as checked
the elements of the select list
prefix of the input item
are the items changable.
true for sorted list
true if the list local key is text for the item
optional class for items
Creates an unordered checklist of the tags
tagSelector(object $that, string $postit[, bool $showCounts = false ][, mixed $mostused = false ][, mixed $addnew = true ][, mixed $resizeable = false ][, mixed $class = 'checkTagsAuto' ]) : mixed
Object for which to get the tags
prefix to prepend for posting
set to true to get tag count displayed
emits the html for editing album information called in edit album and mass edit
printAlbumEditForm(string $index, object $album[, bool $buttons = true ]) : mixed
the index of the entry in mass edit or '0' if single album
the album object
set true for "apply" buttons
puts out the maintenance buttons for an album
printAlbumButtons(object $album) : mixed
is the album being emitted
printAlbumLegend() : mixed
puts out a row in the edit album table
printAlbumEditRow(object $album, bool $show_thumb, object $owner) : mixed
is the album being emitted
set to false to show thumb standin image rather than album thumb
the parent album (or NULL for gallery)
processes the post from the above
processAlbumEdit(int $index, object $album, string &$redirectto) : string
the index of the entry in mass edit or 0 if single album
the album object
used to redirect page refresh on move/copy/rename
error flag if passwords don't match
Process the image edit form posted
processImageEdit(obj $image, type $index[, bool $massedit = true ]) : mixed
Image object
Index of the image if within the images list or 0 if single image edit
Whether editing single image (false) or multiple images at once (true). Note: to determine whether to process additional fields in single image edit mode.
adminPageNav(mixed $pagenum, mixed $totalpages, mixed $adminpage, mixed $parms[, mixed $tab = '' ]) : mixed
Generates an editable list of language strings
print_language_string_list(string $dbstring, string $name[, bool $textbox = false ][, string $locale = NULL ][, string $edit = '' ][, int $wide = TEXT_INPUT_SIZE ][, string $ulclass = 'language_string_list' ][, int $rows = 6 ]) : mixed
either a serialized languag string array or a single string
the prefix for the label, id, and name tags
set to true for a textbox rather than a text field
optional locale of the translation desired
optional class
column size. true or false for the standard or short sizes. Or pass a column size
set to the class for the UL element
set to the number of rows to show.
process the post of a language string form
process_language_string_save(string $name[, $sanitize_level = 3 ]) : string
the prefix for the label, id, and name tags
the type of sanitization required
Returns the desired tagsort order (0 for alphabetic, 1 for most used)
getTagOrder() : int
Unzips an image archive
unzip(file $file, string $dir) : mixed
the archive
where the images go
Checks for a zip file
is_zip(string $filename) : bool
name of the file
Extracts and returns a 'statement' from a PHP script so that it may be 'evaled'
isolate(string $target, string $str) : string
the assignment variable to match on
the PHP script
Return an array of files from a directory and sub directories
listDirectoryFiles(string $dir) : array<string|int, mixed>
This is a non recursive function that digs through a directory. More info here:
directory
Check if a theme is editable (ie not a bundled theme)
themeIsEditable( $theme) : bool
zenPhotoTheme(mixed $theme) : mixed
Copy a theme directory to create a new custom theme
copyThemeDirectory( $source, $target, mixed $newname) : bool|string
either true or an error message
Deletes a theme
deleteThemeDirectory(string $source) : bool
Full serverpath of the theme
Return URL of current admin page
currentRelativeURL() : string
current URL
Returns an array of the names of the parents of the current album.
getParentAlbumsAdmin(object $album) : array<string|int, mixed>
optional album object to use inseted of the current album
getAlbumBreadcrumbAdmin(mixed $album) : mixed
Removes the parent album name so that we can print a album breadcrumb with them
removeParentAlbumNames(object $album) : string
Object of the album
Outputs the rights checkbox table for admin
printAdminRightsTable( $id, string $background, string $alterrights, bit $rights) : mixed
Creates the managed album table for Admin
printManagedObjects(string $type, array<string|int, mixed> $objlist, string $alterrights, object $userobj, mixed $prefix_id, string $kind, mixed $flag) : mixed
the kind of list
list of objects
are the items changable
the user
user, group, or template
processes the post of administrator rights
processRights(int $i) : bit
the admin row number
processManagedObjects(mixed $i, mixed &$rights) : mixed
Returns the value of a checkbox form item
getCheckboxState(string $id) : int
the $_REQUEST index
(0 or 1)
Returns an array of "standard" theme scripts. This list is normally used to exclude these scripts form various option seletors.
standardScripts() : array<string|int, mixed>
Returns a merged list of available watermarks
getWatermarks() : array<string|int, mixed>
Processes the serialized array from tree sort.
processOrder( $orderstr) : array<string|int, mixed>
Returns an array in the form [$id=>array(sort orders), $id=>array(sort orders),...]
POST handler for album tree sorts
postAlbumSort(int $parentid) : mixed
id of owning album
Prints the sortable nested albums list returns true if nesting levels exceede the database container
printNestedAlbumsList(mixed $albums, bool $show_thumb, object $owner) : bool
set false to use thumb standin image.
the album object of the owner or NULL for the gallery
Prints the dropdown menu for the nesting level depth for the album sorting
printEditDropdown(mixed $subtab, mixed $nestinglevels, mixed $nesting) : mixed
processEditSelection(mixed $subtab) : mixed
Edit tab bulk actions drop-down
printBulkActions(array<string|int, mixed> $checkarray[, bool $checkAll = false ]) : mixed
the list of actions
set true to include check all box
common redirector for bulk action handling return
bulkActionRedirect(string $action) : mixed
Process the bulk tags
bulkTags() : array<string|int, mixed>
Processes the check box bulk actions for albums
processAlbumBulkActions() : mixed
Handles Image bulk actions
processImageBulkActions( $album) : mixed
Processes the check box bulk actions for comments
processCommentBulkActions() : mixed
Codeblock tabs JavaScript code
codeblocktabsJS() : mixed
prints codeblock edit boxes
printCodeblockEdit(object $obj, int $id) : mixed
handles saveing of codeblock edits
processCodeblockSave(int $id) : string
Standard admin pages checks
admin_securityChecks(bit $rights, mixed $return) : mixed
getPageSelector "diff" function
minDiff(string $string1, string2 $string2) : mixed
returns the shortest string difference
getPageSelector "diff" function
fullText(string $string1, string $string2) : string
Used when you want getPgeSelector to show the full text of the items
getPageSelector "diff" function
dateDiff(string $date1, string $date2) : string
returns the shortest "date" difference
returns a selector list based on the "names" of the list items
getPageSelector(array<string|int, mixed> $list, int $itmes_per_page[, string $diff = 'fullText' ]) : array<string|int, mixed>
"fullText" for the complete names "minDiff" for a truncated string showing just the unique characters of the names "dateDiff" it the "names" are really dates.
printPageSelector(mixed $pagenumber, mixed $rangeset, mixed $script, mixed $queryParams) : mixed
Strips off quotes from the strng
unQuote( $string) : mixed
Returns an option list of administrators who can own albums or images
admin_album_list(string $owner) : string
Returns an array with the logtabs array, the default log tab and an array of log files to the default (current) log tab (for use in the logfile selector)
getLogTabs() : array<string|int, mixed>
Gets an array log tab names and localized (gettexted) log titles
getDefaultLogTabs() : array<string|int, mixed>
Gets a nested array with the log type (tab name) and corresponding log files
getLogFiles() : array<string|int, mixed>
Prints the selector for logfiles of the current log tab
printLogSelector([string $currentlogtab = '' ][, string $currentlogfile = '' ][, array<string|int, mixed> $logfiles = array() ]) : mixed
Current log tab
Current log file selected
Array of logfiles
Figures out which plugin tabs to display
getPluginTabs() : mixed
Gets an array with the size values for the admin thumb generation
getAdminThumbSizes(obj $imageobj[, string $size = 'small' ]) : array<string|int, mixed>
The image object
Adminthumb sizeame: 'large', 'small', 'large-uncropped', 'small-uncropped'
Gets the URL of the adminthumb
getAdminThumb(obj $imageobj[, string $size = 'small' ]) : string
The image object
Adminthumb sizeame: 'large', 'small', 'large-uncropped', 'small-uncropped'
Returns an array with width and height of the resized image
getSizeAdminThumb(obj $imageobj[, string $size = 'small' ]) : array<string|int, mixed>
The image object
Adminthumb sizeame: 'large', 'small', 'large-uncropped', 'small-uncropped'
Returns the full HTML element of an admin thumb Applies the filters 'adminthumb_html'
getAdminThumbHTML(obj $imageobj[, string $size = 'small' ][, string $class = null ][, string $id = null ][, string $alt = null ][, string $title = null ]) : string
The image object
Adminthumb sizeame: 'large', 'small', 'large-uncropped', 'small-uncropped'
Class name(s) to attach
ID to attach
Alt attribute
Title attribute
Prints an admin thumb
printAdminThumb(obj $imageobj[, string $size = 'small' ][, string $class = null ][, string $id = null ][, string $alt = null ][, string $title = null ]) : string
The image object
Adminthumb sizeame: 'large', 'small', 'large-uncropped', 'small-uncropped'
Class name(s) to attach
ID to attach
Alt attribute
Title attribute
handles save of user/password
processCredentials(object $object[, mixed $suffix = '' ]) : mixed
consolidatedEditMessages(mixed $subtab) : mixed
returns an array of the theme scripts not in the exclude array
getThemeFiles(array<string|int, mixed> $exclude) : array<string|int, mixed>
those scripts to ignore
Checks for bad parentIDs from old move/copy bug
checkAlbumParentid(unknown_type $albumname, unknown_type $id, mixed $recorder) : mixed
clonedFrom() : mixed
Make sure the albumimagesort is only an allowed value. Otherwise returns nothing.
checkAlbumimagesort(string $val[, string $type = 'albumimagesort' ]) : string
'albumimagesort' or 'albumimagesort_status'
Prints the last change date and last change user notice on backend edit pages Also for albums it prints the updateddate
printLastChangeInfo(obj $obj) : mixed
Object of any item type
Returns the option array for the sort by selectors for gallery, albums and images
getSortByOptions(string $type) : array<string|int, mixed>
"albums" (also for gallery), "albums-dynamic", 'images' "image-edit" (the images edit tab backend only ordering) "pages" and "news" for Zenpage items
Returns an array of the status order options for all items
getSortByStatusOptions() : array<string|int, mixed>
Helper to check if notes are to be printed (only needed because of the inconvenient legacy table based layout on image edit pages)
checkSchedulePublishingNotes(obj $obj) : bool
Image, album, news article or page object
Prints various notes regarding the scheduled publishing status for single edit pages
printScheduledPublishingNotes(obj $obj) : mixed
Image, album, news article or page object
Prints various notes regarding the scheduled publishing status for single edit pages
printStatusNotes(obj $obj) : mixed
Image, album, news article, new category or page object
Gets a specific predefined status note for an object (if available) Note: The notes are not status dependend!
getStatusNote([string $name = '' ]) : string
Name of the note
Gets an array of all predefined status notes
getStatusNotes() : array<string|int, mixed>
Gets an array with all status notes that apply to $obj currently
getStatusNotesByContext(string $obj) : array<string|int, mixed>
Gets an key => value array of all available object status icons as full <img> elements
getStatusIcons() : array<string|int, mixed>
Gets the icon img element for a specific status icon
getStatusIcon([string $name = '' ]) : string
(Internal) Name of the icon
Prints the publish icon link to change the status on the album and thumb image list
printPublishIconLinkGallery(object $obj[, bool $enableedit = false ][, string $owner = null ]) : mixed
Image or album object
true if allowed to use
User name of the owner
Returns the publish icon for the current status
getPublishIcon(obj $obj) : string
Object of the page or news article to check
Prints the scheduled publishing date for items if set. Also prints the date for Zenpage news articles and pages
printPublished(string $obj) : string
image, albun, news article or page object
Prints the expiration or expired date for items
printExpired(string $obj) : string
image, albun, news article or page object
Prints the protected icon if the object is password protected on an edit list
printProtectedIcon(obj $obj) : mixed
Checks plugin and theme definition for $plugin_disable / $theme_description['disable'] so plugins/themes are deaktivated respectively cannot be activated if they don't match conditions/requirements. See the plugin/theme documentation for info how to define these.
isIncompatibleExtension(string|array<string|int, mixed> $disable) : bool|string
Returns either the message why incompatible or false if not.
One string or serveral as an array. Not false means incompatible
Processes a plugin or theme definition variable.
processExtensionVariable(string|array<string|int, mixed> $var) : string|bool
If a string or boolean it is returned as it is. If it is an array each entry is enclosed with an HTML paragraph and returned as a string
A plugin or theme definition variable
Prints a selector (select list) with a custom text field from the values parameter. The following array entries will be created automatically:
printSelectorWithCustomField(string $optionname[, array<string|int, mixed> $list = array() ][, string $optionlabel = null ][, string $optionname_customfield = null ][, string $optionlabel_customfield = nulll ][, bool $is_galleryoption = false ]) : mixed
If "custom" is selected the custom text field will be shown.
The option name of the select list
Key value array where key is the display value (gettext generally)
The label text for the select list
The option name of the custom field
THe label text for the custom field
Set to true if this is a special gallery class option
Gets an array of Zenpage pages ready for using with selector, radioboxes and checkbox lists
getZenpagePagesOptionsArray([bool $published = false ]) : mixed
true for only published, default false for all.
Prints an select list option for Zenpage pages
printZenpagePageSelector(string $optionname[, string $optionname_custom = null ][, bool $published = false ][, bool $is_galleryoption = false ]) : mixed
it additionally prints a text field for a custom page URL.
Name of the option, sued for the selector and the current selection
If defined this will be used for the custom url option, if null (default) the option name will be used with "_custom" appended
If the pages should include only published ones
Set to true if this is a special gallery class option
Gets an array of administrators ready for using with selector, radioboxes and checkbox lists
getAdminstratorsOptionsArray([string $type = 'users' ]) : type
'users', 'groups', 'allusers'
Prints an select list option for users
printUserSelector(string $optionname, string $optionname_custom[, bool $type = 'users' ][, bool $is_galleryoption = false ]) : mixed
it additionally prints a text field for a custom name
Name of the option, sued for the selector and the current selection
If defined this will be used for the custom url option, if null (default) the option name will be used with "_custom" appended
'users', 'groups', 'allusers'
Set to true if this is a special gallery class option
Helper for the theme editor
isTextFile(type $file) : type
Updates the $_zp_admin_imagelist global used on dynamic album editing
getSubalbumImages(type $folder) : type
Updates $_zp_admin_user_updated on user editing
markUpdated() : mixed
Prints the image EXIF rotation/flipping selector
printImageRotationSelector(obj $imageobj, int $currentimage) : mixed
Object of the current image
ID of the current image
Prints option selectors for date and time formats
printDatetimeFormatSelector() : mixed
Helper functions for printDatetimeFormatSelector() ot create the format lists for the selector, not intended to be used standalone
getDatetimeFormatlistForSelector([array<string|int, mixed> $formats = array() ][, bool $use_localized_date = false ]) : array<string|int, mixed>
Array as created by array_keys(getStandardDateFormats($type);
Default false, set to true to use localized datees
Connect to the database server and select the database.
db_connect(array<string|int, mixed> $config[, bool $errorstop = true ]) : true
the db configuration parameters
set to false to omit error messages
if successful connection
The main query function. Runs the SQL on the connection and handles errors.
query(string $sql[, bool $errorstop = true ]) : results
sql code
set to false to supress the error message
of the sql statements
Runs a SQL query and returns an associative array of the first row.
query_single_row(string $sql[, bool $errorstop = true ]) : results
Doesn't handle multiple rows, so this should only be used for unique entries.
sql code
set to false to supress the error message
of the sql statements
Runs a SQL query and returns an array of associative arrays of every row returned.
query_full_array(string $sql[, bool $errorstop = true ][, string $key = NULL ]) : results
sql code
set to false to supress the error message
optional array index key
of the sql statements
mysqli_real_escape_string standin that insures the DB connection is passed.
db_quote(string $string[, mixed $addquotes = true ]) : string
returns the insert id of the last database insert
db_insert_id() : mixed
Fetch a result row as an associative array
db_fetch_assoc(mixed $resource) : mixed
Returns the text of the error message from previous operation
db_error() : mixed
Get number of affected rows in previous operation
db_affected_rows() : mixed
Get a result row as an enumerated array
db_fetch_row(mixed $result) : mixed
Get number of rows in result
db_num_rows(mixed $result) : mixed
Closes the database
db_close() : mixed
report the software of the database
db_software() : mixed
create the database
db_create() : mixed
Returns user's permissions on the database
db_permissions() : mixed
Sets the SQL session mode to empty
db_setSQLmode() : mixed
Queries the SQL session mode
db_getSQLmode() : mixed
db_collation() : mixed
db_create_table(mixed $sql) : mixed
db_table_update(mixed $sql) : mixed
db_show(mixed $what[, mixed $aux = '' ]) : mixed
db_list_fields(mixed $table) : mixed
db_truncate_table(mixed $table) : mixed
db_LIKE_escape(mixed $str) : mixed
db_free_result(mixed $result) : mixed
Prefix a table name with a user-defined string to avoid conflicts.
prefix([string $tablename = NULL ]) : prefixed
This MUST be used in all database queries.
name of the table
table name
Constructs a WHERE clause ("WHERE uniqueid1='uniquevalue1' AND uniqueid2='uniquevalue2' ...") from an array (map) of variables and their values which identifies a unique record in the database table.
getWhereClause(string $unique_set) : contructed
what to add to the WHERE clause
WHERE cleause
Constructs a SET clause ("SET uniqueid1='uniquevalue1', uniqueid2='uniquevalue2' ...") from an array (map) of variables and their values which identifies a unique record in the database table. Used to 'move' records. Note: does not check anything.
getSetClause(string $new_unique_set) : contructed
what to add to the SET clause
SET cleause
returns the connected database name
db_name() : mixed
Counts entries in a db table
db_count(string $table[, string $clause = NULL ][, string $field = "id" ]) : int
Table name
Where clause for the count query
Which fields to count (default: id)
Returns the server info
db_getServerInfo() : string
Returns the client info
db_getClientInfo() : string
Gets the plain version number
db_getVersion() : int
zp_imageGet(mixed $imgfile) : mixed
zp_imageOutput(mixed $im, mixed $type[, mixed $filename = NULL ][, mixed $qual = 75 ]) : mixed
zp_createImage(mixed $w, mixed $h) : mixed
zp_imageFill(mixed $image, mixed $x, mixed $y, mixed $color) : mixed
zp_imageColorTransparent(mixed $image, mixed $color) : mixed
zp_copyCanvas(mixed $imgCanvas, mixed $img, mixed $dest_x, mixed $dest_y, mixed $src_x, mixed $src_y, mixed $w, mixed $h) : mixed
zp_resampleImage(mixed $dst_image, mixed $src_image, mixed $dst_x, mixed $dst_y, mixed $src_x, mixed $src_y, mixed $dst_w, mixed $dst_h, mixed $src_w, mixed $src_h) : mixed
zp_imageUnsharpMask(mixed $img, mixed $amount, mixed $radius, mixed $threshold) : mixed
zp_imageResizeAlpha(mixed &$src, mixed $w, mixed $h) : mixed
zp_imageCanRotate() : mixed
zp_rotateImage(mixed $im, mixed $rotate) : mixed
zp_imageDims(mixed $filename) : mixed
zp_imageIPTC(mixed $filename) : mixed
zp_imageWidth(mixed $im) : mixed
zp_imageHeight(mixed $im) : mixed
zp_imageMerge(mixed $dst_im, mixed $src_im, mixed $dst_x, mixed $dst_y, mixed $src_x, mixed $src_y, mixed $src_w, mixed $src_h, mixed $pct) : mixed
zp_imageGray(mixed $image) : mixed
zp_imageKill(mixed $im) : mixed
zp_colorAllocate(mixed $image, mixed $red, mixed $green, mixed $blue) : mixed
zp_writeString(mixed $image, mixed $font, mixed $x, mixed $y, mixed $string, mixed $color) : mixed
zp_drawRectangle(mixed $image, mixed $x1, mixed $y1, mixed $x2, mixed $y2, mixed $color) : mixed
zp_graphicsLibInfo() : mixed
zp_getFonts() : mixed
zp_imageLoadFont([mixed $font = NULL ][, mixed $size = 18 ]) : mixed
zp_imageFontWidth(mixed $font) : mixed
zp_imageFontHeight(mixed $font) : mixed
imageBlurGD(mixed $imgCanvas, mixed $imgCanvas2, mixed $radius, mixed $w, mixed $h) : mixed
zp_imageFromString(mixed $string) : mixed
encodes a pre-sanitized string to be used as a Javascript parameter
js_encode(string $this_string) : string
Get a option stored in the database.
getOption(string $key) : mixed
This function reads the options only once, in order to improve performance.
the name of the option.
Stores an option value.
setOption(string $key, mixed $value[, bool $persistent = true ][, string $creator = NULL ]) : mixed
name of the option.
new value of the option.
set to false if the option is stored in memory only. Otherwise it is preserved in the database
name of the creator the option belongs to. Normally NULL for backend core options.
"zp-core/zp-extensions/
Sets the default value of an option.
setOptionDefault(string $key, mixed $default) : mixed
If the option has never been set it is set to the value passed
the option name
the value to be used as the default
Loads option table with album/theme options
loadLocalOptions(int $albumid, string $theme) : mixed
Replaces/renames an option. If the old option exits, it creates the new option with the old option's value as the default unless the new option has already been set otherwise. Independently it always deletes the old option.
renameOption(string $oldkey, string $newkey) : mixed
Old option name
New option name
Deletes an option from the database
purgeOption(string $key) : mixed
Retuns the option array
getOptionList() : array<string|int, mixed>
Returns true if the file has the dynamic album suffix
hasDynamicAlbumSuffix(string $path) : bool
checks if there is a file with the prefix and one of the handled suffixes. Returns the found suffix
isHandledAlbum(string $path) : string
SERVER path to be tested
Handles the special cases of album/image[rewrite_suffix]
rewrite_get_album_image(string $albumvar, string $imagevar) : mixed
Separates the image part from the album if it is an image reference Strips off the mod_rewrite_suffix if present Handles dynamic album names that do not have the .alb suffix appended
$_GET index for "albums"
$_GET index for "images"
Returns the path of an image for uses in caching it NOTE: character set if for the filesystem
getImageCacheFilename(mixed $album8, mixed $image8, array<string|int, mixed> $args) : string
cropping arguments
Returns an i.php "image name" for an image not within the albums structure
makeSpecialImageName(string $image) : array<string|int, mixed>
Path to the image
Returns the watermark image to pass to i.php
getWatermarkParam(object $image, int $use) : int
Note: this should be used for "real" images only since thumbnail handling for Video and TextObjects is special and the "album" thumbnail is not appropriate for the "default" images for those
image object in question
what the watermark use is
Returns the crop/sizing string to postfix to a cache image
getImageCachePostfix(array<string|int, mixed> $args) : string
cropping arguments
Validates and edits image size/cropping parameters
getImageParameters(array<string|int, mixed> $args[, mixed $album = NULL ]) : array<string|int, mixed>
cropping arguments
forms the i.php parameter list for an image.
getImageProcessorURI(array<string|int, mixed> $args, string $album, string $image) : string
the album name
the image name
Extract the image parameters from the input variables
getImageArgs(array<string|int, mixed> $set) : array<string|int, mixed>
Extracts the image processor URI from an existing cache filename
getImageProcessorURIFromCacheName(string $match, array<string|int, mixed> $watermarks) : array<string|int, mixed>
Returns an URI to the image:
getImageURI(array<string|int, mixed> $args, string $album, string $image, mixed $mtime) : string
If the image is not cached, the uri will be to the image processor If the image is cached then the uri will depend on the site option for cache serving. If the site is set for open cache the uri will point to the cached image. If the site is set for protected cache the uri will point to the image processor (which will serve the image from the cache.) NOTE: this latter implies added overhead for each and every image fetch!
the album name
the image name
Extracts integer value (1-9) from the exifOrientation value stored (e.g. '7: 90 deg CCW Mirrored') in the database for images or returns the value if it is an integer
extractImageExifOrientation([string|int $exiforientation = '' ]) : int
String or integer value as stored in the db (e.g. '7: 90 deg CCW Mirrored' or just "7")
Returns an array with two indexes "rotate" (= degree to rotate) and "flip" ("horizontal" or "vertical") or false if nothing applies
getImageFlipRotate(mixed $rotation) : bool|array<string|int, mixed>
Returns an array of html tags allowed
getAllowedTags(string $which) : mixed
either 'allowed_tags' or 'style_tags' depending on which is wanted.
Returns either the rewrite path or the plain, non-mod_rewrite path based on the mod_rewrite option.
rewrite_path(string $rewrite, string $plain[, bool $webpath = NULL ]) : string
The given paths can start /with or without a slash, it doesn't matter.
IDEA: this function could be used to specially escape items in the rewrite chain, like the # character (a bug in mod_rewrite).
This is here because it's used in both template-functions.php and in the classes.
is the path to return if rewrite is enabled. (eg: "/myalbum")
is the path if rewrite is disabled (eg: "/?album=myalbum")
host path to be prefixed. If "false" is passed you will get a localized "WEBPATH"
parses a query string WITHOUT url decoding it!
parse_query(string $str) : mixed
createsa query string from the array passed
build_query(array<string|int, mixed> $parts) : string
Builds a url from parts
build_url(array<string|int, mixed> $parts) : string
rawurlencode function that is path-safe (does not encode /)
pathurlencode(string $path) : string
URL
Returns the fully qualified path to the album folders
getAlbumFolder([string $root = SERVERPATH ]) : string
the base from whence the path dereives
Returns the fully qualified path to the backup folder
getBackupFolder([string $root = SERVERPATH ]) : string
the base from whence the path dereives
Returns the fully qualified path to the root albums or backup folder
getRootFolder([string $folder = 'albumfolder' ][, string $root = SERVERPATH ]) : string
The folder path to get: "albumfolder" or "backupfolder"
the base from whence the path dereives
Rolls a log over if it has grown too large.
switchLog(string $log) : mixed
Write output to the debug log Use this for debugging when echo statements would come before headers are sent or would create havoc in the HTML.
debugLog(string|array<string|int, mixed>|object $message[, bool $reset = false ][, string $logname = 'debug' ]) : mixed
Creates (or adds to) a file named debug.log which is located in the zenphoto core folder
the debug information. This can also be an array or object. For detailed info about the content use debuglogVar().
set to true to reset the log to zero before writing the message
Optional custom log name to log to, default "debug"
Tool to log execution times of script bits
instrument(string $point) : mixed
location identifier
Parses a byte size from a size value (eg: 100M) for comparison.
parse_size(mixed $size) : mixed
getAlbumArray - returns an array of folder names corresponding to the given album string.
getAlbumArray(string $albumstring[, string $includepaths = false ]) : mixed
is the path to the album as a string. Ex: album/subalbum/my-album
is a boolean whether or not to include the full path to the album in each item of the array. Ex: when $includepaths==false, the above array would be ['album', 'subalbum', 'my-album'], and with $includepaths==true, ['album', 'album/subalbum', 'album/subalbum/my-album'] @return array
Returns an img src URI encoded based on the OS of the server
imgSrcURI(string $uri) : string
uri in FILESYSTEM_CHARSET encoding
Returns the suffix of a file name
getSuffix(string $filename) : string
returns a file name sans the suffix
stripSuffix(string $filename) : string
returns the non-empty value of $field from the album or one of its parents
getAlbumInherited(string $folder, string $field, int &$id) : string
the album name
the desired field name
will be set to the album id
of the album which has the non-empty field
primitive theme setup for image handling scripts
themeSetup(string $album) : string
we need to conserve memory so loading the classes is out of the question.
Checks access for the album root
accessAllAlbums(bit $action) : mixed
what the caller wants to do
Returns the path to a watermark
getWatermarkPath(string $wm) : string
watermark name
Checks to see if access was through a secure protocol
secureServer() : bool
Returns the script requesting URI.
getRequestURI() : string
Uses $_SERVER[REQUEST_URI] if it exists, otherwise it concocts the URI from $_SERVER[SCRIPT_NAME] and $_SERVER[QUERY_STRING]
Provide an alternative to glob which does not return filenames with accented charactes in them
safe_glob(string $pattern[, bit $flags = 0 ]) : mixed
NOTE: this function ignores "hidden" files whose name starts with a period!
the 'pattern' for matching files
glob 'flags'
Check to see if the setup script needs to be run
checkInstall() : mixed
Call when terminating a script.
exitZP() : mixed
Closes the database to be sure that we do not build up outstanding connections
Computes the "installation signature" of the Zenphoto install
installSignature() : array<string|int, mixed>
Starts a zenphoto session (perhaps a secure one)
zp_session_start() : mixed
Ends a zenphoto session if there is one and clear the session cookie
zp_session_destroy() : mixed
Reads the core default rewrite token define array from the config template file `zenphoto_cfg.txt`.
getDefaultRewriteTokens([string $token = null ]) : array<string|int, mixed>
Used primarily in case it is missing from the current config file as silent fallback and within the rewriteToken plugin
The token to get, e.g. "gallery". If the token is not existing or NULL the whole definition array is returned
Adds missing individual default rewrite tokens to $_zp_conf_vars['special_pages']
addMissingDefaultRewriteTokens() : mixed
Sends a simple cURL request to the $uri specified.
curlRequest(string $uri[, array<string|int, mixed> $options = array() ]) : bool
The uri to send the request to. Sets curl_setopt($ch, CURLOPT_URL, $uri);
An array of cURL options to set (uri is set via the separate parameter) Default is if nothing is set: array( CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 2000 ) See http://php.net/manual/en/function.curl-setopt.php for more info
Sends a cURL request to i.php to generate the image requested without printing it.
generateImageCacheFile(string $imageuri) : mixed
Returns the uri to the cache version of the image on success or false. It also returns false if cURL is not available.
The image processor uri to this image
Checks if protocol not https and redirects if https required
httpsRedirect([string $type = 'backend' ]) : mixed
Tpye to redirect "backend" (default) or "frontend"
General url redirection handler using header()
redirectURL(string $url[, string $statuscode = null ][, bool $allowexternal = false ]) : mixed
A full qualified url
Default null (no status header). Enter the status header code to send. Currently supported: 200, 301, 302, 401, 403, 404 (more may be added if needed later on) If you need custom headers not supported just set to null and add them separately before calling this function.
True to allow redirections outside of the current domain (does not cover subdomains!). Default false.
Sanitizes a "redirect" post to always be within the site
sanitizeRedirect(string $redirectTo) : string
Wrapper to call a plugin or otherwise possibly undefined function or method to avoid themes breaking if the plugin is not active
callUserFunction(string|array<string|int, mixed> $function[, array<string|int, mixed>|mixed $parameter = array() ]) : mixed
Follows PHP's native call_user_func_array() but tries to catch invalid calls
Note: Invalid static calls to non static class methods cannot be catched unless the native PHP extension Reflection is available.
A function name, static class method calls like classname::methodname, an array with a class name and static method name or a cass object and a non static class name
Parameters of the function/method as one dimensional array. Alternatively you also add separate argments like the original function defines them
Logs a deprecated notice including traces in the debuglog
deprecationNotice(string $use[, bool|string $parameter = false ]) : mixed
Additional message, e.g. what to use instead
Set to true if this should notify about deprecated parameter usage (default false), You can also set the name of the parameter if you want to notify about a specific parameter change only
Basic conversion for a (deprecated) strftime() date format string
convertStrftimeFormat([string $format = '' ]) : string
Returns a date format string compatible with date() / the DateTime class
Note: There are two exceptions that return a non date format string value because there is no equivalent
zpFormattedDate() can handle these internally
strftime() date format string
Returns true if the install is not a "clone"
hasPrimaryScripts() : mixed
Traps errors and insures thy are logged.
zpErrorHandler(int $errno[, string $errstr = '' ][, string $errfile = '' ][, string $errline = '' ]) : void|bool
Converts a file system filename to UTF-8 for zenphoto internal storage
filesystemToInternal(string $filename) : string
the file name to convert
Converts a Zenphoto Internal filename string to one compatible with the file system
internalToFilesystem(string $filename) : string
the file name to convert
Takes user input meant to be used within a path to a file or folder and removes anything that could be insecure or malicious, or result in duplicate representations for the same physical file.
sanitize_path(string $filename) : string
This function is used primarily for album names. NOTE: The initial and trailing slashes are removed!!!
Returns the sanitized path
is the path text to filter.
Checks if the input is numeric, rounds if so, otherwise returns false.
sanitize_numeric(mixed $num) : int
the number to be sanitized
removes script tags
sanitize_script(string $text) : string
Make strings generally clean. Takes an input string and cleans out null-bytes, and optionally use KSES library to prevent XSS attacks and other malicious user input.
sanitize(string $input_string[, string $sanitize_level = 3 ]) : string
is a string that needs cleaning.
is a number between 0 and 3 that describes the type of sanitizing to perform on $input_string. 0 - Basic sanitation. Only strips null bytes. Not recommended for submitted form data. 1 - User specified. (User defined code is allowed. Used for descriptions and comments.) 2 - Text style/formatting. (Text style codes allowed. Used for titles.) 3 - Full sanitation. (Default. No code allowed. Used for text only fields)
the sanitized string.
Internal "helper" function to apply the tag removal
ksesProcess(string $input_string, array<string|int, mixed> $allowed_tags) : string
Cleans tags and some content.
getBare(type $content) : type
returns a sanitized string for the sanitize function
sanitize_string(mixed $input, string $sanitize_level) : string
See sanitize()
the sanitized string.
triggers an error
zp_error(string $message[, mixed $fatal = E_USER_ERROR ]) : mixed
html_decode(mixed $string) : mixed
encodes a pre-sanitized string to be used in an HTML text-only field (value, alt, title, etc.)
html_encode(string $str) : string
HTML encodes the non-metatag part of the string.
html_encodeTagged(string $original[, bool $allowScript = true ]) : string
string to be encoded
set to false to prevent pass-through of script tags.
Convenience wrapper of html_encode(pathurlencode($url)) Primarily intended for use with img src URLs
html_pathurlencode(string $url) : string
Makes directory recursively, returns TRUE if exists or was created sucessfuly.
mkdir_recursive(string $pathname, mixed $mode) : bool
Note: PHP5 includes a recursive parameter to mkdir, but it apparently does not does not traverse symlinks!
The directory path to be created.
TRUE if exists or made or FALSE on failure.
Logs the calling stack
debugLogBacktrace(string $message[, int $omit = 0 ][, string $logname = 'debug' ]) : mixed
Message to prefix the backtrace
Optional custom log name to log to, default "debug"
Records a Var to the debug log
debugLogVar(string $message[, mixed $var = '' ][, string $logname = 'debug' ]) : mixed
message to insert in log [optional]
the variable to record
Optional custom log name to log to, default "debug"
Returns the value of a cookie from either the cookies or from $_SESSION[]
zp_getCookie(string $name) : mixed
the name of the cookie
Encodes a cookie value tying it to the user IP
zp_cookieEncode( $value) : mixed
Sets a cookie both in the browser cookies and in $_SESSION[]
zp_setCookie(string $name, string $value[, timestamp $time = NULL ][, string $path = NULL ][, bool $secure = false ][, bool $httponly = false ]) : mixed
The 'cookie' name
The value to be stored
The time delta until the cookie expires
The path on the server in which the cookie will be available on
true if secure cookie
true if access to this cookie should only be allowed via http (e.g. no access to JS etc.). Requires browser support though.
Clears a cookie
zp_clearCookie(string $name[, string $path = NULl ][, bool $secure = false ][, bool $httponly = false ]) : mixed
The 'cookie' name
The path on the server in which the cookie will be available on
true if secure cookie
true if access to this cookie should only be allowed via http (e.g. no access to JS etc.). Requires browser support though.
if $string is an serialzied array it is unserialized otherwise an appropriate array is returned
getSerializedArray(string $string[, bool $disallow_classes = false ]) : array<string|int, mixed>
Default false, if set to true the unserializing disallows classes. Set to true if using this on user submitted $_GET/$_POST/$_REQUEST data
Updates an item in the configuration file
updateConfigItem(unknown_type $item, unknown_type $value, mixed $zp_cfg[, unknown_type $quote = true ]) : mixed
backs-up and updates the Zenphoto configuration file
storeConfig(string $zp_cfg) : mixed
Creates a "REWRITE" url given the query parameters that represent the link
zpRewriteURL(type $query) : string
Checks to see if the current URL is a query string url when mod_rewrite is active.
fix_path_redirect() : mixed
If so it will redirects to the rewritten URL with a 301 Moved Permanently.
zp_load_page([mixed $pagenum = NULL ]) : mixed
initializes the gallery.
zp_load_gallery() : mixed
Loads the search object.
zp_load_search() : mixed
zp_load_album - loads the album given by the folder name $folder into the global context, and sets the context appropriately.
zp_load_album( $folder[, mixed $force_nocache = false ]) : the
the folder name of the album to load. Ex: 'testalbum', 'test/subalbum', etc.
loaded album object on success, or (===false) on failure.
zp_load_image - loads the image given by the $folder and $filename into the global context, and sets the context appropriately.
zp_load_image( $folder, $filename) : the
is the folder name of the album this image is in. Ex: 'testalbum'
is the filename of the image to load.
loaded album object on success, or (===false) on failure.
Loads a zenpage pages page Sets up $_zp_current_zenpage_page and returns it as the function result.
load_zenpage_pages( $titlelink) : object
the titlelink of a zenpage page to setup a page object directly. Used for custom page scripts based on a zenpage page.
Loads a zenpage news article Sets up $_zp_current_zenpage_news and returns it as the function result.
load_zenpage_news(array<string|int, mixed> $request) : object
an array with one member: the key is "date", "category", or "title" and specifies what you want loaded. The value is the date or title of the article wanted
Figures out what is being accessed and calls the appropriate load function
zp_load_request() : bool
sets up for loading the index page
prepareIndexPage() : string
sets up for loading an album page
prepareAlbumPage() : mixed
sets up for loading an image page
prepareImagePage() : string
sets up for loading p=page pages
prepareCustomPage() : string
Handles redirections via filter hook "redirection_handler".
redirectionHandler() : mixed
It is meant to perform redirections of pages that have been removed or renamed.
Registers a filtering function Filtering functions are used to post process zenphoto elements or to trigger functions when a filter occur
zp_register_filter(string $hook, callable $function_name[, int $priority = NULL ]) : mixed
Typical use:
zp_register_filter('some_hook', 'function_handler_for_hook');
global array $_zp_filters Storage for all of the filters
the name of the zenphoto element to be filtered
the name of the function that is to be called.
optional. Used to specify the order in which the functions associated with a particular action are executed (default=5, higher=earlier execution, and functions with the same priority are executed in the order in which they were added to the filter)
Build Unique ID for storage and retrieval.
zp_filter_unique_id(string $hook, string|array<string|int, mixed> $function, int|bool $priority) : string
Simply using a function name is not enough, as several functions can have the same name when they are enclosed in classes.
global array $_zp_filters storage for all of the filters
hook to which the function is attached
used for creating unique id
used in counting how many hooks were applied. If === false and $function is an object reference, we return the unique id only if it already has one, false otherwise.
unique ID for usage as array key
Performs a filtering operation on a zenphoto element or event.
zp_apply_filter(string $hook[, mixed $value = '' ]) : mixed
This function is called for each zenphoto element which supports plugin filtering. It is called after any zenphoto specific actions are completed and before the element is used.
Typical use:
1) Modify a variable if a function is attached to hook 'zp_hook'
$zp_var = "default value";
$zp_var = zp_apply_filter( 'zp_hook', $zp_var );
2) Trigger functions is attached to event 'zp_event'
zp_apply_filter( 'zp_event' );
Returns an element which may have been filtered by a filter.
global array $_zp_filters storage for all of the filters
the name of the zenphoto element
the value of the element before filtering
Removes a function from a specified filter hook.
zp_remove_filter(string $hook, callable $function_to_remove[, int $priority = NULL ][, int $accepted_args = 1 ]) : bool
This function removes a function attached to a specified filter hook. This method can be used to remove default functions attached to a specific filter hook and possibly replace them with a substitute.
To be removed the $function_to_remove and $priority arguments must match when the hook was added.
global array $_zp_filters storage for all of the filters
The filter hook to which the function to be removed is hooked.
The name of the function which should be removed.
optional. The priority of the function. If not supplied we will get it from zp_has_filter
optional. The number of arguments the function accpets (default: 1).
Whether the function was registered as a filter before it was removed.
Check if any filter has been registered for a hook.
zp_has_filter(string $hook[, callable $function_to_check = false ]) : int|bool
global array $_zp_filters storage for all of the filters
The name of the filter hook.
optional. If specified, return the priority of that function on this hook or false if not attached.
Optionally returns the priority on that hook for the specified function.
returns a list of scripts that have attached to the hook
get_filterScript(string $hook) : string
Returns the position of the function in the hook queue
zp_filter_slot( $hook, $function) : mixed
functions-i18n.php -- support functions for internationalization
getLanguageArray() : mixed
Returns an array of available language locales.
generateLanguageList([mixed $all = false ]) : array<string|int, mixed>
Sets the locale, etc. to the zenphoto domain details.
setMainDomain() : mixed
Returns the result of setupCurrentLocale()
Gettext replacement function for separate translations of third party themes.
gettext_th(string $string[, string $theme = Null ]) : string
The string to be translated
The name of the plugin. Only required for strings on the 'theme_description.php' file like the general theme description. If the theme is the current theme the function sets it automatically.
ngettext replacement function for separate translations of third party themes.
ngettext_th(string $msgid1, string $msgid2, int $n[, string $theme = NULL ]) : string
Gettext replacement function for separate translations of third party plugins within the root plugins folder.
gettext_pl(string $string, string $plugin) : string
The string to be translated
The name of the plugin. Required.
ngettext replacement function for separate translations of third party plugins within the root plugins folder.
ngettext_pl(string $msgid1, string $msgid2, int $n, string $plugin) : string
Wrapper function for setLocale() so that all the proper permutations are used Returns the result from the setLocale call
i18nSetLocale( $locale) : string
Sets the translation domain and type for optional theme or plugin based translations
setupDomain([mixed $domain = NULL ][, $type = NULL ]) : mixed
Setup code for gettext translation Returns the result of the setlocale call
setupCurrentLocale([string $override = NULL ]) : mixed
force locale to this
Converts underscore locales like "en_US" to valid IANA/BCP 47 hyphen locales like "en-US" Needed for example in JS or HTML "lang" attributes.
getLangAttributeLocale([string $locale = NULL ]) : string
a locale like "en_US", if empty the current locale is used
This function will parse a given HTTP Accepted language instruction (or retrieve it from $_SERVER if not provided) and will return a sorted array. For example, it will parse fr;en-us;q=0.8
parseHttpAcceptLanguage([string $str = NULL ]) : array<string|int, mixed>
Thanks to Fredbird.org for this code.
optional language string
checks a "supplied" locale against the valid locales.
validateLocale(string $userlocale, mixed $source) : mixed
Returns a valid locale if one exists else returns NULL
Returns a saved (or posted) locale. Posted locales are stored as a cookie.
getUserLocale() : mixed
Sets the 'locale' option to the result (non-persistent)
Returns the sring for the current language from a serialized set of language strings Defaults to the string for the current locale, the en_US string, or the first string which ever is present
get_language_string(string $dbstring[, string $locale = NULL ]) : string
either a serialized languag string array or a single string
optional locale of the translation desired
Returns a list of timezones
getTimezones() : unknown
Returns the difference between the server timez one and the local (users) time zone
timezoneDiff(string $server, string $local) : int
returns a serialized "multilingual array" of translations Used for setting default options with multi-lingual strings.
getAllTranslations(string $text) : mixed
to be translated
creates an SEO language prefix list
getLanguageSubdomains() : mixed
Returns a canonical language name string for the location
getLanguageText([string $loc = NULL ][, mixed $separator = NULL ]) : string
the location. If NULL use the current cookie
Gets all locales suppported on the current server as a multidimensional array
getSystemLocales([bool $plainarray = false ]) : array<string|int, mixed>
Default false for a multidimensial array grouped by locale base. Set to true to generate a single dimensional array with all locales.
Returns the real language name to the locale passed.
getLanguageDisplayName(string $locale) : string
If available it will use the native PHP Locale class. It returns the name in the language/locale currently set. Otherwise the far more limited internal Zenphoto catalogue stored in getLanguageArray() will be used.
A vaild locale.
Prints the lang="" attribute for the main <html> element.
printLangAttribute([string $locale = null ]) : mixed
Default null so the current locale is used. Or a locale like "en_US" which will get the underscores replaced by hyphens to be valid
Returns a locale aware - e.g. translated day and month names - formatted date. Requires the PHP intl extension to work properly Otherwise returns standard formatted date.
getFormattedLocaleDate([string $format = 'Y-m-dd' ][, string|int $datetime = '' ]) : string
An ICU dateformat string
A date() compatible string or a timestamp. If empty "now" is used
imageError(string $status_text, string $errormessage[, string $errorimg = 'err-imagegeneral.png' ][, string $image = '' ][, string $album = '' ][, string $newfilename = '' ]) : mixed
the error message to print if $_GET['debug'] is set.
the filename of the error image to display for production. Defaults to 'err-imagegeneral.png'. Images should be located in /zp-core/images_errors .
Prints debug information from the arguments to i.php.
imageDebug(string $album, string $image, array<string|int, mixed> $args, string $imgfile) : mixed
alubm name
image name
size/crop arguments
the filename of the image
Calculates proprotional width and height Used internally by cacheImage
propSizes(int $size, int $width, int $height, int $w, int $h, int $thumb, int $image_use_side, int $dim) : array<string|int, mixed>
Returns array containing the new width and height
iptc_make_tag() function by Thies C. Arntzen
iptc_make_tag( $rec, $data, $value) : mixed
Creates the cache folder version of the image, including watermarking
cacheImage(string $newfilename, string $imgfile, array<string|int, mixed> $args[, bool $allow_watermark = false ][, string $theme = null ][, string $album = null ]) : mixed
the name of the file when it is in the cache
the image name
the cropping arguments
set to true if image may be watermarked
the current theme
the album containing the image
Determines the rotation of the image by looking at EXIF information.
getImageRotation(string $imgfile) : array<string|int, mixed>|false
Returns an array with two indexes "rotate" (= degree to rotate) and "flip" ("horizontal" or "vertical") or false if nothing applies
the image name
Adds a watermark to a resized image. If no watermark is set it just returns the image
addWatermark(resource|object $newim, string $watermark_image[, string $imgfile = null ]) : resource|object
GD image resource or Imagick object
The path to the watermark to use
Path to the image being processed (optionally for debugging only)
Checks if an processed image is a GD library image
isGDImage(mixed $image) : bool
And Image resource (PHP < 8) or GDImage object (PHP 8+)
Executes the configuration change code
reconfigureAction(int $mandatory) : mixed
0-3 0 means signature change where 1 means setup must autorun assuming a fresh install
Checks details of configuration change
checkSignature(bool $auto) : type
Notification handler for configuration change
signatureChange([string $tab = NULL ][, string $subtab = NULL ]) : string
Adds the reconfigure notification via filters
addReconfigureNote() : mixed
prints HTML for the configuration change notification
printReconfigureNote(array<string|int, mixed> $diff, type $needs, type $mandatory) : mixed
Gets data for the configuration change notification
getReconfigureNote(array<string|int, mixed> $diff, type $needs, type $mandatory) : array<string|int, mixed>
Also adds entries to the debuglog.
Prints an error page on the frontend if a mandatory reconfigure issue occurred but the visitor is not loggedin with appropiate rights.
printReconfigureError(mixed $mandatory) : mixed
Adds debuglog entries about the reconfigure note
debuglogReconfigureNote(array<string|int, mixed> $notice) : mixed
reconfigure notice array as returned by getReconfigureNote()
If setup request a run because of a signature change this refreshes the signature on full admin user request so it is ignored until the next signature change.
ignoreSetupRunRequest() : mixed
Checks if setup files are protected. Returns array of the protected files or empty array
isSetupProtected() : array<string|int, mixed>
Unprotectes setup files
unprotectSetupFiles() : mixed
Protects setup files
protectSetupFiles() : mixed
CSS for the configuration change notification
reconfigureCSS() : mixed
"Rewrite" handling for Zenphoto
rewriteHandler() : mixed
The basic rules are found in the rewrite-rules.txt file. Additional rules can be provided by plugins. But for the plugin to load in time for the rules to be seen it must be either a CLASS_PLUGIN or a FEATURE_PLUGIN. Plugins add rules by inserting them into the $_zp_conf_vars['special_pages'] array. Each "rule" is an array of three elements: define, rewrite, and (optionally) rule.
Elemments which have a define and no rule are processed by rewrite rules in the rewrite-rules.txt file and the define is used internally to Zenphoto to reference the rewrite text when building links.
Elements with a rule defined are processed after Search, Pages, and News rewrite rules and before Image and album rewrite rules. The tag %REWRITE% in the rule is replaced with the rewrite text before processing the rule. Thus rewrite is the token that should appear in the acutal URL.
It makes no sense to have an element without either a define or a rule as nothing will happen.
At present all rules are presumed to to stop processing the rule set. Historically that is what all our rules have done, but I suppose we could change that. The "R" flag may be used to cause a header status to be sent. However, we do not redirect back to index.php, so the "R" flag is only useful if the target is a different script.
getRules() : mixed
parses the allowed HTML tags for use by htmLawed
parseAllowedTags(string &$source) : array<string|int, mixed>
by name, contains the string with the tag options
the allowed_tags array.
Search for a thumbnail for the image
checkObjectsThumb( $localpath) : string
Returns a truncated string
truncate_string(string $string, int $length[, string $elipsis = '...' ]) : string
souirce string
how long it should be
the text to tack on indicating shortening
Fixes unbalanced HTML tags. Uses the library htmlawed or if available the native PHP extension tidy
tidyHTML(string $html) : string
Returns truncated html formatted content
shortenContent(string $articlecontent, int $shorten, string $shortenindicator[, bool $forceindicator = false ]) : string
the source string
new size
set to true to include the indicator no matter what
Returns a sort field part for querying Note: $sorttype may be a comma separated list of field names. If so, these are peckmarked and returned otherwise unchanged.
lookupSortKey(string $sorttype, string $default, string $table) : string
the 'Display" name of the sort
the default if $sorttype is empty
the database table being used.
Returns a formatted date for output
zpFormattedDate([string $format = '' ][, string|int $datetime = '' ][, bool $localized_date = null ]) : string
A datetime compatible format string. Leave empty to use the option value. NOTE: If $localize_date = true you need to provide an ICU dateformat string instead of a datetime format string unless you pass a date format constant like DATETIME_DISPLAYFORMAT using one of the standard formats.
the date to be formatted. Can be a date string or a timestamp.
Default null to use the related option setting. Set to true to use localized dates. PHP intl extension required
Returns a datetime object
getDatetimeObject([string|int $datetime = '' ]) : object
the date to be output. Can be a date string or a timestamp. If empty "now" is used
Returns an array with datetime (keys) and ICU dateformat (values) strings
getStandardDateFormats([string $type = "datetime" ]) : array<string|int, mixed>
"date" for date formats without time, "time" for time formats, "datetime" for both combined
Simple SQL timestamp formatting function.
myts_date(string $format, int $mytimestamp) : string
formatting template
timestamp
Send an mail to the mailing list. We also attempt to intercept any form injection attacks by slime ball spammers. Returns error message if send failure.
zp_mail(string $subject, string $message[, array<string|int, mixed> $email_list = NULL ][, array<string|int, mixed> $cc_addresses = NULL ][, array<string|int, mixed> $bcc_addresses = NULL ][, string $replyTo = NULL ]) : string
The subject of the email.
The message contents of the email.
a list of email addresses to send to
a list of addresses to send copies to.
a list of addresses to send blind copies to.
reply-to address
Sorts the results of a DB search by the current locale string for $field
sortByMultilingual(array<string|int, mixed> $dbresult, string $field, bool $descending) : array<string|int, mixed>
the result of the DB query
the field name to sort on
the direction of the sort
the sorted result
Checks to see access is allowed to an album Returns true if access is allowed.
checkAlbumPassword(string $album[, string &$hint = NULL ]) : bool
There is no password dialog--you must have already had authorization via a cookie.
album object or name of the album
becomes populated with the password hint.
Returns a consolidated list of plugins The array structure is key=plugin name, value=plugin path
getPluginFiles(string $pattern[, string $folder = '' ][, bool $stripsuffix = true ]) : array<string|int, mixed>
File system wildcard matching pattern to limit the search
subfolder within the plugin folders to search
set to true to remove the suffix from the key name in the array
Returns the fully qualified file path of a plugin file.
getPlugin(string $plugin[, bool $inTheme = false ][, bool $webpath = false ]) : string|false
Note: order of selection is if the file is named "something.php":
First file found is used. Returns false if no file is found.
is the name of the plugin file, typically something.php
tells where to find the plugin. true means look in the current theme. This for example can be also used to load a additional custom css file for theme customizations so the theme itself does not need to be modified. false means look in the zp-core/plugins folder.
return a WEBPATH rather than a SERVERPATH
Returns an array of the currently enabled plugins
getEnabledPlugins() : array<string|int, mixed>
Returns if a plugin is enabled
extensionEnabled(string $extension) : bool
Enables a plugin
enableExtension(string $extension, int $priority[, bool $persistent = true ]) : mixed
Disables an extension
disableExtension(string $extension[, bool $persistent = true ]) : mixed
Populates and returns the $_zp_admin_album_list array
getManagedAlbumList() : array<string|int, mixed>
Returns a list of album names managed by $id
populateManagedObjectsList(string $type, int $id[, bool $rights = false ]) : array<string|int, mixed>
which kind of object
admin ID
set true for album sub-rights
Returns an array of album ids whose parent is the folder
getAllSubAlbumIDs([string $albumfolder = '' ]) : array<string|int, mixed>
folder name if you want a album different >>from the current album
recovers search parameters from stored cookie, clears the cookie
handleSearchParms(string $what[, string $album = NULL ][, string $image = NULL ]) : mixed
the page type
Name of the album
Name of the image
Returns the number of album thumbs that go on a gallery page
galleryAlbumsPerPage() : int
Returns the theme folder If there is an album theme, loads the theme options.
setupTheme([object $album = NULL ]) : string
album object if override desired
Returns an array of unique tag names
getAllTagsUnique([bool $checkaccess = false ]) : array<string|int, mixed>
Set to true if you wish to exclude tags that are assigned to items (or are not assigned at all) the visitor is not allowed to see Beware that this may cause overhead on large sites. Usage of the static_html_cache plugin is strongely recommended.
Returns an array indexed by 'tag' with the element value the count of the tag
getAllTagsCount([bool $exclude_unassigned = false ][, bool $checkaccess = false ]) : array<string|int, mixed>
Set to true if you wish to exclude tags that are not assigne to any item
Set to true if you wish to exclude tags that are assigned to items (or are not assigned at all) the visitor is not allowed to see If set to true it overrides the $exclude_unassigned parameter. Beware that this may cause overhead on large sites. Usage of the static_html_cache plugin is strongely recommended.
Checks if a tag is assigned at all and if it can be viewed by the current visitor and returns the corrected count Helper function used optionally within getAllTagsCount() and getAllTagsUnique()
getTagCountByAccess(array<string|int, mixed> $tag) : int
Array representing a tag containing at least its name and id
Stores tags for an object
storeTags(array<string|int, mixed> $tags, int $id, string $tbl) : mixed
the tag values
the record id of the album/image
database table of the object
Retrieves the tags for an object Returns them in an array
readTags(int $id, string $tbl) : unknown
the record id of the album/image
'albums' or 'images', etc.
Creates the body of a select list
generateListFromArray(array<string|int, mixed> $currentValue, array<string|int, mixed> $list, bool $descending, bool $localize) : mixed
list of items to be flagged as checked
the elements of the select list
set true for a ascending order sort. Set to null to keep the array as it is passed.
set true if the keys as description should be listed instead of the plain values
Generates a selection list from files found on disk
generateListFromFiles(strig $currentValue, string $root, string $suffix[, bool $descending = false ]) : mixed
the current value of the selector
directory path to search
suffix to select for
set true to get a reverse order sort. Set to null to keep the array as it is passed.
Helper to generate attributename="attributevalue" for HTML elements based on an array consisting of key => value pairs
generateAttributesFromArray([array<string|int, mixed> $attributes = array() ][, array<string|int, mixed> $exclude = array() ]) : string
Returns a string with with prependend space to directly use with an HTML element.
Note: There is no check if these attributes are valid. Also values are not html_encoded as that could break for example JS event handlers. Do this in your attribute definition array as needed. Attributes with an empty value are skipped except the alt attribute or known boolean attributes (see in function definition)
key => value pairs of element attribute name and value. e.g. array('class' => 'someclass', 'id' => 'someid');
Names of attributes to exclude (in case already set otherwise)
getLinkHTML(string $url, string $text[, string $title = NULL ][, string $class = NULL ][, string $id = NULL ][, array<string|int, mixed> $extra_attr = array() ]) : mixed
The link URL
The text to go with the link
Text for the title tag
optional class
optional id
Additional attributes as array of key => value pairs
General link printing function
printLinkHTML(string $url, string $text[, string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
The link URL
The text to go with the link
Text for the title tag
optional class
optional id
shuffles an array maintaining the keys
shuffle_assoc(array<string|int, mixed> &$array) : bool
sorts the found albums (images) by the required key(s)
sortByKey(array<string|int, mixed> $results, string $sortkey, string $order) : mixed
NB: this sort is sensitive to the key(s) chosen and makes the appropriate sorts based on same. Some multi-key sorts will not make any sense and will give unexpected results. Most notably any that contain the keys "title" or "desc" as these require multi-lingual sorts.
multidimensional array column sort
sortMultiArray(array<string|int, mixed> $array, mixed $index[, string $descending = false ][, bool $natsort = true ][, bool $case_sensitive = false ][, bool $preservekeys = false ][, array<string|int, mixed> $remove_criteria = array() ]) : array<string|int, mixed>
If the system's PHP has the native intl extension and its Collator class available the sorting is locale aware (true natural order) and always case sensitive if $natsort is set to true
The multidimensional array to be sorted
Which key(s) should be sorted by
true for descending sortorder
If natural order should be used. If available sorting will be locale aware.
If the sort should be case sensitive. Note if $natsort is true and locale aware sorting is available sorting is always case sensitive
Default false,
Array of indices to remove.
General one dimensional array sorting function. Key/value associations are preserved.
sortArray(array<string|int, mixed> &$array[, string $descending = false ][, bool $natsort = true ][, bool $case_sensitive = false ]) : bool
If the system's PHP has the native intl extension and its Collator class available and $natsort is set to true the sorting is locale sensitive (true natural order).
The function follows native PHP array sorting functions (natcasesort() etc.) and uses the array by reference and returns true or false on success or failure.
The array to sort. The array is passed by reference
true for descending sorts (default false)
If natural order should be used (default true). If available sorting will be locale sensitive.
If the sort should be case sensitive (default false). Note if $natsort is true and locale aware sorting is available sorting is always case sensitive
Returns a list of album IDs that the current viewer is not allowed to see
getNotViewableAlbums() : array<string|int, mixed>
Returns a list of image IDs that the current viewer is not allowed to see
getNotViewableImages() : array<string|int, mixed>
Checks to see if a URL is valid
isValidURL(string $url) : bool
the URL being checked
pattern match function Works with characters with diacritical marks where the PHP one does not.
safe_fnmatch(string $pattern, string $string) : bool
pattern
haystack
Returns true if the mail address passed is valid.
isValidEmail(string $email) : bool
It uses PHP's internal filter_var
functions to validate the syntax but not the existence.
An email address
returns a list of comment record 'types' for "images"
zp_image_types(string $quote) : string
quotation mark to use
Copies a directory recursively
dircopy(string $srcdir, string $dstdir) : the
the source directory.
the destination directory.
total number of files copied.
Returns a byte size from a size value (eg: 100M).
byteConvert(int $bytes) : string
Converts a datetime to connoical form
dateTimeConvert(string $datetime[, bool $raw = false ]) : mixed
input date/time string
set to true to return the timestamp otherwise you get a string
Removes the time zone info from date formats like "2009-05-14T13:30:29+10:00" as stored for e.g. image meta data
removeDateTimeZone(string $date) : string
get_context() : mixed
set_context(mixed $context) : mixed
in_context(mixed $context) : mixed
add_context(mixed $context) : mixed
rem_context(mixed $context) : mixed
save_context() : mixed
restore_context() : mixed
Returns the current item object (image, album and Zenpage page, article, category) of the current theme context or false if no context is set or matches
getContextObject() : bool|obj
checks password posting
zp_handle_password([string $authType = NULL ][, mixed $check_auth = NULL ][, mixed $check_user = NULL ]) : mixed
override of athorization type
Handles a passwort
zp_handle_password_single([string $authType = NULL ][, string $check_auth = NULL ][, string $check_user = NULL ]) : bool
override of authorization type
Password
User
Gets an option directly from the database.
getOptionFromDB(string $key) : mixed
Set options local to theme and/or album
setThemeOption(string $key, string $value, object $album, string $theme[, bool $default = false ]) : mixed
default theme
set to true for setting default theme options (does not set the option if it already exists)
Replaces/renames an option. If the old option exits, it creates the new option with the old option's value as the default unless the new option has already been set otherwise. Independently it always deletes the old option.
replaceThemeOption(string $oldkey, string $newkey) : mixed
Old option name
New option name
Deletes an theme option for a specific or the current theme from the database
purgeThemeOption(string $key[, mixed $album = NULL ][, mixed $theme = NULL ][, mixed $allthemes = false ]) : mixed
Deletes a theme option for all themes present or not
purgeThemeOptionTotal(string $key) : mixed
Used to set default values for theme specific options
setThemeOptionDefault(string $key, mixed $value) : mixed
Returns the value of a theme option
getThemeOption(string $option[, object $album = NULL ][, string $theme = NULL ]) : mixed
option key
default theme name
Returns the viewer's IP address Deals with transparent proxies
getUserIP([bool $anonymize = null ]) : string
If null (default) the backend option setting is used. Override with anonymize levels
Anonymizing of IP addresses
getAnonymIP(mixed $ip[, bool $anonymize = null ]) : string
If null (default) the backend option setting is used. Override with anonymize levels
Strips out and/or replaces characters from the string that are not "soe" friendly
seoFriendly(string $string) : string
emit the javascript seojs() function
seoFriendlyJS() : mixed
Returns true if there is an internet connection
is_connected([string $host = 'www.zenphoto.org' ]) : bool
optional host name to test
produce debugging information on 404 errors
debug404(string $album, string $image, string $theme) : mixed
Checks for Cross Site Request Forgeries
XSRFdefender(string $action) : mixed
returns an XSRF token
getXSRFToken(string $action) : mixed
Emits a "hidden" input for the XSRF token
XSRFToken(string $action) : mixed
Starts a sechedule script run
cron_starter(string $script, array<string|int, mixed> $params, mixed $offsetPath[, bool $inline = false ]) : mixed
The script file to load
"POST" parameters
set to true to run the task "in-line". Set false run asynchronously
Check if logged in (with specific rights) Returns a true value if there is a user logged on with the required rights
zp_loggedin([bit $rights = ALL_RIGHTS ]) : bool
rights required by the caller
Provides an error protected read of image EXIF/IPTC data
read_exif_data_protected(string $path) : array<string|int, mixed>
image path
fetches the path to the flag image
getLanguageFlag(string $lang) : string
whose flag
Gets an item object by id
getItemByID(string $table, int $id) : mixed
database table to search
id of the item to get
uses down and up arrow links to show and hide sections of HTML
reveal(string $content[, bool $visible = false ]) : mixed
the id of the html section to be revealed
true if the content is initially visible
Deals with the [macro parameters] substitutions
applyMacros(string $text) : string
See the macroList plugin for details
getMacros() : mixed
generates a nested list of albums for the album tab sorting Returns an array of "albums" each element contains: 'name' which is the folder name 'sort_order' which is an array of the sort order set
getNestedAlbumList( $subalbum, $levels[, $checkalbumrights = true ][, $level = array() ]) : array<string|int, mixed>
root level album (NULL is the gallery)
how far to nest
TRUE (Default) for album rights for backend usage, FALSE to skip for frontend usage
internal for keeping the sort order elements
initializes the $_zp_exifvars array display state
setexifvars() : mixed
Recursively clears and removes a folder
removeDir(string $path[, mixed $within = false ]) : bool
inserts location independent WEB path tags in place of site path tags
tagURLs(string $text) : mixed
reverses tagURLs()
unTagURLs(string|array<string|int, mixed> $text) : string
Searches out i.php image links and replaces them with cache links if image is cached
updateImageProcessorLink(string $text) : string
pluginDebug(mixed $extension, mixed $priority, mixed $start) : mixed
Removes a trailing slash from a string if one exists, otherwise just returns the string Used primarily within date and tag searches and news date archive results
removeTrailingSlash(string $string) : string
Returns an array the data privacy policy page and the data usage confirmation text as defined on Options > Security array( 'notice' => '<The defined text>', 'url' => '<url to the define page either custom page url or Zenpage page>', 'linktext' => '<The defined text>' )
getDataUsageNotice() : array<string|int, mixed>
Prints the data privacy policy page and the data usage confirmation text as defined on Options > Security If there is no page defined it only prints the default text.
printDataUsageNotice() : mixed
Returns an array with predefined info about general cookies set by the system and/or plugins
getCookieInfoData([string $section = null ]) : array<string|int, mixed>
Name of the section to get: 'authentication', 'search', 'admin', 'cookie', 'various' or null (default) for the full array
Returns a definition list with predefined info about general cookies set by the system and/or plugins as a string
getCookieInfoHTML([string $section = null ][, string $sectionheadline = 'h2' ]) : string
Name of the section to get: 'authentication', 'search', 'admin', 'cookie', 'various' or null (default) for the full array
Add h2 to h6 to print as the section headline, h2 default.
Prints a definition list with predefined info about general cookies set by the system and/or plugins
printCookieInfo([string $section = null ][, string $sectionheadline = 'h2' ]) : mixed
Name of the section to get: 'authentication', 'search', 'admin', 'cookie', 'various' or null (default) for the full array
Add h2 to h6 to print as the section headline, h2 default.
Registers the content macro(s)
getCookieInfoMacro(array<string|int, mixed> $macros) : array<string|int, mixed>
Passes through the array of already registered
Gets a formatted metadata field value for display
getImageMetadataValue([string $type = '' ][, mixed $value = '' ][, string $name = '' ]) : mixed
The field type
The field value
The field name (Metadata Key)
Prints a formatted metadata field value
printImageMetadataValue(string $type[, mixed $value = '' ][, string $name = '' ]) : mixed
The field type
The field value
The field name (Metadata Key)
encryption support functions
rc4(mixed $pass, mixed $message) : mixed
Dummy routines so zenphoto will run on servers that do not have PHP getttext support.
bindtextdomain(mixed $domain, mixed $path) : mixed
Wrappers used as a drop in replacement for the standard gettext functions
Only include if the native PHP extension gettext is not available!
bind_textdomain_codeset(mixed $domain, mixed $codeset) : mixed
textdomain(mixed $domain) : mixed
gettext(mixed $msgid) : mixed
ngettext(mixed $msgid1, mixed $msgid2, mixed $n) : mixed
dgettext(mixed $plugin, mixed $string) : mixed
dngettext(mixed $theme, mixed $msgid1, mixed $msgid2, mixed $n) : mixed
This function makes sure that only the allowed HTML element names, attribute names and attribute values plus only sane HTML entities will occur in $string. You have to remove any slashes from PHP's magic quotes before you call this function.
kses(type $string, type $allowed_html[, type $allowed_protocols = array('http', 'https', 'ftp', 'news', 'nntp', 'telnet', 'gopher', 'mailto') ]) : type
You add any kses hooks here.
kses_hook(mixed $string) : mixed
This function returns kses' version number.
kses_version() : mixed
This function searches for HTML tags, no matter how malformed. It also matches stray ">" characters.
kses_split(mixed $string, mixed $allowed_html, mixed $allowed_protocols) : mixed
This function does a lot of work. It rejects some very malformed things like <:::>. It returns an empty string, if the element isn't allowed (look ma, no strip_tags()!). Otherwise it splits the tag into an element and an attribute list.
kses_split2(type $matches) : string
This function removes all attributes, if none are allowed for this element.
kses_attr(type $element, type $attr, type $allowed_html, type $allowed_protocols) : type
If some are allowed it calls kses_hair() to split them further, and then it builds up new HTML code from the data that kses_hair() returns. It also removes "<" and ">" characters, if there are any left. One more thing it does is to check if the tag has a closing XHTML slash, and if it does, it puts one in the returned code as well.
This function does a lot of work. It parses an attribute list into an array with attribute data, and tries to do the right thing even if it gets weird input. It will add quotes around attribute values that don't have any quotes or apostrophes around them, to make it easier to produce HTML code that will conform to W3C's HTML specification. It will also remove bad URL protocols from attribute values.
kses_hair(type $attr, type $allowed_protocols) : type
This function performs different checks for attribute values. The currently implemented checks are "maxlen", "minlen", "maxval", "minval" and "valueless" with even more checks to come soon.
kses_check_attr_val(type $value, type $vless, type $checkname, type $checkvalue) : bool
This function removes all non-allowed protocols from the beginning of $string. It ignores whitespace and the case of the letters, and it does understand HTML entities. It does its work in a while loop, so it won't be fooled by a string like "javascript:javascript:alert(57)".
kses_bad_protocol(type $string, type $allowed_protocols) : type
This function removes any NULL characters in $string.
kses_no_null(type $string) : type
This function changes the character sequence \" to just " It leaves all other slashes alone. It's really weird, but the quoting from preg_replace(//e) seems to require this.
kses_stripslashes(type $string) : type
This function goes through an array, and changes the keys to all lower case.
kses_array_lc(mixed $inarray) : mixed
This function removes the HTML JavaScript entities found in early versions of Netscape 4.
kses_js_entities(type $string) : type
This function deals with parsing errors in kses_hair(). The general plan is to remove everything to and including some whitespace, but it deals with quotes and apostrophes as well.
kses_html_error(type $string) : type
This function searches for URL protocols at the beginning of $string, while handling whitespace and HTML entities.
kses_bad_protocol_once(type $string, type $allowed_protocols) : type
This function processes URL protocols, checks to see if they're in the white- list or not, and returns different data depending on the answer.
kses_bad_protocol_once2(type $matches) : string
This function normalizes HTML entities. It will convert "AT&T" to the correct "AT&T", ":" to ":", "&#XYZZY;" to "&#XYZZY;" and so on.
kses_normalize_entities(type $string) : type
This function helps kses_normalize_entities() to only accept 16 bit values and nothing more for &#number; entities.
kses_normalize_entities2(type $matches) : type
This function decodes numeric HTML entities (A and A). It doesn't do anything with other entities like ä, but we don't need them in the URL protocol whitelisting system anyway.
kses_decode_entities(type $string) : type
mb_strtolower(mixed $str) : mixed
mb_strtoupper(mixed $str) : mixed
mb_strlen(mixed $str) : mixed
mb_substr(mixed $str, mixed $start[, mixed $length = NULL ]) : mixed
mb_strrpos(mixed $haystack, mixed $needle) : mixed
mb_strpos(mixed $haystack, mixed $needle[, mixed $offset = 0 ]) : mixed
mb_substr_count(mixed $haystack, mixed $needle) : mixed
processCommentBlock(mixed $commentBlock) : mixed
getOption(mixed $key) : mixed
setOption(mixed $key, mixed $value[, mixed $persistent = true ]) : mixed
setOptionDefault(mixed $key, mixed $value) : mixed
debugLog(mixed $message[, mixed $reset = false ]) : mixed
getRequestURI() : mixed
Returns the zenphoto version string
getVersion() : mixed
Prints the zenphoto version string
printVersion() : mixed
Print any Javascript required by zenphoto.
printZenJavascripts() : mixed
Prints the clickable drop down toolbox on any theme page with generic admin helpers
adminToolbox() : mixed
Returns the raw title of the gallery.
getGalleryTitle() : string
Returns a text-only title of the gallery.
getBareGalleryTitle() : string
Prints the title of the gallery.
printGalleryTitle() : mixed
printBareGalleryTitle() : mixed
Function to create the page title to be used within the html <head> <title></title> element.
getHeadTitle([string $separator = ' | ' ][, bool $listparentalbums = false ][, mixed $listparentpages = false ]) : mixed
Usefull if you use one header.php for the header of all theme pages instead of individual ones on the theme pages It returns the title and site name in reversed breadcrumb order:
<title of current page> |How you wish the parts to be separated
If the parent albums should be printed in reversed order before the current
Function to print the html <title>title</title> within the <head> of a html page based on the current theme page Usefull if you use one header.php for the header of all theme pages instead of individual ones on the theme pages It prints the title and site name including the <title> tag in reversed breadcrumb order: <title><title of current page> | <parent item if present> | <gallery title></title> It supports standard gallery pages as well a custom and Zenpage news articles, categories and pages.
printHeadTitle([string $separator = ' | ' ][, bool $listparentalbums = true ][, mixed $listparentpages = false ]) : mixed
How you wish the parts to be separated
If the parent albums should be printed in reversed order before the current
Returns the raw description of the gallery.
getGalleryDesc() : string
Returns a text-only description of the gallery.
getBareGalleryDesc() : string
Prints the description of the gallery.
printGalleryDesc() : mixed
printBareGalleryDesc() : mixed
Returns the name of the parent website as set by the "Website Title" option on the gallery options tab. Use this if Zenphoto is only a part of your website.
getParentSiteTitle() : string
Returns the URL of the main website as set by the "Website URL" option on the gallery options tab. Use this if Zenphoto is only a part of your website.
getParentSiteURL() : string
getMainSiteName() : string
getMainSiteURL() : string
Returns the URL of the main gallery index page. If a custom index page is set this returns that page.
getGalleryIndexURL() : string
So this is not necessarily the home page of the site!
Returns the url to the standard gallery index.php page
getStandardGalleryIndexURL([int $page = 1 ][, bool $webpath = null ]) : string
Pagenumber to append
host path to be prefixed. If "false" is passed you will get a localized "WEBPATH"
Gets the custom gallery index url if one is set, otherwise false
getCustomGalleryIndexURL([int $page = 1 ][, bool $webpath = null ]) : string
Pagenumber for pagination
host path to be prefixed. If "false" is passed you will get a localized "WEBPATH"
Returns the name to the individual custom gallery index page name if set, otherwise returns generic custom gallery page "gallery.php" that is widely supported by themes If you need to check if there is an indovidual custom_index_page set use `getOption('custom_index_page')` or `getCustomGalleryIndexURL()`
getCustomGalleryIndexPage() : string
If a custom gallery index page is set this first prints a link to the actual site index (home page = index.php) followed by the gallery index page link. Otherwise just the gallery index link
printGalleryIndexURL([string $after = NULL ][, string $text = NULL ][, bool $printHomeURL = true ]) : mixed
Text to append after and outside the link for breadcrumbs
Name of the link, if NULL "Gallery" is used
In case of a custom gallery index, display breadcrumb with home link (default is true)
Returns the home page link (WEBPATH) to the Zenphoto theme index.php page Use in breadcrumbs if the theme uses a custom gallery index page so the gallery is not the site's home page
getSiteHomeURL() : string
Prints the home page link (WEBPATH with trailing slash) to a Zenphoto theme index.php page Use in breadcrumbs if the theme uses a custom gallery index page so the gallery is not the site's home page
printSiteHomeURL([string $after = NULL ][, string $text = NULL ]) : mixed
Text after and outside the link for breadcrumbs
Text of the link, if NULL "Home"
If the privacy page url option is set this prints a link to it
printPrivacyPageLink([string $before = null ][, string $after = null ]) : mixed
To print before the link
To print after the link
Returns the number of albums.
getNumAlbums() : int
Returns the name of the currently active theme
getCurrentTheme() : string
WHILE next_album(): context switches to Album.
next_album([bool $all = false ][, bool $mine = NULL ]) : bool
If we're already in the album context, this is a sub-albums loop, which, quite simply, changes the source of the album list. Switch back to the previous context when there are no more albums.
Returns true if there are albums, false if none
true to go through all the albums
override the password checks
Returns the number of the current page without printing it.
getCurrentPage() : int
Gets an array of the album ids of all accessible albums (publich or user dependend)
getAllAccessibleAlbums(object $obj, array<string|int, mixed> &$albumlist, bool $scan) : mixed
from whence to get the albums
collects the list
force scan for new images in the album folder
Returns the number of pages for the current object
getTotalPages([bool $one_image_page = false ]) : int
set to true if your theme collapses all image thumbs or their equivalent to one page. This is typical with flash viewer themes
Returns the URL of the page number passed as a parameter
getPageNumURL(int $page[, int $total = null ]) : int
Which page is desired
How many pages there are.
Returns true if there is a next page
hasNextPage() : bool
Returns the URL of the next page. Use within If or while loops for pagination.
getNextPageURL() : string
Prints the URL of the next page.
printNextPageURL(string $text[, string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
text for the URL
Text for the HTML title
Text for the HTML class
Text for the HTML id
Returns TRUE if there is a previous page. Use within If or while loops for pagination.
hasPrevPage() : bool
Returns the URL of the previous page.
getPrevPageURL() : string
Returns the URL of the previous page.
printPrevPageURL(string $text[, string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
The linktext that should be printed as a link
The text the html-tag "title" should contain
Insert here the CSS-class name you want to style the link with
Insert here the CSS-ID name you want to style the link with
Prints a page navigation including previous and next page links
printPageNav(string $prevtext, string $separator, string $nexttext[, string $class = 'pagenav' ][, string $id = NULL ]) : mixed
Insert here the linktext like 'previous page'
Insert here what you like to be shown between the prev and next links
Insert here the linktext like "next page"
Insert here the CSS-class name you want to style the link with (default is "pagelist")
Insert here the CSS-ID name if you want to style the link with this
Prints a list of all pages.
printPageList([string $class = 'pagelist' ][, string $id = NULL ][, int $navlen = 9 ]) : mixed
the css class to use, "pagelist" by default
the css id to use
Number of navigation links to show (0 for all pages). Works best if the number is odd.
returns a page nav list.
getPageNavList(bool $_zp_one_image_page, int $navlen, bool $firstlast, int $current, int $total) : mixed
set to true if there is only one image page as, for instance, in flash themes
Number of navigation links to show (0 for all pages). Works best if the number is odd.
Add links to the first and last pages of you gallery
the current page
total number of pages
Prints a full page navigation including previous and next page links with a list of all pages in between.
printPageListWithNav(string $prevtext, string $nexttext[, bool $_zp_one_image_page = false ][, string $nextprev = true ][, string $class = 'pagelist' ][, string $id = NULL ][, bool $firstlast = true ][, int $navlen = 9 ]) : mixed
Insert here the linktext like 'previous page'
Insert here the linktext like 'next page'
set to true if there is only one image page as, for instance, in flash themes
set to true to get the 'next' and 'prev' links printed
Insert here the CSS-class name you want to style the link with (default is "pagelist")
Insert here the CSS-ID name if you want to style the link with this
Add links to the first and last pages of you gallery
Number of navigation links to show (0 for all pages). Works best if the number is odd.
Sets the album passed as the current album
makeAlbumCurrent(object $album) : mixed
the album to be made current
Returns the raw title of the current album.
getAlbumTitle() : string
Returns a text-only title of the current album.
getBareAlbumTitle() : string
Returns an album title taged with of Not visible or password protected status
getAnnotatedAlbumTitle() : string
printAnnotatedAlbumTitle() : mixed
Prints an encapsulated title of the current album.
printAlbumTitle() : mixed
If you are logged in you can click on this to modify the title on the fly.
printBareAlbumTitle() : mixed
Gets the 'n' for n of m albums
albumNumber() : int
Returns an array of the names of the parents of the current album.
getParentAlbums([object $album = null ]) : array<string|int, mixed>
optional album object to use inseted of the current album
returns the breadcrumb item for the current images's album
getAlbumBreadcrumb([string $title = NULL ]) : array<string|int, mixed>
Text to be used as the URL title tag
prints the breadcrumb item for the current images's album
printAlbumBreadcrumb([string $before = '' ][, string $after = '' ][, string $title = NULL ]) : mixed
Text to place before the breadcrumb
Text to place after the breadcrumb
Text to be used as the URL title attribute and text link
Prints the "breadcrumb" for a search page if the search was for a data range, the breadcrumb is "Archive" otherwise it is "Search"
printSearchBreadcrumb([string $between = NULL ][, string $class = NULL ][, string $search = NULL ][, string $archive = NULL ][, string $format = 'F Y' ]) : mixed
Insert here the text to be printed between the links
is the class for the link (if present)
text for a search page title
text for an archive page title
data format for archive page breadcrumb - A datetime format, if using localized dates an ICU dateformat
returns the breadcrumb navigation for album, gallery and image view.
getParentBreadcrumb() : array<string|int, mixed>
Prints the breadcrumb navigation for album, gallery and image view.
printParentBreadcrumb([string $before = NULL ][, string $between = NULL ][, string $after = NULL ][, mixed $truncate = NULL ][, string $elipsis = NULL ]) : mixed
Insert here the text to be printed before the links
Insert here the text to be printed between the links
Insert here the text to be printed after the links
if not empty, the max lenght of the description.
the text to append to the truncated description
Prints a link to the 'main website', not the Zenphoto site home page! Only prints the link if the url is not empty and does not point back the gallery page
printHomeLink([string $before = '' ][, string $after = '' ][, string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
text to precede the link
text to follow the link
Title text
optional css class
optional css id
Returns the formatted date field of the album
getAlbumDate([string $format = null ]) : string
optional format string for the date - A datetime format, if using localized dates an ICU dateformat
Prints the date of the current album
printAlbumDate([string $before = '' ][, string $format = NULL ]) : mixed
Insert here the text to be printed before the date.
A datetime format, if using localized dates an ICU dateformat
Returns the Location of the album.
getAlbumLocation() : string
Prints the location of the album
printAlbumLocation() : mixed
Returns the raw description of the current album.
getAlbumDesc() : string
Returns a text-only description of the current album.
getBareAlbumDesc() : string
Prints description of the current album
printAlbumDesc() : mixed
printBareAlbumDesc() : mixed
Returns the custom_data field of the current album
getAlbumCustomData() : string
Prints the custom_data field of the current album.
printAlbumCustomData() : mixed
Converts and displays line break in the admin field as
.
A composit for getting album data
getAlbumData(string $field) : string
which field you want
Prints arbitrary data from the album object
printAlbumData(string $field[, string $label = '' ]) : mixed
the field name of the data desired
text to label the field
Returns the album page number of the current image
getAlbumPage([object $album = NULL ]) : int
optional album object
Returns the album link url of the current album.
getAlbumURL([object $album = NULL ]) : string
optional album object
Prints the album link url of the current album.
printAlbumURL(string $text, string $title[, string $class = NULL ][, string $id = NULL ]) : mixed
Insert the link text here.
Insert the title text here.
Insert here the CSS-class name with with you want to style the link.
Insert here the CSS-id name with with you want to style the link.
Returns the name of the defined album thumbnail image.
getAlbumThumb() : string
Returns an <img> element of the password protect thumb substitute
getPasswordProtectImage([string $extra = '' ]) : string
extra stuff to put in the HTML
Gets the URL to the password protected images
getPasswordProtectedImage() : string
Prints an image element with the password protected image.
printPasswordProtectedImage([string $extra = '' ]) : mixed
extra attributes, trailing space required. Do not pass the width/height as it is taken from the image itself
Prints the album thumbnail image.
printAlbumThumbImage([string $alt = '' ][, string $class = '' ][, string $id = '' ][, string $title = '' ]) : mixed
Insert the text for the alternate image name here.
Insert here the CSS-class name with with you want to style the link.
Insert here the CSS-id name with with you want to style the link.
option title attribute
Returns a link to a custom sized thumbnail of the current album
getCustomAlbumThumb([int $size = null ][, int $width = NULL ][, int $height = NULL ][, int $cropw = NULL ][, int $croph = NULL ][, int $cropx = NULL ][, int $cropy = null ][, bool $effects = NULL ]) : string
the size of the image to have
width
height
crop width
crop height
crop part x axis
crop part y axis
image effects (e.g. set 'gray' to force grayscale)
Prints a link to a custom sized thumbnail of the current album
printCustomAlbumThumbImage([string $alt = '' ][, int $size = null ][, int $width = NULL ][, int $height = NULL ][, int $cropw = NULL ][, int $croph = NULL ][, int $cropx = NULL ][, int $cropy = null ][, string $class = NULL ][, string $id = NULL ][, string $title = null ][, bool $maxspace = false ]) : string
See getCustomImageURL() for details.
Alt atribute text
size
width
height
cropwidth
crop height
crop part x axis
crop part y axis
css class
css id
title attribute
true for maxspace image, false is default
Called by ***MaxSpace functions to compute the parameters to be passed to xxCustomyyy functions.
getMaxSpaceContainer(int &$width, int &$height, object $image[, bool $thumb = false ]) : mixed
maxspace width
maxspace height
the image in question
true if for a thumbnail
Returns a link to a un-cropped custom sized version of the current album thumb within the given height and width dimensions.
getCustomAlbumThumbMaxSpace(int $width, int $height) : string
width
height
Prints a un-cropped custom sized album thumb within the given height and width dimensions.
printCustomAlbumThumbMaxSpace([string $alt = '' ][, int $width = null ][, int $height = null ][, string $class = NULL ][, string $id = NULL ][, string $title = null ]) : mixed
Note: a class of 'not_visible' or 'password_protected' will be added as appropriate
Alt text for the url
width
height
Optional style class
Optional style id
Optional title attribute
Returns the next album
getNextAlbum() : object
Get the URL of the next album in the gallery.
getNextAlbumURL() : string
Returns the previous album
getPrevAlbum() : object
Get the URL of the previous album in the gallery.
getPrevAlbumURL() : string
Returns true if this page has image thumbs on it
isImagePage() : bool
Returns true if this page has album thumbs on it
isAlbumPage() : bool
Returns the number of images in the album.
getNumImages() : int
getFirstPageImages([type $one_image_page = false ]) : type
Returns the next image on a page.
next_image([bool $all = false ][, int $firstPageCount = NULL ][, bool $mine = NULL ]) : bool
sets $_zp_current_image to the next image in the album.
Returns true if there is an image to be shown
set to true disable pagination
the number of images which can go on the page that transitions between albums and images Normally this parameter should be NULL so as to use the default computations.
overridePassword the password check
Sets the image passed as the current image
makeImageCurrent(object $image) : mixed
the image to become current
Returns the raw title of the current image.
getImageTitle() : string
Returns a text-only title of the current image.
getBareImageTitle() : string
Returns the image title taged with not visible annotation.
getAnnotatedImageTitle() : string
printAnnotatedImageTitle() : mixed
Prints title of the current image
printImageTitle() : mixed
printBareImageTitle() : mixed
Returns the 'n' of n of m images
imageNumber() : int
Returns the image date of the current image in yyyy-mm-dd hh:mm:ss format.
getImageDate([string $format = null ]) : string
Pass it a date format string for custom formatting
A datetime format, if using localized dates an ICU dateformat
Prints the date of the current album
printImageDate([string $before = '' ][, string $format = null ]) : mixed
Insert here the text to be printed before the date.
A datetime format, if using localized dates an ICU dateformat
Returns the Location field of the current image
getImageLocation() : string
Returns the City field of the current image
getImageCity() : string
Returns the State field of the current image
getImageState() : string
Returns the Country field of the current image
getImageCountry() : string
Returns the raw description of the current image.
getImageDesc() : string
new lines are replaced with
tags
Returns a text-only description of the current image.
getBareImageDesc() : string
Prints the description of the current image.
printImageDesc() : mixed
Converts and displays line breaks set in the admin field as
.
printBareImageDesc() : mixed
A composit for getting image data
getImageData(string $field) : string
which field you want
Returns the custom_data field of the current image
getImageCustomData() : string
Prints the custom_data field of the current image.
printImageCustomData() : string
Converts and displays line breaks set in the admin field as
.
Prints arbitrary data from the image object
printImageData(string $field[, string $label = '' ]) : mixed
the field name of the data desired
text to label the field.
Returns the file size of the full original image
getFullImageFilesize() : int
True if there is a next image
hasNextImage() : bool
True if there is a previous image
hasPrevImage() : bool
Returns the url of the next image.
getNextImageURL() : string
Returns the url of the previous image.
getPrevImageURL() : string
Returns the thumbnail of the previous image.
getPrevImageThumb() : string
Returns the thumbnail of the next image.
getNextImageThumb() : string
Returns the url of the current image.
getImageURL() : string
Prints the link to the current image.
printImageURL(string $text, string $title[, string $class = NULL ][, string $id = NULL ]) : mixed
text for the link
title tag for the link
optional style class for the link
optional style id for the link
Returns the Metadata infromation from the current image
getImageMetaData([ $image = NULL ][, string $displayonly = true ]) : array<string|int, mixed>
optional image object
set to true to return only the items selected for display
Prints the Metadata data of the current image
printImageMetadata([string $title = NULL ][, bool $toggle = true ][, string $id = 'imagemetadata' ][, string $class = null ][, mixed $span = NULL ]) : mixed
title tag for the class
set to true to get a javascript toggle on the display of the data
style class id
style class
Returns an array with the height & width
getSizeCustomImage([int $size = null ][, int $width = NULL ][, int $height = NULL ][, int $cw = NULL ][, int $ch = NULL ][, int $cx = NULL ][, int $cy = NULL ][, obj $image = NULL ][, string $type = 'image' ]) : array<string|int, mixed>
size
width
height
crop width
crop height
crop x axis
crop y axis
The image object for which the size is desired. NULL means the current image
"image" (sizedimage) (default), "thumb" (thumbnail) required for using option settings for uncropped images
Returns an array [width, height] of the default-sized image.
getSizeDefaultImage([int $size = NULL ][, $image = NULL ]) : array<string|int, mixed>
override the 'image_zize' option
object the image for which the size is desired. NULL means the current image
Returns an array [width, height] of the original image.
getSizeFullImage([ $image = NULL ]) : array<string|int, mixed>
The width of the default-sized image (in printDefaultSizedImage)
getDefaultWidth([mixed $size = NULL ][, $image = NULL ]) : int
object the image for which the size is desired. NULL means the current image
Returns the height of the default-sized image (in printDefaultSizedImage)
getDefaultHeight([mixed $size = NULL ][, $image = NULL ]) : int
object the image for which the size is desired. NULL means the current image
Returns the width of the original image
getFullWidth([ $image = NULL ]) : int
Returns the height of the original image
getFullHeight([ $image = NULL ]) : int
Returns true if the image is landscape-oriented (width is greater than height) or - kept here for backwards compatibility - square (equal widht and height)
isLandscape([ $image = NULL ]) : bool
Returns the url to the default sized image.
getDefaultSizedImage([ $image = NULL ]) : string
Show video player with video loaded or display the image.
printDefaultSizedImage(string $alt[, string $class = null ][, string $id = null ][, string $title = null ][, obj $image = null ]) : mixed
Alt text
Optional style class
Optional style id
Optional title attribute
optional image object, null means current image
Returns the url to the thumbnail of the current image.
getImageThumb([obj $image = null ]) : string
optional image object, null means current image
printImageThumb(string $alt[, string $class = null ][, string $id = null ][, string $title = null ][, obj $image = null ]) : mixed
Alt text
optional class attribute
optional id attribute
optional title attribute
optional image object, null means current image
Gets the width and height of a default thumb for the <img> tag height/width
getSizeDefaultThumb([obj $image = NULL ]) : aray
Image object, if NULL the current image is used
Returns the url to original image.
getFullImageURL([ $image = NULL ]) : string
It will return a protected image is the option "protect_full_image" is set
Returns the "raw" url to the image in the albums folder
getUnprotectedImageURL([ $image = NULL ]) : string
Returns an url to the password protected/watermarked current image
getProtectedImageURL([object $image = NULL ][, string $disposal = NULL ]) : string
optional image object overrides the current image
set to override the 'protect_full_image' option. 'protected', "download", "unprotected" or "no-access"
Returns a link to the current image custom sized to $size
getSizedImageURL(int $size) : mixed
The size the image is to be
Returns the url to the image with the dimensions you define with this function.
getCustomImageURL(int $size[, int $width = NULL ][, int $height = NULL ][, int $cropw = NULL ][, int $croph = NULL ][, int $cropx = NULL ][, int $cropy = NULL ][, bool $thumbStandin = false ][, bool $effects = NULL ][, obj $image = null ]) : string
the size of the image to have
width
height
crop width
crop height
crop part x axis
crop part y axis
set true to inhibit watermarking
image effects (e.g. set gray to force to grayscale)
optional image object, null means current image
$size, $width, and $height are used in determining the final image size. At least one of these must be provided. If $size is provided, $width and $height are ignored. If both $width and $height are provided, the image will have those dimensions regardless of the original image height/width ratio. (Yes, this means that the image may be distorted!)
The $crop* parameters determine the portion of the original image that will be incorporated into the final image.
$cropw and $croph "sizes" are typically proportional. That is you can set them to values that reflect the ratio of width to height that you want for the final image. Typically you would set them to the final height and width. These values will always be adjusted so that they are not larger than the original image dimensions.
The $cropx and $cropy values represent the offset of the crop from the top left corner of the image. If these values are provided, the $croph and $cropw parameters are treated as absolute pixels not proportions of the image. If cropx and cropy are not provided, the crop will be "centered" in the image.
When $cropx and $cropy are not provided the crop is offset from the top left proportionally to the ratio of the final image size and the crop size.
Some typical croppings:
$size=200, $width=NULL, $height=NULL, $cropw=200, $croph=100, $cropx=NULL, $cropy=NULL produces an image cropped to a 2x1 ratio which will fit in a 200x200 pixel frame.
$size=NULL, $width=200, $height=NULL, $cropw=200, $croph=100, $cropx=100, $cropy=10 will will take a 200x100 pixel slice from (10,100) of the picture and create a 200x100 image
$size=NULL, $width=200, $height=100, $cropw=200, $croph=120, $cropx=NULL, $cropy=NULL will produce a (distorted) image 200x100 pixels from a 1x0.6 crop of the image.
$size=NULL, $width=200, $height=NULL, $cropw=180, $croph=120, $cropx=NULL, $cropy=NULL will produce an image that is 200x133 from a 1.5x1 crop that is 5% from the left and 15% from the top of the image.
Print normal video or custom sized images.
printCustomSizedImage([string $alt = '' ][, int $size = null ][, int $width = NULL ][, int $height = NULL ][, int $cropw = NULL ][, int $croph = NULL ][, int $cropx = NULL ][, int $cropy = NULL ][, string $class = NULL ][, string $id = NULL ][, bool $thumbStandin = false ][, bool $effects = NULL ][, string $title = null ][, string $type = 'image' ][, obj $image = null ][, bool $maxspace = false ]) : mixed
Note: a class of 'not_visible' or 'password_protected' will be added as appropriate
Notes on cropping:
The $crop* parameters determine the portion of the original image that will be incorporated into the final image. The w and h "sizes" are typically proportional. That is you can set them to values that reflect the ratio of width to height that you want for the final image. Typically you would set them to the fincal height and width.
Alt text for the url
size
width
height
crop width
crop height
crop x axis
crop y axis
Optional style class
Optional style id
set to true to treat as thumbnail
image effects (e.g. set gray to force grayscale)
Optional title attribute
"image" (sizedimage) (default), "thumb" (thumbnail) required for using option settings for uncropped images
optional image object, null means current image
true for maxspace, false default
Returns a link to a un-cropped custom sized version of the current image within the given height and width dimensions.
getCustomSizedImageMaxSpace(int $width, int $height) : string
Use for sized images.
width
height
Returns a link to a un-cropped custom sized version of the current image within the given height and width dimensions.
getCustomSizedImageThumbMaxSpace(int $width, int $height) : string
Use for sized thumbnails.
width
height
Creates image thumbnails which will fit un-cropped within the width & height parameters given
printCustomSizedImageThumbMaxSpace([string $alt = '' ][, int $width = null ][, int $height = null ][, string $class = NULL ][, string $id = NULL ][, string $title = null ][, obj $image = null ]) : mixed
Alt text for the url
width
height
Optional style class
Optional style id
optional title attribute
optional image object, null means current image
Print normal video or un-cropped within the given height and width dimensions. Use for sized images or thumbnails in an album.
printCustomSizedImageMaxSpace([string $alt = '' ][, int $width = null ][, int $height = null ][, string $class = NULL ][, string $id = NULL ][, mixed $thumb = false ][, string $title = null ][, obj $image = null ]) : mixed
Note: a class of 'not_visible' or 'password_protected' will be added as appropriate
Alt text for the url
width
height
Optional style class
Optional style id
optional title attribute
optional image object, null means current image
Prints link to an image of specific size
printSizedImageURL(int $size, string $text, string $title[, string $class = NULL ][, string $id = NULL ]) : mixed
how big
URL text
URL title
optional URL class
optional URL id
Returns a list of tags for context of the page called where called
getTags() : string
Prints a list of tags, editable by admin
printTags([string $option = 'links' ][, string $preText = NULL ][, string $class = NULL ][, string $separator = ', ' ]) : mixed
links by default, if anything else the tags will not link to all other images with the same tag
text to go before the printed tags
css class to apply to the div surrounding the UL list
what charactor shall separate the tags
Either prints all of the galleries tgs as a UL list or a cloud
printAllTagsAs(string $option[, string $class = '' ][, string $sort = NULL ][, bool $counter = FALSE ][, bool $links = TRUE ][, int $maxfontsize = 2 ][, int $maxcount = 50 ][, int $mincount = 1 ][, int $limit = NULL ][, int $minfontsize = 0.8 ][, bool $exclude_unassigned = true ][, bool $checkaccess = false ]) : mixed
"cloud" for tag cloud, "list" for simple list
CSS class
"results" for relevance list, "random" for random ordering, otherwise the list is alphabetical
TRUE if you want the tag count within brackets behind the tag
set to TRUE to have tag search links included with the tag.
largest font size the cloud should display
the floor count for setting the cloud font size to $maxfontsize
the minimum count for a tag to appear in the output
set to limit the number of tags displayed to the top $numtags
minimum font size the cloud should display
True or false if you wish to exclude tags that are not assigne to any item (default: true)
True or false (default: false) if you wish to exclude tags that are assigned to items (or are not assigned at all) the visitor is not allowed to see Beware that this may cause overhead on large sites. Usage of the static_html_cache is strongely recommended then.
Retrieves a list of all unique years & months from the images in the gallery
getAllDates([string $order = 'asc' ]) : array<string|int, mixed>
set to 'desc' for the list to be in descending order
Prints a compendum of dates and links to a search page that will show results of the date
printAllDates([string $class = 'archive' ][, string $yearid = 'year' ][, string $monthid = 'month' ][, string $order = 'desc' ]) : mixed
optional class
optional class for "year"
optional class for "month"
set to 'desc' for the list to be in descending order
Produces the url to a custom page (e.g. one that is not album.php, image.php, or index.php)
getCustomPageURL(string $page[, string $q = '' ][, bool $webpath = null ]) : string
page name to include in URL
query string to add to url
host path to be prefixed. If "false" is passed you will get a localized "WEBPATH"
Prints the url to a custom page (e.g. one that is not album.php, image.php, or index.php)
printCustomPageURL(string $linktext, string $page[, string $q = '' ][, string $prev = '' ][, string $next = '' ][, string $class = NULL ]) : mixed
Text for the URL
page name to include in URL
query string to add to url
text to insert before the URL
text to follow the URL
optional class
tests if a search page is an "archive" page
isArchive() : bool
Returns a search URL
getSearchURL(mixed $words, mixed $dates, mixed $fields, int $page[, array<string|int, mixed> $object_list = NULL ]) : string
the search words target
the dates that limit the search
the fields on which to search
the page number for the URL
the list of objects to search
Prints the search form
printSearchForm([string $prevtext = NULL ][, string $id = 'search' ][, string $buttonSource = '' ][, string $buttontext = '' ][, string $iconsource = NULL ][, array<string|int, mixed> $query_fields = NULL ][, mixed $object_list = NULL ][, string $within = NULL ][, bool $enable_fieldselector = null ]) : mixed
Search works on a list of tokens entered into the search form.
Tokens may be part of boolean expressions using &, |, !, and parens. (Comma is retained as a synonom of | for backwords compatibility.)
Tokens may be enclosed in quotation marks to create exact pattern matches or to include the boolean operators and parens as part of the tag..
text to go before the search form
css id for the search form, default is 'search'
optional path to the image for the button or if not a path to an image, this will be the button hint
optional text for the button ("Search" will be the default text)
optional theme based icon for the search fields toggle
override selection for enabled fields with this list
set to true to search within current results, false to search fresh
True|false to enable/disable the search fields selector. Default null to use the option as set
Returns the a sanitized version of the search string
getSearchWords() : string
Returns the date of the search
getSearchDate([string $format = 'F Y' ]) : string
A datetime format, if using localized dates an ICU dateformat
returns the auth type of a guest login
checkForGuest([string &$hint = NULL ][, string &$show = NULL ]) : string
Checks to see if a password is needed
checkAccess([string &$hint = NULL ][, bool &$show = NULL ]) : bool
Returns true if access is allowed
The password protection is hereditary. This normally only impacts direct url access to an object since if you are going down the tree you will be stopped at the first place a password is required.
the password hint
whether there is a user associated with the password.
Returns a redirection link for the password form
getPageRedirect() : string
Prints the album password form
printPasswordForm(mixed $_password_hint[, mixed $_password_showuser = NULL ][, mixed $_password_showProtected = true ][, mixed $_password_redirect = NULL ]) : mixed
prints the zenphoto logo and link
printZenphotoLink() : mixed
Expose some informations in a HTML comment
exposeZenPhotoInformations([string $obj = '' ][, array<string|int, mixed> $plugins = '' ][, string $theme = '' ]) : mixed
the path to the page being loaded
list of activated plugins
The theme being used
Gets the content of a codeblock for an image, album or Zenpage newsarticle or page.
getCodeblock([int $number = 1 ][, mixed $object = NULL ]) : string
The priority for codeblocks will be (based on context) 1: articles 2: pages 3: images 4: albums 5: gallery.
This means, for instance, if we are in ZP_ZENPAGE_NEWS_ARTICLE context we will use the news article codeblock even if others are available.
Note: Echoing this array's content does not execute it. Also no special chars will be escaped. Use printCodeblock() if you need to execute script code.
The codeblock you want to get
Prints the content of a codeblock for an image, album or Zenpage newsarticle or page.
printCodeblock([int $number = 1 ][, mixed $what = NULL ]) : string
The codeblock you want to get
optonal object for which you want the codeblock
Checks for URL page out-of-bounds for "standard" themes Note: This function assumes that an "index" page will display albums and the pagination be determined by them. Any other "index" page strategy needs to be handled by the theme itself.
checkPageValidity(bool $request, string $gallery_page, int $page) : bool
will be true if all is well, false if a 404 error should occur
print404status(mixed $album, mixed $image, mixed $obj) : mixed
Gets current item's owner (gallery images and albums) or author (Zenpage articles and pages)
getOwnerAuthor([bool $fullname = false ]) : bool
If the owner/author has a real user account and there is a full name set it is returned
Prints current item's owner (gallery images and albums) or author (Zenpage articles and pages)
printOwnerAuthor([type $fullname = false ]) : mixed
Returns the search url for items the current item's owner (gallery) or author (Zenpage) is assigned to
getOwnerAuthorURL() : type
This eventually may return the url to an actual user profile page in the future.
Prints the link to the search engine for results of all items the current item's owner (gallery) or author (Zenpage) is assigned to
printOwnerAuthorURL([type $fullname = false ][, type $resulttype = 'all' ][, type $class = null ][, type $id = null ][, type $title = null ]) : mixed
This eventually may return the url to an actual user profile page in the future.
Returns a an url for the search engine for results of all items the user with $username is assigned to either as owner (gallery) or author (Zenpage) Note there is no check if the user name is actually a vaild user account name, owner or author! Use the *OwerAuthor() function for that instead
getUserURL(string $username[, string $resulttype = 'all' ]) : string|null
This eventually may return the url to an actual user profile page in the future.
The user name of a user. Note there is no check if the user name is actually valid!
'all' for owner and author, 'gallery' for owner of images/albums only, 'zenpage' for author of news articles and pages
Prints the link to the search engine for results of all items $username is assigned to either as owner (gallery) or author (Zenpage) Note there is no check if the user name is actually a vaild user account name, owner or author! Use the *OwerAuthor() function for that instead
printUserURL(string $username[, string $resulttype = 'all' ][, string $linktext = null ][, string $class = null ][, type $id = null ][, type $title = null ]) : mixed
This eventually may point to an actual user profile page in the future.
The user name of a user.
'all' for owner and author, 'gallery' for owner of images/albums only, 'zenpage' for author of news articles and pages
The link text. If null the user name will be used
The CSS class to attach, default null.
The CSS id to attach, default null.
The title attribute to attach, default null so the user name is used
Display the site or image copyright notice if defined and display is enabled
printCopyrightNotice([string $before = '' ][, string $after = '' ][, mixed $linked = true ][, mixed $type = 'gallery' ]) : mixed
Text to print before it
Text to print after it Å“param bool $linked Default true to use the copyright URL if defined
Display the site copyright notice if defined and display is enabled
printGalleryCopyrightNotice([string $before = '' ][, string $after = '' ][, mixed $linked = true ]) : mixed
Text to print before it
Text to print after it Å“param bool $linked Default true to use the copyright URL if defined
Display the image copyright notice if defined and display iss enabled
printImageCopyrightNotice([string $before = '' ][, string $after = '' ][, mixed $linked = true ]) : mixed
Text to print before it
Text to print after it Å“param bool $linked Default true to use the copyright URL if defined
Gets the current page number if it is larger than 1 for use on paginated pages for SEO reason to avoid duplicate titles
getCurrentPageAppendix([string $before = ' (' ][, string $after = ')' ]) : string
Text to add before the page number. Default ' (';
Text to add ager the page number. Default ')';
Prints the current page number if it is larger than 1 for use on paginated pages for SEO reason to avoid duplicate titles
printCurrentPageAppendix([string $before = ' (' ][, string $after = ')' ]) : mixed
Text to add before the page number. Default ' (';
Text to add ager the page number. Default ')';
gallerystats_filesize_r(mixed $path) : mixed
Prints a table with a bar graph of the values.
printBarGraph([string $sortorder = "mostimages" ][, string_type $type = "albums" ][, mixed $from_number = 0 ][, mixed $to_number = 10 ]) : mixed
"popular", "mostrated","toprated","mostcommented" or - only if $type = "albums"! - "mostimages"
"albums", "images", "pages", "news", "tags"
Prints the jQuery bxslider HTML setup to be replaced by JS
printThumbNav([int $minitems = NULL ][, int $maxitems = NULL ][, int $width = NULL ][, int $height = NULL ][, int $cropw = NULL ][, int $croph = NULL ][, bool $fullimagelink = NULL ][, string $mode = NULL ][, int $speed = NULL ]) : mixed
The minimum number of thumbs to be visible always if resized regarding responsiveness.
The maximum number of thumbs to be visible always if resized regarding responsiveness.
Width Set to NULL if you want to use the backend plugin options.
Height Set to NULL if you want to use the backend plugin options.
Crop width Set to NULL if you want to use the backend plugin options.
Crop heigth Set to NULL if you want to use the backend plugin options.
Set to TRUE if you want the thumb link to link to the full image instead of the image page. Set to NULL if you want to use the backend plugin options.
'horizontal','vertical', 'fade'
The speed in miliseconds the slides advance when clicked
Searches the zenphoto.org home page for the current zenphoto download locates the version number of the download and compares it to the version we are running.
checkForUpdate() : string
If there is a more current version on the WEB, returns its version number otherwise returns FALSE
Displays the "new version available" message on admin pages
admin_showupdate(mixed $tab, unknown_type $subtab) : mixed
get_AnyFile_suffixes() : mixed
comment_form_PaginationJS() : mixed
comment_form_visualEditor() : mixed
Admin overview summary
comment_form_print10Most() : mixed
Processes the post of an address
getCommentAddress(int $i) : array<string|int, mixed>
sequence number of the comment
Returns an error message if a comment posting was not accepted
getCommentErrors() : string
Tool to output an error message if a comment posting was not accepted
printCommentErrors() : mixed
Generic comment adding routine. Called by album objects or image objects to add comments.
comment_form_addComment(string $name, string $email, string $website, string $comment, string $code, string $code_ok, object $receiver, string $ip, bool $private, bool $anon, string $customdata[, bit $check = false ][, bool $dataconfirmation = null ][, string $textquiz_answer_user = '' ][, string $mathquiz_answer_user = '' ]) : object
Returns a comment object
Comment author name
Comment author email
Comment author website
body of the comment
CAPTCHA code entered
CAPTCHA hash expected
the object (image or album) to which to post the comment
the IP address of the comment poster
set to true if the comment is for the admin only
set to true if the poster wishes to remain anonymous
bitmask of which fields must be checked. If set overrides the options
True if data privacy confirmation required
Use see if a captcha should be displayed
commentFormUseCaptcha() : bool
checks if comments are allowed and then processes them if so
comment_form_postcomment(string $error) : mixed
Handles the POSTing of a comment
comment_form_handle_comment() : null|bool
Returns the comment author's name
getCommentAuthorName() : string
Returns the comment author's email
getCommentAuthorEmail() : string
Returns the comment author's website
getCommentAuthorSite() : string
Prints a link to the author
getCommentAuthorLink([string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
URL title tag
optional class tag
optional id tag
Prints a link to the author
printCommentAuthorLink([string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
URL title tag
optional class tag
optional id tag
Returns a formatted date and time for the comment.
getCommentDateTime([string $format = NULL ]) : string
Uses the "date_format" option for the formatting unless a format string is passed.
A datetime format, if using localized dates an ICU dateformat
Returns the body of the current comment
getCommentBody() : string
Creates a link to the admin comment edit page for the current comment
printEditCommentLink(string $text[, string $before = '' ][, string $after = '' ][, string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
Link text
text to go before the link
text to go after the link
title text
optional css clasee
optional css id
Gets latest comments for images, albums, news and pages
getLatestComments(int $number[, string|array<string|int, mixed> $type = "all" ][, int $id = NULL ]) : mixed
how many comments you want.
"all" for all latest comments of all images, albums, news and pages an array of table items e.g. array('images','albums') for all images, albums, news and pages "image" for the lastest comments of one specific image "album" for the latest comments of one specific album "news" for the latest comments of one specific news article "page" for the latest comments of one specific Page
the record id of element to get the comments for if $type != "all"
Prints latest comments for images, albums, news and pages
printLatestComments(int $number[, int $shorten = '123' ][, string $type = "all" ][, int $item = NULL ][, string $ulid = 'showlatestcomments' ][, string $shortenindicator = '...' ]) : mixed
how many comments you want.
how many characters you want to show in the excerpt.
"all" for all latest comments of all images, albums, news and pages an array of table items e.g. array('images','albums', 'news', 'pages') for all images, albums, news and pages "image" for the lastest comments of one specific image "album" for the latest comments of one specific album "news" for the latest comments of one specific news article "page" for the latest comments of one specific Page
the record id of element to get the comments for if $type != "all".
id for the
indicator to show that the string is truncated.
Retuns the count of comments on the current image
getCommentCount() : int
Iterate through comments; use the ZP_COMMENT context.
next_comment([bool $desc = false ]) : bool
Return true if there are more comments
set true for desecnding order
Returns the data from the last comment posted
getCommentStored([bool $numeric = false ]) : array<string|int, mixed>
Set to true for old themes to get 0->6 indices rather than descriptive ones
Takes a comment and makes the body of an email.
commentReply(obj $obj, string $author, string $fullcomment) : string
Object of the item commented on
Comment author
The comment itself
Returns true if all the right conditions are set to allow comments for the $type
commentsAllowed(string $type) : bool
Which comments
Gets an array of comments for the current admin
getComments(int $number) : array<string|int, mixed>
how many comments desired
Gets an array of comments for the current admin
fetchComments(int $number) : array<string|int, mixed>
how many comments desired
Checks if a field is required
isCommentFormRequiredField(string $option) : bool
The field option name
Gets the star to mark required field names
getCommentFormRequiredFieldMark(string $option) : string
The field option name
Returns the required attribute if the field is required
getCommentFormRequiredFieldAttr(string $option) : string
The field option name
Checks if the field should be set to readonly
isCommentFormReadonlyField(bool $disabled) : mixed
return bool
Gets the readonly attribute for disabled fields
getCommentFormReadonlyFieldAttr(bool $disabled) : string
Prints the combined required and readonly attributes as needed
printCommentFormFieldAttributes(string $option, bool $disabled[, string $autocomplete_value = 'on' ]) : mixed
The field option name
Default "on" if autocomplete is ebabled
Returns the autocomplete attribute for the form depending if autocomplete is enabled
getCommentformFormAutocompleteAttr() : string
Gets the autocomplete attribute with the value passed if autocomplete is enabled Note that the value is not validated. See See e.g. https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete for valid values and tokens
getCommentformAutocompleteAttr([string $value = "on" ][, bool $skip_off = false ]) : string
Default "on" if autocomplete is ebabled
Set to true to skip returing autocomplete="off"
Prints the autocomplete attribute with the value passed if autocomplete is enabled Note that the value is not validated. See See e.g. https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete for valid values and tokens
printCommentformAutocompleteAttr([string $value = "on" ][, bool $skip_off = false ]) : mixed
Default "on" if autocomplete is ebabled
Set to true to skip printing autocomplete="off"
Gets the the question to a quiz field if the field is enabled and setup correctly
getQuizFieldQuestion([string $which = '' ]) : string|bool
Prints a form for posting comments
printCommentForm([bool $showcomments = true ][, string $addcommenttext = NULL ][, bool $addheader = true ][, string $comment_commententry_mod = '' ][, bool $desc_order = false ]) : mixed
defaults to true for showing list of comments
alternate text for "Add a comment:"
set true to display comment count header
use to add styles, classes to the comment form div
default false, set to true to change the comment order to descending ( = newst to oldest)
Retrieves the post field if it exists
getField(string $field[, int $level = 3 ]) : string
Prints the mail contact form, handles checks and the mail sending. It uses Zenphoto's check for valid e-mail address and website URL and also supports CAPTCHA.
printContactForm([string $subject_override = '' ]) : mixed
The contact form itself is a separate file and is located within the /contact_form/form.php so that it can be style as needed.
set to override the subject.
Helper function that checks if a field should be shown ("required" or "show") or omitted ("ommitt").
showOrNotShowField(string $option) : bool
Only for the fields set by radioboxes.
The option value
Helper function that checks if the field is a required one. If it returns '*" to be appended to the field name as an indicator.
checkRequiredField(string $option) : string
Not for the CAPTCHA field that is always required if shown...
the option value
Buffers the contact form print out so it can be passed to its content macro
printContactFormMacro([type $subject_override = '' ]) : type
Registers the content macro(s)
getContactFormMacros(array<string|int, mixed> $macros) : array<string|int, mixed>
Passes through the array of already registered
defaultCodeblocks_codebox(mixed $current, mixed $object, mixed $number) : mixed
controls the thumbnail layout of themes.
setThemeColumns() : mixed
Uses the theme options: albums_per_row albums_per_page images_per_row images_per_page
Returns the mimetype for a suffix
getMimeString(string $suffix) : string
Suffix without . to get the mimetype for
Wrapper instantiation function for albums. Do not instantiate directly
newAlbum(string $folder8[, bool $cache = true ][, bool $quiet = false ]) : Album
the name of the folder (inernal character set)
true if the album should be fetched from the cache
true to supress error messages
Returns true if the object is a zenphoto 'album'
isAlbumClass([object $album = NULL ]) : bool
Returns the oldest ancestor of an alubm;
getUrAlbum(string $album) : object
an album object
Returns a new "image" object based on the file extension
newImage(object $album, string $filename[, bool $quiet = false ]) : object
the owner album
the filename
set true to supress error messages (used by loadimage)
Returns true if the object is a zenphoto 'image'
isImageClass([object $image = NULL ]) : bool
encloses search word in quotes if needed
search_quote(string $word) : string
Returns video argument of the current Image.
isImageVideo([object $image = NULL ]) : bool
optional image object
Returns true if the image is a standard photo type
isImagePhoto([object $image = NULL ]) : bool
optional image object
Replaces/renames an option. If the old option exits, it creates the new option with the old option's value as the default unless the new option has already been set otherwise. Independently it always deletes the old option.
replaceOption(string $oldkey, string $newkey) : mixed
Old option name
New option name
Determines if the input is an e-mail address. Adapted from WordPress.
is_valid_email_zp(string $input_email) : bool
Name changed to avoid conflicts in WP integrations.
email address?
Populatest $list with an one dimensional list with album name and title of all albums or the subalbums of a specific album
genAlbumList(array<string|int, mixed> &$list[, obj $curAlbum = NULL ][, int $rights = UPLOAD_RIGHTS ]) : mixed
The array to fill with the album list
Optional object of the album to start with
Rights constant to filter album access by.
Returns a list of all albums decendent from an album
getAllAlbums([object $album = NULL ]) : array<string|int, mixed>
optional album. If absent the current album is used
printPopularAlbums([mixed $number = 5 ][, mixed $showtitle = false ][, mixed $showdate = false ][, mixed $showdesc = false ][, mixed $desclength = 40 ][, mixed $showstatistic = 'hitcounter' ][, mixed $width = NULL ][, mixed $height = NULL ][, mixed $crop = NULL ][, mixed $albumfolder = '' ][, mixed $firstimglink = false ][, mixed $threshold = 0 ][, mixed $collection = false ]) : mixed
printLatestAlbums([mixed $number = 5 ][, mixed $showtitle = false ][, mixed $showdate = false ][, mixed $showdesc = false ][, mixed $desclength = 40 ][, mixed $showstatistic = '' ][, mixed $width = NULL ][, mixed $height = NULL ][, mixed $crop = NULL ][, mixed $albumfolder = '' ][, mixed $firstimglink = false ][, mixed $collection = false ]) : mixed
printMostRatedAlbums([mixed $number = 5 ][, mixed $showtitle = false ][, mixed $showdate = false ][, mixed $showdesc = false ][, mixed $desclength = 40 ][, mixed $showstatistic = '' ][, mixed $width = NULL ][, mixed $height = NULL ][, mixed $crop = NULL ][, mixed $albumfolder = '' ][, mixed $firstimglink = false ][, mixed $threshold = 0 ][, mixed $collection = false ]) : mixed
printTopRatedAlbums([mixed $number = 5 ][, mixed $showtitle = false ][, mixed $showdate = false ][, mixed $showdesc = false ][, mixed $desclength = 40 ][, mixed $showstatistic = '' ][, mixed $width = NULL ][, mixed $height = NULL ][, mixed $crop = NULL ][, mixed $albumfolder = '' ][, mixed $firstimglink = false ][, mixed $threshold = 0 ][, mixed $collection = false ]) : mixed
printLatestUpdatedAlbums([mixed $number = 5 ][, mixed $showtitle = false ][, mixed $showdate = false ][, mixed $showdesc = false ][, mixed $desclength = 40 ][, mixed $showstatistic = '' ][, mixed $width = NULL ][, mixed $height = NULL ][, mixed $crop = NULL ][, mixed $albumfolder = '' ][, mixed $firstimglink = false ][, mixed $collection = false ]) : mixed
printPopularImages([mixed $number = 5 ][, mixed $albumfolder = '' ][, mixed $showtitle = false ][, mixed $showdate = false ][, mixed $showdesc = false ][, mixed $desclength = 40 ][, mixed $showstatistic = '' ][, mixed $width = NULL ][, mixed $height = NULL ][, mixed $crop = NULL ][, mixed $collection = false ][, mixed $fullimagelink = false ][, mixed $threshold = 0 ]) : mixed
printTopRatedImages([mixed $number = 5 ][, mixed $albumfolder = "" ][, mixed $showtitle = false ][, mixed $showdate = false ][, mixed $showdesc = false ][, mixed $desclength = 40 ][, mixed $showstatistic = '' ][, mixed $width = NULL ][, mixed $height = NULL ][, mixed $crop = NULL ][, mixed $collection = false ][, mixed $fullimagelink = false ][, mixed $threshold = 0 ]) : mixed
printMostRatedImages([mixed $number = 5 ][, mixed $albumfolder = '' ][, mixed $showtitle = false ][, mixed $showdate = false ][, mixed $showdesc = false ][, mixed $desclength = 40 ][, mixed $showstatistic = '' ][, mixed $width = NULL ][, mixed $height = NULL ][, mixed $crop = NULL ][, mixed $collection = false ][, mixed $fullimagelink = false ][, mixed $threshold = 0 ]) : mixed
printLatestImages([mixed $number = 5 ][, mixed $albumfolder = '' ][, mixed $showtitle = false ][, mixed $showdate = false ][, mixed $showdesc = false ][, mixed $desclength = 40 ][, mixed $showstatistic = '' ][, mixed $width = NULL ][, mixed $height = NULL ][, mixed $crop = NULL ][, mixed $collection = false ][, mixed $fullimagelink = false ]) : mixed
printLatestImagesByDate([mixed $number = 5 ][, mixed $albumfolder = '' ][, mixed $showtitle = false ][, mixed $showdate = false ][, mixed $showdesc = false ][, mixed $desclength = 40 ][, mixed $showstatistic = '' ][, mixed $width = NULL ][, mixed $height = NULL ][, mixed $crop = NULL ][, mixed $collection = false ][, mixed $fullimagelink = false ]) : mixed
printLatestImagesByMtime([mixed $number = 5 ][, mixed $albumfolder = '' ][, mixed $showtitle = false ][, mixed $showdate = false ][, mixed $showdesc = false ][, mixed $desclength = 40 ][, mixed $showstatistic = '' ][, mixed $width = NULL ][, mixed $height = NULL ][, mixed $crop = NULL ][, mixed $collection = false ][, mixed $fullimagelink = false ]) : mixed
performs a query and then filters out "illegal" images returning the first "good" image used by the random image functions.
filterImageQuery(object $result, string $source) : mixed
query result
album object if this is search within the album
Returns a randomly selected image from the gallery. (May be NULL if none exists)
getRandomImages([bool $daily = false ]) : object
set to true and the picture changes only once a day.
Returns a randomly selected image from the album or its subalbums. (May be NULL if none exists)
getRandomImagesAlbum([mixed $rootAlbum = NULL ][, bool $daily = false ]) : object
optional album object/folder from which to get the image.
set to true to change picture only once a day.
Puts up random image thumbs from the gallery
printRandomImages([int $number = 5 ][, string $class = null ][, string $option = 'all' ][, mixed $rootAlbum = '' ][, int $width = NULL ][, int $height = NULL ][, bool $crop = NULL ][, bool $fullimagelink = false ]) : mixed
how many images
optional class
what you want selected: all for all images, album for selected ones from an album
optional album object/folder from which to get the image.
the width/cropwidth of the thumb if crop=true else $width is longest size.
the height/cropheight of the thumb if crop=true else not used
'true' (default) if the thumb should be cropped, 'false' if not
'false' (default) for the image page link , 'true' for the unprotected full image link (to use Colorbox for example)
fixes unbalanced HTML tags. Used by shortenContent when PHP tidy is not present
cleanHTML(string $html) : string
Returns the count of all the images in the album and any subalbums
getTotalImagesIn(object $album) : int
The album whose image count you want
checks if the item has expired
checkPublishDates(array<string|int, mixed> $row) : mixed
database row of the object
getPHPFiles(type $folder, type $exclude) : string
formatList(type $title, type $subject, type $pattern) : bool
listUses(type $files, type $base, type $pattern) : type
listDBUses(type $pattern) : bool
Prints a table with a bar graph of the values.
printBarGraph() : mixed
Prints the actual download list included all subfolders and files
printdownloadList([string $dir = '' ][, string $listtype = 'ol' ][, array<string|int, mixed> $filters = array() ][, array<string|int, mixed> $excludesuffixes = '' ][, string $sort = 'desc' ]) : mixed
An optional different folder to generate the list that overrides the folder set on the option.
"ol" or "ul" for the type of HTML list you want to use
an array of files to exclude from the list. Standard items are Array( '.', '..','.DS_Store','Thumbs.db','.htaccess','.svn')
an array of file suffixes (without trailing dot to exclude from the list (e.g. "jpg")
'asc" or "desc" (default) for alphabetical ascending or descending list
Gets the actual download list included all subfolders and files
getdownloadList(string $dir8, array<string|int, mixed> $filters8, array<string|int, mixed> $excludesuffixes, string $sort) : array<string|int, mixed>
An optional different folder to generate the list that overrides the folder set on the option. This could be a subfolder of the main download folder set on the plugin's options. You have to include the base directory as like this: "folder" or "folder/subfolder" or "../folder" You can also set any folder within or without the root of your Zenphoto installation as a download folder with this directly
an array of files to exclude from the list. Standard items are '.', '..','.DS_Store','Thumbs.db','.htaccess','.svn'
an array of file suffixes (without trailing dot to exclude from the list (e.g. "jpg")
'asc" or "desc" (default) for alphabetical ascending or descending list
Gets the download url for a file
getDownloadURL(string $file) : mixed
the path to a file to get a download link.
Prints a download link for a file, depending on the plugin options including the downloadcount and filesize
printDownloadURL(string $file[, string $linktext = NULL ]) : mixed
the path to a file to print a download link.
Optionally how you wish to call the link. Set/leave to NULL to use the filename.
Prints the dwnload url link for a full image
printFullImageDownloadURL([string $linktext = null ][, obj $imageobj = null ]) : mixed
Linktext for the download
Optional image object to use, otherwise the current image if available
Prints a download link for an album zip of the current album (therefore to be used only on album.php/image.php).
printDownloadAlbumZipURL([string $linktext = NULL ][, object $albumobj = NULL ][, bool $fromcache = NULL ]) : mixed
This function only creates a download count and then redirects to the original Zenphoto album zip download.
if true get the images from the cache
prints a form for selecting a locale The POST handling is by getUserLocale() called in functions.php
printLanguageSelector([mixed $flags = NULL ]) : mixed
elFinderAutoloader(mixed $name) : mixed
Simple function to demonstrate how to control file access using "accessControl" callback.
access(string $attr, string $path, mixed $data, mixed $volume) : bool|null
This method will disable accessing files/folders starting from '.' (dot)
attribute name (read|write|locked|hidden)
file path relative to volume root directory started with directory separator
accessImage(mixed $attr, mixed $path, mixed $data, mixed $volume) : mixed
accessAlbums(mixed $attr, mixed $path, mixed $data, mixed $volume) : mixed
imagecreatefrombmp(mixed $filename_or_stream_or_binary) : mixed
elFinder_admin_tabs(mixed $tabs) : mixed
elFinder_tinymce(mixed $discard) : mixed
printAddToFavorites(mixed $obj[, mixed $add = NULL ][, mixed $remove = NULL ]) : mixed
getFavoritesURL() : mixed
Prints links to the favorites "albums"
printFavoritesURL([type $text = NULL ][, mixed $before = NULL ][, mixed $between = NULL ][, mixed $after = NULL ]) : mixed
Returns the image object if an featured image is assigned, otherwise false
getFeaturedImage([obj $obj = NULL ]) : mixed
Object of the Zenpage article, category you want the featured image to get return mixed
Gets a custom sized version of this image based on the parameters. Multimedia items don't use these.
getSizedFeaturedImage([obj $obj = NULL ][, int $size = NULL ][, int $width = NULL ][, int $height = NULL ][, int $cropw = NULL ][, int $croph = NULL ][, int $cropx = NULL ][, int $cropy = NULL ][, bool $thumb = false ][, bool $effects = NULL ][, bool $maxspace = false ]) : string
Object of the Zenpage page, article or category you want the featured image to get. If you set it to NULL on news.php or pages.php it will try to get the image for the current page, news article or category
size
width
height
crop width
crop height
crop x axis
crop y axis
set to true to treat as thumbnail. Multimedia items are not used then
set to desired image effect (e.g. 'gray' to force gray scale)
Set $width and height and this to true (default false) to get a maxspace image. Other size paramaters will be ignored
Print a custom sized version of this image based on the parameters. Multimedia items don't use these.
printSizedFeaturedImage([obj $obj = NULL ][, string $alt = '' ][, int $size = NULL ][, int $width = NULL ][, int $height = NULL ][, int $cropw = NULL ][, int $croph = NULL ][, int $cropx = NULL ][, int $cropy = NULL ][, string $class = NULL ][, string $id = NULL ][, bool $thumb = false ][, bool $effects = NULL ][, bool $maxspace = false ]) : string
Object of the Zenpage page, article or category you want the featured image to get. If you set it to NULL on news.php or pages.php it will try to get the image for the current page, news article or category
Alt text of the img element
size
width
height
crop width
crop height
crop x axis
crop y axis
Class of the img element
Id of the img element
set to true to treat as thumbnail. Multimedia items are not used then
set to desired image effect (e.g. 'gray' to force gray scale)
Set $width and height and this to true (default false) to get a maxspace image. Other size paramaters will be ignored
Gets the default thumb size of a featured image
getFeaturedImageThumb([obj $obj = null ]) : string
Object of the Zenpage page, article or category you want the featured image to get. If you set it to NULL on news.php or pages.php it will try to get the image for the current page, news article or category
Prints the default thumb size of a featured image
printFeaturedImageThumb([string $alt = null ][, string $class = null ][, string $id = NULL ][, string $title = null ][, obj $obj = null ]) : mixed
Alt text
optional class attribute
optional id attribute
optional title attribute
Object of the Zenpage page, article or category you want the featured image to get. If you set it to NULL on news.php or pages.php it will try to get the image for the current page, news article or category
log_message(mixed $class, mixed $msg) : mixed
get_instance() : mixed
omsAdditions() : mixed
$returns coordinate informations for an image
getGeoCoord( $image) : mixed
Add a point to a map object
addGeoCoord( $map, $coord) : mixed
Gathers the data for an image
getImageGeodata( $image, $map) : mixed
Gathers the map data for an album
getAlbumGeodata( $album, $map) : mixed
Output the google map
printGoogleMap([string $text = NULL ][, string $id = NULL ][, string $hide = NULL ][, object $obj = NULL ][, function $callback = NULL ]) : mixed
text for the "toggle" link that shows/hides the map. Set empty to omit (then Map is always displayed)
used to set the IDs for the toggle href element ($id_toggle) and the map element ($id_data)
initial map state: "hide", "show", or "colorbox"
optional image/album object. Pass string for generic map and use callback to set points
optional callback function to set map options.
returns the hitcounter for the current page or for the object passed
getHitcounter([object $obj = NULL ]) : string
the album or page object for which the hitcount is desired
Gets the total hitcounter sum of one or several items
getTotalHitcounter([array<string|int, mixed> $items = array() ]) : int
an array with one or more item table names, e.g. array('albums', 'images', 'news', 'news_categories', 'pages')
Returns a array of album objects of album statistic accordingly to $option
getAlbumStatistic([int $number = 5 ][, string $option = '' ][, string $albumfolder = '' ][, int $threshold = 0 ][, mixed $sortdirection = 'desc' ][, bool $collection = false ]) : array<string|int, mixed>
the number of albums to get
"popular" for the most popular albums, "latest" for the latest uploaded by id (Discovery) "latest-date" for the latest by date "latest-mtime" for the latest by mtime "latest-publishdate" for the latest by publishdate "mostrated" for the most voted, "toprated" for the best voted "latestupdated" for the latest updated "random" for random order (yes, strictly no statistical order...)
The name of an album to get only the statistc for its direct subalbums
the minimum number of ratings (for rating options) or hits (for popular option) an album must have to be included in the list. (Default 0)
only if $albumfolder is set: true if you want to get statistics to include all subalbum levels
Prints album statistic according to $option as an unordered HTML list A css id is attached by default named '$option_album'
printAlbumStatistic(string $number, string $option[, bool $showtitle = false ][, bool $showdate = false ][, bool $showdesc = false ][, int $desclength = 40 ][, string $showstatistic = '' ][, int $width = NULL ][, int $height = NULL ][, bool $crop = NULL ][, mixed $albumfolder = '' ][, mixed $firstimglink = false ][, int $threshold = 0 ][, bool $collection = false ]) : mixed
the number of albums to get
"popular" for the most popular albums, "latest" for the latest uploaded by id (Discovery) "latest-date" for the latest by date "latest-mtime" for the latest by mtime "latest-publishdate" for the latest by publishdate "mostrated" for the most voted, "toprated" for the best voted "latestupdated" for the latest updated "random" for random order (yes, strictly no statistical order...)
if the album title should be shown
if the album date should be shown
if the album description should be shown
the length of the description to be shown
"hitcounter" for showing the hitcounter (views), "rating" for rating, "rating+hitcounter" for both.
the width/cropwidth of the thumb if crop=true else $width is longest size. (Default 85px)
the height/cropheight of the thumb if crop=true else not used. (Default 85px)
'true' (default) if the thumb should be cropped, 'false' if not
the minimum number of ratings (for rating options) or hits (for popular option) an album must have to be included in the list. (Default 0)
only if $albumfolder is set: true if you want to get statistics to include all subalbum levels
A helper function that only prints a item of the loop within printAlbumStatistic() Not for standalone use.
printAlbumStatisticItem(array<string|int, mixed> $album, string $option[, bool $showtitle = false ][, bool $showdate = false ][, bool $showdesc = false ][, int $desclength = 40 ][, string $showstatistic = '' ][, int $width = NULL ][, int $height = NULL ][, bool $crop = NULL ][, bool $firstimglink = false ]) : mixed
the array with album objects that getAlbumsStatistic() submitted
"popular" for the most popular albums, "latest" for the latest uploaded by id (Discovery) "latest-date" for the latest by date "latest-mtime" for the latest by mtime "latest-publishdate" for the latest by publishdate "mostrated" for the most voted, "toprated" for the best voted "latestupdated" for the latest updated "random" for random order (yes, strictly no statistical order...)
if the album title should be shown
if the album date should be shown
if the album description should be shown
the length of the description to be shown
"hitcounter" for showing the hitcounter (views), "rating" for rating, "rating+hitcounter" for both.
the width/cropwidth of the thumb if crop=true else $width is longest size. (Default 85px)
the height/cropheight of the thumb if crop=true else not used. (Default 85px)
'true' (default) if the thumb should be cropped, 'false' if not
'false' (default) if the album thumb link should lead to the album page, 'true' if to the first image of theh album if the album itself has images
Returns a array of image objects of image statistic according to $option
getImageStatistic(string $number, string $option[, string $albumfolder = '' ][, bool $collection = false ][, int $threshold = 0 ][, mixed $sortdirection = 'desc' ]) : array<string|int, mixed>
the number of images to get
"popular" for the most popular images, "popular" for the most popular albums, "latest" for the latest uploaded by id (Discovery) "latest-date" for the latest by date "latest-mtime" for the latest by mtime "latest-publishdate" for the latest by publishdate "mostrated" for the most voted, "toprated" for the best voted "latestupdated" for the latest updated "random" for random order (yes, strictly no statistical order...)
foldername of an specific album
only if $albumfolder is set: true if you want to get statistics from this album and all of its subalbums
the minimum number of ratings (for rating options) or hits (for popular option) an image must have to be included in the list. (Default 0)
Prints image statistic according to $option as an unordered HTML list A css id is attached by default named accordingly'$option'
printImageStatistic(string $number, string $option[, string $albumfolder = '' ][, bool $showtitle = false ][, bool $showdate = false ][, bool $showdesc = false ][, int $desclength = 40 ][, string $showstatistic = '' ][, int $width = NULL ][, int $height = NULL ][, bool $crop = NULL ][, bool $collection = false ][, bool $fullimagelink = false ][, int $threshold = 0 ]) : string
the number of albums to get
"popular" for the most popular images, "popular" for the most popular albums, "latest" for the latest uploaded by id (Discovery) "latest-date" for the latest by date "latest-mtime" for the latest by mtime "latest-publishdate" for the latest by publishdate "mostrated" for the most voted, "toprated" for the best voted "latestupdated" for the latest updated "random" for random order (yes, strictly no statistical order...)
foldername of an specific album
if the image title should be shown
if the image date should be shown
if the image description should be shown
the length of the description to be shown
"hitcounter" for showing the hitcounter (views), "rating" for rating, "rating+hitcounter" for both.
the width/cropwidth of the thumb if crop=true else $width is longest size. (Default 85px)
the height/cropheight of the thumb if crop=true else not used. (Default 85px)
'true' (default) if the thumb should be cropped, 'false' if not
only if $albumfolder is set: true if you want to get statistics from this album and all of its subalbums
'false' (default) for the image page link , 'true' for the unprotected full image link (to use Colorbox for example)
the minimum number of ratings (for rating options) or hits (for popular option) an image must have to be included in the list. (Default 0)
A little helper function that checks if an image or album is to be considered 'new' within the time range set in relation to getImageDate()/getAlbumDate() Returns true or false.
checkIfNew([string $mode = "image" ][, int $timerange = 604800 ]) : bool
What to check "image" or "album".
The time range the item should be considered new. Default is 604800 (unix time seconds = ca. 7 days)
Gets the number of all subalbums of all subalbum levels of either the current album or $albumobj
getNumAllSubalbums(object $albumobj[, string $pre = '' ]) : bool
Optional album object to check
Optional text you want to print before the number
Returns an randomly selected image objecet from the gallery per day.
getPictureOfTheDay([string $albumfolder = '' ][, bool $collection = false ]) : object|nill
Returns null on failure
foldername of an specific album. If not set from all images in the gallery
only if $albumfolder is set: true if you want to get statistics from this album and all of its subalbums
Gets the skin names and css files
getjPlayerSkins() : mixed
Gets the css files for a skin. Helper function for getjPlayerSkins().
getjPlayerSkinCSS(mixed $skins, mixed $dir) : mixed
jplayer class theme function wrapper for user convenience
printjPlayerPlaylist([type $option = "playlist" ][, type $albumfolder = "" ]) : mixed
macro_admin_tabs(mixed $tabs) : mixed
macroList_show(mixed $macro, mixed $detail) : mixed
markRelease_button(mixed $buttons) : mixed
Updates the sortorder of the pages list in the database
updateItemsSortorder() : mixed
Prints the table part of a single page item for the sortable pages list
printItemsListTable(mixed $item, bool $flag) : mixed
set to true to flag the element as having a problem with nesting level
Prints the sortable pages list returns true if nesting levels exceede the database container
printItemsList(mixed $items) : bool
Prints the link to the edit page of a menu item. For gallery and Zenpage items it links to their normal edit pages, for custom pages and custom links to menu specific edit page.
printItemEditLink(array<string|int, mixed> $item) : mixed
Array of the menu item
Prints the item status selector to choose if all items or only hidden or visible should be listed
printItemStatusDropdown() : mixed
returns the menu set selector
getMenuSetSelector(string $active) : mixed
true if changing the selection shuld reload to the new selection
Sets a menu item to published/visible
publishItem(int $id, string $show, string $menuset) : mixed
id of the item
published status.
chosen menu set
adds (sub)albums to menu base with their gallery sorting order intact
addSubalbumMenus(string $menuset, int $id, string $link, string $sort) : mixed
chosen menu set
table id of the parent.
folder name of the album
xxx-xxx-xxx style sort order for album
Adds albums to the menu set. Returns the next sort order base
addalbumsToDatabase(string $menuset[, string $base = NULL ]) : int
current menu set
starting "sort order"
Adds Zenpage pages to the menu set
addPagesToDatabase(string $menuset[, mixed $base = NULL ]) : int
current menu set
Adds Zenpage news categories to the menu set
addCategoriesToDatabase(string $menuset[, mixed $base = NULL ]) : mixed
chosen menu set
Adds an menu item set via POST
addItem(mixed &$reports) : array<string|int, mixed>
Updates a menu item (custom link, custom page only) set via POST
updateMenuItem(mixed &$reports) : mixed
Deletes a menu item set via GET
deleteItem(mixed &$reports) : mixed
Prints all albums of the Zenphoto gallery as a partial drop down menu (<option></option> parts).
printAlbumsSelector(string $current) : string
set to the album name selected (if any)
Prints all available pages in Zenpage
printZenpagePagesSelector(string $current) : string
set to the page selected (if any)
Prints all available articles or categories in Zenpage
printZenpageNewsCategorySelector(string $current) : string
set to category selected (if any)
Prints the selector for custom pages
printCustomPageSelector(mixed $current) : string
checks if a album or image is un-published and returns a '*'
unpublishedZenphotoItemCheck(mixed $obj[, mixed $dropdown = true ]) : string
Processes the check box bulk actions
processMenuBulkActions() : mixed
Add menu to the admin toolbox
menu_admin_toolbox_global(mixed $zf) : mixed
Adds menu manager to admin tabs
menu_tabs( $tabs) : unknown
Gets the menu items
getMenuItems(string $menuset, string $visible) : array<string|int, mixed>
the menu tree desired
Gets a menu item by its id
getItem(int $id) : array<string|int, mixed>
id of the item
Checks which menu set is chosen via $_GET. If none is explicity chosen the "default" one (create initially) is used.
checkChosenMenuset([mixed $default = 'default' ]) : string
Checks if the menu item is set visible or not
checkChosenItemStatus() : string
Gets the title, url and name of a menu item
getItemTitleAndURL(mixed $item) : array<string|int, mixed>
Gets the menu visibility
getMenuVisibility() : string
"invents" a menu item for the current page (for when one does not exist) Adds the item to the current menuset and modifies its "parent" as needed
inventMenuItem(string $menuset, string $visibility[, string $field = 'sort_order' ]) : int|array<string|int, mixed>|string
returns a contrived sort_order for the item.
The field of the array item to get, "all" for the full item array, "key" for the array index of the item within the items array (old default value)
Returns the data of the current menu item
getCurrentMenuItem(string $menuset[, string $field = 'sort_order' ]) : int|array<string|int, mixed>|string
current menu set
The field of the array item to get, "all" for the full item array, "key" for the array index of the item within the items array (old default value). Default 'sort_order'
Returns the link to the predicessor of the current menu item
getMenumanagerPredicessor([string $menuset = 'default' ]) : string
current menu set
Prints the previous link of the current menu item
printMenumanagerPrevLink(string $text[, string $menuset = 'default' ][, string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
Returns the successor link of the current menu item
getMenumanagerSuccessor([string $menuset = 'default' ]) : string
Gets the link to the next menu item
printMenumanagerNextLink(string $text[, string $menuset = 'default' ][, string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
current menu set
Prints a list of all pages.
printMenuemanagerPageListWithNav(string $prevtext, mixed $nexttext[, string $menuset = 'default' ][, string $class = 'pagelist' ][, string $nextprev = true ][, string $id = NULL ][, bool $firstlast = true ][, int $navlen = 9 ]) : mixed
Insert here the linktext like 'previous page'
current menu set
the css class to use, "pagelist" by default
set to true to get the 'next' and 'prev' links printed
the css id to use
Add links to the first and last pages of you gallery
Number of navigation links to show (0 for all pages). Works best if the number is odd.
Prints a full page navigation including previous and next page links with a list of all pages in between.
printMenuemanagerPageList([mixed $menuset = 'default' ][, string $class = 'pagelist' ][, string $id = NULL ][, bool $firstlast = true ][, int $navlen = 9 ]) : mixed
Insert here the CSS-class name you want to style the link with (default is "pagelist")
Insert here the CSS-ID name if you want to style the link with this
Add links to the first and last pages of you gallery
Number of navigation links to show (0 for all pages). Works best if the number is odd.
Gets the parent menu items of the current menu item. Returns the array of the items or false.
getParentMenuItems([string $menuset = 'default' ][, array<string|int, mixed> $currentitem = null ]) : array<string|int, mixed>|false
current menu set
Optional array of the menu item to get parents of. Default null for the current item
Prints the breadcrumbs of the current page
printMenumanagerBreadcrumb([string $menuset = 'default' ][, string $before = '' ][, string $between = ' | ' ][, string $after = ' | ' ]) : mixed
NOTE: this function is entirely dependedn on the menu tree you have generated. It will work only with static menu trees. That is, if the page upon which you call this function is not present in your menu tree it will not have any parent pages. Thus, menu items generated for instance by function calls cannot have parents in the printMenumanagerBreadcrumb sense.
Likewise if you have non exclusive menu links to a page the parentage of that page with respect to breadcrumbs may not reflect on the menu transitions that the user used to arrive on the page.
current menu set
before text
between text
after text
Returns the menu item corresponding to $link
getMenuFromLink(string $link[, string $menuset = 'default' ]) : array<string|int, mixed>
Returns true if the current menu item is a sub item of $link
submenuOf(string $link[, string $menuset = 'default' ]) : bool
possible parent
current menuset
Creates a menu set from the items passed. But only if the menu set does not already exist
createMenuIfNotExists(array<string|int, mixed> $menuitems[, string $menuset = 'default' ]) : mixed
items for the menuset array elements: 'type'=>menuset type 'title'=>title for the menu item 'link'=>URL or other data for the item link 'show'=>set to 1:"visible" or 0:"hidden", 'nesting'=>nesting level of this item in the menu heirarchy
current menuset
Gets the direct child menu items of the current menu item. Returns the array of the items or false.
getMenuItemChilds([string $menuset = 'default' ][, bool $allchilds = false ][, mixed $currentitem = null ]) : array<string|int, mixed>|false
current menu set
Set to false (default) for the next level childs, true for childs of all further levels
Checks if the item $item is a parent item of the current item
isCurrentitemParent([string $menuset = 'default' ][, array<string|int, mixed> $item = array() ]) : bool
Name of the menuset to use
Array of the item to check
Checks if the actual object the menu item represents is actually public
isPublicMenuItem(string $menuset, array<string|int, mixed> $item, array<string|int, mixed> $itemarray) : bool
The menu item array of the menu item to check
The item array of the menu item to check as returned by getItemTitleAndURL()
Prints a context sensitive menu of all pages as a unordered html list
printCustomMenu([string $menuset = 'default' ][, string $option = 'list' ][, string $css_id = '' ][, string $css_class_topactive = '' ][, string $css_class = '' ][, string $css_class_active = '' ][, int $showsubs = 0 ][, bool $counter = false ]) : string
the menu tree to output
The mode for the menu: "list" context sensitive toplevel plus sublevel pages, "list-top" only top level pages, "omit-top" only sub level pages "list-sub" lists only the current pages direct offspring
CSS id of the top level list
class of the active item in the top level list
CSS class of the sub level list(s)
CSS class of the sub level list(s)
Set to depth of sublevels that should be shown always. 0 by default. To show all, set to a true! Only valid if option=="list".
TRUE (FALSE default) if you want the count of articles for Zenpage news categories or images/subalbums for albums.
Gets the selected layout page for this item. Returns false if nothing is selected.
getSelectedLayout(object $obj, string $type) : string|false
the object being selected
For Zenphoto gallery items "multiple_layouts_albums", 'multiple_layouts_albums_images', 'multiple_layouts_images' For Zenpage CMS items , "multiple_layouts_pages", , "multiple_layouts_news" , "multiple_layouts_news_categories"
Checks if there is a layout inherited from a parent items (album, page or category) and returns it. Returns false otherwise.
checkParentLayouts(object $obj, string $type) : array<string|int, mixed>|false
the object being selected
For Zenphoto gallery items "multiple_layouts_albums", 'multiple_layouts_albums_images', 'multiple_layouts_images' For Zenpage CMS items , "multiple_layouts_pages", , "multiple_layouts_news" , "multiple_layouts_news_categories"
Gets the selected layout page for images if the album option to use the equivalent of their album layout is seleted.
checkLayoutUseForImages(object $obj) : array<string|int, mixed>|false
the album
returns the layout selector for an object.
layoutSelector(mixed $html, object $obj[, mixed $prefix = '' ]) : string
returns the layout selectors for an album.
layoutSelector_album(mixed $html, object $obj[, mixed $prefix = '' ]) : string
Worker function for creating layout selectors. Returns the HTML
getLayoutSelector(object $obj, string $type, string $text[, string $prefix = '' ][, bool $secondary = false ]) : string
Default empty
Default false
Gets the select layout page and returns it to the load_theme_script filter
getLayout(string $path) : string
Path of the layout file
Saves the layout page assignment via filter on the backend
saveLayoutSelection(string $message, object $obj) : string
Message (not used)
Object of the item to assign the layout
Saves the layout page assignment via filter on the backend for images and albums
saveZenphotoLayoutSelection(object $obj, string $prefix) : string
Object of the item to assign the layout
processes object removals if they have been assigned layouts
deleteLayoutSelection(bool $allow, object $obj) : bool
we just return this since we have no need to abort the remove
the object being removed
Copies the layout selection
copyLayoutSelection(int $newid, obj $obj) : mixed
ID of the item to copy to
Object of the original item return int
Template function wrapper for the openStreetMap class to show a map with geodata markers for the current image or collected the images of an album.
printOpenStreetMap([array<string|int, mixed> $geodata = NULL ][, string $width = NULL ][, string $height = NULL ][, array<string|int, mixed> $mapcenter = NULL ][, int $zoom = NULL ][, array<string|int, mixed> $fitbounds = NULL ][, string $class = '' ][, int $mapnumber = NULL ][, obj $obj = NULL ][, bool $minimap = false ]) : mixed
For more flexibility use the class directly.
The map is not shown if there is no geodata available.
Array of the geodata to create and display markers. See the constructor of the openStreetMap Class for the require structure
Width with unit, e.g. 100%, 100px, 100em
Height with unit, e.g. 100px, 100em
geodata array(lat,lng);
Number of the zoom 0 -
geodata array('min' => array(lat,lng), 'max => array(lat,lng))
Class name to attach to the map element
If calling more than one map per page an unique number is required
Image or album object to skip current image or album and also $geodata
True to show the minimap in the lower right corner
Prints a paged thumbnail navigation to be used on a theme's image.php, independent of the album.php's thumbs loop
printPagedThumbsNav([int $imagesperpage = '' ][, bool $counter = false ][, string $prev = '' ][, string $next = '' ][, int $width = NULL ][, int $height = NULL ][, bool $crop = NULL ][, bool $placeholders = NULL ][, bool $showpagelist = false ][, mixed $pagelistprevnext = false ][, mixed $pagelistlength = 6 ]) : mixed
NOTE: With version 1.0.2 $size is no longer an option for this plugin. This plugin now uses the new maxspace function if cropping set to false.
The function contains some predefined CSS ids you can use for styling. NOTE: In 1.0.3 a extra div around the thumbnails has been added:
You can of course build your own order of the elements as this plugin is with version 1.2.7 based on a class. Make a custom theme function and change the order of the functions calls within. Alternatively you can use also use the "get" class methods to build something completely customized.
How many thumbs you want to display per list page
If you want to show the counter of the type "Images 1 - 10 of 20 (1/3)"
The previous thumb list link text
The next thumb list link text
The thumbnail crop width, if set to NULL the general admin setting is used. If cropping is FALSE this is the maxwidth of the thumb
The thumbnail crop height, if set to NULL the general admin setting is used. If cropping is FALSE this is the maxwheight of the thumb
Enter 'true' or 'false' to override the admin plugin option setting, enter NULL to use the admin plugin option (default)
Enter 'true' or 'false' if you want to use placeholder for layout reasons if teh the number of thumbs does not match $imagesperpage. Recommended only for cropped thumbs. This is printed as an empty whose width and height are set via inline css. The remaining needs to be style via the css file and can be addressed via "#pagedthumbsimages span".
Enter 'true' or 'false' if you want to a list of the pages available. Can be styled via "#pagedthumbsnav-pagelist".
zenphoto_PHPMailer(mixed $msg, mixed $email_list, mixed $subject, mixed $message, mixed $from_mail, mixed $from_name, mixed $cc_addresses, mixed $replyTo) : mixed
Prints a list of all albums context sensitive.
printAlbumMenu(string $option[, bool $showcount = NULL ][, string $css_id = '' ][, string $css_class_topactive = '' ][, string $css_class = '' ][, string $css_class_active = '' ][, string $indexname = "Gallery Index" ][, int $showsubs = NULL ][, bool $firstimagelink = false ][, bool $keeptopactive = false ]) : mixed
Since 1.4.3 this is a wrapper function for the separate functions printAlbumMenuList() and printAlbumMenuJump(). that was included to remain compatiblility with older installs of this menu.
Usage: add the following to the php page where you wish to use these menus: enable this extension on the zenphoto admin plugins tab. Call the function printAlbumMenu() at the point where you want the menu to appear.
"list" for html list, "list-top" for only the top level albums, "omit-top" same as list, but the first level of albums is omitted "list-sub" lists the offspring level of subalbums for the current album "jump" dropdown menu of all albums(not context sensitive)
true for a image counter or subalbum count in brackets behind the album name, false for no image numbers or leave blank
insert css id for the main album list, leave empty if you don't use (only list mode)
insert css class for the active link in the main album list (only list mode)
insert css class for the sub album lists (only list mode)
insert css class for the active link in the sub album lists (only list mode)
insert the name how you want to call the link to the gallery index (insert "" if you don't use it, it is not printed then)
Set to depth of sublevels that should be shown always. 0 by default. To show all, set to a true! Only valid if option=="list".
If set to TRUE and if the album has images the link will point to page of the first image instead the album thumbnail page
If set to TRUE the toplevel album entry will stay marked as active if within its subalbums ("list" only)
Prints a nested html list of all albums context sensitive.
printAlbumMenuList(string $option[, bool $showcount = NULL ][, string $css_id = '' ][, mixed $css_class_topactive = '' ][, string $css_class = '' ][, string $css_class_active = '' ][, string $indexname = "Gallery Index" ][, int $showsubs = NULL ][, bool $firstimagelink = false ][, bool $keeptopactive = false ][, bool $startlist = true ][, int $limit = NULL ]) : html
Usage: add the following to the php page where you wish to use these menus: enable this extension on the zenphoto admin plugins tab; Call the function printAlbumMenuList() at the point where you want the menu to appear.
"list" for html list, "list-top" for only the top level albums, "omit-top" same as list, but the first level of albums is omitted "list-sub" lists the offspring level of subalbums for the current album
true for a image counter in brackets behind the album name, false for no image numbers or leave empty
insert css id for the main album list, leave empty if you don't use (only list mode)
insert css class for the sub album lists (only list mode)
insert css class for the active link in the sub album lists (only list mode)
insert the name (default "Gallery Index") how you want to call the link to the gallery index, insert "" if you don't use it, it is not printed then.
Set to depth of sublevels that should be shown always. 0 by default. To show all, set to a true! Only valid if option=="list".
If set to TRUE and if the album has images the link will point to page of the first image instead the album thumbnail page
If set to TRUE the toplevel album entry will stay marked as active if within its subalbums ("list" only)
set to true to output the UL tab (false automatically if you use 'omit-top' or 'list-sub')
truncation of display text
list of the albums
Handles an album for printAlbumMenuList
printAlbumMenuListAlbum(array<string|int, mixed> $albums, string $folder, string $option, string $showcount, int $showsubs, string $css_class, string $css_class_topactive, string $css_class_active, bool $firstimagelink, bool $keeptopactive[, int $limit = NULL ]) : mixed
albums array
see printAlbumMenuList
see printAlbumMenuList
see printAlbumMenuList
see printAlbumMenuList
see printAlbumMenuList
see printAlbumMenuList
If set to TRUE and if the album has images the link will point to page of the first image instead the album thumbnail page
If set to TRUE the toplevel album entry will stay marked as active if within its subalbums ("list" only)
truncation of display text
Prints a dropdown menu of all albums(not context sensitive) Is used by the wrapper function printAlbumMenu() if the options "jump" is choosen. For standalone use, too.
printAlbumMenuJump([string $option = "count" ][, string $indexname = "Gallery Index" ][, bool $firstimagelink = false ][, mixed $showsubs = NULL ][, bool $skipform = false ]) : mixed
Usage: add the following to the php page where you wish to use these menus: enable this extension on the zenphoto admin plugins tab; Call the function printAlbumMenuJump() at the point where you want the menu to appear.
"count" for a image counter in brackets behind the album name, "" = for no image numbers
insert the name (default "Gallery Index") how you want to call the link to the gallery index, insert "" if you don't use it, it is not printed then.
If set to TRUE and if the album has images the link will point to page of the first image instead the album thumbnail page
If set to false this prints a full form option select list (default), if set to true it will only print the options
A printAlbumMenu() helper function for the jump menu mode of printAlbumMenu() that only checks which the current album so that the entry in the in the dropdown jump menu can be selected Not for standalone use.
checkSelectedAlbum(string $checkalbum, string $option) : string
The album folder name to check
"index" for index level, "album" for album level
returns nothing or "selected"
unpublishSubalbums(mixed $album) : mixed
Prints the rating star form and the current rating Insert this function call in the page script where you want the star ratings to appear.
printRating([bool $vote = 3 ][, object $object = NULL ][, bool $text = true ]) : mixed
NOTE: If $vote is false or the rating_recast option is false then the stars shown will be the rating. Otherwise the stars will show the value of the viewer's last vote.
set to false to disable voting
optional object for the ratings target. If not set, the current page object is used
if false, no annotation text is displayed
Returns the current rating of an object
getRating([object $object = NULL ]) : float
optional ratings target. If not supplied, the current script object is used
Parses the verification and registration if they have occurred places the user registration form
printRegistrationForm([string $thanks = NULL ]) : mixed
the message shown on successful registration
prints the link to the register user page
printRegisterURL(string $_linktext[, string $prev = '' ][, string $next = '' ][, string $class = NULL ]) : mixed
text for the link
text to insert before the URL
text to follow the URL
optional class
getRelatedItems([mixed $type = 'news' ][, mixed $album = NULL ]) : mixed
Helper function for getRelatedItems() only.
createRelatedItemsResultArray(array<string|int, mixed> $result, string $type) : mixed
Returns an array with array for each item with name, album (images only), type and weight (search weight value) Excludes the current item itself.
array with search results
"albums", "images", "news", "pages"
Prints the x related articles based on a tag search
printRelatedItems([int $number = 5 ][, string $type = 'news' ][, string $specific = NULL ][, bool $excerpt = NULL ][, bool $thumb = false ][, mixed $date = false ]) : mixed
Number of items to get
'albums', 'images','news','pages', "all" for all combined.
If $type = 'albums' or 'images' name of album
If a text excerpt (gallery items: description; Zenpage items: content) should be shown. NULL for none or number of length
For $type = 'albums' or 'images' if a thumb should be shown (default size as set on the options)
rulesList() : type
Prints a RSS link for if (class_exists('RSS')) printRSSLink() and if (class_exists('RSS')) printRSSHeaderLink()
getRSSLink(string $option[, string $lang = NULL ][, string $addl = NULL ]) : mixed
type of RSS: "Gallery" feed for latest images of the whole gallery "Album" for latest images only of the album it is called from "Collection" for latest images of the album it is called from and all of its subalbums "Comments-gallery" for all comments of all albums and images "Comments-image" for latest comments of only the image it is called from "Comments-album" for latest comments of only the album it is called from "AlbumsRSS" for latest albums "AlbumsRSScollection" only for latest subalbums with the album it is called from or "News" feed for all news articles "Category" for only the news articles of the category that is currently selected "NewsWithImages" for all news articles and latest images "Comments-zenpage" for all comments of all news articles and pages "Comments-news" for comments of only the news article it is called from "Comments-page" for comments of only the page it is called from "Comments-all" for comments from all albums, images, news articels and pages "Pages" feed for all pages
optional to display a feed link for a specific language. Enter the locale like "de_DE" (the locale must be installed on your Zenphoto to work of course). If empty the locale set in the admin option or the language selector (getOption('locale') is used.
provided additional data for feeds (e.g. album object for album feeds, $categorylink for zenpage categories
Prints an RSS link
printRSSLink(string $option, string $prev, string $linktext, string $next[, bool $printIcon = true ][, string $class = null ][, string $lang = '' ][, string $addl = NULL ]) : mixed
type of RSS: See getRSSLink for details
text to before before the link
title of the link
text to appear after the link
print an RSS icon beside it? if true, the icon is zp-core/images/rss.png
css class
optional to display a feed link for a specific language. Enter the locale like "de_DE" (the locale must be installed on your Zenphoto to work of course). If empty the locale set in the admin option or the language selector (getOption('locale') is used.
provided additional data for feeds (e.g. album object for album feeds, $categorylink for zenpage categories
Prints the RSS link for use in the HTML HEAD
printRSSHeaderLink(string $option, string $linktext[, string $lang = '' ][, string $addl = NULL ]) : mixed
type of RSS: "Gallery" feed for latest images of the whole gallery "Album" for latest images only of the album it is called from "Collection" for latest images of the album it is called from and all of its subalbums "Comments" for all comments of all albums and images "Comments-image" for latest comments of only the image it is called from "Comments-album" for latest comments of only the album it is called from "AlbumsRSS" for latest albums "AlbumsRSScollection" only for latest subalbums with the album it is called from
title of the link
optional to display a feed link for a specific language. Enter the locale like "de_DE" (the locale must be installed on your Zenphoto to work of course). If empty the locale set in the admin option or the language selector (getOption('locale') is used.
provided additional data for feeds (e.g. album object for album feeds, $categorylink for zenpage categories
executeRSS() : mixed
seo_cleanup_button(mixed $buttons) : mixed
getE(mixed $e) : mixed
cleanAlbum(mixed $obj) : mixed
checkFolder(mixed $album, mixed $album_cleaned) : mixed
Prints a link to call the slideshow (not shown if there are no images in the album) To be used on album.php and image.php A CSS id names 'slideshowlink' is attached to the link so it can be directly styled.
printSlideShowLink([string $linktext = NULL ][, string $linkstyle = Null ]) : mixed
If the mode is set to "jQuery Colorbox" and the Colorbox plugin is enabled this link starts a Colorbox slideshow from a hidden HTML list of all images in the album. On album.php it starts with the first always, on image.php with the current image.
Text for the link
Style of Text for the link
Prints the slideshow using the {@link http://http://www.malsup.com/jquery/cycle2/ jQuery plugin Cycle2 }
printSlideShow([bool $heading = true ][, bool $speedctl = false ][, obj $albumobj = NULL ][, obj $imageobj = NULL ][, int $width = NULL ][, int $height = NULL ][, bool $crop = false ][, bool $shuffle = false ][, bool $linkslides = false ][, bool $controls = true ]) : mixed
Two ways to use: a) Use on your theme's slideshow.php page and called via printSlideShowLink(): If called from image.php it starts with that image, called from album.php it starts with the first image (jQuery only) To be used on slideshow.php only and called from album.php or image.php.
b) Calling directly via printSlideShow() function (jQuery mode) Place the printSlideShow() function where you want the slideshow to appear and set create an album object for $albumobj and if needed an image object for $imageobj. The controls are disabled automatically.
NOTE: The jQuery mode does not support movie and audio files anymore. If you need to show them please use the Flash mode. Also note that this function is not used for the Colorbox mode!
set to true (default) to emit the slideshow breadcrumbs in flash mode
controls whether an option box for controlling transition speed is displayed
The object of the album to show the slideshow of. If set this overrides the POST data of the printSlideShowLink()
The object of the image to start the slideshow with. If set this overrides the POST data of the printSlideShowLink(). If not set the slideshow starts with the first image of the album.
The width of the images (jQuery mode). If set this overrides the size the slideshow_width plugin option that otherwise is used.
The heigth of the images (jQuery mode). If set this overrides the size the slideshow_height plugin option that otherwise is used.
Set to true if you want images cropped width x height (jQuery mode only)
Set to true if you want random (shuffled) order
Set to true if you want the slides to be linked to their image pages (jQuery mode only)
Set to true (default) if you want the slideshow controls to be shown (might require theme CSS changes if calling outside the slideshow.php page) (jQuery mode only)
Prints a tag cloud list of the tags in one album and optionally its subalbums. Returns FALSE if no value.
getAllTagsFromAlbum(string $albumname[, bool $subalbums = false ][, string $mode = 'images' ]) : array<string|int, mixed>
folder name of the album to get the tags from ($subalbums = true this is the base albums)- This value is mandatory.
TRUE if the tags of subalbum should be. FALSE is default
"images" for image tags, "albums" for album tags."images" is default.
Gets all tags used by either all Zenpage news articles or pages.
getAllTagsFromZenpage([string $mode = 'news' ]) : mixed
"news" for Zenpage news article tags, "pages" for Zenpage pages tags
Prints a tag cloud list of the tags used by either all Zenpage news articles or pages.
printAllTagsFromZenpage([string $mode = 'news' ][, string $separator = '' ][, string $class = '' ][, int $showcounter = true ][, bool $tagcloud = true ][, integere $size_min = 1 ][, int $size_max = 5 ][, int $count_min = 1 ][, int $count_max = 50 ]) : mixed
"news" for Zenpage news article tags, "pages" for Zenpage pages tags
how to separate the entries
css classs to style the list
if the tag count should be shown (no counter if $mode = "all")
if set to false a simple list without font size changes will be printed, set to true (default) prints a list as a tag cloud
smallest font size the cloud should display
largest font size the cloud should display
the minimum count for a tag to appear in the output
the floor count for setting the cloud font size to $size_max
Prints a tag cloud list of the tags in one album and optionally its subalbums.
printAllTagsFromAlbum([string $albumname = "" ][, bool $subalbums = false ][, string $mode = 'images' ][, string $separator = '' ][, string $class = '' ][, int $showcounter = true ][, bool $tagcloud = true ][, integere $size_min = 1 ][, int $size_max = 5 ][, int $count_min = 1 ][, int $count_max = 50 ]) : mixed
Known limitation: If $mode is set to "all" there is no tag count and therefore no tag cloud but a simple list
folder name of the album to get the tags from ($subalbums = true this is the base albums)
TRUE if the tags of subalbum should be. FALSE is default
"images" for image tags, "albums" for album tags, "all" for both mixed
how to separate the entries
css classs to style the list
if the tag count should be shown (no counter if $mode = "all")
if set to false a simple list without font size changes will be printed, set to true (default) prints a list as a tag cloud
smallest font size the cloud should display
largest font size the cloud should display
the minimum count for a tag to appear in the output
the floor count for setting the cloud font size to $size_max
Prints a tag cloud list of the tags in one album and optionally its subalbums. Base function to printAllTagsFromAlbum().
printAllTags(array<string|int, mixed> $tags, string $mode[, string $separator = '' ][, string $class = '' ][, int $showcounter = true ][, bool $tagcloud = true ][, integere $size_min = 1 ][, int $size_max = 5 ][, int $count_min = 1 ][, int $count_max = 50 ]) : mixed
Note meant to be used standalone.
array of tags with the fields count, id, and name (as passed by the specific printAllTagsFrom.... functions)
"images" for image tags, "albums" for album tags, "all" for images and albums mixed or "news" for Zenpage news articles, "pages" for Zenpage pages
how to separate the entries
css classs to style the list
if the tag count should be shown (no counter if $mode = "all")
if set to false a simple list without font size changes will be printed, set to true (default) prints a list as a tag cloud
smallest font size the cloud should display
largest font size the cloud should display
the minimum count for a tag to appear in the output
the floor count for setting the cloud font size to $size_max
Removes duplicate entries in multi dimensional array.
getAllTagsFromAlbum_multi_unique(array<string|int, mixed> $array) : array<string|int, mixed>
From kenrbnsn at rbnsn dot com http://uk.php.net/manual/en/function.array-unique.php#57202
tagSuggestJS_admin() : mixed
tagSuggestJS_frontend() : mixed
tagSuggestJS([mixed $exclude_unassigned = false ][, mixed $checkaccess = false ]) : mixed
Prints all albums of the Zenphoto gallery as a partial drop down menu (<option></option> parts).
printFullAlbumsList() : string
Recursive helper function for printFullAlbumsList() to get all sub albums of each top level album
printSubLevelAlbums(mixed &$albumobj) : string
checks if a album or image is un-published and returns a '*'
unpublishedZenphotoItemCheck(mixed $obj[, mixed $dropdown = true ]) : string
shortens a string, truncate_string() was not exact enough.
shortentitle( $title, $length) : string
Prints the images and/or albums as thumbnails of the selected album
printImageslist( $number) : string
Returns the object "type" of the "image".
getImageType(mixed $imageobj) : string
Note: If the root object is a video object then If a mediaplayer is enabled a sub-type of video or audio will be determined from the suffix. If it is not one of the known suffixes or if the mediaplayer is not enabled then 'other' is returned as the object type.
Pure images return empty for an object type.
Prints all available articles in Zenpage
printNewsArticlesList(mixed $number) : string
Checks if an album has images for display on the form
checkAlbumForImages() : bool
Checks if the full Zenphoto include form options should be shown
showZenphotoOptions() : bool
Prints the page navigation for albums or Zenpage news articles
printTinyPageNav([ $pagestotal = "" ][, $currentpage = "" ][, $mode = 'images' ]) : string
int The number page in total
int Number of the current page
string 'images' or 'articles'
Prints the Zenpage items as a partial dropdown (pages, news articles, categories)
printZenpageItems() : string
Prints all available pages or categories in Zenpage
printAllNestedList() : string
checks if a news article or page is un-published and/or protected and returns a '*'
unpublishedZenpageItemCheck(mixed $page) : string
Set the locale for gettext translation of this plugin. Somehow ZenPhoto's setupDomain() does not work here.
setTinyZenpageLocale() : mixed
..
Prints the dropdown menu for the category selector for the news articles list
printTinyZenpageCategorySelector([mixed $currentpage = '' ]) : mixed
Prints all albums of the Zenphoto gallery as a partial drop down menu (<option></option> parts).
printFullAlbumsList() : string
Recursive helper function for printFullAlbumsList() to get all sub albums of each top level album
printSubLevelAlbums(mixed &$albumobj) : string
checks if a album or image is un-published and returns a '*'
unpublishedZenphotoItemCheck(mixed $obj[, mixed $dropdown = true ]) : string
shortens a string, truncate_string() was not exact enough.
shortentitle( $title, $length) : string
Prints the images and/or albums as thumbnails of the selected album
printImageslist( $number) : string
Returns the object "type" of the "image".
getImageType(mixed $imageobj) : string
Note: If the root object is a video object then If a mediaplayer is enabled a sub-type of video or audio will be determined from the suffix. If it is not one of the known suffixes or if the mediaplayer is not enabled then 'other' is returned as the object type.
Pure images return empty for an object type.
Prints all available articles in Zenpage
printNewsArticlesList(mixed $number) : string
Checks if an album has images for display on the form
checkAlbumForImages() : bool
Checks if the full Zenphoto include form options should be shown
showZenphotoOptions() : bool
Prints the page navigation for albums or Zenpage news articles
printTinyPageNav([ $pagestotal = "" ][, $currentpage = "" ][, $mode = 'images' ]) : string
int The number page in total
int Number of the current page
string 'images' or 'articles'
Prints the Zenpage items as a partial dropdown (pages, news articles, categories)
printZenpageItems() : string
Prints all available pages or categories in Zenpage
printAllNestedList() : string
checks if a news article or page is un-published and/or protected and returns a '*'
unpublishedZenpageItemCheck(mixed $page) : string
Set the locale for gettext translation of this plugin. Somehow ZenPhoto's setupDomain() does not work here.
setTinyZenpageLocale() : mixed
..
Prints the dropdown menu for the category selector for the news articles list
printTinyZenpageCategorySelector([mixed $currentpage = '' ]) : mixed
tinymce4ConfigJS(mixed $mode) : mixed
getTinyMCE4ConfigFiles(mixed $mode) : mixed
upload_head() : mixed
upload_extra(mixed $uploadlimit, mixed $passedalbum) : mixed
upload_form(mixed $uploadlimit, mixed $passedalbum) : mixed
httpUploadHandler(mixed $uploadHandlers) : mixed
httpUploadHandler_admin_tabs(mixed $tabs) : mixed
jQueryUpload_headers() : mixed
jQueryUpload_head() : mixed
upload_head() : mixed
upload_extra(mixed $uploadlimit, mixed $passedalbum) : mixed
upload_form(mixed $uploadlimit, mixed $passedalbum) : mixed
jQueryUploadHandler(mixed $uploadHandlers) : mixed
jQueryUploadHandler_admin_tabs(mixed $tabs) : mixed
Prints the logout link if the user is logged in.
printUserLogin_out([string $before = '' ][, string $after = '' ][, int $showLoginForm = NULL ][, string $logouttext = NULL ]) : mixed
This is for album passwords only, not admin users;
before text
after text
to display a login form to not display a login form, but just a login link, set to 0 to display a login form set to 1 to display a link to a login form in colorbox, set to 2, but you must have colorbox enabled for the theme pages where this link appears.)
optional replacement text for "Logout"
user_mailing_list_button(mixed $buttons) : mixed
Retrieves posted expiry date and checks it against the current date/time Returns the posted date if it is in the future Returns NULL if the date is past
getExpiryDatePost() : string
processes the taglist save
processTags(object $object) : mixed
the object on which the save happened
Updates or adds a page and returns the object of that page
updatePage(array<string|int, mixed> &$reports[, bool $newpage = false ]) : object
report display
true if it is a new page
Deletes a page (and also if existing its subpages) from the database
deletePage(mixed $titlelink) : mixed
Prints the table part of a single page item for the sortable pages list
printPagesListTable(object $page, bool $flag) : mixed
The array containing the single page
set to true to flag the element as having a problem with nesting level
Updates or adds a news article and returns the object of that article
updateArticle(array<string|int, mixed> &$reports[, bool $newarticle = false ]) : object
display
true if a new article
Deletes an news article from the database
deleteArticle(mixed $titlelink) : mixed
Print the categories of a news article for the news articles list
printArticleCategories(obj $obj) : mixed
object of the news article
Print the categories of a news article for the news articles list
printPageArticleTags(obj $obj) : mixed
object of the news article
Prints the checkboxes to select and/or show the category of an news article on the edit or add page
printCategorySelection([int $id = '' ][, string $option = '' ]) : mixed
ID of the news article if the categories an existing articles is assigned to shall be shown, empty if this is a new article to be added.
"all" to show all categories if creating a new article without categories assigned, empty if editing an existing article that already has categories assigned.
Prints the dropdown menu for the date archive selector for the news articles list
printArticleDatesDropdown(mixed $pagenumber) : mixed
Compiles an option parameter list
getNewsAdminOption(array<string|int, mixed> $test) : array<string|int, mixed>
array of parameter=>type elements. type=0:string type=1:numeric
Creates the admin paths for news articles if you use the dropdowns on the admin news article list together
getNewsAdminOptionPath(array<string|int, mixed> $list) : string
an parameter array of item=>value for instance, the result of getNewsAdminOption()
Prints the dropdown menu for the published/un-publishd selector for the news articles list
printUnpublishedDropdown() : mixed
Prints the dropdown menu for the sortorder selector for the news articles list
printSortOrderDropdown() : mixed
Prints the dropdown menu for the category selector for the news articles list
printCategoryDropdown() : mixed
Prints the dropdown menu for the articles per page selector for the news articles list
printArticlesPerPageDropdown(mixed $pagenumber, mixed $articles_page) : mixed
Prints the dropdown menu all authors that currently are authors of news articles
printAuthorDropdown() : mixed
Updates or adds a category
updateCategory(array<string|int, mixed> &$reports[, bool $newcategory = false ]) : mixed
the results display
true if a new article
Deletes a category (and also if existing its subpages) from the database
deleteCategory(mixed $titlelink) : mixed
Prints the list entry of a single category for the sortable list
printCategoryListSortableTable(array<string|int, mixed> $cat, string $flag) : string
Array storing the db info of the category
If the category is protected
Prints the checkboxes to select and/or show the category of an news article on the edit or add page
printCategoryCheckboxListEntry(mixed $cat, mixed $articleid, string $option[, mixed $class = '' ]) : mixed
"all" to show all categories if creating a new article without categories assigned, empty if editing an existing article that already has categories assigned.
Prints the nested list for pages and categories
printNestedItemsList([string $listtype = 'cats-sortablelist' ][, $obj = '' ][, string $option = '' ][, mixed $class = 'nestedItem' ]) : string
'cats-checkboxlist' for a fake nested checkbock list of categories for the news article edit/add page 'cats-sortablelist' for a sortable nested list of categories for the admin categories page 'pages-sortablelist' for a sortable nested list of pages for the admin pages page
$obj Optional, default empty. Passing an articledid is deprecated and will be removed in ZenphotoCMS 2.0.
Only for $listtype = 'cats-checkboxlist': "all" to show all categories if creating a new article without categories assigned, empty if editing an existing article that already has categories assigned.
| bool
Updates the sortorder of the items list in the database
updateItemSortorder([string $mode = 'pages' ]) : array<string|int, mixed>
'pages' or 'categories'
Checks if no title has been provide for items on new item creation
checkForEmptyTitle(string $titlefield, string $type[, mixed $truncate = true ]) : string
The title field
'page', 'news' or 'category'
Publishes a page or news article
zenpagePublish(object $obj, int $show) : string
the value for publishing
Skips the scheduled future publishing by setting the date of a page or article to the current date to publish it immediately or the expiration handling by setting the expiredate to null.
skipScheduledPublishing(object $obj[, string $type = 'futuredate' ]) : string
"futuredate" or "expiredate"
Checks if there are hitcounts and if they are displayed behind the news article, page or category title
checkHitcounterDisplay(string $item) : string
The array of the current news article, page or category in the list.
returns an array of how many pages, articles, categories and news or pages comments we got.
getNewsPagesStatistic(string $option) : mixed
What the statistic should be shown of: "news", "pages", "categories"
printPagesStatistic() : mixed
printNewsStatistic() : mixed
printCategoriesStatistic() : mixed
Prints the links to JavaScript and CSS files zenpage needs.
zenpageJSCSS() : mixed
Actually the same as for zenphoto but with different paths since we are in the plugins folder.
printZenpageIconLegend() : mixed
Prints a dropdown to select the author of a page or news article (Admin rights users only)
authorSelector([mixed $author = NULL ]) : mixed
Prints the publish/un-published/scheduled publishing icon with a link for the pages and news articles list.
printPublishIconLink(obj $obj[, mixed $type = '' ][, mixed $linkback = '' ]) : mixed
Object of the page or news article to check
Checks if a checkbox is selected and checks it if.
checkIfChecked(string $field) : mixed
the array field of an item array to be checked (for example "permalink" or "comments on")
Checks if the current logged in admin user is the author that locked the page/article.
checkIfLockedPage(object $page) : bool
Only that author or any user with admin rights will be able to edit or unlock.
The array of the page or article to check
Checks if the current logged in admin user is the author that locked the article.
checkIfLockedNews(mixed $news) : bool
Only that author or any user with admin rights will be able to edit or unlock.
Checks if the current admin-edit.php page is called for news articles or for pages.
is_AdminEditPage(string $page) : bool
What you want to check for, "page" or "newsarticle"
Processes the check box bulk actions
processZenpageBulkActions(mixed $type) : mixed
zenpageBulkActionMessage(mixed $action) : mixed
Creates the titlelink from the title passed.
createTitlelink(string|array<string|int, mixed> $title, string $date) : type
The title respectively language array of titles
The date the article is saved
Checks if a title link of this itemtype already exists
checkTitlelinkDuplicate(string $titlelink, string $itemtype) : bool
The titlelink to check
Append or prepends a date string to a titlelink as defined.
addDateToTitlelink(string $titlelink) : string
Note: This does not check the item type option and will add to any string passed!
The titleink (e.g. as created by createTitleink())
Returns the full path of the news index page
getNewsIndexURL([int $page = '' ]) : string
Page number to append, default empty (page 1)
Returns the full path of the news archive page
getNewsArchiveURL(string $date) : string
the date of the archive page
RSS_Tags(mixed $item, mixed $type) : mixed
RSS_Channel(mixed $channel) : mixed
RSS_Retrieve(mixed $url) : mixed
printNews() : mixed
zenphoto_sendmail(type $msg, type $email_list, type $subject, type $message, type $from_mail, type $from_name, type $cc_addresses, type $replyTo) : type