API Documentation
Table of Contents
Namespaces
Interfaces
- elFinderSessionInterface
- elFinder - file manager for web.
Classes
- _zp_captcha
- Standins for when no captcha is enabled
- _zp_HTML_cache
- stand-in for when there is no HTML cache plugin enabled
- Administrator
- This is a simple class so that we have a convienient "handle" for manipulating Administrators.
- Zenphoto_Administrator
- This is a simple class so that we have a convienient "handle" for manipulating Administrators.
- Album
- Album Class
- AlbumBase
- Album Base Class
- Authority
- Provides the methods used for user authorization and management store an instantiation of this class in `$_zp_authority`.
- Zenphoto_Authority
- Provides the methods used for user authorization and management store an instantiation of this class in `$_zp_authority`.
- backupRestore
- Class for creating and restoring database backups.
- dbBase
- Database base class if no supported database is configured in PHP
- dbMySQLi
- Database core class for the MySQLi library
- dbPDO_MySQL
- Database core class for the PDO::MySQL library
- dynamicAlbum
- Dynamic Album Class for "saved searches"
- external_auth
- Root class for external authorizaton plugins
- feed
- Base feed class from which all others descend.
- Gallery
- Gallery Class
- graphicsBase
- Base class that kicks in if neither GD or Imagick are available for image handling Provides basic check method to see what library is available
- graphicsGD
- class for image handling using the GD library
- graphicsImagick
- Class for image handling using the Imagick library
- graphicsOptions
- Option class for graphics handlers
- Image
- Image Class
- imageMetaFormatter
- Class to handle metadata formatting
- maintenanceMode
- Maintenance mode utility class based on the former site_upgrade plugin
- MediaObject
- Root class for images and albums
- mimeTypes
- Library for mimetypes
- PersistentObject
- Persistent Object Class
- SearchEngine
- search class
- ThemeObject
- The basic ThemeObject class. Extends PersistentObject, is extended by various Theme related objects.
- Transientimage
- Transient image class
- userDataExport
- Class for exporting possible privacy related user data
- zpMutex
- Zenphoto Mutex class
- utf8
- UTF-8 friendly replacement functions - v0.2 Copyright (C) 2004-2006 Niels Leenheer & Andy Matsubara
- ZipStream
- setup
- setup support class
- setupMutex
- Zenphoto Mutex class
- admin_approval
- auto_backup
- Option handler class
- bxslider
- Plugin option handling class
- cachemanager_internal_deprecations
- cacheManager
- Standard options interface
- AnyFile_Options
- Option class for textobjects objects
- AnyFile
- Core class for handling "non-image" files
- TextObject
- Core class for handling "non-image" files
- TextObject_Options
- Option class for textobjects objects
- getid3_lib
- getID3
- getid3_handler
- getid3_exception
- getid3_mpeg
- getid3_quicktime
- getid3_aac
- getid3_mp3
- getid3_apetag
- getid3_id3v1
- getid3_id3v2
- getid3_lyrics3
- VideoObject_Options
- Option class for video objects
- Video
- Image Class
- pseudoPlayer
- WEBdocs_Options
- Option class for textobjects objects
- WEBdocs
- Core class for handling "non-image" files
- cloneZenphoto
- colorbox
- Comment
- Comment Class
- comment_form
- fieldExtender
- This is the root class for use by plugins to extend the Zenphoto database table fields. The administrative tabs for the objects will have input items for these new fields. They will be placed in the proximate location of the "custom data" field on the page.
- JSMin
- jsmin.php - PHP implementation of Douglas Crockford's JSMin.
- JSMin_UnterminatedStringException
- JSMin_UnterminatedCommentException
- JSMin_UnterminatedRegExpException
- OAuthExcept
- OAuthConsumer
- OAuthToken
- OAuthSignatureMethod
- A class for implementing a Signature Method See section 9 ("Signing Requests") in the spec
- OAuthSignatureMethod_HMAC_SHA1
- The HMAC-SHA1 signature method uses the HMAC-SHA1 signature algorithm as defined in [RFC2104] where the Signature Base String is the text and the key is the concatenated values (each first encoded per Parameter Encoding) of the Consumer Secret and Token Secret, separated by an '&' character (ASCII code 38) even if empty.
- OAuthSignatureMethod_PLAINTEXT
- The PLAINTEXT method does not provide any security protection and SHOULD only be used over a secure channel such as HTTPS. It does not use the Signature Base String.
- OAuthSignatureMethod_RSA_SHA1
- The RSA-SHA1 signature method uses the RSASSA-PKCS1-v1_5 signature algorithm as defined in [RFC3447] section 8.2 (more simply known as PKCS#1), using SHA-1 as the hash function for EMSA-PKCS1-v1_5. It is assumed that the Consumer has provided its RSA public key in a verified way to the Service Provider, in a manner which is beyond the scope of this specification.
- OAuthRequest
- OAuthServer
- OAuthDataStore
- OAuthUtil
- contactformOptions
- Plugin option handling class
- contactForm
- The plugin class
- cookieConsent
- crop_image
- defaultCodeblocks
- internal_deprecations
- Zenphoto general deprecated functions
- zpFunctions
- deprecated_functions
- DownloadList
- Plugin option handling class
- AlbumZip
- dynamic_locale
- elFinderEditor
- Abstract class of editor plugins.
- elFinderEditorOnlineConvert
- Abstract class of editor plugins.
- elFinderEditorZipArchive
- Abstract class of editor plugins.
- elFinderEditorZohoOffice
- Abstract class of editor plugins.
- elFinderConnector
- Default elFinder connector
- elFinderVolumeFlysystemGoogleDriveCache
- elFinderVolumeFlysystemGoogleDriveNetmount
- elFinderPlugin
- elFinder Plugin Abstract
- elFinderSession
- elFinder - file manager for web.
- elFinderVolumeBox
- Simple elFinder driver for BoxDrive Box.com API v2.0.
- elFinderVolumeDriver
- Base class for elFinder volume.
- elFinderVolumeDropbox
- Simple elFinder driver for FTP
- elFinderVolumeDropbox2
- Simple elFinder driver for Dropbox kunalvarma05/dropbox-php-sdk:0.1.5 or above.
- elFinderVolumeFTP
- Simple elFinder driver for FTP
- elFinderVolumeGoogleDrive
- Simple elFinder driver for GoogleDrive google-api-php-client-2.x or above.
- elFinderVolumeGroup
- elFinder driver for Volume Group.
- RecursiveCallbackFilterIterator
- elFinderVolumeLocalFileSystem
- elFinder driver for local filesystem.
- elFinderVolumeMySQL
- Simple elFinder driver for MySQL.
- elFinderVolumeOneDrive
- Simple elFinder driver for OneDrive onedrive api v5.0.
- elFinderVolumeSFTPphpseclib
- Simple elFinder driver for SFTP using phpseclib 1
- elFinderVolumeTrash
- elFinder driver for trash bin at local filesystem.
- elFinderVolumeTrashMySQL
- elFinder driver for trash bin at MySQL Database
- elFinderLibGdBmp
- elFinderPluginAutoResize
- elFinder Plugin AutoResize Auto resize on file upload.
- elFinderPluginAutoRotate
- elFinder Plugin AutoRotate Auto rotation on file upload of JPEG file by EXIF Orientation.
- elFinderPluginNormalizer
- elFinder Plugin Normalizer UTF-8 Normalizer of file-name and file-path etc.
- elFinderPluginSanitizer
- elFinder Plugin Sanitizer Sanitizer of file-name and file-path etc.
- elFinderPluginWatermark
- elFinder Plugin Watermark Print watermark on file upload.
- elFinderPluginWinRemoveTailDots
- This class describes elFinder plugin window remove tail dots.
- elFinder_options
- Option handler class
- email_new_user
- exampleMacros
- favorites
- This is the class declaration
- favoritesOptions
- featuredImage
- flag_thumbnail
- Plugin option handling class
- Combi
- Zenpage root classes
- galleryArticles
- Standard options interface
- Googlemaps
- CodeIgniter Google Maps API V3 Class
- GoogleMap
- googleMap
- CI_load
- CI_jsmin
- codeIgniter_kludge
- hitcounter
- Plugin option handling class
- htmlmetatags
- securityheadersOptions
- Options handler for http_security_headers plugin
- securityHeaders
- Static class to generate the headers as set on the plugin options
- ipBlocker
- Option handler class
- jplayer_options
- jPlayer
- lazyloadOptions
- Options for the lazyload plugin
- lazyload
- Filter HTML to add JS lazyloading using the script lazysizes
- matomoStats
- menu_manager
- option handler
- MergedRSSOptions
- MergedRSS
- ComposerAutoloaderInitd5350eb3a139c07c29d30a628169cbde
- mobileTheme
- mobile
- Child class of MobileDetect. isMobile() and isTablet()
- multipleLayoutOptions
- Plugin option handling class
- openStreetMapOptions
- openStreetMap
- The class for all OSM map related functionality
- pagedthumbsOptions
- Plugin option handling class
- pagedThumbsNav
- zp_PHPMailer
- Option handler class
- print_album_menu
- Plugin option handling class
- publishContent
- quota_manager
- Option handler class
- jquery_rating
- Option handler class
- reCaptcha
- Standins for when no captcha is enabled
- redirectorOptions
- redirector plugin options
- redirector
- redirection handler class
- registerUserOptions
- Options class
- registerUser
- Plugin class
- register_user
- Plugin class
- rewriteRules
- rewriteTokens
- rss_options
- RSS
- Base feed class from which all others descend.
- scriptlessSocialsharingOptions
- scriptlessSocialsharing
- Static class wrapper
- search_statistics
- Option handler class
- security_logger
- Option handler class
- seo_locale
- null_seo
- Option handler class
- zenphoto_seo
- Option handler class
- show_not_loggedin
- zpSimpleSpam
- This implements the standard SpamFilter class for the Simple spam filter.
- sitemapOptions
- Plugin option handling class
- sitemap
- Sitemap class
- cycle
- Plugin option handling class
- staticHTMLCacheOptions
- static_html_cache
- tagsuggest
- themeSwitcher
- tinymceOptions
- Plugin option handling class
- tinymce4Options
- Plugin option handling class
- tinyURL
- zpTrivialSpam
- This implements the standard SpamFilter class for the none spam filter.
- UploadHandler
- UploadHandlerZP
- jQuery File Upload Plugin PHP Class based on the https://github.com/blueimp/jQuery-File-Upload
- uploaderjQueryOptions
- user_expiry
- Option handler class
- user_groups
- user_logout_options
- Plugin option handling class
- userAddressFields
- This is the root class for use by plugins to extend the Zenphoto database table fields. The administrative tabs for the objects will have input items for these new fields. They will be placed in the proximate location of the "custom data" field on the page.
- Zenpage
- Zenpage root classes
- ZenpageCategory
- zenpage news category class
- ZenpageItems
- Base class from which Zenpage news articles and pages derive
- ZenpageNews
- zenpage news class
- ZenpagePage
- zenpage page class
- ZenpageRoot
- Base class from which all Zenpage classes derive
- Zenpage_internal_deprecations
- These are the Zenpage functions which have been deprecated
- zenpagecms
- zenphoto_org_news
- zenphotoDonate
Constants
- ACK_DISPLAY_ERRORS = 2
- ADMIN_IMAGES_STEP = 5
- ADMIN_PLUGIN = 4096
- Defines the bitmask for load order priority of admin plugins
- ADMIN_RIGHTS = 1
- ALBUM_FOLDER_EMPTY = \getAlbumFolder('')
- ALBUM_FOLDER_SERVERPATH = \getAlbumFolder(\SERVERPATH)
- ALBUM_FOLDER_WEBPATH = \getAlbumFolder(\WEBPATH)
- ALBUM_MENU_COUNT = \getOption('print_album_menu_count')
- ALBUM_MENU_SHOWSUBS = \getOption('print_album_menu_showsubs')
- ALBUMFOLDER = 'albums'
- Defines the name of the albums folder
- ALL_ALBUMS_RIGHTS = \VIEW_ALL_RIGHTS
- ALL_NEWS_RIGHTS = \VIEW_ALL_RIGHTS
- ALL_PAGES_RIGHTS = \VIEW_ALL_RIGHTS
- BACKUPFOLDER = 'backup'
- Defines the name of the backup folder
- BASEPATH = true
- CACHE_HASH_LENGTH = \strlen(\sha1(\strval(\HASH_SEED)))
- CACHEFOLDER = 'cache'
- Defines the name of the image cache folder
- CASE_INSENSITIVE = \file_exists(\dirname(__FILE__) . '/VERSION.PHP')
- Defines if the server file system is case insensitive
- CHMOD_VALUE = \fileperms(\dirname(__FILE__)) & 0666
- CLASS_PLUGIN = 8192
- Defines the bitmask for load order priority of class plugins
- COMMENT_BODY_REQUIRED = 16
- COMMENT_DATACONFIRMATION = 64
- COMMENT_EMAIL_REQUIRED = 1
- COMMENT_MATHQUIZ = 256
- COMMENT_NAME_REQUIRED = 2
- COMMENT_SEND_EMAIL = 32
- COMMENT_TEXTQUIZ = 128
- COMMENT_WEB_REQUIRED = 4
- COMMENTS_PER_PAGE = \max(1, \getOption('comment_form_comments_per_page'))
- COMMON_FOLDER = \PLUGIN_FOLDER . '/common'
- Defines the name of the shared "common" folder within/for core extensions
- CONFIGFILE = 'zenphoto.cfg.php'
- Defines the name of the config file
- COOKIE_PATH = \WEBPATH
- COOKIE_PERSISTENCE = $persistence
- CUSTOM_OPTION_PREFIX = '_ZP_CUSTOM_'
- DATA_FOLDER = 'zp-data'
- Defines the name of the zp-data folder outside the core folder
- DATA_MOD = \fileperms(\SERVERPATH . '/' . \DATA_FOLDER . '/' . \CONFIGFILE) & 0777
- DATABASE_DESIRED_VERSION = '5.7.0'
- DATABASE_DESIRED_VERSION = '0.0.0'
- DATABASE_MARIADB_DESIRED_VERSION = '10.1.0'
- DATABASE_MARIADB_DESIRED_VERSION = '0.0.0'
- DATABASE_MARIADB_MIN_VERSION = '5.5.0'
- DATABASE_MARIADB_MIN_VERSION = '0.0.0'
- DATABASE_MIN_VERSION = '5.5.3'
- DATABASE_MIN_VERSION = '0.0.0'
- DATABASE_PREFIX = $mysql_prefix
- DATABASE_SOFTWARE = $_zp_conf_vars['db_software']
- DATABASE_SOFTWARE = 'Database setup'
- DATE_FORMAT = \trim(\strval(\getOption('date_format')))
- DATETIME_DISPLAYFORMAT = \DATETIME_FORMAT
- DATETIME_FORMAT = \DATE_FORMAT . ' ' . \TIME_FORMAT
- DEBUG_404 = isset($_zp_conf_vars['debug_404']) && $_zp_conf_vars['debug_404'] || \TEST_RELEASE
- set to true to log 404 error processing debug information.
- DEBUG_ERROR = isset($_zp_conf_vars['debug_error']) && $_zp_conf_vars['debug_error'] || \TEST_RELEASE
- set to true to supplies the calling sequence with zp_error messages
- DEBUG_EXIF = isset($_zp_conf_vars['debug_exif']) && $_zp_conf_vars['debug_exif']
- set to true to log start/finish of exif processing. Useful to find problematic images.
- DEBUG_FILTERS = isset($_zp_conf_vars['debug_filters']) && $_zp_conf_vars['debug_filters']
- set to true to log filter application sequence.
- DEBUG_IMAGE = isset($_zp_conf_vars['debug_image']) && $_zp_conf_vars['debug_image']
- set to true to log image processing debug information.
- DEBUG_IMAGE_ERR = isset($_zp_conf_vars['debug_image_err']) && $_zp_conf_vars['debug_image_err'] || \TEST_RELEASE
- set to true to flag image processing errors.
- DEBUG_LOCALE = isset($_zp_conf_vars['debug_locale']) && $_zp_conf_vars['debug_locale']
- used for examining language selection problems
- DEBUG_LOG_SIZE = \getOption('debug_log_size')
- DEBUG_LOGIN = isset($_zp_conf_vars['debug_login']) && $_zp_conf_vars['debug_login']
- set to true to log admin saves and login attempts
- DEBUG_PLUGINS = isset($_zp_conf_vars['debug_plugins']) && $_zp_conf_vars['debug_plugins']
- set to true to log plugin load sequence.
- EDITOR_SANITIZE_LEVEL = 1
- EDITOR_SANITIZE_LEVEL = 4
- EDITOR_SANITIZE_LEVEL = 4
- ELFINDER_PHP_ROOT_PATH = \dirname(__FILE__)
- ENT_SUBSTITUTE = \defined('ENT_IGNORE') ? \ENT_IGNORE : 8
- EXACT_TAG_MATCH = \getOption('exact_tag_match')
- EXPLAIN_SELECTS = isset($_zp_conf_vars['explain_selects']) && $_zp_conf_vars['explain_selects']
- set to true to log the "EXPLAIN" of SELECT queries in the debug log
- FEATURE_PLUGIN = 2048
- Defines the bitmask for load order priority of feature plugins
- FILE_MOD = \CHMOD_VALUE & 0666
- FILESYSTEM_CHARSET = $data
- FILESYSTEM_CHARSET = 'UTF-8'
- FOLDER_MOD = \CHMOD_VALUE | 0311
- FULLIMAGE_WATERMARK = \getOption('fullsizeimage_watermark')
- FULLWEBPATH = \SERVER_HTTP_HOST . \WEBPATH
- GALLERY_SECURITY = @$data['gallery_security']
- GALLERY_SESSION = @$data['album_session']
- GD_FREETYPE = (bool) $this->info['FreeType']
- GD_FREETYPE_SAMPLE = 'The quick brown fox jumps over the lazy dog'
- GD_FREETYPE_SAMPLE_CHARS = strlen('GD_FREETYPE_SAMPLE')
- GETID3_HELPERAPPSDIR = $helperappsdir . DIRECTORY_SEPARATOR
- GETID3_INCLUDEPATH = \dirname(__FILE__) . \DIRECTORY_SEPARATOR
- GETID3_INCLUDEPATH = \SERVERPATH . '/' . \ZENFOLDER . '/' . \PLUGIN_FOLDER . '/class-video/getid3/'
- GETID3_LIBXML_OPTIONS = \LIBXML_NOENT | \LIBXML_NONET | \LIBXML_NOWARNING
- GETID3_OS_ISWINDOWS = \stripos(\PHP_OS, 'WIN') === 0
- GETID3_TEMP_DIR = $temp_dir
- GOOGLE_SITEMAP = \getOption('sitemap_google')
- GRAPHICS_LIBRARY = $_zp_cachefile_suffix['Library']
- HASH_SEED = \getOption('extra_auth_hash_text')
- HTACCESS_VERSION = '1.4.12'
- IM_SUFFIX = \getOption('mod_rewrite_image_suffix')
- IMAGE_CACHE_SUFFIX = \getOption('image_cache_suffix')
- IMAGE_SORT_DIRECTION = \getOption('image_sortdirection')
- IMAGE_SORT_TYPE = \getOption('image_sorttype')
- IMAGE_WATERMARK = \getOption('fullimage_watermark')
- IMAGEMAGICK_REQUIRED_VERSION = '6.3.8'
- IMAGICK_REQUIRED_VERSION = '3.0.0'
- IP_TIED_COOKIES = \getOption('IP_tied_cookies')
- LIST_RIGHTS = \NO_RIGHTS
- LOCAL_CHARSET = $data
- LOCAL_CHARSET = 'UTF-8'
- LOCALE_TYPE = 0
- LOGS_MOD = \DATA_MOD
- MANAGED_OBJECT_RIGHTS_EDIT = 1
- MANAGED_OBJECT_RIGHTS_UPLOAD = 2
- MANAGED_OBJECT_RIGHTS_VIEW = 4
- MAX_SIZE = \getOption('image_max_size')
- MEMBERS_ONLY_COMMENTS = \getOption('comment_form_members_only')
- MENU_TRUNCATE_INDICATOR = \getOption('menu_truncate_indicator')
- MENU_TRUNCATE_STRING = \getOption('menu_truncate_string')
- METATAG_LOCALE_TYPE = 0
- MOD_REWRITE = \getOption('mod_rewrite')
- MUTEX_FOLDER = '.mutex'
- Defines the mutex folder
- NEWS_POSITION_NORMAL = 0
- NEWS_POSITION_STICK_TO_TOP = 9
- NEWS_POSITION_STICKY = 1
- NO_WATERMARK = '!'
- OBJECT_CACHE_DEPTH = 150
- OFFSET_PATH = 1
- used in sorting the images within and album
- OFFSET_PATH = 1
- This script is used to create dynamic albums from a search.
- OFFSET_PATH = 1
- admin-edit.php editing of albums.
- OFFSET_PATH = 1
- user_groups log--tabs
- OFFSET_PATH = 1
- provides the Options tab of admin
- OFFSET_PATH = 1
- provides the Plugins tab of admin
- OFFSET_PATH = 2
- 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.
- OFFSET_PATH = 1
- provides the TAGS tab of admin
- OFFSET_PATH = 1
- Theme file editor
- OFFSET_PATH = 1
- provides the Themes tab of admin
- OFFSET_PATH = 1
- OFFSET_PATH = 1
- provides the Upload tab of admin
- OFFSET_PATH = 1
- provides the Options tab of admin
- OFFSET_PATH = 1
- admin.php is the main script for administrative functions.
- OFFSET_PATH = 1
- OFFSET_PATH = 1
- OFFSET_PATH = 0
- OFFSET_PATH = 2
- OFFSET_PATH = 1
- OFFSET_PATH = 2
- OFFSET_PATH = 2
- OFFSET_PATH = 2
- Used for changing permissions on a mass basis
- OFFSET_PATH = 2
- Used for setting theme/plugin default options
- OFFSET_PATH = 2
- Used for setting theme/plugin default options
- OFFSET_PATH = 3
- OFFSET_PATH = 3
- Database quick reference
- OFFSET_PATH = 3
- Detailed Gallery Statistics
- OFFSET_PATH = 3
- Displays which HTTP headers your site sends
- OFFSET_PATH = 3
- Displays locale information of the system
- OFFSET_PATH = 3
- Maintenance mode utility based on the former site_upgrade plugin
- OFFSET_PATH = 3
- Displays the PHP configuration information
- OFFSET_PATH = 3
- Use this utility to reset your album thumbnails to either "random" or from an ordered field query
- OFFSET_PATH = 3
- GDPR data export tool
- 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.
- 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.
- OFFSET_PATH = 4
- Zenphoto site cloner
- OFFSET_PATH = 4
- OFFSET_PATH = 1
- provides the Comments tab of admin
- OFFSET_PATH = 3
- OFFSET_PATH = 4
- Check for use of deprecated functions
- OFFSET_PATH = 3
- Detailed Gallery Statistics
- OFFSET_PATH = 3
- OFFSET_PATH = 3
- OFFSET_PATH = 3
- The Matomo statistis page if widgets are defined
- OFFSET_PATH = 4
- OFFSET_PATH = 4
- OFFSET_PATH = 3
- OFFSET_PATH = 4
- OFFSET_PATH = 3
- OFFSET_PATH = 3
- This is the "rewrite rules" tab
- OFFSET_PATH = 4
- Collects and analyzes searches
- OFFSET_PATH = 3
- OFFSET_PATH = 3
- Sitemap Tools
- OFFSET_PATH = 3
- OFFSET_PATH = 3
- OFFSET_PATH = 3
- OFFSET_PATH = 3
- OFFSET_PATH = 3
- OFFSET_PATH = 3
- OFFSET_PATH = 4
- user_groups plugin--tabs
- OFFSET_PATH = 4
- user_groups plugin--tabs
- OFFSET_PATH = 3
- OFFSET_PATH = 4
- zenpage admin-categories.php
- OFFSET_PATH = 4
- zenpage admin-edit.php
- OFFSET_PATH = 4
- zenpage admin-news-articles.php
- OFFSET_PATH = 4
- zenpage admin-pages.php
- OPEN_IMAGE_CACHE = !\getOption('protected_image_cache')
- OPTION_TYPE_CHECKBOX = 1
- OPTION_TYPE_CHECKBOX_ARRAY = 6
- OPTION_TYPE_CHECKBOX_UL = 7
- OPTION_TYPE_CLEARTEXT = 9
- OPTION_TYPE_COLOR_PICKER = 8
- OPTION_TYPE_CUSTOM = 2
- OPTION_TYPE_NOTE = 10
- OPTION_TYPE_PASSWORD = 11
- OPTION_TYPE_RADIO = 4
- OPTION_TYPE_RICHTEXT = 12
- OPTION_TYPE_SELECTOR = 5
- OPTION_TYPE_TEXTAREA = 3
- OPTION_TYPE_TEXTBOX = 0
- 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.
- PHP_INT_MAX = 2147483647
- PHP_INT_MIN = ~PHP_INT_MAX
- PLUGIN_FOLDER = 'zp-extensions'
- Defines the name of the core extensions folder
- PLUGIN_PRIORITY = 1023
- Defines the bitmask for load order priority of standard plugins
- PLUGINS_PER_PAGE = \max(1, \getOption('plugins_per_page'))
- PLUGINS_PER_PAGE = \max(1, \getOption('plugins_per_page'))
- PRIMARY_INSTALLATION = true
- PROTOCOL = 'http'
- PROTOCOL = 'http'
- RECORD_LIMIT = 5
- SAFE_MODE = \false
- SAFE_MODE_ALBUM_SEP = ''
- SEARCH_CACHE_DURATION = \getOption('search_cache_duration')
- SEARCH_DURATION = 3000
- SEO_FULLWEBPATH = \FULLWEBPATH
- SEO_FULLWEBPATH = \seo_locale::localePath(\true)
- SEO_WEBPATH = \WEBPATH
- SEO_WEBPATH = \seo_locale::localePath()
- SERVER_HTTP_HOST = \PROTOCOL . "://" . $_SERVER['HTTP_HOST']
- SERVER_PROTOCOL = 'http'
- SERVERCACHE = \SERVERPATH . '/' . \CACHEFOLDER
- SERVERPATH = $const_serverpath
- SERVERPATH = $_zp_setup_serverpath
- SERVERPATH = $_zp_setup_serverpath
- SETUPLOG = $_zp_setup_serverpath . '/' . \DATA_FOLDER . '/setup.log'
- SITE_LOCALE = 'en_US'
- SITEMAP_CHUNK = \getOption('sitemap_processing_chunk')
- SITEMAP_LOCALE_TYPE = 0
- SORT_FLAG_CASE = 0
- Defines sort flag case
- SORT_NATURAL = 0
- Defines if sorting should be natural order
- STATIC_CACHE_FOLDER = "cache_html"
- Defines the name of the html cache folder
- SYMLINK = \function_exists('symlink') && \strpos(@\ini_get("suhosin.executor.func.blacklist"), 'symlink') === \false
- Defines if symlinks are supported on the server
- TEST_RELEASE = isset($_zp_conf_vars['test_release']) && $_zp_conf_vars['test_release'] || \preg_match('~-[^RC]~', \ZENPHOTO_VERSION)
- Enables test release mode, supports the markRelease plugin
- TEXT_INPUT_SIZE = 48
- TEXT_INPUT_SIZE_SHORT = 30
- TEXTAREA_COLUMNS = 50
- TEXTAREA_COLUMNS_SHORT = 32
- THEME_PLUGIN = 1024
- Defines the bitmask for load order priority of theme plugins
- THEMEFOLDER = 'themes'
- Defines the name of the themes folder
- THUMB_WATERMARK = \getOption('Image_watermark')
- TIME_FORMAT = \trim(\strval(\getOption('time_format')))
- UPLOAD_ERR_BLOCKED = -2
- UPLOAD_ERR_QUOTA = -1
- Initialize globals for Admin
- UPLOAD_FOLDER = 'uploaded'
- Defines name of the non albums upload folder
- USE_CAPTCHA = 8
- USER_PLUGIN_FOLDER = 'plugins'
- Defines the user 3rd party plugin folder outside the Zenphoto core folder
- USER_RIGHTS = \NO_RIGHTS
- USERS_PER_PAGE = \max(1, \getOption('users_per_page'))
- USERS_PER_PAGE = \max(1, \getOption('users_per_page'))
- UTF8_IMAGE_URI = \getOption('UTF8_image_URI')
- UTILITIES_FOLDER = 'utilities'
- Defines the name of the core utlitlites folder
- VIEW_ALL_RIGHTS = \ALL_ALBUMS_RIGHTS | \ALL_PAGES_RIGHTS | \ALL_NEWS_RIGHTS
- VIEW_FULLIMAGE_RIGHTS = \NO_RIGHTS
- VIEW_GALLERY_RIGHTS = \NO_RIGHTS
- VIEW_SEARCH_RIGHTS = \NO_RIGHTS
- WATERMARK_FULL = 4
- WATERMARK_IMAGE = 1
- WATERMARK_THUMB = 2
- WEBPATH = $const_webpath
- WEBPATH = $const_webpath
- ZENFOLDER = 'zp-core'
- Defines the name of the Zenphoto core folder (zp-core)
- ZENPAGE_COMBINEWS = \false
- Some global variable setup
- ZENPHOTO_LOCALE = \setMainDomain()
- ZENPHOTO_VERSION = '1.6.5'
- Defines the Zenphoto version
- ZP_ALBUM = 2
- ZP_ALBUM_LINKED = 64
- ZP_ARTICLES_PER_PAGE = \getOption("zenpage_articles_per_page") >= 1 ? \getOption("zenpage_articles_per_page") : 1
- ZP_COMBINEWS = \false
- ZP_COMMENT = 8
- ZP_IMAGE = 4
- ZP_IMAGE_LINKED = 128
- ZP_INDEX = 1
- ZP_LAST_MODIFIED = \gmdate('D, d M Y H:i:s') . ' GMT'
- Defines the date of the current session for use as a last modified date within the page header()
- ZP_NEWS_ENABLED = \false
- ZP_PAGES_ENABLED = \false
- ZP_READ_MORE = \getOption("zenpage_read_more")
- ZP_SEARCH = 16
- ZP_SEARCH_LINKED = 32
- ZP_SHORTEN_LENGTH = \getOption('zenpage_text_length')
- ZP_SHORTENINDICATOR = $shortenindicator = \getOption('zenpage_textshorten_indicator')
- ZP_ZENPAGE_NEWS_ARTICLE = 512
- ZP_ZENPAGE_NEWS_CATEGORY = 1024
- ZP_ZENPAGE_NEWS_DATE = 2048
- ZP_ZENPAGE_NEWS_PAGE = 256
- ZP_ZENPAGE_PAGE = 4096
- ZP_ZENPAGE_SINGLE = 8192
Functions
- printAdminFooter() : mixed
- Print the footer <div> for the bottom of all admin pages.
- datepickerJS() : mixed
- printAdminHeader() : 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.
- printSortableHead() : mixed
- printLogoAndLinks() : mixed
- Print the html required to display the ZP logo and links in the top section of the admin page.
- printTabs() : 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".
- getSubtabs() : mixed
- printSubtabs() : mixed
- setAlbumSubtabs() : mixed
- handleDeprecatedMenuGlobals() : mixed
- Roughly fixes outdated usages of old admin "tab" globals and joins them with the actual globals.
- checked() : mixed
- Used for checkbox and radiobox form elements to compare the $checked value with the $current.
- customOptions() : mixed
- processCustomOptionSave() : mixed
- standardThemeOptions() : mixed
- Set defaults for standard theme options incase the theme has not done so
- postIndexEncode() : mixed
- Encodes for use as a $_POST index
- postIndexDecode() : string
- Decodes encoded $_POST index
- generateRadiobuttonsFromArray() : mixed
- Prints radio buttons from an array
- generateUnorderedListFromArray() : mixed
- Creates the body of an unordered list with checkbox label/input fields (scrollable sortables)
- tagSelector() : mixed
- Creates an unordered checklist of the tags
- printAlbumEditForm() : mixed
- emits the html for editing album information called in edit album and mass edit
- printAlbumButtons() : mixed
- puts out the maintenance buttons for an album
- printAlbumLegend() : mixed
- printAlbumEditRow() : mixed
- puts out a row in the edit album table
- processAlbumEdit() : string
- processes the post from the above
- processImageEdit() : mixed
- Process the image edit form posted
- adminPageNav() : mixed
- print_language_string_list() : mixed
- Generates an editable list of language strings
- process_language_string_save() : string
- process the post of a language string form
- getTagOrder() : int
- Returns the desired tagsort order (0 for alphabetic, 1 for most used)
- unzip() : mixed
- Unzips an image archive
- is_zip() : bool
- Checks for a zip file
- isolate() : string
- Extracts and returns a 'statement' from a PHP script so that it may be 'evaled'
- listDirectoryFiles() : array<string|int, mixed>
- Return an array of files from a directory and sub directories
- themeIsEditable() : bool
- Check if a theme is editable (ie not a bundled theme)
- zenPhotoTheme() : mixed
- copyThemeDirectory() : bool|string
- Copy a theme directory to create a new custom theme
- deleteThemeDirectory() : bool
- Deletes a theme
- currentRelativeURL() : string
- Return URL of current admin page
- getParentAlbumsAdmin() : array<string|int, mixed>
- Returns an array of the names of the parents of the current album.
- getAlbumBreadcrumbAdmin() : mixed
- removeParentAlbumNames() : string
- Removes the parent album name so that we can print a album breadcrumb with them
- printAdminRightsTable() : mixed
- Outputs the rights checkbox table for admin
- printManagedObjects() : mixed
- Creates the managed album table for Admin
- processRights() : bit
- processes the post of administrator rights
- processManagedObjects() : mixed
- getCheckboxState() : int
- Returns the value of a checkbox form item
- standardScripts() : array<string|int, mixed>
- Returns an array of "standard" theme scripts. This list is normally used to exclude these scripts form various option seletors.
- getWatermarks() : array<string|int, mixed>
- Returns a merged list of available watermarks
- processOrder() : array<string|int, mixed>
- Processes the serialized array from tree sort.
- postAlbumSort() : mixed
- POST handler for album tree sorts
- printNestedAlbumsList() : bool
- Prints the sortable nested albums list returns true if nesting levels exceede the database container
- printEditDropdown() : mixed
- Prints the dropdown menu for the nesting level depth for the album sorting
- processEditSelection() : mixed
- printBulkActions() : mixed
- Edit tab bulk actions drop-down
- bulkActionRedirect() : mixed
- common redirector for bulk action handling return
- bulkTags() : array<string|int, mixed>
- Process the bulk tags
- processAlbumBulkActions() : mixed
- Processes the check box bulk actions for albums
- processImageBulkActions() : mixed
- Handles Image bulk actions
- processCommentBulkActions() : mixed
- Processes the check box bulk actions for comments
- codeblocktabsJS() : mixed
- Codeblock tabs JavaScript code
- printCodeblockEdit() : mixed
- prints codeblock edit boxes
- processCodeblockSave() : string
- handles saveing of codeblock edits
- admin_securityChecks() : mixed
- Standard admin pages checks
- minDiff() : mixed
- getPageSelector "diff" function
- fullText() : string
- getPageSelector "diff" function
- dateDiff() : string
- getPageSelector "diff" function
- getPageSelector() : array<string|int, mixed>
- returns a selector list based on the "names" of the list items
- printPageSelector() : mixed
- unQuote() : mixed
- Strips off quotes from the strng
- admin_album_list() : string
- Returns an option list of administrators who can own albums or images
- getLogTabs() : array<string|int, mixed>
- 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)
- getDefaultLogTabs() : array<string|int, mixed>
- Gets an array log tab names and localized (gettexted) log titles
- getLogFiles() : array<string|int, mixed>
- Gets a nested array with the log type (tab name) and corresponding log files
- printLogSelector() : mixed
- Prints the selector for logfiles of the current log tab
- getPluginTabs() : mixed
- Figures out which plugin tabs to display
- getAdminThumbSizes() : array<string|int, mixed>
- Gets an array with the size values for the admin thumb generation
- getAdminThumb() : string
- Gets the URL of the adminthumb
- getSizeAdminThumb() : array<string|int, mixed>
- Returns an array with width and height of the resized image
- getAdminThumbHTML() : string
- Returns the full HTML element of an admin thumb Applies the filters 'adminthumb_html'
- printAdminThumb() : string
- Prints an admin thumb
- processCredentials() : mixed
- handles save of user/password
- consolidatedEditMessages() : mixed
- getThemeFiles() : array<string|int, mixed>
- returns an array of the theme scripts not in the exclude array
- checkAlbumParentid() : mixed
- Checks for bad parentIDs from old move/copy bug
- clonedFrom() : mixed
- checkAlbumimagesort() : string
- Make sure the albumimagesort is only an allowed value. Otherwise returns nothing.
- printLastChangeInfo() : mixed
- Prints the last change date and last change user notice on backend edit pages Also for albums it prints the updateddate
- getSortByOptions() : array<string|int, mixed>
- Returns the option array for the sort by selectors for gallery, albums and images
- getSortByStatusOptions() : array<string|int, mixed>
- Returns an array of the status order options for all items
- checkSchedulePublishingNotes() : bool
- Helper to check if notes are to be printed (only needed because of the inconvenient legacy table based layout on image edit pages)
- printScheduledPublishingNotes() : mixed
- Prints various notes regarding the scheduled publishing status for single edit pages
- printStatusNotes() : mixed
- Prints various notes regarding the scheduled publishing status for single edit pages
- getStatusNote() : string
- Gets a specific predefined status note for an object (if available) Note: The notes are not status dependend!
- getStatusNotes() : array<string|int, mixed>
- Gets an array of all predefined status notes
- getStatusNotesByContext() : array<string|int, mixed>
- Gets an array with all status notes that apply to $obj currently
- getStatusIcons() : array<string|int, mixed>
- Gets an key => value array of all available object status icons as full <img> elements
- getStatusIcon() : string
- Gets the icon img element for a specific status icon
- printPublishIconLinkGallery() : mixed
- Prints the publish icon link to change the status on the album and thumb image list
- getPublishIcon() : string
- Returns the publish icon for the current status
- printPublished() : string
- Prints the scheduled publishing date for items if set. Also prints the date for Zenpage news articles and pages
- printExpired() : string
- Prints the expiration or expired date for items
- printProtectedIcon() : mixed
- Prints the protected icon if the object is password protected on an edit list
- isIncompatibleExtension() : bool|string
- 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.
- processExtensionVariable() : string|bool
- Processes a plugin or theme definition variable.
- printSelectorWithCustomField() : mixed
- Prints a selector (select list) with a custom text field from the values parameter. The following array entries will be created automatically:
- getZenpagePagesOptionsArray() : mixed
- Gets an array of Zenpage pages ready for using with selector, radioboxes and checkbox lists
- printZenpagePageSelector() : mixed
- Prints an select list option for Zenpage pages
- getAdminstratorsOptionsArray() : type
- Gets an array of administrators ready for using with selector, radioboxes and checkbox lists
- printUserSelector() : mixed
- Prints an select list option for users
- isTextFile() : type
- Helper for the theme editor
- getSubalbumImages() : type
- Updates the $_zp_admin_imagelist global used on dynamic album editing
- markUpdated() : mixed
- Updates $_zp_admin_user_updated on user editing
- printImageRotationSelector() : mixed
- Prints the image EXIF rotation/flipping selector
- printDatetimeFormatSelector() : mixed
- Prints option selectors for date and time formats
- getDatetimeFormatlistForSelector() : array<string|int, mixed>
- Helper functions for printDatetimeFormatSelector() ot create the format lists for the selector, not intended to be used standalone
- db_connect() : true
- Connect to the database server and select the database.
- query() : results
- The main query function. Runs the SQL on the connection and handles errors.
- query_single_row() : results
- Runs a SQL query and returns an associative array of the first row.
- query_full_array() : results
- Runs a SQL query and returns an array of associative arrays of every row returned.
- db_quote() : string
- mysqli_real_escape_string standin that insures the DB connection is passed.
- db_insert_id() : mixed
- returns the insert id of the last database insert
- db_fetch_assoc() : mixed
- Fetch a result row as an associative array
- db_error() : mixed
- Returns the text of the error message from previous operation
- db_affected_rows() : mixed
- Get number of affected rows in previous operation
- db_fetch_row() : mixed
- Get a result row as an enumerated array
- db_num_rows() : mixed
- Get number of rows in result
- db_close() : mixed
- Closes the database
- db_software() : mixed
- report the software of the database
- db_create() : mixed
- create the database
- db_permissions() : mixed
- Returns user's permissions on the database
- db_setSQLmode() : mixed
- Sets the SQL session mode to empty
- db_getSQLmode() : mixed
- Queries the SQL session mode
- db_collation() : mixed
- db_create_table() : mixed
- db_table_update() : mixed
- db_show() : mixed
- db_list_fields() : mixed
- db_truncate_table() : mixed
- db_LIKE_escape() : mixed
- db_free_result() : mixed
- prefix() : prefixed
- Prefix a table name with a user-defined string to avoid conflicts.
- getWhereClause() : contructed
- 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.
- getSetClause() : contructed
- 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.
- db_name() : mixed
- returns the connected database name
- db_count() : int
- Counts entries in a db table
- db_getServerInfo() : string
- Returns the server info
- db_getClientInfo() : string
- Returns the client info
- db_getVersion() : int
- Gets the plain version number
- zp_imageGet() : mixed
- zp_imageOutput() : mixed
- zp_createImage() : mixed
- zp_imageFill() : mixed
- zp_imageColorTransparent() : mixed
- zp_copyCanvas() : mixed
- zp_resampleImage() : mixed
- zp_imageUnsharpMask() : mixed
- zp_imageResizeAlpha() : mixed
- zp_imageCanRotate() : mixed
- zp_rotateImage() : mixed
- zp_imageDims() : mixed
- zp_imageIPTC() : mixed
- zp_imageWidth() : mixed
- zp_imageHeight() : mixed
- zp_imageMerge() : mixed
- zp_imageGray() : mixed
- zp_imageKill() : mixed
- zp_colorAllocate() : mixed
- zp_writeString() : mixed
- zp_drawRectangle() : mixed
- zp_graphicsLibInfo() : mixed
- zp_getFonts() : mixed
- zp_imageLoadFont() : mixed
- zp_imageFontWidth() : mixed
- zp_imageFontHeight() : mixed
- imageBlurGD() : mixed
- zp_imageFromString() : mixed
- js_encode() : string
- encodes a pre-sanitized string to be used as a Javascript parameter
- getOption() : mixed
- Get a option stored in the database.
- setOption() : mixed
- Stores an option value.
- setOptionDefault() : mixed
- Sets the default value of an option.
- loadLocalOptions() : mixed
- Loads option table with album/theme options
- renameOption() : 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.
- purgeOption() : mixed
- Deletes an option from the database
- getOptionList() : array<string|int, mixed>
- Retuns the option array
- hasDynamicAlbumSuffix() : bool
- Returns true if the file has the dynamic album suffix
- isHandledAlbum() : string
- checks if there is a file with the prefix and one of the handled suffixes. Returns the found suffix
- rewrite_get_album_image() : mixed
- Handles the special cases of album/image[rewrite_suffix]
- getImageCacheFilename() : string
- Returns the path of an image for uses in caching it NOTE: character set if for the filesystem
- makeSpecialImageName() : array<string|int, mixed>
- Returns an i.php "image name" for an image not within the albums structure
- getWatermarkParam() : int
- Returns the watermark image to pass to i.php
- getImageCachePostfix() : string
- Returns the crop/sizing string to postfix to a cache image
- getImageParameters() : array<string|int, mixed>
- Validates and edits image size/cropping parameters
- getImageProcessorURI() : string
- forms the i.php parameter list for an image.
- getImageArgs() : array<string|int, mixed>
- Extract the image parameters from the input variables
- getImageProcessorURIFromCacheName() : array<string|int, mixed>
- Extracts the image processor URI from an existing cache filename
- getImageURI() : string
- Returns an URI to the image:
- extractImageExifOrientation() : int
- 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
- getImageFlipRotate() : bool|array<string|int, mixed>
- Returns an array with two indexes "rotate" (= degree to rotate) and "flip" ("horizontal" or "vertical") or false if nothing applies
- getAllowedTags() : mixed
- Returns an array of html tags allowed
- rewrite_path() : string
- Returns either the rewrite path or the plain, non-mod_rewrite path based on the mod_rewrite option.
- parse_query() : mixed
- parses a query string WITHOUT url decoding it!
- build_query() : string
- createsa query string from the array passed
- build_url() : string
- Builds a url from parts
- pathurlencode() : string
- rawurlencode function that is path-safe (does not encode /)
- getAlbumFolder() : string
- Returns the fully qualified path to the album folders
- getBackupFolder() : string
- Returns the fully qualified path to the backup folder
- getRootFolder() : string
- Returns the fully qualified path to the root albums or backup folder
- switchLog() : mixed
- Rolls a log over if it has grown too large.
- debugLog() : 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.
- instrument() : mixed
- Tool to log execution times of script bits
- parse_size() : mixed
- Parses a byte size from a size value (eg: 100M) for comparison.
- getAlbumArray() : mixed
- getAlbumArray - returns an array of folder names corresponding to the given album string.
- imgSrcURI() : string
- Returns an img src URI encoded based on the OS of the server
- getSuffix() : string
- Returns the suffix of a file name
- stripSuffix() : string
- returns a file name sans the suffix
- getAlbumInherited() : string
- returns the non-empty value of $field from the album or one of its parents
- themeSetup() : string
- primitive theme setup for image handling scripts
- accessAllAlbums() : mixed
- Checks access for the album root
- getWatermarkPath() : string
- Returns the path to a watermark
- secureServer() : bool
- Checks to see if access was through a secure protocol
- getRequestURI() : string
- Returns the script requesting URI.
- safe_glob() : mixed
- Provide an alternative to glob which does not return filenames with accented charactes in them
- checkInstall() : mixed
- Check to see if the setup script needs to be run
- exitZP() : mixed
- Call when terminating a script.
- installSignature() : array<string|int, mixed>
- Computes the "installation signature" of the Zenphoto install
- zp_session_start() : mixed
- Starts a zenphoto session (perhaps a secure one)
- zp_session_destroy() : mixed
- Ends a zenphoto session if there is one and clear the session cookie
- getDefaultRewriteTokens() : array<string|int, mixed>
- Reads the core default rewrite token define array from the config template file `zenphoto_cfg.txt`.
- addMissingDefaultRewriteTokens() : mixed
- Adds missing individual default rewrite tokens to $_zp_conf_vars['special_pages']
- curlRequest() : bool
- Sends a simple cURL request to the $uri specified.
- generateImageCacheFile() : mixed
- Sends a cURL request to i.php to generate the image requested without printing it.
- httpsRedirect() : mixed
- Checks if protocol not https and redirects if https required
- redirectURL() : mixed
- General url redirection handler using header()
- sanitizeRedirect() : string
- Sanitizes a "redirect" post to always be within the site
- callUserFunction() : mixed
- Wrapper to call a plugin or otherwise possibly undefined function or method to avoid themes breaking if the plugin is not active
- deprecationNotice() : mixed
- Logs a deprecated notice including traces in the debuglog
- convertStrftimeFormat() : string
- Basic conversion for a (deprecated) strftime() date format string
- hasPrimaryScripts() : mixed
- Returns true if the install is not a "clone"
- zpErrorHandler() : void|bool
- Traps errors and insures thy are logged.
- filesystemToInternal() : string
- Converts a file system filename to UTF-8 for zenphoto internal storage
- internalToFilesystem() : string
- Converts a Zenphoto Internal filename string to one compatible with the file system
- sanitize_path() : string
- 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_numeric() : int
- Checks if the input is numeric, rounds if so, otherwise returns false.
- sanitize_script() : string
- removes script tags
- sanitize() : 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.
- ksesProcess() : string
- Internal "helper" function to apply the tag removal
- getBare() : type
- Cleans tags and some content.
- sanitize_string() : string
- returns a sanitized string for the sanitize function
- zp_error() : mixed
- triggers an error
- html_decode() : mixed
- html_encode() : string
- encodes a pre-sanitized string to be used in an HTML text-only field (value, alt, title, etc.)
- html_encodeTagged() : string
- HTML encodes the non-metatag part of the string.
- html_pathurlencode() : string
- Convenience wrapper of html_encode(pathurlencode($url)) Primarily intended for use with img src URLs
- mkdir_recursive() : bool
- Makes directory recursively, returns TRUE if exists or was created sucessfuly.
- debugLogBacktrace() : mixed
- Logs the calling stack
- debugLogVar() : mixed
- Records a Var to the debug log
- zp_getCookie() : mixed
- Returns the value of a cookie from either the cookies or from $_SESSION[]
- zp_cookieEncode() : mixed
- Encodes a cookie value tying it to the user IP
- zp_setCookie() : mixed
- Sets a cookie both in the browser cookies and in $_SESSION[]
- zp_clearCookie() : mixed
- Clears a cookie
- getSerializedArray() : array<string|int, mixed>
- if $string is an serialzied array it is unserialized otherwise an appropriate array is returned
- updateConfigItem() : mixed
- Updates an item in the configuration file
- storeConfig() : mixed
- backs-up and updates the Zenphoto configuration file
- zpRewriteURL() : string
- Creates a "REWRITE" url given the query parameters that represent the link
- fix_path_redirect() : mixed
- Checks to see if the current URL is a query string url when mod_rewrite is active.
- zp_load_page() : mixed
- zp_load_gallery() : mixed
- initializes the gallery.
- zp_load_search() : mixed
- Loads the search object.
- zp_load_album() : the
- zp_load_album - loads the album given by the folder name $folder into the global context, and sets the context appropriately.
- zp_load_image() : the
- zp_load_image - loads the image given by the $folder and $filename into the global context, and sets the context appropriately.
- load_zenpage_pages() : object
- Loads a zenpage pages page Sets up $_zp_current_zenpage_page and returns it as the function result.
- load_zenpage_news() : object
- Loads a zenpage news article Sets up $_zp_current_zenpage_news and returns it as the function result.
- zp_load_request() : bool
- Figures out what is being accessed and calls the appropriate load function
- prepareIndexPage() : string
- sets up for loading the index page
- prepareAlbumPage() : mixed
- sets up for loading an album page
- prepareImagePage() : string
- sets up for loading an image page
- prepareCustomPage() : string
- sets up for loading p=page pages
- redirectionHandler() : mixed
- Handles redirections via filter hook "redirection_handler".
- zp_register_filter() : mixed
- Registers a filtering function Filtering functions are used to post process zenphoto elements or to trigger functions when a filter occur
- zp_filter_unique_id() : string
- Build Unique ID for storage and retrieval.
- zp_apply_filter() : mixed
- Performs a filtering operation on a zenphoto element or event.
- zp_remove_filter() : bool
- Removes a function from a specified filter hook.
- zp_has_filter() : int|bool
- Check if any filter has been registered for a hook.
- get_filterScript() : string
- returns a list of scripts that have attached to the hook
- zp_filter_slot() : mixed
- Returns the position of the function in the hook queue
- getLanguageArray() : mixed
- functions-i18n.php -- support functions for internationalization
- generateLanguageList() : array<string|int, mixed>
- Returns an array of available language locales.
- setMainDomain() : mixed
- Sets the locale, etc. to the zenphoto domain details.
- gettext_th() : string
- Gettext replacement function for separate translations of third party themes.
- ngettext_th() : string
- ngettext replacement function for separate translations of third party themes.
- gettext_pl() : string
- Gettext replacement function for separate translations of third party plugins within the root plugins folder.
- ngettext_pl() : string
- ngettext replacement function for separate translations of third party plugins within the root plugins folder.
- i18nSetLocale() : string
- Wrapper function for setLocale() so that all the proper permutations are used Returns the result from the setLocale call
- setupDomain() : mixed
- Sets the translation domain and type for optional theme or plugin based translations
- setupCurrentLocale() : mixed
- Setup code for gettext translation Returns the result of the setlocale call
- getLangAttributeLocale() : string
- 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.
- parseHttpAcceptLanguage() : array<string|int, mixed>
- 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
- validateLocale() : mixed
- checks a "supplied" locale against the valid locales.
- getUserLocale() : mixed
- Returns a saved (or posted) locale. Posted locales are stored as a cookie.
- get_language_string() : string
- 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
- getTimezones() : unknown
- Returns a list of timezones
- timezoneDiff() : int
- Returns the difference between the server timez one and the local (users) time zone
- getAllTranslations() : mixed
- returns a serialized "multilingual array" of translations Used for setting default options with multi-lingual strings.
- getLanguageSubdomains() : mixed
- creates an SEO language prefix list
- getLanguageText() : string
- Returns a canonical language name string for the location
- getSystemLocales() : array<string|int, mixed>
- Gets all locales suppported on the current server as a multidimensional array
- getLanguageDisplayName() : string
- Returns the real language name to the locale passed.
- printLangAttribute() : mixed
- Prints the lang="" attribute for the main <html> element.
- getFormattedLocaleDate() : string
- 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.
- imageError() : mixed
- imageDebug() : mixed
- Prints debug information from the arguments to i.php.
- propSizes() : array<string|int, mixed>
- Calculates proprotional width and height Used internally by cacheImage
- iptc_make_tag() : mixed
- iptc_make_tag() function by Thies C. Arntzen
- cacheImage() : mixed
- Creates the cache folder version of the image, including watermarking
- getImageRotation() : array<string|int, mixed>|false
- Determines the rotation of the image by looking at EXIF information.
- addWatermark() : resource|object
- Adds a watermark to a resized image. If no watermark is set it just returns the image
- isGDImage() : bool
- Checks if an processed image is a GD library image
- reconfigureAction() : mixed
- Executes the configuration change code
- checkSignature() : type
- Checks details of configuration change
- signatureChange() : string
- Notification handler for configuration change
- addReconfigureNote() : mixed
- Adds the reconfigure notification via filters
- printReconfigureNote() : mixed
- prints HTML for the configuration change notification
- getReconfigureNote() : array<string|int, mixed>
- Gets data for the configuration change notification
- printReconfigureError() : mixed
- Prints an error page on the frontend if a mandatory reconfigure issue occurred but the visitor is not loggedin with appropiate rights.
- debuglogReconfigureNote() : mixed
- Adds debuglog entries about the reconfigure note
- ignoreSetupRunRequest() : mixed
- 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.
- isSetupProtected() : array<string|int, mixed>
- Checks if setup files are protected. Returns array of the protected files or empty array
- unprotectSetupFiles() : mixed
- Unprotectes setup files
- protectSetupFiles() : mixed
- Protects setup files
- reconfigureCSS() : mixed
- CSS for the configuration change notification
- rewriteHandler() : mixed
- "Rewrite" handling for Zenphoto
- getRules() : mixed
- parseAllowedTags() : array<string|int, mixed>
- parses the allowed HTML tags for use by htmLawed
- checkObjectsThumb() : string
- Search for a thumbnail for the image
- truncate_string() : string
- Returns a truncated string
- tidyHTML() : string
- Fixes unbalanced HTML tags. Uses the library htmlawed or if available the native PHP extension tidy
- shortenContent() : string
- Returns truncated html formatted content
- lookupSortKey() : string
- 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.
- zpFormattedDate() : string
- Returns a formatted date for output
- getDatetimeObject() : object
- Returns a datetime object
- getStandardDateFormats() : array<string|int, mixed>
- Returns an array with datetime (keys) and ICU dateformat (values) strings
- myts_date() : string
- Simple SQL timestamp formatting function.
- zp_mail() : string
- 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.
- sortByMultilingual() : array<string|int, mixed>
- Sorts the results of a DB search by the current locale string for $field
- checkAlbumPassword() : bool
- Checks to see access is allowed to an album Returns true if access is allowed.
- getPluginFiles() : array<string|int, mixed>
- Returns a consolidated list of plugins The array structure is key=plugin name, value=plugin path
- getPlugin() : string|false
- Returns the fully qualified file path of a plugin file.
- getEnabledPlugins() : array<string|int, mixed>
- Returns an array of the currently enabled plugins
- extensionEnabled() : bool
- Returns if a plugin is enabled
- enableExtension() : mixed
- Enables a plugin
- disableExtension() : mixed
- Disables an extension
- getManagedAlbumList() : array<string|int, mixed>
- Populates and returns the $_zp_admin_album_list array
- populateManagedObjectsList() : array<string|int, mixed>
- Returns a list of album names managed by $id
- getAllSubAlbumIDs() : array<string|int, mixed>
- Returns an array of album ids whose parent is the folder
- handleSearchParms() : mixed
- recovers search parameters from stored cookie, clears the cookie
- galleryAlbumsPerPage() : int
- Returns the number of album thumbs that go on a gallery page
- setupTheme() : string
- Returns the theme folder If there is an album theme, loads the theme options.
- getAllTagsUnique() : array<string|int, mixed>
- Returns an array of unique tag names
- getAllTagsCount() : array<string|int, mixed>
- Returns an array indexed by 'tag' with the element value the count of the tag
- getTagCountByAccess() : int
- 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()
- storeTags() : mixed
- Stores tags for an object
- readTags() : unknown
- Retrieves the tags for an object Returns them in an array
- generateListFromArray() : mixed
- Creates the body of a select list
- generateListFromFiles() : mixed
- Generates a selection list from files found on disk
- generateAttributesFromArray() : string
- Helper to generate attributename="attributevalue" for HTML elements based on an array consisting of key => value pairs
- getLinkHTML() : mixed
- printLinkHTML() : mixed
- General link printing function
- shuffle_assoc() : bool
- shuffles an array maintaining the keys
- sortByKey() : mixed
- sorts the found albums (images) by the required key(s)
- sortMultiArray() : array<string|int, mixed>
- multidimensional array column sort
- sortArray() : bool
- General one dimensional array sorting function. Key/value associations are preserved.
- getNotViewableAlbums() : array<string|int, mixed>
- Returns a list of album IDs that the current viewer is not allowed to see
- getNotViewableImages() : array<string|int, mixed>
- Returns a list of image IDs that the current viewer is not allowed to see
- isValidURL() : bool
- Checks to see if a URL is valid
- safe_fnmatch() : bool
- pattern match function Works with characters with diacritical marks where the PHP one does not.
- isValidEmail() : bool
- Returns true if the mail address passed is valid.
- zp_image_types() : string
- returns a list of comment record 'types' for "images"
- dircopy() : the
- Copies a directory recursively
- byteConvert() : string
- Returns a byte size from a size value (eg: 100M).
- dateTimeConvert() : mixed
- Converts a datetime to connoical form
- removeDateTimeZone() : 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
- get_context() : mixed
- set_context() : mixed
- in_context() : mixed
- add_context() : mixed
- rem_context() : mixed
- save_context() : mixed
- restore_context() : mixed
- getContextObject() : bool|obj
- 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
- zp_handle_password() : mixed
- checks password posting
- zp_handle_password_single() : bool
- Handles a passwort
- getOptionFromDB() : mixed
- Gets an option directly from the database.
- setThemeOption() : mixed
- Set options local to theme and/or album
- replaceThemeOption() : 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.
- purgeThemeOption() : mixed
- Deletes an theme option for a specific or the current theme from the database
- purgeThemeOptionTotal() : mixed
- Deletes a theme option for all themes present or not
- setThemeOptionDefault() : mixed
- Used to set default values for theme specific options
- getThemeOption() : mixed
- Returns the value of a theme option
- getUserIP() : string
- Returns the viewer's IP address Deals with transparent proxies
- getAnonymIP() : string
- Anonymizing of IP addresses
- seoFriendly() : string
- Strips out and/or replaces characters from the string that are not "soe" friendly
- seoFriendlyJS() : mixed
- emit the javascript seojs() function
- is_connected() : bool
- Returns true if there is an internet connection
- debug404() : mixed
- produce debugging information on 404 errors
- XSRFdefender() : mixed
- Checks for Cross Site Request Forgeries
- getXSRFToken() : mixed
- returns an XSRF token
- XSRFToken() : mixed
- Emits a "hidden" input for the XSRF token
- cron_starter() : mixed
- Starts a sechedule script run
- zp_loggedin() : bool
- Check if logged in (with specific rights) Returns a true value if there is a user logged on with the required rights
- read_exif_data_protected() : array<string|int, mixed>
- Provides an error protected read of image EXIF/IPTC data
- getLanguageFlag() : string
- fetches the path to the flag image
- getItemByID() : mixed
- Gets an item object by id
- reveal() : mixed
- uses down and up arrow links to show and hide sections of HTML
- applyMacros() : string
- Deals with the [macro parameters] substitutions
- getMacros() : mixed
- getNestedAlbumList() : array<string|int, 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
- setexifvars() : mixed
- initializes the $_zp_exifvars array display state
- removeDir() : bool
- Recursively clears and removes a folder
- tagURLs() : mixed
- inserts location independent WEB path tags in place of site path tags
- unTagURLs() : string
- reverses tagURLs()
- updateImageProcessorLink() : string
- Searches out i.php image links and replaces them with cache links if image is cached
- pluginDebug() : mixed
- removeTrailingSlash() : string
- 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
- getDataUsageNotice() : array<string|int, mixed>
- 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>' )
- printDataUsageNotice() : 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.
- getCookieInfoData() : array<string|int, mixed>
- Returns an array with predefined info about general cookies set by the system and/or plugins
- getCookieInfoHTML() : string
- Returns a definition list with predefined info about general cookies set by the system and/or plugins as a string
- printCookieInfo() : mixed
- Prints a definition list with predefined info about general cookies set by the system and/or plugins
- getCookieInfoMacro() : array<string|int, mixed>
- Registers the content macro(s)
- getImageMetadataValue() : mixed
- Gets a formatted metadata field value for display
- printImageMetadataValue() : mixed
- Prints a formatted metadata field value
- rc4() : mixed
- encryption support functions
- bindtextdomain() : mixed
- Dummy routines so zenphoto will run on servers that do not have PHP getttext support.
- bind_textdomain_codeset() : mixed
- textdomain() : mixed
- gettext() : mixed
- ngettext() : mixed
- dgettext() : mixed
- dngettext() : mixed
- kses() : type
- 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_hook() : mixed
- You add any kses hooks here.
- kses_version() : mixed
- This function returns kses' version number.
- kses_split() : mixed
- This function searches for HTML tags, no matter how malformed. It also matches stray ">" characters.
- kses_split2() : string
- 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_attr() : type
- This function removes all attributes, if none are allowed for this element.
- kses_hair() : type
- 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_check_attr_val() : bool
- 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_bad_protocol() : type
- 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_no_null() : type
- This function removes any NULL characters in $string.
- kses_stripslashes() : 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_array_lc() : mixed
- This function goes through an array, and changes the keys to all lower case.
- kses_js_entities() : type
- This function removes the HTML JavaScript entities found in early versions of Netscape 4.
- kses_html_error() : 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_bad_protocol_once() : type
- This function searches for URL protocols at the beginning of $string, while handling whitespace and HTML entities.
- kses_bad_protocol_once2() : string
- 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_normalize_entities() : type
- This function normalizes HTML entities. It will convert "AT&T" to the correct "AT&T", ":" to ":", "&#XYZZY;" to "&#XYZZY;" and so on.
- kses_normalize_entities2() : type
- This function helps kses_normalize_entities() to only accept 16 bit values and nothing more for &#number; entities.
- kses_decode_entities() : 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.
- mb_strtolower() : mixed
- mb_strtoupper() : mixed
- mb_strlen() : mixed
- mb_substr() : mixed
- mb_strrpos() : mixed
- mb_strpos() : mixed
- mb_substr_count() : mixed
- processCommentBlock() : mixed
- getOption() : mixed
- setOption() : mixed
- setOptionDefault() : mixed
- debugLog() : mixed
- getRequestURI() : mixed
- getVersion() : mixed
- Returns the zenphoto version string
- printVersion() : mixed
- Prints the zenphoto version string
- printZenJavascripts() : mixed
- Print any Javascript required by zenphoto.
- adminToolbox() : mixed
- Prints the clickable drop down toolbox on any theme page with generic admin helpers
- getGalleryTitle() : string
- Returns the raw title of the gallery.
- getBareGalleryTitle() : string
- Returns a text-only title of the gallery.
- printGalleryTitle() : mixed
- Prints the title of the gallery.
- printBareGalleryTitle() : mixed
- getHeadTitle() : mixed
- Function to create the page title to be used within the html <head> <title></title> element.
- printHeadTitle() : mixed
- 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.
- getGalleryDesc() : string
- Returns the raw description of the gallery.
- getBareGalleryDesc() : string
- Returns a text-only description of the gallery.
- printGalleryDesc() : mixed
- Prints the description of the gallery.
- printBareGalleryDesc() : mixed
- getParentSiteTitle() : string
- 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.
- getParentSiteURL() : 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.
- getMainSiteName() : string
- getMainSiteURL() : string
- getGalleryIndexURL() : string
- Returns the URL of the main gallery index page. If a custom index page is set this returns that page.
- getStandardGalleryIndexURL() : string
- Returns the url to the standard gallery index.php page
- getCustomGalleryIndexURL() : string
- Gets the custom gallery index url if one is set, otherwise false
- getCustomGalleryIndexPage() : string
- 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()`
- printGalleryIndexURL() : mixed
- 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
- getSiteHomeURL() : string
- 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
- printSiteHomeURL() : mixed
- 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
- printPrivacyPageLink() : mixed
- If the privacy page url option is set this prints a link to it
- getNumAlbums() : int
- Returns the number of albums.
- getCurrentTheme() : string
- Returns the name of the currently active theme
- next_album() : bool
- WHILE next_album(): context switches to Album.
- getCurrentPage() : int
- Returns the number of the current page without printing it.
- getAllAccessibleAlbums() : mixed
- Gets an array of the album ids of all accessible albums (publich or user dependend)
- getTotalPages() : int
- Returns the number of pages for the current object
- getPageNumURL() : int
- Returns the URL of the page number passed as a parameter
- hasNextPage() : bool
- Returns true if there is a next page
- getNextPageURL() : string
- Returns the URL of the next page. Use within If or while loops for pagination.
- printNextPageURL() : mixed
- Prints the URL of the next page.
- hasPrevPage() : bool
- Returns TRUE if there is a previous page. Use within If or while loops for pagination.
- getPrevPageURL() : string
- Returns the URL of the previous page.
- printPrevPageURL() : mixed
- Returns the URL of the previous page.
- printPageNav() : mixed
- Prints a page navigation including previous and next page links
- printPageList() : mixed
- Prints a list of all pages.
- getPageNavList() : mixed
- returns a page nav list.
- printPageListWithNav() : mixed
- Prints a full page navigation including previous and next page links with a list of all pages in between.
- makeAlbumCurrent() : mixed
- Sets the album passed as the current album
- getAlbumTitle() : string
- Returns the raw title of the current album.
- getBareAlbumTitle() : string
- Returns a text-only title of the current album.
- getAnnotatedAlbumTitle() : string
- Returns an album title taged with of Not visible or password protected status
- printAnnotatedAlbumTitle() : mixed
- printAlbumTitle() : mixed
- Prints an encapsulated title of the current album.
- printBareAlbumTitle() : mixed
- albumNumber() : int
- Gets the 'n' for n of m albums
- getParentAlbums() : array<string|int, mixed>
- Returns an array of the names of the parents of the current album.
- getAlbumBreadcrumb() : array<string|int, mixed>
- returns the breadcrumb item for the current images's album
- printAlbumBreadcrumb() : mixed
- prints the breadcrumb item for the current images's album
- printSearchBreadcrumb() : mixed
- Prints the "breadcrumb" for a search page if the search was for a data range, the breadcrumb is "Archive" otherwise it is "Search"
- getParentBreadcrumb() : array<string|int, mixed>
- returns the breadcrumb navigation for album, gallery and image view.
- printParentBreadcrumb() : mixed
- Prints the breadcrumb navigation for album, gallery and image view.
- printHomeLink() : mixed
- 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
- getAlbumDate() : string
- Returns the formatted date field of the album
- printAlbumDate() : mixed
- Prints the date of the current album
- getAlbumLocation() : string
- Returns the Location of the album.
- printAlbumLocation() : mixed
- Prints the location of the album
- getAlbumDesc() : string
- Returns the raw description of the current album.
- getBareAlbumDesc() : string
- Returns a text-only description of the current album.
- printAlbumDesc() : mixed
- Prints description of the current album
- printBareAlbumDesc() : mixed
- getAlbumCustomData() : string
- Returns the custom_data field of the current album
- printAlbumCustomData() : mixed
- Prints the custom_data field of the current album.
- getAlbumData() : string
- A composit for getting album data
- printAlbumData() : mixed
- Prints arbitrary data from the album object
- getAlbumPage() : int
- Returns the album page number of the current image
- getAlbumURL() : string
- Returns the album link url of the current album.
- printAlbumURL() : mixed
- Prints the album link url of the current album.
- getAlbumThumb() : string
- Returns the name of the defined album thumbnail image.
- getPasswordProtectImage() : string
- Returns an <img> element of the password protect thumb substitute
- getPasswordProtectedImage() : string
- Gets the URL to the password protected images
- printPasswordProtectedImage() : mixed
- Prints an image element with the password protected image.
- printAlbumThumbImage() : mixed
- Prints the album thumbnail image.
- getCustomAlbumThumb() : string
- Returns a link to a custom sized thumbnail of the current album
- printCustomAlbumThumbImage() : string
- Prints a link to a custom sized thumbnail of the current album
- getMaxSpaceContainer() : mixed
- Called by ***MaxSpace functions to compute the parameters to be passed to xxCustomyyy functions.
- getCustomAlbumThumbMaxSpace() : string
- Returns a link to a un-cropped custom sized version of the current album thumb within the given height and width dimensions.
- printCustomAlbumThumbMaxSpace() : mixed
- Prints a un-cropped custom sized album thumb within the given height and width dimensions.
- getNextAlbum() : object
- Returns the next album
- getNextAlbumURL() : string
- Get the URL of the next album in the gallery.
- getPrevAlbum() : object
- Returns the previous album
- getPrevAlbumURL() : string
- Get the URL of the previous album in the gallery.
- isImagePage() : bool
- Returns true if this page has image thumbs on it
- isAlbumPage() : bool
- Returns true if this page has album thumbs on it
- getNumImages() : int
- Returns the number of images in the album.
- getFirstPageImages() : type
- next_image() : bool
- Returns the next image on a page.
- makeImageCurrent() : mixed
- Sets the image passed as the current image
- getImageTitle() : string
- Returns the raw title of the current image.
- getBareImageTitle() : string
- Returns a text-only title of the current image.
- getAnnotatedImageTitle() : string
- Returns the image title taged with not visible annotation.
- printAnnotatedImageTitle() : mixed
- printImageTitle() : mixed
- Prints title of the current image
- printBareImageTitle() : mixed
- imageNumber() : int
- Returns the 'n' of n of m images
- getImageDate() : string
- Returns the image date of the current image in yyyy-mm-dd hh:mm:ss format.
- printImageDate() : mixed
- Prints the date of the current album
- getImageLocation() : string
- Returns the Location field of the current image
- getImageCity() : string
- Returns the City field of the current image
- getImageState() : string
- Returns the State field of the current image
- getImageCountry() : string
- Returns the Country field of the current image
- getImageDesc() : string
- Returns the raw description of the current image.
- getBareImageDesc() : string
- Returns a text-only description of the current image.
- printImageDesc() : mixed
- Prints the description of the current image.
- printBareImageDesc() : mixed
- getImageData() : string
- A composit for getting image data
- getImageCustomData() : string
- Returns the custom_data field of the current image
- printImageCustomData() : string
- Prints the custom_data field of the current image.
- printImageData() : mixed
- Prints arbitrary data from the image object
- getFullImageFilesize() : int
- Returns the file size of the full original image
- hasNextImage() : bool
- True if there is a next image
- hasPrevImage() : bool
- True if there is a previous image
- getNextImageURL() : string
- Returns the url of the next image.
- getPrevImageURL() : string
- Returns the url of the previous image.
- getPrevImageThumb() : string
- Returns the thumbnail of the previous image.
- getNextImageThumb() : string
- Returns the thumbnail of the next image.
- getImageURL() : string
- Returns the url of the current image.
- printImageURL() : mixed
- Prints the link to the current image.
- getImageMetaData() : array<string|int, mixed>
- Returns the Metadata infromation from the current image
- printImageMetadata() : mixed
- Prints the Metadata data of the current image
- getSizeCustomImage() : array<string|int, mixed>
- Returns an array with the height & width
- getSizeDefaultImage() : array<string|int, mixed>
- Returns an array [width, height] of the default-sized image.
- getSizeFullImage() : array<string|int, mixed>
- Returns an array [width, height] of the original image.
- getDefaultWidth() : int
- The width of the default-sized image (in printDefaultSizedImage)
- getDefaultHeight() : int
- Returns the height of the default-sized image (in printDefaultSizedImage)
- getFullWidth() : int
- Returns the width of the original image
- getFullHeight() : int
- Returns the height of the original image
- isLandscape() : bool
- Returns true if the image is landscape-oriented (width is greater than height) or - kept here for backwards compatibility - square (equal widht and height)
- getDefaultSizedImage() : string
- Returns the url to the default sized image.
- printDefaultSizedImage() : mixed
- Show video player with video loaded or display the image.
- getImageThumb() : string
- Returns the url to the thumbnail of the current image.
- printImageThumb() : mixed
- getSizeDefaultThumb() : aray
- Gets the width and height of a default thumb for the <img> tag height/width
- getFullImageURL() : string
- Returns the url to original image.
- getUnprotectedImageURL() : string
- Returns the "raw" url to the image in the albums folder
- getProtectedImageURL() : string
- Returns an url to the password protected/watermarked current image
- getSizedImageURL() : mixed
- Returns a link to the current image custom sized to $size
- getCustomImageURL() : string
- Returns the url to the image with the dimensions you define with this function.
- printCustomSizedImage() : mixed
- Print normal video or custom sized images.
- getCustomSizedImageMaxSpace() : string
- Returns a link to a un-cropped custom sized version of the current image within the given height and width dimensions.
- getCustomSizedImageThumbMaxSpace() : string
- Returns a link to a un-cropped custom sized version of the current image within the given height and width dimensions.
- printCustomSizedImageThumbMaxSpace() : mixed
- Creates image thumbnails which will fit un-cropped within the width & height parameters given
- printCustomSizedImageMaxSpace() : mixed
- Print normal video or un-cropped within the given height and width dimensions. Use for sized images or thumbnails in an album.
- printSizedImageURL() : mixed
- Prints link to an image of specific size
- getTags() : string
- Returns a list of tags for context of the page called where called
- printTags() : mixed
- Prints a list of tags, editable by admin
- printAllTagsAs() : mixed
- Either prints all of the galleries tgs as a UL list or a cloud
- getAllDates() : array<string|int, mixed>
- Retrieves a list of all unique years & months from the images in the gallery
- printAllDates() : mixed
- Prints a compendum of dates and links to a search page that will show results of the date
- getCustomPageURL() : string
- Produces the url to a custom page (e.g. one that is not album.php, image.php, or index.php)
- printCustomPageURL() : mixed
- Prints the url to a custom page (e.g. one that is not album.php, image.php, or index.php)
- isArchive() : bool
- tests if a search page is an "archive" page
- getSearchURL() : string
- Returns a search URL
- printSearchForm() : mixed
- Prints the search form
- getSearchWords() : string
- Returns the a sanitized version of the search string
- getSearchDate() : string
- Returns the date of the search
- checkForGuest() : string
- returns the auth type of a guest login
- checkAccess() : bool
- Checks to see if a password is needed
- getPageRedirect() : string
- Returns a redirection link for the password form
- printPasswordForm() : mixed
- Prints the album password form
- printZenphotoLink() : mixed
- prints the zenphoto logo and link
- exposeZenPhotoInformations() : mixed
- Expose some informations in a HTML comment
- getCodeblock() : string
- Gets the content of a codeblock for an image, album or Zenpage newsarticle or page.
- printCodeblock() : string
- Prints the content of a codeblock for an image, album or Zenpage newsarticle or page.
- checkPageValidity() : bool
- 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.
- print404status() : mixed
- getOwnerAuthor() : bool
- Gets current item's owner (gallery images and albums) or author (Zenpage articles and pages)
- printOwnerAuthor() : mixed
- Prints current item's owner (gallery images and albums) or author (Zenpage articles and pages)
- getOwnerAuthorURL() : type
- Returns the search url for items the current item's owner (gallery) or author (Zenpage) is assigned to
- printOwnerAuthorURL() : mixed
- Prints the link to the search engine for results of all items the current item's owner (gallery) or author (Zenpage) is assigned to
- getUserURL() : string|null
- 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
- printUserURL() : mixed
- 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
- printCopyrightNotice() : mixed
- Display the site or image copyright notice if defined and display is enabled
- printGalleryCopyrightNotice() : mixed
- Display the site copyright notice if defined and display is enabled
- printImageCopyrightNotice() : mixed
- Display the image copyright notice if defined and display iss enabled
- getCurrentPageAppendix() : string
- Gets the current page number if it is larger than 1 for use on paginated pages for SEO reason to avoid duplicate titles
- printCurrentPageAppendix() : mixed
- Prints the current page number if it is larger than 1 for use on paginated pages for SEO reason to avoid duplicate titles
- gallerystats_filesize_r() : mixed
- printBarGraph() : mixed
- Prints a table with a bar graph of the values.
- printThumbNav() : mixed
- Prints the jQuery bxslider HTML setup to be replaced by JS
- checkForUpdate() : string
- 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.
- admin_showupdate() : mixed
- Displays the "new version available" message on admin pages
- get_AnyFile_suffixes() : mixed
- comment_form_PaginationJS() : mixed
- comment_form_visualEditor() : mixed
- comment_form_print10Most() : mixed
- Admin overview summary
- getCommentAddress() : array<string|int, mixed>
- Processes the post of an address
- getCommentErrors() : string
- Returns an error message if a comment posting was not accepted
- printCommentErrors() : mixed
- Tool to output an error message if a comment posting was not accepted
- comment_form_addComment() : object
- Generic comment adding routine. Called by album objects or image objects to add comments.
- commentFormUseCaptcha() : bool
- Use see if a captcha should be displayed
- comment_form_postcomment() : mixed
- checks if comments are allowed and then processes them if so
- comment_form_handle_comment() : null|bool
- Handles the POSTing of a comment
- getCommentAuthorName() : string
- Returns the comment author's name
- getCommentAuthorEmail() : string
- Returns the comment author's email
- getCommentAuthorSite() : string
- Returns the comment author's website
- getCommentAuthorLink() : mixed
- Prints a link to the author
- printCommentAuthorLink() : mixed
- Prints a link to the author
- getCommentDateTime() : string
- Returns a formatted date and time for the comment.
- getCommentBody() : string
- Returns the body of the current comment
- printEditCommentLink() : mixed
- Creates a link to the admin comment edit page for the current comment
- getLatestComments() : mixed
- Gets latest comments for images, albums, news and pages
- printLatestComments() : mixed
- Prints latest comments for images, albums, news and pages
- getCommentCount() : int
- Retuns the count of comments on the current image
- next_comment() : bool
- Iterate through comments; use the ZP_COMMENT context.
- getCommentStored() : array<string|int, mixed>
- Returns the data from the last comment posted
- commentReply() : string
- Takes a comment and makes the body of an email.
- commentsAllowed() : bool
- Returns true if all the right conditions are set to allow comments for the $type
- getComments() : array<string|int, mixed>
- Gets an array of comments for the current admin
- fetchComments() : array<string|int, mixed>
- Gets an array of comments for the current admin
- isCommentFormRequiredField() : bool
- Checks if a field is required
- getCommentFormRequiredFieldMark() : string
- Gets the star to mark required field names
- getCommentFormRequiredFieldAttr() : string
- Returns the required attribute if the field is required
- isCommentFormReadonlyField() : mixed
- Checks if the field should be set to readonly
- getCommentFormReadonlyFieldAttr() : string
- Gets the readonly attribute for disabled fields
- printCommentFormFieldAttributes() : mixed
- Prints the combined required and readonly attributes as needed
- getCommentformFormAutocompleteAttr() : string
- Returns the autocomplete attribute for the form depending if autocomplete is enabled
- getCommentformAutocompleteAttr() : 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
- printCommentformAutocompleteAttr() : mixed
- 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
- getQuizFieldQuestion() : string|bool
- Gets the the question to a quiz field if the field is enabled and setup correctly
- printCommentForm() : mixed
- Prints a form for posting comments
- getField() : string
- Retrieves the post field if it exists
- printContactForm() : mixed
- 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.
- showOrNotShowField() : bool
- Helper function that checks if a field should be shown ("required" or "show") or omitted ("ommitt").
- checkRequiredField() : string
- Helper function that checks if the field is a required one. If it returns '*" to be appended to the field name as an indicator.
- printContactFormMacro() : type
- Buffers the contact form print out so it can be passed to its content macro
- getContactFormMacros() : array<string|int, mixed>
- Registers the content macro(s)
- defaultCodeblocks_codebox() : mixed
- setThemeColumns() : mixed
- controls the thumbnail layout of themes.
- getMimeString() : string
- Returns the mimetype for a suffix
- newAlbum() : Album
- Wrapper instantiation function for albums. Do not instantiate directly
- isAlbumClass() : bool
- Returns true if the object is a zenphoto 'album'
- getUrAlbum() : object
- Returns the oldest ancestor of an alubm;
- newImage() : object
- Returns a new "image" object based on the file extension
- isImageClass() : bool
- Returns true if the object is a zenphoto 'image'
- search_quote() : string
- encloses search word in quotes if needed
- isImageVideo() : bool
- Returns video argument of the current Image.
- isImagePhoto() : bool
- Returns true if the image is a standard photo type
- replaceOption() : 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.
- is_valid_email_zp() : bool
- Determines if the input is an e-mail address. Adapted from WordPress.
- genAlbumList() : mixed
- Populatest $list with an one dimensional list with album name and title of all albums or the subalbums of a specific album
- getAllAlbums() : array<string|int, mixed>
- Returns a list of all albums decendent from an album
- printPopularAlbums() : mixed
- printLatestAlbums() : mixed
- printMostRatedAlbums() : mixed
- printTopRatedAlbums() : mixed
- printLatestUpdatedAlbums() : mixed
- printPopularImages() : mixed
- printTopRatedImages() : mixed
- printMostRatedImages() : mixed
- printLatestImages() : mixed
- printLatestImagesByDate() : mixed
- printLatestImagesByMtime() : mixed
- filterImageQuery() : mixed
- performs a query and then filters out "illegal" images returning the first "good" image used by the random image functions.
- getRandomImages() : object
- Returns a randomly selected image from the gallery. (May be NULL if none exists)
- getRandomImagesAlbum() : object
- Returns a randomly selected image from the album or its subalbums. (May be NULL if none exists)
- printRandomImages() : mixed
- Puts up random image thumbs from the gallery
- cleanHTML() : string
- fixes unbalanced HTML tags. Used by shortenContent when PHP tidy is not present
- getTotalImagesIn() : int
- Returns the count of all the images in the album and any subalbums
- checkPublishDates() : mixed
- checks if the item has expired
- getPHPFiles() : string
- formatList() : bool
- listUses() : type
- listDBUses() : bool
- printBarGraph() : mixed
- Prints a table with a bar graph of the values.
- printdownloadList() : mixed
- Prints the actual download list included all subfolders and files
- getdownloadList() : array<string|int, mixed>
- Gets the actual download list included all subfolders and files
- getDownloadURL() : mixed
- Gets the download url for a file
- printDownloadURL() : mixed
- Prints a download link for a file, depending on the plugin options including the downloadcount and filesize
- printFullImageDownloadURL() : mixed
- Prints the dwnload url link for a full image
- printDownloadAlbumZipURL() : mixed
- Prints a download link for an album zip of the current album (therefore to be used only on album.php/image.php).
- printLanguageSelector() : mixed
- prints a form for selecting a locale The POST handling is by getUserLocale() called in functions.php
- elFinderAutoloader() : mixed
- access() : bool|null
- Simple function to demonstrate how to control file access using "accessControl" callback.
- accessImage() : mixed
- accessAlbums() : mixed
- imagecreatefrombmp() : mixed
- elFinder_admin_tabs() : mixed
- elFinder_tinymce() : mixed
- printAddToFavorites() : mixed
- getFavoritesURL() : mixed
- printFavoritesURL() : mixed
- Prints links to the favorites "albums"
- getFeaturedImage() : mixed
- Returns the image object if an featured image is assigned, otherwise false
- getSizedFeaturedImage() : string
- Gets a custom sized version of this image based on the parameters. Multimedia items don't use these.
- printSizedFeaturedImage() : string
- Print a custom sized version of this image based on the parameters. Multimedia items don't use these.
- getFeaturedImageThumb() : string
- Gets the default thumb size of a featured image
- printFeaturedImageThumb() : mixed
- Prints the default thumb size of a featured image
- log_message() : mixed
- get_instance() : mixed
- omsAdditions() : mixed
- getGeoCoord() : mixed
- $returns coordinate informations for an image
- addGeoCoord() : mixed
- Add a point to a map object
- getImageGeodata() : mixed
- Gathers the data for an image
- getAlbumGeodata() : mixed
- Gathers the map data for an album
- printGoogleMap() : mixed
- Output the google map
- getHitcounter() : string
- returns the hitcounter for the current page or for the object passed
- getTotalHitcounter() : int
- Gets the total hitcounter sum of one or several items
- getAlbumStatistic() : array<string|int, mixed>
- Returns a array of album objects of album statistic accordingly to $option
- printAlbumStatistic() : mixed
- Prints album statistic according to $option as an unordered HTML list A css id is attached by default named '$option_album'
- printAlbumStatisticItem() : mixed
- A helper function that only prints a item of the loop within printAlbumStatistic() Not for standalone use.
- getImageStatistic() : array<string|int, mixed>
- Returns a array of image objects of image statistic according to $option
- printImageStatistic() : string
- Prints image statistic according to $option as an unordered HTML list A css id is attached by default named accordingly'$option'
- checkIfNew() : bool
- 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.
- getNumAllSubalbums() : bool
- Gets the number of all subalbums of all subalbum levels of either the current album or $albumobj
- getPictureOfTheDay() : object|nill
- Returns an randomly selected image objecet from the gallery per day.
- getjPlayerSkins() : mixed
- Gets the skin names and css files
- getjPlayerSkinCSS() : mixed
- Gets the css files for a skin. Helper function for getjPlayerSkins().
- printjPlayerPlaylist() : mixed
- jplayer class theme function wrapper for user convenience
- macro_admin_tabs() : mixed
- macroList_show() : mixed
- markRelease_button() : mixed
- updateItemsSortorder() : mixed
- Updates the sortorder of the pages list in the database
- printItemsListTable() : mixed
- Prints the table part of a single page item for the sortable pages list
- printItemsList() : bool
- Prints the sortable pages list returns true if nesting levels exceede the database container
- printItemEditLink() : mixed
- 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.
- printItemStatusDropdown() : mixed
- Prints the item status selector to choose if all items or only hidden or visible should be listed
- getMenuSetSelector() : mixed
- returns the menu set selector
- publishItem() : mixed
- Sets a menu item to published/visible
- addSubalbumMenus() : mixed
- adds (sub)albums to menu base with their gallery sorting order intact
- addalbumsToDatabase() : int
- Adds albums to the menu set. Returns the next sort order base
- addPagesToDatabase() : int
- Adds Zenpage pages to the menu set
- addCategoriesToDatabase() : mixed
- Adds Zenpage news categories to the menu set
- addItem() : array<string|int, mixed>
- Adds an menu item set via POST
- updateMenuItem() : mixed
- Updates a menu item (custom link, custom page only) set via POST
- deleteItem() : mixed
- Deletes a menu item set via GET
- printAlbumsSelector() : string
- Prints all albums of the Zenphoto gallery as a partial drop down menu (<option></option> parts).
- printZenpagePagesSelector() : string
- Prints all available pages in Zenpage
- printZenpageNewsCategorySelector() : string
- Prints all available articles or categories in Zenpage
- printCustomPageSelector() : string
- Prints the selector for custom pages
- unpublishedZenphotoItemCheck() : string
- checks if a album or image is un-published and returns a '*'
- processMenuBulkActions() : mixed
- Processes the check box bulk actions
- menu_admin_toolbox_global() : mixed
- Add menu to the admin toolbox
- menu_tabs() : unknown
- Adds menu manager to admin tabs
- getMenuItems() : array<string|int, mixed>
- Gets the menu items
- getItem() : array<string|int, mixed>
- Gets a menu item by its id
- checkChosenMenuset() : string
- Checks which menu set is chosen via $_GET. If none is explicity chosen the "default" one (create initially) is used.
- checkChosenItemStatus() : string
- Checks if the menu item is set visible or not
- getItemTitleAndURL() : array<string|int, mixed>
- Gets the title, url and name of a menu item
- getMenuVisibility() : string
- Gets the menu visibility
- inventMenuItem() : int|array<string|int, mixed>|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
- getCurrentMenuItem() : int|array<string|int, mixed>|string
- Returns the data of the current menu item
- getMenumanagerPredicessor() : string
- Returns the link to the predicessor of the current menu item
- printMenumanagerPrevLink() : mixed
- Prints the previous link of the current menu item
- getMenumanagerSuccessor() : string
- Returns the successor link of the current menu item
- printMenumanagerNextLink() : mixed
- Gets the link to the next menu item
- printMenuemanagerPageListWithNav() : mixed
- Prints a list of all pages.
- printMenuemanagerPageList() : mixed
- Prints a full page navigation including previous and next page links with a list of all pages in between.
- getParentMenuItems() : array<string|int, mixed>|false
- Gets the parent menu items of the current menu item. Returns the array of the items or false.
- printMenumanagerBreadcrumb() : mixed
- Prints the breadcrumbs of the current page
- getMenuFromLink() : array<string|int, mixed>
- Returns the menu item corresponding to $link
- submenuOf() : bool
- Returns true if the current menu item is a sub item of $link
- createMenuIfNotExists() : mixed
- Creates a menu set from the items passed. But only if the menu set does not already exist
- getMenuItemChilds() : array<string|int, mixed>|false
- Gets the direct child menu items of the current menu item. Returns the array of the items or false.
- isCurrentitemParent() : bool
- Checks if the item $item is a parent item of the current item
- isPublicMenuItem() : bool
- Checks if the actual object the menu item represents is actually public
- printCustomMenu() : string
- Prints a context sensitive menu of all pages as a unordered html list
- getSelectedLayout() : string|false
- Gets the selected layout page for this item. Returns false if nothing is selected.
- checkParentLayouts() : array<string|int, mixed>|false
- Checks if there is a layout inherited from a parent items (album, page or category) and returns it. Returns false otherwise.
- checkLayoutUseForImages() : array<string|int, mixed>|false
- Gets the selected layout page for images if the album option to use the equivalent of their album layout is seleted.
- layoutSelector() : string
- returns the layout selector for an object.
- layoutSelector_album() : string
- returns the layout selectors for an album.
- getLayoutSelector() : string
- Worker function for creating layout selectors. Returns the HTML
- getLayout() : string
- Gets the select layout page and returns it to the load_theme_script filter
- saveLayoutSelection() : string
- Saves the layout page assignment via filter on the backend
- saveZenphotoLayoutSelection() : string
- Saves the layout page assignment via filter on the backend for images and albums
- deleteLayoutSelection() : bool
- processes object removals if they have been assigned layouts
- copyLayoutSelection() : mixed
- Copies the layout selection
- printOpenStreetMap() : mixed
- 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.
- printPagedThumbsNav() : mixed
- Prints a paged thumbnail navigation to be used on a theme's image.php, independent of the album.php's thumbs loop
- zenphoto_PHPMailer() : mixed
- printAlbumMenu() : mixed
- Prints a list of all albums context sensitive.
- printAlbumMenuList() : html
- Prints a nested html list of all albums context sensitive.
- printAlbumMenuListAlbum() : mixed
- Handles an album for printAlbumMenuList
- printAlbumMenuJump() : mixed
- 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.
- checkSelectedAlbum() : string
- 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.
- unpublishSubalbums() : mixed
- printRating() : 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.
- getRating() : float
- Returns the current rating of an object
- printRegistrationForm() : mixed
- Parses the verification and registration if they have occurred places the user registration form
- printRegisterURL() : mixed
- prints the link to the register user page
- getRelatedItems() : mixed
- createRelatedItemsResultArray() : mixed
- Helper function for getRelatedItems() only.
- printRelatedItems() : mixed
- Prints the x related articles based on a tag search
- rulesList() : type
- getRSSLink() : mixed
- Prints a RSS link for if (class_exists('RSS')) printRSSLink() and if (class_exists('RSS')) printRSSHeaderLink()
- printRSSLink() : mixed
- Prints an RSS link
- printRSSHeaderLink() : mixed
- Prints the RSS link for use in the HTML HEAD
- executeRSS() : mixed
- seo_cleanup_button() : mixed
- getE() : mixed
- cleanAlbum() : mixed
- checkFolder() : mixed
- printSlideShowLink() : 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.
- printSlideShow() : mixed
- Prints the slideshow using the {@link http://http://www.malsup.com/jquery/cycle2/ jQuery plugin Cycle2 }
- getAllTagsFromAlbum() : array<string|int, mixed>
- Prints a tag cloud list of the tags in one album and optionally its subalbums. Returns FALSE if no value.
- getAllTagsFromZenpage() : mixed
- Gets all tags used by either all Zenpage news articles or pages.
- printAllTagsFromZenpage() : mixed
- Prints a tag cloud list of the tags used by either all Zenpage news articles or pages.
- printAllTagsFromAlbum() : mixed
- Prints a tag cloud list of the tags in one album and optionally its subalbums.
- printAllTags() : mixed
- Prints a tag cloud list of the tags in one album and optionally its subalbums. Base function to printAllTagsFromAlbum().
- getAllTagsFromAlbum_multi_unique() : array<string|int, mixed>
- Removes duplicate entries in multi dimensional array.
- tagSuggestJS_admin() : mixed
- tagSuggestJS_frontend() : mixed
- tagSuggestJS() : mixed
- printFullAlbumsList() : string
- Prints all albums of the Zenphoto gallery as a partial drop down menu (<option></option> parts).
- printSubLevelAlbums() : string
- Recursive helper function for printFullAlbumsList() to get all sub albums of each top level album
- unpublishedZenphotoItemCheck() : string
- checks if a album or image is un-published and returns a '*'
- shortentitle() : string
- shortens a string, truncate_string() was not exact enough.
- printImageslist() : string
- Prints the images and/or albums as thumbnails of the selected album
- getImageType() : string
- Returns the object "type" of the "image".
- printNewsArticlesList() : string
- Prints all available articles in Zenpage
- checkAlbumForImages() : bool
- Checks if an album has images for display on the form
- showZenphotoOptions() : bool
- Checks if the full Zenphoto include form options should be shown
- printTinyPageNav() : string
- Prints the page navigation for albums or Zenpage news articles
- printZenpageItems() : string
- Prints the Zenpage items as a partial dropdown (pages, news articles, categories)
- printAllNestedList() : string
- Prints all available pages or categories in Zenpage
- unpublishedZenpageItemCheck() : string
- checks if a news article or page is un-published and/or protected and returns a '*'
- setTinyZenpageLocale() : mixed
- Set the locale for gettext translation of this plugin. Somehow ZenPhoto's setupDomain() does not work here.
- printTinyZenpageCategorySelector() : mixed
- Prints the dropdown menu for the category selector for the news articles list
- printFullAlbumsList() : string
- Prints all albums of the Zenphoto gallery as a partial drop down menu (<option></option> parts).
- printSubLevelAlbums() : string
- Recursive helper function for printFullAlbumsList() to get all sub albums of each top level album
- unpublishedZenphotoItemCheck() : string
- checks if a album or image is un-published and returns a '*'
- shortentitle() : string
- shortens a string, truncate_string() was not exact enough.
- printImageslist() : string
- Prints the images and/or albums as thumbnails of the selected album
- getImageType() : string
- Returns the object "type" of the "image".
- printNewsArticlesList() : string
- Prints all available articles in Zenpage
- checkAlbumForImages() : bool
- Checks if an album has images for display on the form
- showZenphotoOptions() : bool
- Checks if the full Zenphoto include form options should be shown
- printTinyPageNav() : string
- Prints the page navigation for albums or Zenpage news articles
- printZenpageItems() : string
- Prints the Zenpage items as a partial dropdown (pages, news articles, categories)
- printAllNestedList() : string
- Prints all available pages or categories in Zenpage
- unpublishedZenpageItemCheck() : string
- checks if a news article or page is un-published and/or protected and returns a '*'
- setTinyZenpageLocale() : mixed
- Set the locale for gettext translation of this plugin. Somehow ZenPhoto's setupDomain() does not work here.
- printTinyZenpageCategorySelector() : mixed
- Prints the dropdown menu for the category selector for the news articles list
- tinymce4ConfigJS() : mixed
- getTinyMCE4ConfigFiles() : mixed
- upload_head() : mixed
- upload_extra() : mixed
- upload_form() : mixed
- httpUploadHandler() : mixed
- httpUploadHandler_admin_tabs() : mixed
- jQueryUpload_headers() : mixed
- jQueryUpload_head() : mixed
- upload_head() : mixed
- upload_extra() : mixed
- upload_form() : mixed
- jQueryUploadHandler() : mixed
- jQueryUploadHandler_admin_tabs() : mixed
- printUserLogin_out() : mixed
- Prints the logout link if the user is logged in.
- user_mailing_list_button() : mixed
- getExpiryDatePost() : string
- 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
- processTags() : mixed
- processes the taglist save
- updatePage() : object
- Updates or adds a page and returns the object of that page
- deletePage() : mixed
- Deletes a page (and also if existing its subpages) from the database
- printPagesListTable() : mixed
- Prints the table part of a single page item for the sortable pages list
- updateArticle() : object
- Updates or adds a news article and returns the object of that article
- deleteArticle() : mixed
- Deletes an news article from the database
- printArticleCategories() : mixed
- Print the categories of a news article for the news articles list
- printPageArticleTags() : mixed
- Print the categories of a news article for the news articles list
- printCategorySelection() : mixed
- Prints the checkboxes to select and/or show the category of an news article on the edit or add page
- printArticleDatesDropdown() : mixed
- Prints the dropdown menu for the date archive selector for the news articles list
- getNewsAdminOption() : array<string|int, mixed>
- Compiles an option parameter list
- getNewsAdminOptionPath() : string
- Creates the admin paths for news articles if you use the dropdowns on the admin news article list together
- printUnpublishedDropdown() : mixed
- Prints the dropdown menu for the published/un-publishd selector for the news articles list
- printSortOrderDropdown() : mixed
- Prints the dropdown menu for the sortorder selector for the news articles list
- printCategoryDropdown() : mixed
- Prints the dropdown menu for the category selector for the news articles list
- printArticlesPerPageDropdown() : mixed
- Prints the dropdown menu for the articles per page selector for the news articles list
- printAuthorDropdown() : mixed
- Prints the dropdown menu all authors that currently are authors of news articles
- updateCategory() : mixed
- Updates or adds a category
- deleteCategory() : mixed
- Deletes a category (and also if existing its subpages) from the database
- printCategoryListSortableTable() : string
- Prints the list entry of a single category for the sortable list
- printCategoryCheckboxListEntry() : mixed
- Prints the checkboxes to select and/or show the category of an news article on the edit or add page
- printNestedItemsList() : string
- Prints the nested list for pages and categories
- updateItemSortorder() : array<string|int, mixed>
- Updates the sortorder of the items list in the database
- checkForEmptyTitle() : string
- Checks if no title has been provide for items on new item creation
- zenpagePublish() : string
- Publishes a page or news article
- skipScheduledPublishing() : string
- 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.
- checkHitcounterDisplay() : string
- Checks if there are hitcounts and if they are displayed behind the news article, page or category title
- getNewsPagesStatistic() : mixed
- returns an array of how many pages, articles, categories and news or pages comments we got.
- printPagesStatistic() : mixed
- printNewsStatistic() : mixed
- printCategoriesStatistic() : mixed
- zenpageJSCSS() : mixed
- Prints the links to JavaScript and CSS files zenpage needs.
- printZenpageIconLegend() : mixed
- authorSelector() : mixed
- Prints a dropdown to select the author of a page or news article (Admin rights users only)
- printPublishIconLink() : mixed
- Prints the publish/un-published/scheduled publishing icon with a link for the pages and news articles list.
- checkIfChecked() : mixed
- Checks if a checkbox is selected and checks it if.
- checkIfLockedPage() : bool
- Checks if the current logged in admin user is the author that locked the page/article.
- checkIfLockedNews() : bool
- Checks if the current logged in admin user is the author that locked the article.
- is_AdminEditPage() : bool
- Checks if the current admin-edit.php page is called for news articles or for pages.
- processZenpageBulkActions() : mixed
- Processes the check box bulk actions
- zenpageBulkActionMessage() : mixed
- createTitlelink() : type
- Creates the titlelink from the title passed.
- checkTitlelinkDuplicate() : bool
- Checks if a title link of this itemtype already exists
- addDateToTitlelink() : string
- Append or prepends a date string to a titlelink as defined.
- getNewsIndexURL() : string
- Returns the full path of the news index page
- getNewsArchiveURL() : string
- Returns the full path of the news archive page
- RSS_Tags() : mixed
- RSS_Channel() : mixed
- RSS_Retrieve() : mixed
- printNews() : mixed
- zenphoto_sendmail() : type
Constants
ACK_DISPLAY_ERRORS
public
mixed
ACK_DISPLAY_ERRORS
= 2
ADMIN_IMAGES_STEP
public
mixed
ADMIN_IMAGES_STEP
= 5
ADMIN_PLUGIN
Defines the bitmask for load order priority of admin plugins
public
mixed
ADMIN_PLUGIN
= 4096
ADMIN_RIGHTS
public
mixed
ADMIN_RIGHTS
= 1
ALBUM_FOLDER_EMPTY
public
mixed
ALBUM_FOLDER_EMPTY
= \getAlbumFolder('')
ALBUM_FOLDER_SERVERPATH
public
mixed
ALBUM_FOLDER_SERVERPATH
= \getAlbumFolder(\SERVERPATH)
ALBUM_FOLDER_WEBPATH
public
mixed
ALBUM_FOLDER_WEBPATH
= \getAlbumFolder(\WEBPATH)
ALBUM_MENU_COUNT
public
mixed
ALBUM_MENU_COUNT
= \getOption('print_album_menu_count')
ALBUM_MENU_SHOWSUBS
public
mixed
ALBUM_MENU_SHOWSUBS
= \getOption('print_album_menu_showsubs')
ALBUMFOLDER
Defines the name of the albums folder
public
mixed
ALBUMFOLDER
= 'albums'
ALL_ALBUMS_RIGHTS
public
mixed
ALL_ALBUMS_RIGHTS
= \VIEW_ALL_RIGHTS
ALL_NEWS_RIGHTS
public
mixed
ALL_NEWS_RIGHTS
= \VIEW_ALL_RIGHTS
ALL_PAGES_RIGHTS
public
mixed
ALL_PAGES_RIGHTS
= \VIEW_ALL_RIGHTS
BACKUPFOLDER
Defines the name of the backup folder
public
mixed
BACKUPFOLDER
= 'backup'
BASEPATH
public
mixed
BASEPATH
= true
CACHE_HASH_LENGTH
public
mixed
CACHE_HASH_LENGTH
= \strlen(\sha1(\strval(\HASH_SEED)))
CACHEFOLDER
Defines the name of the image cache folder
public
mixed
CACHEFOLDER
= 'cache'
CASE_INSENSITIVE
Defines if the server file system is case insensitive
public
mixed
CASE_INSENSITIVE
= \file_exists(\dirname(__FILE__) . '/VERSION.PHP')
CHMOD_VALUE
public
mixed
CHMOD_VALUE
= \fileperms(\dirname(__FILE__)) & 0666
CLASS_PLUGIN
Defines the bitmask for load order priority of class plugins
public
mixed
CLASS_PLUGIN
= 8192
COMMENT_BODY_REQUIRED
public
mixed
COMMENT_BODY_REQUIRED
= 16
COMMENT_DATACONFIRMATION
public
mixed
COMMENT_DATACONFIRMATION
= 64
COMMENT_EMAIL_REQUIRED
public
mixed
COMMENT_EMAIL_REQUIRED
= 1
COMMENT_MATHQUIZ
public
mixed
COMMENT_MATHQUIZ
= 256
COMMENT_NAME_REQUIRED
public
mixed
COMMENT_NAME_REQUIRED
= 2
COMMENT_SEND_EMAIL
public
mixed
COMMENT_SEND_EMAIL
= 32
COMMENT_TEXTQUIZ
public
mixed
COMMENT_TEXTQUIZ
= 128
COMMENT_WEB_REQUIRED
public
mixed
COMMENT_WEB_REQUIRED
= 4
COMMENTS_PER_PAGE
public
mixed
COMMENTS_PER_PAGE
= \max(1, \getOption('comment_form_comments_per_page'))
COMMON_FOLDER
Defines the name of the shared "common" folder within/for core extensions
public
mixed
COMMON_FOLDER
= \PLUGIN_FOLDER . '/common'
CONFIGFILE
Defines the name of the config file
public
mixed
CONFIGFILE
= 'zenphoto.cfg.php'
COOKIE_PATH
public
mixed
COOKIE_PATH
= \WEBPATH
COOKIE_PERSISTENCE
public
mixed
COOKIE_PERSISTENCE
= $persistence
CUSTOM_OPTION_PREFIX
public
mixed
CUSTOM_OPTION_PREFIX
= '_ZP_CUSTOM_'
DATA_FOLDER
Defines the name of the zp-data folder outside the core folder
public
mixed
DATA_FOLDER
= 'zp-data'
DATA_MOD
public
mixed
DATA_MOD
= \fileperms(\SERVERPATH . '/' . \DATA_FOLDER . '/' . \CONFIGFILE) & 0777
DATABASE_DESIRED_VERSION
public
mixed
DATABASE_DESIRED_VERSION
= '5.7.0'
DATABASE_DESIRED_VERSION
public
mixed
DATABASE_DESIRED_VERSION
= '0.0.0'
DATABASE_MARIADB_DESIRED_VERSION
public
mixed
DATABASE_MARIADB_DESIRED_VERSION
= '10.1.0'
DATABASE_MARIADB_DESIRED_VERSION
public
mixed
DATABASE_MARIADB_DESIRED_VERSION
= '0.0.0'
DATABASE_MARIADB_MIN_VERSION
public
mixed
DATABASE_MARIADB_MIN_VERSION
= '5.5.0'
DATABASE_MARIADB_MIN_VERSION
public
mixed
DATABASE_MARIADB_MIN_VERSION
= '0.0.0'
DATABASE_MIN_VERSION
public
mixed
DATABASE_MIN_VERSION
= '5.5.3'
DATABASE_MIN_VERSION
public
mixed
DATABASE_MIN_VERSION
= '0.0.0'
DATABASE_PREFIX
public
mixed
DATABASE_PREFIX
= $mysql_prefix
DATABASE_SOFTWARE
public
mixed
DATABASE_SOFTWARE
= $_zp_conf_vars['db_software']
DATABASE_SOFTWARE
public
mixed
DATABASE_SOFTWARE
= 'Database setup'
DATE_FORMAT
public
mixed
DATE_FORMAT
= \trim(\strval(\getOption('date_format')))
DATETIME_DISPLAYFORMAT
public
mixed
DATETIME_DISPLAYFORMAT
= \DATETIME_FORMAT
DATETIME_FORMAT
public
mixed
DATETIME_FORMAT
= \DATE_FORMAT . ' ' . \TIME_FORMAT
DEBUG_404
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
DEBUG_ERROR
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
DEBUG_EXIF
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']
DEBUG_FILTERS
set to true to log filter application sequence.
public
mixed
DEBUG_FILTERS
= isset($_zp_conf_vars['debug_filters']) && $_zp_conf_vars['debug_filters']
DEBUG_IMAGE
set to true to log image processing debug information.
public
mixed
DEBUG_IMAGE
= isset($_zp_conf_vars['debug_image']) && $_zp_conf_vars['debug_image']
DEBUG_IMAGE_ERR
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
DEBUG_LOCALE
used for examining language selection problems
public
mixed
DEBUG_LOCALE
= isset($_zp_conf_vars['debug_locale']) && $_zp_conf_vars['debug_locale']
DEBUG_LOG_SIZE
public
mixed
DEBUG_LOG_SIZE
= \getOption('debug_log_size')
DEBUG_LOGIN
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']
DEBUG_PLUGINS
set to true to log plugin load sequence.
public
mixed
DEBUG_PLUGINS
= isset($_zp_conf_vars['debug_plugins']) && $_zp_conf_vars['debug_plugins']
EDITOR_SANITIZE_LEVEL
public
mixed
EDITOR_SANITIZE_LEVEL
= 1
EDITOR_SANITIZE_LEVEL
public
mixed
EDITOR_SANITIZE_LEVEL
= 4
EDITOR_SANITIZE_LEVEL
public
mixed
EDITOR_SANITIZE_LEVEL
= 4
ELFINDER_PHP_ROOT_PATH
public
mixed
ELFINDER_PHP_ROOT_PATH
= \dirname(__FILE__)
ENT_SUBSTITUTE
public
mixed
ENT_SUBSTITUTE
= \defined('ENT_IGNORE') ? \ENT_IGNORE : 8
EXACT_TAG_MATCH
public
mixed
EXACT_TAG_MATCH
= \getOption('exact_tag_match')
EXPLAIN_SELECTS
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']
FEATURE_PLUGIN
Defines the bitmask for load order priority of feature plugins
public
mixed
FEATURE_PLUGIN
= 2048
FILE_MOD
public
mixed
FILE_MOD
= \CHMOD_VALUE & 0666
FILESYSTEM_CHARSET
public
mixed
FILESYSTEM_CHARSET
= $data
FILESYSTEM_CHARSET
public
mixed
FILESYSTEM_CHARSET
= 'UTF-8'
FOLDER_MOD
public
mixed
FOLDER_MOD
= \CHMOD_VALUE | 0311
FULLIMAGE_WATERMARK
public
mixed
FULLIMAGE_WATERMARK
= \getOption('fullsizeimage_watermark')
FULLWEBPATH
public
mixed
FULLWEBPATH
= \SERVER_HTTP_HOST . \WEBPATH
GALLERY_SECURITY
public
mixed
GALLERY_SECURITY
= @$data['gallery_security']
GALLERY_SESSION
public
mixed
GALLERY_SESSION
= @$data['album_session']
GD_FREETYPE
public
mixed
GD_FREETYPE
= (bool) $this->info['FreeType']
GD_FREETYPE_SAMPLE
public
mixed
GD_FREETYPE_SAMPLE
= 'The quick brown fox jumps over the lazy dog'
GD_FREETYPE_SAMPLE_CHARS
public
mixed
GD_FREETYPE_SAMPLE_CHARS
= strlen('GD_FREETYPE_SAMPLE')
GETID3_HELPERAPPSDIR
public
mixed
GETID3_HELPERAPPSDIR
= $helperappsdir . DIRECTORY_SEPARATOR
GETID3_INCLUDEPATH
public
mixed
GETID3_INCLUDEPATH
= \dirname(__FILE__) . \DIRECTORY_SEPARATOR
GETID3_INCLUDEPATH
public
mixed
GETID3_INCLUDEPATH
= \SERVERPATH . '/' . \ZENFOLDER . '/' . \PLUGIN_FOLDER . '/class-video/getid3/'
GETID3_LIBXML_OPTIONS
public
mixed
GETID3_LIBXML_OPTIONS
= \LIBXML_NOENT | \LIBXML_NONET | \LIBXML_NOWARNING
GETID3_OS_ISWINDOWS
public
mixed
GETID3_OS_ISWINDOWS
= \stripos(\PHP_OS, 'WIN') === 0
GETID3_TEMP_DIR
public
mixed
GETID3_TEMP_DIR
= $temp_dir
GOOGLE_SITEMAP
public
mixed
GOOGLE_SITEMAP
= \getOption('sitemap_google')
GRAPHICS_LIBRARY
public
mixed
GRAPHICS_LIBRARY
= $_zp_cachefile_suffix['Library']
HASH_SEED
public
mixed
HASH_SEED
= \getOption('extra_auth_hash_text')
HTACCESS_VERSION
public
mixed
HTACCESS_VERSION
= '1.4.12'
IM_SUFFIX
public
mixed
IM_SUFFIX
= \getOption('mod_rewrite_image_suffix')
IMAGE_CACHE_SUFFIX
public
mixed
IMAGE_CACHE_SUFFIX
= \getOption('image_cache_suffix')
IMAGE_SORT_DIRECTION
public
mixed
IMAGE_SORT_DIRECTION
= \getOption('image_sortdirection')
IMAGE_SORT_TYPE
public
mixed
IMAGE_SORT_TYPE
= \getOption('image_sorttype')
IMAGE_WATERMARK
public
mixed
IMAGE_WATERMARK
= \getOption('fullimage_watermark')
IMAGEMAGICK_REQUIRED_VERSION
public
mixed
IMAGEMAGICK_REQUIRED_VERSION
= '6.3.8'
IMAGICK_REQUIRED_VERSION
public
mixed
IMAGICK_REQUIRED_VERSION
= '3.0.0'
IP_TIED_COOKIES
public
mixed
IP_TIED_COOKIES
= \getOption('IP_tied_cookies')
LIST_RIGHTS
public
mixed
LIST_RIGHTS
= \NO_RIGHTS
LOCAL_CHARSET
public
mixed
LOCAL_CHARSET
= $data
LOCAL_CHARSET
public
mixed
LOCAL_CHARSET
= 'UTF-8'
LOCALE_TYPE
public
mixed
LOCALE_TYPE
= 0
LOGS_MOD
public
mixed
LOGS_MOD
= \DATA_MOD
MANAGED_OBJECT_RIGHTS_EDIT
public
mixed
MANAGED_OBJECT_RIGHTS_EDIT
= 1
MANAGED_OBJECT_RIGHTS_UPLOAD
public
mixed
MANAGED_OBJECT_RIGHTS_UPLOAD
= 2
MANAGED_OBJECT_RIGHTS_VIEW
public
mixed
MANAGED_OBJECT_RIGHTS_VIEW
= 4
MAX_SIZE
public
mixed
MAX_SIZE
= \getOption('image_max_size')
MEMBERS_ONLY_COMMENTS
public
mixed
MEMBERS_ONLY_COMMENTS
= \getOption('comment_form_members_only')
MENU_TRUNCATE_INDICATOR
public
mixed
MENU_TRUNCATE_INDICATOR
= \getOption('menu_truncate_indicator')
MENU_TRUNCATE_STRING
public
mixed
MENU_TRUNCATE_STRING
= \getOption('menu_truncate_string')
METATAG_LOCALE_TYPE
public
mixed
METATAG_LOCALE_TYPE
= 0
MOD_REWRITE
public
mixed
MOD_REWRITE
= \getOption('mod_rewrite')
MUTEX_FOLDER
Defines the mutex folder
public
mixed
MUTEX_FOLDER
= '.mutex'
NEWS_POSITION_NORMAL
public
mixed
NEWS_POSITION_NORMAL
= 0
NEWS_POSITION_STICK_TO_TOP
public
mixed
NEWS_POSITION_STICK_TO_TOP
= 9
NEWS_POSITION_STICKY
public
mixed
NEWS_POSITION_STICKY
= 1
NO_WATERMARK
public
mixed
NO_WATERMARK
= '!'
OBJECT_CACHE_DEPTH
public
mixed
OBJECT_CACHE_DEPTH
= 150
OFFSET_PATH
used in sorting the images within and album
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
This script is used to create dynamic albums from a search.
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
admin-edit.php editing of albums.
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
user_groups log--tabs
public
mixed
OFFSET_PATH
= 1
Tags
OFFSET_PATH
provides the Options tab of admin
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
provides the Plugins tab of admin
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
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
OFFSET_PATH
provides the TAGS tab of admin
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
Theme file editor
public
mixed
OFFSET_PATH
= 1
Tags
OFFSET_PATH
provides the Themes tab of admin
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
provides the Upload tab of admin
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
provides the Options tab of admin
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
admin.php is the main script for administrative functions.
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
public
mixed
OFFSET_PATH
= 0
OFFSET_PATH
public
mixed
OFFSET_PATH
= 2
OFFSET_PATH
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
public
mixed
OFFSET_PATH
= 2
OFFSET_PATH
public
mixed
OFFSET_PATH
= 2
OFFSET_PATH
Used for changing permissions on a mass basis
public
mixed
OFFSET_PATH
= 2
OFFSET_PATH
Used for setting theme/plugin default options
public
mixed
OFFSET_PATH
= 2
OFFSET_PATH
Used for setting theme/plugin default options
public
mixed
OFFSET_PATH
= 2
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
Database quick reference
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
Detailed Gallery Statistics
public
mixed
OFFSET_PATH
= 3
This plugin shows statistical graphs and info about your gallery's images and albums
OFFSET_PATH
Displays which HTTP headers your site sends
public
mixed
OFFSET_PATH
= 3
Tags
OFFSET_PATH
Displays locale information of the system
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
Maintenance mode utility based on the former site_upgrade plugin
public
mixed
OFFSET_PATH
= 3
Tags
OFFSET_PATH
Displays the PHP configuration information
public
mixed
OFFSET_PATH
= 3
Tags
OFFSET_PATH
Use this utility to reset your album thumbnails to either "random" or from an ordered field query
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
GDPR data export tool
public
mixed
OFFSET_PATH
= 3
Tags
OFFSET_PATH
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
OFFSET_PATH
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
OFFSET_PATH
Zenphoto site cloner
public
mixed
OFFSET_PATH
= 4
OFFSET_PATH
public
mixed
OFFSET_PATH
= 4
OFFSET_PATH
provides the Comments tab of admin
public
mixed
OFFSET_PATH
= 1
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
Check for use of deprecated functions
public
mixed
OFFSET_PATH
= 4
Tags
OFFSET_PATH
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!
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
The Matomo statistis page if widgets are defined
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
public
mixed
OFFSET_PATH
= 4
OFFSET_PATH
public
mixed
OFFSET_PATH
= 4
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
public
mixed
OFFSET_PATH
= 4
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
This is the "rewrite rules" tab
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
Collects and analyzes searches
public
mixed
OFFSET_PATH
= 4
Tags
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
Sitemap Tools
public
mixed
OFFSET_PATH
= 3
Tool to generate sitemaps
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
user_groups plugin--tabs
public
mixed
OFFSET_PATH
= 4
Tags
OFFSET_PATH
user_groups plugin--tabs
public
mixed
OFFSET_PATH
= 4
Tags
OFFSET_PATH
public
mixed
OFFSET_PATH
= 3
OFFSET_PATH
zenpage admin-categories.php
public
mixed
OFFSET_PATH
= 4
Tags
OFFSET_PATH
zenpage admin-edit.php
public
mixed
OFFSET_PATH
= 4
Tags
OFFSET_PATH
zenpage admin-news-articles.php
public
mixed
OFFSET_PATH
= 4
Tags
OFFSET_PATH
zenpage admin-pages.php
public
mixed
OFFSET_PATH
= 4
Tags
OPEN_IMAGE_CACHE
public
mixed
OPEN_IMAGE_CACHE
= !\getOption('protected_image_cache')
OPTION_TYPE_CHECKBOX
public
mixed
OPTION_TYPE_CHECKBOX
= 1
OPTION_TYPE_CHECKBOX_ARRAY
public
mixed
OPTION_TYPE_CHECKBOX_ARRAY
= 6
OPTION_TYPE_CHECKBOX_UL
public
mixed
OPTION_TYPE_CHECKBOX_UL
= 7
OPTION_TYPE_CLEARTEXT
public
mixed
OPTION_TYPE_CLEARTEXT
= 9
OPTION_TYPE_COLOR_PICKER
public
mixed
OPTION_TYPE_COLOR_PICKER
= 8
OPTION_TYPE_CUSTOM
public
mixed
OPTION_TYPE_CUSTOM
= 2
OPTION_TYPE_NOTE
public
mixed
OPTION_TYPE_NOTE
= 10
OPTION_TYPE_PASSWORD
public
mixed
OPTION_TYPE_PASSWORD
= 11
OPTION_TYPE_RADIO
public
mixed
OPTION_TYPE_RADIO
= 4
OPTION_TYPE_RICHTEXT
public
mixed
OPTION_TYPE_RICHTEXT
= 12
OPTION_TYPE_SELECTOR
public
mixed
OPTION_TYPE_SELECTOR
= 5
OPTION_TYPE_TEXTAREA
public
mixed
OPTION_TYPE_TEXTAREA
= 3
OPTION_TYPE_TEXTBOX
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
PHP_INT_MAX
public
mixed
PHP_INT_MAX
= 2147483647
PHP_INT_MIN
public
mixed
PHP_INT_MIN
= ~PHP_INT_MAX
PLUGIN_FOLDER
Defines the name of the core extensions folder
public
mixed
PLUGIN_FOLDER
= 'zp-extensions'
PLUGIN_PRIORITY
Defines the bitmask for load order priority of standard plugins
public
mixed
PLUGIN_PRIORITY
= 1023
PLUGINS_PER_PAGE
public
mixed
PLUGINS_PER_PAGE
= \max(1, \getOption('plugins_per_page'))
PLUGINS_PER_PAGE
public
mixed
PLUGINS_PER_PAGE
= \max(1, \getOption('plugins_per_page'))
PRIMARY_INSTALLATION
public
mixed
PRIMARY_INSTALLATION
= true
PROTOCOL
public
mixed
PROTOCOL
= 'http'
PROTOCOL
public
mixed
PROTOCOL
= 'http'
RECORD_LIMIT
public
mixed
RECORD_LIMIT
= 5
SAFE_MODE
public
mixed
SAFE_MODE
= \false
SAFE_MODE_ALBUM_SEP
public
mixed
SAFE_MODE_ALBUM_SEP
= ''
SEARCH_CACHE_DURATION
public
mixed
SEARCH_CACHE_DURATION
= \getOption('search_cache_duration')
SEARCH_DURATION
public
mixed
SEARCH_DURATION
= 3000
SEO_FULLWEBPATH
public
mixed
SEO_FULLWEBPATH
= \FULLWEBPATH
SEO_FULLWEBPATH
public
mixed
SEO_FULLWEBPATH
= \seo_locale::localePath(\true)
SEO_WEBPATH
public
mixed
SEO_WEBPATH
= \WEBPATH
SEO_WEBPATH
public
mixed
SEO_WEBPATH
= \seo_locale::localePath()
SERVER_HTTP_HOST
public
mixed
SERVER_HTTP_HOST
= \PROTOCOL . "://" . $_SERVER['HTTP_HOST']
SERVER_PROTOCOL
public
mixed
SERVER_PROTOCOL
= 'http'
SERVERCACHE
public
mixed
SERVERCACHE
= \SERVERPATH . '/' . \CACHEFOLDER
SERVERPATH
public
mixed
SERVERPATH
= $const_serverpath
SERVERPATH
public
mixed
SERVERPATH
= $_zp_setup_serverpath
SERVERPATH
public
mixed
SERVERPATH
= $_zp_setup_serverpath
SETUPLOG
public
mixed
SETUPLOG
= $_zp_setup_serverpath . '/' . \DATA_FOLDER . '/setup.log'
SITE_LOCALE
public
mixed
SITE_LOCALE
= 'en_US'
SITEMAP_CHUNK
public
mixed
SITEMAP_CHUNK
= \getOption('sitemap_processing_chunk')
SITEMAP_LOCALE_TYPE
public
mixed
SITEMAP_LOCALE_TYPE
= 0
SORT_FLAG_CASE
Defines sort flag case
public
mixed
SORT_FLAG_CASE
= 0
SORT_NATURAL
Defines if sorting should be natural order
public
mixed
SORT_NATURAL
= 0
STATIC_CACHE_FOLDER
Defines the name of the html cache folder
public
mixed
STATIC_CACHE_FOLDER
= "cache_html"
SYMLINK
Defines if symlinks are supported on the server
public
mixed
SYMLINK
= \function_exists('symlink') && \strpos(@\ini_get("suhosin.executor.func.blacklist"), 'symlink') === \false
TEST_RELEASE
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)
TEXT_INPUT_SIZE
public
mixed
TEXT_INPUT_SIZE
= 48
TEXT_INPUT_SIZE_SHORT
public
mixed
TEXT_INPUT_SIZE_SHORT
= 30
TEXTAREA_COLUMNS
public
mixed
TEXTAREA_COLUMNS
= 50
TEXTAREA_COLUMNS_SHORT
public
mixed
TEXTAREA_COLUMNS_SHORT
= 32
THEME_PLUGIN
Defines the bitmask for load order priority of theme plugins
public
mixed
THEME_PLUGIN
= 1024
THEMEFOLDER
Defines the name of the themes folder
public
mixed
THEMEFOLDER
= 'themes'
THUMB_WATERMARK
public
mixed
THUMB_WATERMARK
= \getOption('Image_watermark')
TIME_FORMAT
public
mixed
TIME_FORMAT
= \trim(\strval(\getOption('time_format')))
UPLOAD_ERR_BLOCKED
public
mixed
UPLOAD_ERR_BLOCKED
= -2
UPLOAD_ERR_QUOTA
Initialize globals for Admin
public
mixed
UPLOAD_ERR_QUOTA
= -1
UPLOAD_FOLDER
Defines name of the non albums upload folder
public
mixed
UPLOAD_FOLDER
= 'uploaded'
USE_CAPTCHA
public
mixed
USE_CAPTCHA
= 8
USER_PLUGIN_FOLDER
Defines the user 3rd party plugin folder outside the Zenphoto core folder
public
mixed
USER_PLUGIN_FOLDER
= 'plugins'
USER_RIGHTS
public
mixed
USER_RIGHTS
= \NO_RIGHTS
USERS_PER_PAGE
public
mixed
USERS_PER_PAGE
= \max(1, \getOption('users_per_page'))
USERS_PER_PAGE
public
mixed
USERS_PER_PAGE
= \max(1, \getOption('users_per_page'))
UTF8_IMAGE_URI
public
mixed
UTF8_IMAGE_URI
= \getOption('UTF8_image_URI')
UTILITIES_FOLDER
Defines the name of the core utlitlites folder
public
mixed
UTILITIES_FOLDER
= 'utilities'
VIEW_ALL_RIGHTS
public
mixed
VIEW_ALL_RIGHTS
= \ALL_ALBUMS_RIGHTS | \ALL_PAGES_RIGHTS | \ALL_NEWS_RIGHTS
VIEW_FULLIMAGE_RIGHTS
public
mixed
VIEW_FULLIMAGE_RIGHTS
= \NO_RIGHTS
VIEW_GALLERY_RIGHTS
public
mixed
VIEW_GALLERY_RIGHTS
= \NO_RIGHTS
VIEW_SEARCH_RIGHTS
public
mixed
VIEW_SEARCH_RIGHTS
= \NO_RIGHTS
WATERMARK_FULL
public
mixed
WATERMARK_FULL
= 4
WATERMARK_IMAGE
public
mixed
WATERMARK_IMAGE
= 1
WATERMARK_THUMB
public
mixed
WATERMARK_THUMB
= 2
WEBPATH
public
mixed
WEBPATH
= $const_webpath
WEBPATH
public
mixed
WEBPATH
= $const_webpath
ZENFOLDER
Defines the name of the Zenphoto core folder (zp-core)
public
mixed
ZENFOLDER
= 'zp-core'
ZENPAGE_COMBINEWS
Some global variable setup
public
mixed
ZENPAGE_COMBINEWS
= \false
ZENPHOTO_LOCALE
public
mixed
ZENPHOTO_LOCALE
= \setMainDomain()
ZENPHOTO_VERSION
Defines the Zenphoto version
public
mixed
ZENPHOTO_VERSION
= '1.6.5'
ZP_ALBUM
public
mixed
ZP_ALBUM
= 2
ZP_ALBUM_LINKED
public
mixed
ZP_ALBUM_LINKED
= 64
ZP_ARTICLES_PER_PAGE
public
mixed
ZP_ARTICLES_PER_PAGE
= \getOption("zenpage_articles_per_page") >= 1 ? \getOption("zenpage_articles_per_page") : 1
ZP_COMBINEWS
public
mixed
ZP_COMBINEWS
= \false
ZP_COMMENT
public
mixed
ZP_COMMENT
= 8
ZP_IMAGE
public
mixed
ZP_IMAGE
= 4
ZP_IMAGE_LINKED
public
mixed
ZP_IMAGE_LINKED
= 128
ZP_INDEX
public
mixed
ZP_INDEX
= 1
ZP_LAST_MODIFIED
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'
ZP_NEWS_ENABLED
public
mixed
ZP_NEWS_ENABLED
= \false
ZP_PAGES_ENABLED
public
mixed
ZP_PAGES_ENABLED
= \false
ZP_READ_MORE
public
mixed
ZP_READ_MORE
= \getOption("zenpage_read_more")
ZP_SEARCH
public
mixed
ZP_SEARCH
= 16
ZP_SEARCH_LINKED
public
mixed
ZP_SEARCH_LINKED
= 32
ZP_SHORTEN_LENGTH
public
mixed
ZP_SHORTEN_LENGTH
= \getOption('zenpage_text_length')
ZP_SHORTENINDICATOR
public
mixed
ZP_SHORTENINDICATOR
= $shortenindicator = \getOption('zenpage_textshorten_indicator')
ZP_ZENPAGE_NEWS_ARTICLE
public
mixed
ZP_ZENPAGE_NEWS_ARTICLE
= 512
ZP_ZENPAGE_NEWS_CATEGORY
public
mixed
ZP_ZENPAGE_NEWS_CATEGORY
= 1024
ZP_ZENPAGE_NEWS_DATE
public
mixed
ZP_ZENPAGE_NEWS_DATE
= 2048
ZP_ZENPAGE_NEWS_PAGE
public
mixed
ZP_ZENPAGE_NEWS_PAGE
= 256
ZP_ZENPAGE_PAGE
public
mixed
ZP_ZENPAGE_PAGE
= 4096
ZP_ZENPAGE_SINGLE
public
mixed
ZP_ZENPAGE_SINGLE
= 8192
Functions
printAdminFooter()
Print the footer <div> for the bottom of all admin pages.
printAdminFooter([string $addl = '' ]) : mixed
Parameters
- $addl : string = ''
-
additional text to output on the footer.
Tags
datepickerJS()
datepickerJS() : mixed
printAdminHeader()
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
Parameters
- $tab : string
-
the album page
- $subtab : string = NULL
-
the sub-tab if any
printSortableHead()
printSortableHead() : mixed
printLogoAndLinks()
Print the html required to display the ZP logo and links in the top section of the admin page.
printLogoAndLinks() : mixed
Tags
printTabs()
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
Tags
getSubtabs()
getSubtabs() : mixed
printSubtabs()
printSubtabs() : mixed
setAlbumSubtabs()
setAlbumSubtabs(mixed $album) : mixed
Parameters
- $album : mixed
handleDeprecatedMenuGlobals()
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.
Tags
checked()
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
Parameters
- $checked : mixed
- $current : mixed
customOptions()
customOptions(mixed $optionHandler[, mixed $indent = "" ][, mixed $album = NULL ][, mixed $showhide = false ][, mixed $supportedOptions = NULL ][, mixed $theme = false ][, mixed $initial = 'none' ][, mixed $extension = NULL ]) : mixed
Parameters
- $optionHandler : mixed
- $indent : mixed = ""
- $album : mixed = NULL
- $showhide : mixed = false
- $supportedOptions : mixed = NULL
- $theme : mixed = false
- $initial : mixed = 'none'
- $extension : mixed = NULL
processCustomOptionSave()
processCustomOptionSave(mixed $returntab[, mixed $themename = NULL ][, mixed $themealbum = NULL ]) : mixed
Parameters
- $returntab : mixed
- $themename : mixed = NULL
- $themealbum : mixed = NULL
standardThemeOptions()
Set defaults for standard theme options incase the theme has not done so
standardThemeOptions(string $theme, mixed $album) : mixed
Parameters
- $theme : string
- $album : mixed
postIndexEncode()
Encodes for use as a $_POST index
postIndexEncode(string $str) : mixed
Parameters
- $str : string
postIndexDecode()
Decodes encoded $_POST index
postIndexDecode(string $str) : string
Parameters
- $str : string
Return values
stringgenerateRadiobuttonsFromArray()
Prints radio buttons from an array
generateRadiobuttonsFromArray(string $currentvalue, string $list, string $option[, bool $behind = false ][, mixed $class = 'checkboxlabel' ][, mixed $disabled = NULL ]) : mixed
Parameters
- $currentvalue : string
-
The current selected value
- $list : string
-
the array of the list items form is localtext => buttonvalue
- $option : string
-
the name of the option for the input field name
- $behind : bool = false
-
set true to have the "text" before the button
- $class : mixed = 'checkboxlabel'
- $disabled : mixed = NULL
generateUnorderedListFromArray()
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
Parameters
- $currentValue : array<string|int, mixed>
-
list of items to be flagged as checked
- $list : array<string|int, mixed>
-
the elements of the select list
- $prefix : string
-
prefix of the input item
- $alterrights : string
-
are the items changable.
- $sort : bool
-
true for sorted list
- $localize : bool
-
true if the list local key is text for the item
- $class : string = NULL
-
optional class for items
- $extra : mixed = NULL
tagSelector()
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
Parameters
- $that : object
-
Object for which to get the tags
- $postit : string
-
prefix to prepend for posting
- $showCounts : bool = false
-
set to true to get tag count displayed
- $mostused : mixed = false
- $addnew : mixed = true
- $resizeable : mixed = false
- $class : mixed = 'checkTagsAuto'
printAlbumEditForm()
emits the html for editing album information called in edit album and mass edit
printAlbumEditForm(string $index, object $album[, bool $buttons = true ]) : mixed
Parameters
- $index : string
-
the index of the entry in mass edit or '0' if single album
- $album : object
-
the album object
- $buttons : bool = true
-
set true for "apply" buttons
Tags
printAlbumButtons()
puts out the maintenance buttons for an album
printAlbumButtons(object $album) : mixed
Parameters
- $album : object
-
is the album being emitted
printAlbumLegend()
printAlbumLegend() : mixed
printAlbumEditRow()
puts out a row in the edit album table
printAlbumEditRow(object $album, bool $show_thumb, object $owner) : mixed
Parameters
- $album : object
-
is the album being emitted
- $show_thumb : bool
-
set to false to show thumb standin image rather than album thumb
- $owner : object
-
the parent album (or NULL for gallery)
processAlbumEdit()
processes the post from the above
processAlbumEdit(int $index, object $album, string &$redirectto) : string
Parameters
- $index : int
-
the index of the entry in mass edit or 0 if single album
- $album : object
-
the album object
- $redirectto : string
-
used to redirect page refresh on move/copy/rename
Tags
Return values
string —error flag if passwords don't match
processImageEdit()
Process the image edit form posted
processImageEdit(obj $image, type $index[, bool $massedit = true ]) : mixed
Parameters
- $image : obj
-
Image object
- $index : type
-
Index of the image if within the images list or 0 if single image edit
- $massedit : bool = true
-
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()
adminPageNav(mixed $pagenum, mixed $totalpages, mixed $adminpage, mixed $parms[, mixed $tab = '' ]) : mixed
Parameters
- $pagenum : mixed
- $totalpages : mixed
- $adminpage : mixed
- $parms : mixed
- $tab : mixed = ''
print_language_string_list()
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
Parameters
- $dbstring : string
-
either a serialized languag string array or a single string
- $name : string
-
the prefix for the label, id, and name tags
- $textbox : bool = false
-
set to true for a textbox rather than a text field
- $locale : string = NULL
-
optional locale of the translation desired
- $edit : string = ''
-
optional class
- $wide : int = TEXT_INPUT_SIZE
-
column size. true or false for the standard or short sizes. Or pass a column size
- $ulclass : string = 'language_string_list'
-
set to the class for the UL element
- $rows : int = 6
-
set to the number of rows to show.
process_language_string_save()
process the post of a language string form
process_language_string_save(string $name[, $sanitize_level = 3 ]) : string
Parameters
- $name : string
-
the prefix for the label, id, and name tags
- $sanitize_level : = 3
-
the type of sanitization required
Return values
stringgetTagOrder()
Returns the desired tagsort order (0 for alphabetic, 1 for most used)
getTagOrder() : int
Return values
intunzip()
Unzips an image archive
unzip(file $file, string $dir) : mixed
Parameters
- $file : file
-
the archive
- $dir : string
-
where the images go
is_zip()
Checks for a zip file
is_zip(string $filename) : bool
Parameters
- $filename : string
-
name of the file
Return values
boolisolate()
Extracts and returns a 'statement' from a PHP script so that it may be 'evaled'
isolate(string $target, string $str) : string
Parameters
- $target : string
-
the assignment variable to match on
- $str : string
-
the PHP script
Return values
stringlistDirectoryFiles()
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:
Parameters
- $dir : string
-
directory
Tags
Return values
array<string|int, mixed>themeIsEditable()
Check if a theme is editable (ie not a bundled theme)
themeIsEditable( $theme) : bool
Parameters
Tags
Return values
boolzenPhotoTheme()
zenPhotoTheme(mixed $theme) : mixed
Parameters
- $theme : mixed
copyThemeDirectory()
Copy a theme directory to create a new custom theme
copyThemeDirectory( $source, $target, mixed $newname) : bool|string
Parameters
Tags
Return values
bool|string —either true or an error message
deleteThemeDirectory()
Deletes a theme
deleteThemeDirectory(string $source) : bool
Parameters
- $source : string
-
Full serverpath of the theme
Return values
boolcurrentRelativeURL()
Return URL of current admin page
currentRelativeURL() : string
Tags
Return values
string —current URL
getParentAlbumsAdmin()
Returns an array of the names of the parents of the current album.
getParentAlbumsAdmin(object $album) : array<string|int, mixed>
Parameters
- $album : object
-
optional album object to use inseted of the current album
Return values
array<string|int, mixed>getAlbumBreadcrumbAdmin()
getAlbumBreadcrumbAdmin(mixed $album) : mixed
Parameters
- $album : mixed
removeParentAlbumNames()
Removes the parent album name so that we can print a album breadcrumb with them
removeParentAlbumNames(object $album) : string
Parameters
- $album : object
-
Object of the album
Return values
stringprintAdminRightsTable()
Outputs the rights checkbox table for admin
printAdminRightsTable( $id, string $background, string $alterrights, bit $rights) : mixed
Parameters
printManagedObjects()
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
Parameters
- $type : string
-
the kind of list
- $objlist : array<string|int, mixed>
-
list of objects
- $alterrights : string
-
are the items changable
- $userobj : object
-
the user
- $prefix_id : mixed
- $kind : string
-
user, group, or template
- $flag : mixed
processRights()
processes the post of administrator rights
processRights(int $i) : bit
Parameters
- $i : int
-
the admin row number
Return values
bitprocessManagedObjects()
processManagedObjects(mixed $i, mixed &$rights) : mixed
Parameters
- $i : mixed
- $rights : mixed
getCheckboxState()
Returns the value of a checkbox form item
getCheckboxState(string $id) : int
Parameters
- $id : string
-
the $_REQUEST index
Return values
int —(0 or 1)
standardScripts()
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>
Return values
array<string|int, mixed>getWatermarks()
Returns a merged list of available watermarks
getWatermarks() : array<string|int, mixed>
Return values
array<string|int, mixed>processOrder()
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),...]
Parameters
Return values
array<string|int, mixed>postAlbumSort()
POST handler for album tree sorts
postAlbumSort(int $parentid) : mixed
Parameters
- $parentid : int
-
id of owning album
printNestedAlbumsList()
Prints the sortable nested albums list returns true if nesting levels exceede the database container
printNestedAlbumsList(mixed $albums, bool $show_thumb, object $owner) : bool
Parameters
- $albums : mixed
- $show_thumb : bool
-
set false to use thumb standin image.
- $owner : object
-
the album object of the owner or NULL for the gallery
Return values
boolprintEditDropdown()
Prints the dropdown menu for the nesting level depth for the album sorting
printEditDropdown(mixed $subtab, mixed $nestinglevels, mixed $nesting) : mixed
Parameters
- $subtab : mixed
- $nestinglevels : mixed
- $nesting : mixed
processEditSelection()
processEditSelection(mixed $subtab) : mixed
Parameters
- $subtab : mixed
printBulkActions()
Edit tab bulk actions drop-down
printBulkActions(array<string|int, mixed> $checkarray[, bool $checkAll = false ]) : mixed
Parameters
- $checkarray : array<string|int, mixed>
-
the list of actions
- $checkAll : bool = false
-
set true to include check all box
bulkActionRedirect()
common redirector for bulk action handling return
bulkActionRedirect(string $action) : mixed
Parameters
- $action : string
bulkTags()
Process the bulk tags
bulkTags() : array<string|int, mixed>
Return values
array<string|int, mixed>processAlbumBulkActions()
Processes the check box bulk actions for albums
processAlbumBulkActions() : mixed
processImageBulkActions()
Handles Image bulk actions
processImageBulkActions( $album) : mixed
Parameters
processCommentBulkActions()
Processes the check box bulk actions for comments
processCommentBulkActions() : mixed
codeblocktabsJS()
Codeblock tabs JavaScript code
codeblocktabsJS() : mixed
printCodeblockEdit()
prints codeblock edit boxes
printCodeblockEdit(object $obj, int $id) : mixed
Parameters
- $obj : object
- $id : int
processCodeblockSave()
handles saveing of codeblock edits
processCodeblockSave(int $id) : string
Parameters
- $id : int
Return values
stringadmin_securityChecks()
Standard admin pages checks
admin_securityChecks(bit $rights, mixed $return) : mixed
Parameters
- $rights : bit
- $return : mixed
minDiff()
getPageSelector "diff" function
minDiff(string $string1, string2 $string2) : mixed
returns the shortest string difference
Parameters
- $string1 : string
- $string2 : string2
fullText()
getPageSelector "diff" function
fullText(string $string1, string $string2) : string
Used when you want getPgeSelector to show the full text of the items
Parameters
- $string1 : string
- $string2 : string
Return values
stringdateDiff()
getPageSelector "diff" function
dateDiff(string $date1, string $date2) : string
returns the shortest "date" difference
Parameters
- $date1 : string
- $date2 : string
Return values
stringgetPageSelector()
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>
Parameters
- $list : array<string|int, mixed>
- $itmes_per_page : int
- $diff : string = 'fullText'
-
"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.
Return values
array<string|int, mixed>printPageSelector()
printPageSelector(mixed $pagenumber, mixed $rangeset, mixed $script, mixed $queryParams) : mixed
Parameters
- $pagenumber : mixed
- $rangeset : mixed
- $script : mixed
- $queryParams : mixed
unQuote()
Strips off quotes from the strng
unQuote( $string) : mixed
Parameters
admin_album_list()
Returns an option list of administrators who can own albums or images
admin_album_list(string $owner) : string
Parameters
- $owner : string
Return values
stringgetLogTabs()
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>
Tags
Return values
array<string|int, mixed>getDefaultLogTabs()
Gets an array log tab names and localized (gettexted) log titles
getDefaultLogTabs() : array<string|int, mixed>
Tags
Return values
array<string|int, mixed>getLogFiles()
Gets a nested array with the log type (tab name) and corresponding log files
getLogFiles() : array<string|int, mixed>
Tags
Return values
array<string|int, mixed>printLogSelector()
Prints the selector for logfiles of the current log tab
printLogSelector([string $currentlogtab = '' ][, string $currentlogfile = '' ][, array<string|int, mixed> $logfiles = array() ]) : mixed
Parameters
- $currentlogtab : string = ''
-
Current log tab
- $currentlogfile : string = ''
-
Current log file selected
- $logfiles : array<string|int, mixed> = array()
-
Array of logfiles
Tags
getPluginTabs()
Figures out which plugin tabs to display
getPluginTabs() : mixed
getAdminThumbSizes()
Gets an array with the size values for the admin thumb generation
getAdminThumbSizes(obj $imageobj[, string $size = 'small' ]) : array<string|int, mixed>
Parameters
- $imageobj : obj
-
The image object
- $size : string = 'small'
-
Adminthumb sizeame: 'large', 'small', 'large-uncropped', 'small-uncropped'
Tags
Return values
array<string|int, mixed>getAdminThumb()
Gets the URL of the adminthumb
getAdminThumb(obj $imageobj[, string $size = 'small' ]) : string
Parameters
- $imageobj : obj
-
The image object
- $size : string = 'small'
-
Adminthumb sizeame: 'large', 'small', 'large-uncropped', 'small-uncropped'
Return values
stringgetSizeAdminThumb()
Returns an array with width and height of the resized image
getSizeAdminThumb(obj $imageobj[, string $size = 'small' ]) : array<string|int, mixed>
Parameters
- $imageobj : obj
-
The image object
- $size : string = 'small'
-
Adminthumb sizeame: 'large', 'small', 'large-uncropped', 'small-uncropped'
Tags
Return values
array<string|int, mixed>getAdminThumbHTML()
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
Parameters
- $imageobj : obj
-
The image object
- $size : string = 'small'
-
Adminthumb sizeame: 'large', 'small', 'large-uncropped', 'small-uncropped'
- $class : string = null
-
Class name(s) to attach
- $id : string = null
-
ID to attach
- $alt : string = null
-
Alt attribute
- $title : string = null
-
Title attribute
Tags
Return values
stringprintAdminThumb()
Prints an admin thumb
printAdminThumb(obj $imageobj[, string $size = 'small' ][, string $class = null ][, string $id = null ][, string $alt = null ][, string $title = null ]) : string
Parameters
- $imageobj : obj
-
The image object
- $size : string = 'small'
-
Adminthumb sizeame: 'large', 'small', 'large-uncropped', 'small-uncropped'
- $class : string = null
-
Class name(s) to attach
- $id : string = null
-
ID to attach
- $alt : string = null
-
Alt attribute
- $title : string = null
-
Title attribute
Tags
Return values
stringprocessCredentials()
handles save of user/password
processCredentials(object $object[, mixed $suffix = '' ]) : mixed
Parameters
- $object : object
- $suffix : mixed = ''
consolidatedEditMessages()
consolidatedEditMessages(mixed $subtab) : mixed
Parameters
- $subtab : mixed
getThemeFiles()
returns an array of the theme scripts not in the exclude array
getThemeFiles(array<string|int, mixed> $exclude) : array<string|int, mixed>
Parameters
- $exclude : array<string|int, mixed>
-
those scripts to ignore
Return values
array<string|int, mixed>checkAlbumParentid()
Checks for bad parentIDs from old move/copy bug
checkAlbumParentid(unknown_type $albumname, unknown_type $id, mixed $recorder) : mixed
Parameters
- $albumname : unknown_type
- $id : unknown_type
- $recorder : mixed
clonedFrom()
clonedFrom() : mixed
checkAlbumimagesort()
Make sure the albumimagesort is only an allowed value. Otherwise returns nothing.
checkAlbumimagesort(string $val[, string $type = 'albumimagesort' ]) : string
Parameters
- $val : string
- $type : string = 'albumimagesort'
-
'albumimagesort' or 'albumimagesort_status'
Return values
stringprintLastChangeInfo()
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
Parameters
- $obj : obj
-
Object of any item type
Tags
getSortByOptions()
Returns the option array for the sort by selectors for gallery, albums and images
getSortByOptions(string $type) : array<string|int, mixed>
Parameters
- $type : string
-
"albums" (also for gallery), "albums-dynamic", 'images' "image-edit" (the images edit tab backend only ordering) "pages" and "news" for Zenpage items
Tags
Return values
array<string|int, mixed>getSortByStatusOptions()
Returns an array of the status order options for all items
getSortByStatusOptions() : array<string|int, mixed>
Tags
Return values
array<string|int, mixed>checkSchedulePublishingNotes()
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
Parameters
- $obj : obj
-
Image, album, news article or page object
Tags
Return values
boolprintScheduledPublishingNotes()
Prints various notes regarding the scheduled publishing status for single edit pages
printScheduledPublishingNotes(obj $obj) : mixed
Parameters
- $obj : obj
-
Image, album, news article or page object
Tags
printStatusNotes()
Prints various notes regarding the scheduled publishing status for single edit pages
printStatusNotes(obj $obj) : mixed
Parameters
- $obj : obj
-
Image, album, news article, new category or page object
Tags
getStatusNote()
Gets a specific predefined status note for an object (if available) Note: The notes are not status dependend!
getStatusNote([string $name = '' ]) : string
Parameters
- $name : string = ''
-
Name of the note
Return values
stringgetStatusNotes()
Gets an array of all predefined status notes
getStatusNotes() : array<string|int, mixed>
Tags
Return values
array<string|int, mixed>getStatusNotesByContext()
Gets an array with all status notes that apply to $obj currently
getStatusNotesByContext(string $obj) : array<string|int, mixed>
Parameters
- $obj : string
Tags
Return values
array<string|int, mixed>getStatusIcons()
Gets an key => value array of all available object status icons as full <img> elements
getStatusIcons() : array<string|int, mixed>
Tags
Return values
array<string|int, mixed>getStatusIcon()
Gets the icon img element for a specific status icon
getStatusIcon([string $name = '' ]) : string
Parameters
- $name : string = ''
-
(Internal) Name of the icon
Tags
Return values
stringprintPublishIconLinkGallery()
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
Parameters
- $obj : object
-
Image or album object
- $enableedit : bool = false
-
true if allowed to use
- $owner : string = null
-
User name of the owner
Tags
getPublishIcon()
Returns the publish icon for the current status
getPublishIcon(obj $obj) : string
Parameters
- $obj : obj
-
Object of the page or news article to check
Tags
Return values
stringprintPublished()
Prints the scheduled publishing date for items if set. Also prints the date for Zenpage news articles and pages
printPublished(string $obj) : string
Parameters
- $obj : string
-
image, albun, news article or page object
Tags
Return values
stringprintExpired()
Prints the expiration or expired date for items
printExpired(string $obj) : string
Parameters
- $obj : string
-
image, albun, news article or page object
Tags
Return values
stringprintProtectedIcon()
Prints the protected icon if the object is password protected on an edit list
printProtectedIcon(obj $obj) : mixed
Parameters
- $obj : obj
Tags
isIncompatibleExtension()
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.
Parameters
- $disable : string|array<string|int, mixed>
-
One string or serveral as an array. Not false means incompatible
Tags
Return values
bool|stringprocessExtensionVariable()
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
Parameters
- $var : string|array<string|int, mixed>
-
A plugin or theme definition variable
Tags
Return values
string|boolprintSelectorWithCustomField()
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
- gettext('Custom') = 'custom'
If "custom" is selected the custom text field will be shown.
Parameters
- $optionname : string
-
The option name of the select list
- $list : array<string|int, mixed> = array()
-
Key value array where key is the display value (gettext generally)
- $optionlabel : string = null
-
The label text for the select list
- $optionname_customfield : string = null
-
The option name of the custom field
- $optionlabel_customfield : string = nulll
-
THe label text for the custom field
- $is_galleryoption : bool = false
-
Set to true if this is a special gallery class option
Tags
getZenpagePagesOptionsArray()
Gets an array of Zenpage pages ready for using with selector, radioboxes and checkbox lists
getZenpagePagesOptionsArray([bool $published = false ]) : mixed
Parameters
- $published : bool = false
-
true for only published, default false for all.
Tags
printZenpagePageSelector()
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.
Parameters
- $optionname : string
-
Name of the option, sued for the selector and the current selection
- $optionname_custom : string = null
-
If defined this will be used for the custom url option, if null (default) the option name will be used with "_custom" appended
- $published : bool = false
-
If the pages should include only published ones
- $is_galleryoption : bool = false
-
Set to true if this is a special gallery class option
Tags
getAdminstratorsOptionsArray()
Gets an array of administrators ready for using with selector, radioboxes and checkbox lists
getAdminstratorsOptionsArray([string $type = 'users' ]) : type
Parameters
- $type : string = 'users'
-
'users', 'groups', 'allusers'
Tags
Return values
typeprintUserSelector()
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
Parameters
- $optionname : string
-
Name of the option, sued for the selector and the current selection
- $optionname_custom : string
-
If defined this will be used for the custom url option, if null (default) the option name will be used with "_custom" appended
- $type : bool = 'users'
-
'users', 'groups', 'allusers'
- $is_galleryoption : bool = false
-
Set to true if this is a special gallery class option
Tags
isTextFile()
Helper for the theme editor
isTextFile(type $file) : type
Parameters
- $file : type
Return values
typegetSubalbumImages()
Updates the $_zp_admin_imagelist global used on dynamic album editing
getSubalbumImages(type $folder) : type
Parameters
- $folder : type
Tags
Return values
typemarkUpdated()
Updates $_zp_admin_user_updated on user editing
markUpdated() : mixed
Tags
printImageRotationSelector()
Prints the image EXIF rotation/flipping selector
printImageRotationSelector(obj $imageobj, int $currentimage) : mixed
Parameters
- $imageobj : obj
-
Object of the current image
- $currentimage : int
-
ID of the current image
Tags
printDatetimeFormatSelector()
Prints option selectors for date and time formats
printDatetimeFormatSelector() : mixed
Tags
getDatetimeFormatlistForSelector()
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>
Parameters
- $formats : array<string|int, mixed> = array()
-
Array as created by array_keys(getStandardDateFormats($type);
- $use_localized_date : bool = false
-
Default false, set to true to use localized datees
Tags
Return values
array<string|int, mixed>db_connect()
Connect to the database server and select the database.
db_connect(array<string|int, mixed> $config[, bool $errorstop = true ]) : true
Parameters
- $config : array<string|int, mixed>
-
the db configuration parameters
- $errorstop : bool = true
-
set to false to omit error messages
Tags
Return values
true —if successful connection
query()
The main query function. Runs the SQL on the connection and handles errors.
query(string $sql[, bool $errorstop = true ]) : results
Parameters
- $sql : string
-
sql code
- $errorstop : bool = true
-
set to false to supress the error message
Tags
Return values
results —of the sql statements
query_single_row()
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.
Parameters
- $sql : string
-
sql code
- $errorstop : bool = true
-
set to false to supress the error message
Tags
Return values
results —of the sql statements
query_full_array()
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
Parameters
- $sql : string
-
sql code
- $errorstop : bool = true
-
set to false to supress the error message
- $key : string = NULL
-
optional array index key
Tags
Return values
results —of the sql statements
db_quote()
mysqli_real_escape_string standin that insures the DB connection is passed.
db_quote(string $string[, mixed $addquotes = true ]) : string
Parameters
- $string : string
- $addquotes : mixed = true
Tags
Return values
stringdb_insert_id()
returns the insert id of the last database insert
db_insert_id() : mixed
Tags
db_fetch_assoc()
Fetch a result row as an associative array
db_fetch_assoc(mixed $resource) : mixed
Parameters
- $resource : mixed
Tags
db_error()
Returns the text of the error message from previous operation
db_error() : mixed
Tags
db_affected_rows()
Get number of affected rows in previous operation
db_affected_rows() : mixed
Tags
db_fetch_row()
Get a result row as an enumerated array
db_fetch_row(mixed $result) : mixed
Parameters
- $result : mixed
Tags
db_num_rows()
Get number of rows in result
db_num_rows(mixed $result) : mixed
Parameters
- $result : mixed
Tags
db_close()
Closes the database
db_close() : mixed
Tags
db_software()
report the software of the database
db_software() : mixed
Tags
db_create()
create the database
db_create() : mixed
Tags
db_permissions()
Returns user's permissions on the database
db_permissions() : mixed
Tags
db_setSQLmode()
Sets the SQL session mode to empty
db_setSQLmode() : mixed
Tags
db_getSQLmode()
Queries the SQL session mode
db_getSQLmode() : mixed
Tags
db_collation()
db_collation() : mixed
Tags
db_create_table()
db_create_table(mixed $sql) : mixed
Parameters
- $sql : mixed
Tags
db_table_update()
db_table_update(mixed $sql) : mixed
Parameters
- $sql : mixed
Tags
db_show()
db_show(mixed $what[, mixed $aux = '' ]) : mixed
Parameters
- $what : mixed
- $aux : mixed = ''
Tags
db_list_fields()
db_list_fields(mixed $table) : mixed
Parameters
- $table : mixed
Tags
db_truncate_table()
db_truncate_table(mixed $table) : mixed
Parameters
- $table : mixed
Tags
db_LIKE_escape()
db_LIKE_escape(mixed $str) : mixed
Parameters
- $str : mixed
Tags
db_free_result()
db_free_result(mixed $result) : mixed
Parameters
- $result : mixed
Tags
prefix()
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.
Parameters
- $tablename : string = NULL
-
name of the table
Tags
Return values
prefixed —table name
getWhereClause()
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
Parameters
- $unique_set : string
-
what to add to the WHERE clause
Tags
Return values
contructed —WHERE cleause
getSetClause()
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
Parameters
- $new_unique_set : string
-
what to add to the SET clause
Tags
Return values
contructed —SET cleause
db_name()
returns the connected database name
db_name() : mixed
Tags
db_count()
Counts entries in a db table
db_count(string $table[, string $clause = NULL ][, string $field = "id" ]) : int
Parameters
- $table : string
-
Table name
- $clause : string = NULL
-
Where clause for the count query
- $field : string = "id"
-
Which fields to count (default: id)
Tags
Return values
intdb_getServerInfo()
Returns the server info
db_getServerInfo() : string
Tags
Return values
stringdb_getClientInfo()
Returns the client info
db_getClientInfo() : string
Tags
Return values
stringdb_getVersion()
Gets the plain version number
db_getVersion() : int
Tags
Return values
intzp_imageGet()
zp_imageGet(mixed $imgfile) : mixed
Parameters
- $imgfile : mixed
Tags
zp_imageOutput()
zp_imageOutput(mixed $im, mixed $type[, mixed $filename = NULL ][, mixed $qual = 75 ]) : mixed
Parameters
- $im : mixed
- $type : mixed
- $filename : mixed = NULL
- $qual : mixed = 75
Tags
zp_createImage()
zp_createImage(mixed $w, mixed $h) : mixed
Parameters
- $w : mixed
- $h : mixed
Tags
zp_imageFill()
zp_imageFill(mixed $image, mixed $x, mixed $y, mixed $color) : mixed
Parameters
- $image : mixed
- $x : mixed
- $y : mixed
- $color : mixed
Tags
zp_imageColorTransparent()
zp_imageColorTransparent(mixed $image, mixed $color) : mixed
Parameters
- $image : mixed
- $color : mixed
Tags
zp_copyCanvas()
zp_copyCanvas(mixed $imgCanvas, mixed $img, mixed $dest_x, mixed $dest_y, mixed $src_x, mixed $src_y, mixed $w, mixed $h) : mixed
Parameters
- $imgCanvas : mixed
- $img : mixed
- $dest_x : mixed
- $dest_y : mixed
- $src_x : mixed
- $src_y : mixed
- $w : mixed
- $h : mixed
Tags
zp_resampleImage()
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
Parameters
- $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
Tags
zp_imageUnsharpMask()
zp_imageUnsharpMask(mixed $img, mixed $amount, mixed $radius, mixed $threshold) : mixed
Parameters
- $img : mixed
- $amount : mixed
- $radius : mixed
- $threshold : mixed
Tags
zp_imageResizeAlpha()
zp_imageResizeAlpha(mixed &$src, mixed $w, mixed $h) : mixed
Parameters
- $src : mixed
- $w : mixed
- $h : mixed
Tags
zp_imageCanRotate()
zp_imageCanRotate() : mixed
Tags
zp_rotateImage()
zp_rotateImage(mixed $im, mixed $rotate) : mixed
Parameters
- $im : mixed
- $rotate : mixed
Tags
zp_imageDims()
zp_imageDims(mixed $filename) : mixed
Parameters
- $filename : mixed
Tags
zp_imageIPTC()
zp_imageIPTC(mixed $filename) : mixed
Parameters
- $filename : mixed
Tags
zp_imageWidth()
zp_imageWidth(mixed $im) : mixed
Parameters
- $im : mixed
Tags
zp_imageHeight()
zp_imageHeight(mixed $im) : mixed
Parameters
- $im : mixed
Tags
zp_imageMerge()
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
Parameters
- $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
Tags
zp_imageGray()
zp_imageGray(mixed $image) : mixed
Parameters
- $image : mixed
Tags
zp_imageKill()
zp_imageKill(mixed $im) : mixed
Parameters
- $im : mixed
Tags
zp_colorAllocate()
zp_colorAllocate(mixed $image, mixed $red, mixed $green, mixed $blue) : mixed
Parameters
- $image : mixed
- $red : mixed
- $green : mixed
- $blue : mixed
Tags
zp_writeString()
zp_writeString(mixed $image, mixed $font, mixed $x, mixed $y, mixed $string, mixed $color) : mixed
Parameters
- $image : mixed
- $font : mixed
- $x : mixed
- $y : mixed
- $string : mixed
- $color : mixed
Tags
zp_drawRectangle()
zp_drawRectangle(mixed $image, mixed $x1, mixed $y1, mixed $x2, mixed $y2, mixed $color) : mixed
Parameters
- $image : mixed
- $x1 : mixed
- $y1 : mixed
- $x2 : mixed
- $y2 : mixed
- $color : mixed
Tags
zp_graphicsLibInfo()
zp_graphicsLibInfo() : mixed
Tags
zp_getFonts()
zp_getFonts() : mixed
Tags
zp_imageLoadFont()
zp_imageLoadFont([mixed $font = NULL ][, mixed $size = 18 ]) : mixed
Parameters
- $font : mixed = NULL
- $size : mixed = 18
Tags
zp_imageFontWidth()
zp_imageFontWidth(mixed $font) : mixed
Parameters
- $font : mixed
Tags
zp_imageFontHeight()
zp_imageFontHeight(mixed $font) : mixed
Parameters
- $font : mixed
Tags
imageBlurGD()
imageBlurGD(mixed $imgCanvas, mixed $imgCanvas2, mixed $radius, mixed $w, mixed $h) : mixed
Parameters
- $imgCanvas : mixed
- $imgCanvas2 : mixed
- $radius : mixed
- $w : mixed
- $h : mixed
Tags
zp_imageFromString()
zp_imageFromString(mixed $string) : mixed
Parameters
- $string : mixed
Tags
js_encode()
encodes a pre-sanitized string to be used as a Javascript parameter
js_encode(string $this_string) : string
Parameters
- $this_string : string
Return values
stringgetOption()
Get a option stored in the database.
getOption(string $key) : mixed
This function reads the options only once, in order to improve performance.
Parameters
- $key : string
-
the name of the option.
setOption()
Stores an option value.
setOption(string $key, mixed $value[, bool $persistent = true ][, string $creator = NULL ]) : mixed
Parameters
- $key : string
-
name of the option.
- $value : mixed
-
new value of the option.
- $persistent : bool = true
-
set to false if the option is stored in memory only. Otherwise it is preserved in the database
- $creator : string = NULL
-
name of the creator the option belongs to. Normally NULL for backend core options. "zp-core/zp-extensions/
.php" for official plugin and /plugins/ .php for user plugin options
setOptionDefault()
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
Parameters
- $key : string
-
the option name
- $default : mixed
-
the value to be used as the default
loadLocalOptions()
Loads option table with album/theme options
loadLocalOptions(int $albumid, string $theme) : mixed
Parameters
- $albumid : int
- $theme : string
renameOption()
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
Parameters
- $oldkey : string
-
Old option name
- $newkey : string
-
New option name
Tags
purgeOption()
Deletes an option from the database
purgeOption(string $key) : mixed
Parameters
- $key : string
Tags
getOptionList()
Retuns the option array
getOptionList() : array<string|int, mixed>
Return values
array<string|int, mixed>hasDynamicAlbumSuffix()
Returns true if the file has the dynamic album suffix
hasDynamicAlbumSuffix(string $path) : bool
Parameters
- $path : string
Return values
boolisHandledAlbum()
checks if there is a file with the prefix and one of the handled suffixes. Returns the found suffix
isHandledAlbum(string $path) : string
Parameters
- $path : string
-
SERVER path to be tested
Return values
stringrewrite_get_album_image()
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
Parameters
- $albumvar : string
-
$_GET index for "albums"
- $imagevar : string
-
$_GET index for "images"
getImageCacheFilename()
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
Parameters
- $album8 : mixed
- $image8 : mixed
- $args : array<string|int, mixed>
-
cropping arguments
Return values
stringmakeSpecialImageName()
Returns an i.php "image name" for an image not within the albums structure
makeSpecialImageName(string $image) : array<string|int, mixed>
Parameters
- $image : string
-
Path to the image
Return values
array<string|int, mixed>getWatermarkParam()
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
Parameters
- $image : object
-
image object in question
- $use : int
-
what the watermark use is
Return values
intgetImageCachePostfix()
Returns the crop/sizing string to postfix to a cache image
getImageCachePostfix(array<string|int, mixed> $args) : string
Parameters
- $args : array<string|int, mixed>
-
cropping arguments
Return values
stringgetImageParameters()
Validates and edits image size/cropping parameters
getImageParameters(array<string|int, mixed> $args[, mixed $album = NULL ]) : array<string|int, mixed>
Parameters
- $args : array<string|int, mixed>
-
cropping arguments
- $album : mixed = NULL
Return values
array<string|int, mixed>getImageProcessorURI()
forms the i.php parameter list for an image.
getImageProcessorURI(array<string|int, mixed> $args, string $album, string $image) : string
Parameters
- $args : array<string|int, mixed>
- $album : string
-
the album name
- $image : string
-
the image name
Return values
stringgetImageArgs()
Extract the image parameters from the input variables
getImageArgs(array<string|int, mixed> $set) : array<string|int, mixed>
Parameters
- $set : array<string|int, mixed>
Return values
array<string|int, mixed>getImageProcessorURIFromCacheName()
Extracts the image processor URI from an existing cache filename
getImageProcessorURIFromCacheName(string $match, array<string|int, mixed> $watermarks) : array<string|int, mixed>
Parameters
- $match : string
- $watermarks : array<string|int, mixed>
Tags
Return values
array<string|int, mixed>getImageURI()
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!
Parameters
- $args : array<string|int, mixed>
- $album : string
-
the album name
- $image : string
-
the image name
- $mtime : mixed
Return values
stringextractImageExifOrientation()
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
Parameters
- $exiforientation : string|int = ''
-
String or integer value as stored in the db (e.g. '7: 90 deg CCW Mirrored' or just "7")
Tags
Return values
intgetImageFlipRotate()
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>
Parameters
- $rotation : mixed
Tags
Return values
bool|array<string|int, mixed>getAllowedTags()
Returns an array of html tags allowed
getAllowedTags(string $which) : mixed
Parameters
- $which : string
-
either 'allowed_tags' or 'style_tags' depending on which is wanted.
rewrite_path()
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.
Parameters
- $rewrite : string
-
is the path to return if rewrite is enabled. (eg: "/myalbum")
- $plain : string
-
is the path if rewrite is disabled (eg: "/?album=myalbum")
- $webpath : bool = NULL
-
host path to be prefixed. If "false" is passed you will get a localized "WEBPATH"
Return values
stringparse_query()
parses a query string WITHOUT url decoding it!
parse_query(string $str) : mixed
Parameters
- $str : string
build_query()
createsa query string from the array passed
build_query(array<string|int, mixed> $parts) : string
Parameters
- $parts : array<string|int, mixed>
Return values
stringbuild_url()
Builds a url from parts
build_url(array<string|int, mixed> $parts) : string
Parameters
- $parts : array<string|int, mixed>
Return values
stringpathurlencode()
rawurlencode function that is path-safe (does not encode /)
pathurlencode(string $path) : string
Parameters
- $path : string
-
URL
Return values
stringgetAlbumFolder()
Returns the fully qualified path to the album folders
getAlbumFolder([string $root = SERVERPATH ]) : string
Parameters
- $root : string = SERVERPATH
-
the base from whence the path dereives
Return values
stringgetBackupFolder()
Returns the fully qualified path to the backup folder
getBackupFolder([string $root = SERVERPATH ]) : string
Parameters
- $root : string = SERVERPATH
-
the base from whence the path dereives
Tags
Return values
stringgetRootFolder()
Returns the fully qualified path to the root albums or backup folder
getRootFolder([string $folder = 'albumfolder' ][, string $root = SERVERPATH ]) : string
Parameters
- $folder : string = 'albumfolder'
-
The folder path to get: "albumfolder" or "backupfolder"
- $root : string = SERVERPATH
-
the base from whence the path dereives
Tags
Return values
stringswitchLog()
Rolls a log over if it has grown too large.
switchLog(string $log) : mixed
Parameters
- $log : string
debugLog()
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
Parameters
- $message : string|array<string|int, mixed>|object
-
the debug information. This can also be an array or object. For detailed info about the content use debuglogVar().
- $reset : bool = false
-
set to true to reset the log to zero before writing the message
- $logname : string = 'debug'
-
Optional custom log name to log to, default "debug"
instrument()
Tool to log execution times of script bits
instrument(string $point) : mixed
Parameters
- $point : string
-
location identifier
parse_size()
Parses a byte size from a size value (eg: 100M) for comparison.
parse_size(mixed $size) : mixed
Parameters
- $size : mixed
getAlbumArray()
getAlbumArray - returns an array of folder names corresponding to the given album string.
getAlbumArray(string $albumstring[, string $includepaths = false ]) : mixed
Parameters
- $albumstring : string
-
is the path to the album as a string. Ex: album/subalbum/my-album
- $includepaths : string = false
-
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
imgSrcURI()
Returns an img src URI encoded based on the OS of the server
imgSrcURI(string $uri) : string
Parameters
- $uri : string
-
uri in FILESYSTEM_CHARSET encoding
Return values
stringgetSuffix()
Returns the suffix of a file name
getSuffix(string $filename) : string
Parameters
- $filename : string
Return values
stringstripSuffix()
returns a file name sans the suffix
stripSuffix(string $filename) : string
Parameters
- $filename : string
Return values
stringgetAlbumInherited()
returns the non-empty value of $field from the album or one of its parents
getAlbumInherited(string $folder, string $field, int &$id) : string
Parameters
- $folder : string
-
the album name
- $field : string
-
the desired field name
- $id : int
-
will be set to the album
id
of the album which has the non-empty field
Return values
stringthemeSetup()
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.
Parameters
- $album : string
Return values
stringaccessAllAlbums()
Checks access for the album root
accessAllAlbums(bit $action) : mixed
Parameters
- $action : bit
-
what the caller wants to do
getWatermarkPath()
Returns the path to a watermark
getWatermarkPath(string $wm) : string
Parameters
- $wm : string
-
watermark name
Return values
stringsecureServer()
Checks to see if access was through a secure protocol
secureServer() : bool
Tags
Return values
boolgetRequestURI()
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]
Return values
stringsafe_glob()
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!
Parameters
- $pattern : string
-
the 'pattern' for matching files
- $flags : bit = 0
-
glob 'flags'
checkInstall()
Check to see if the setup script needs to be run
checkInstall() : mixed
exitZP()
Call when terminating a script.
exitZP() : mixed
Closes the database to be sure that we do not build up outstanding connections
installSignature()
Computes the "installation signature" of the Zenphoto install
installSignature() : array<string|int, mixed>
Return values
array<string|int, mixed>zp_session_start()
Starts a zenphoto session (perhaps a secure one)
zp_session_start() : mixed
zp_session_destroy()
Ends a zenphoto session if there is one and clear the session cookie
zp_session_destroy() : mixed
getDefaultRewriteTokens()
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
Parameters
- $token : string = null
-
The token to get, e.g. "gallery". If the token is not existing or NULL the whole definition array is returned
Return values
array<string|int, mixed>addMissingDefaultRewriteTokens()
Adds missing individual default rewrite tokens to $_zp_conf_vars['special_pages']
addMissingDefaultRewriteTokens() : mixed
Tags
curlRequest()
Sends a simple cURL request to the $uri specified.
curlRequest(string $uri[, array<string|int, mixed> $options = array() ]) : bool
Parameters
- $uri : string
-
The uri to send the request to. Sets
curl_setopt($ch, CURLOPT_URL, $uri);
- $options : array<string|int, mixed> = array()
-
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
Return values
boolgenerateImageCacheFile()
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.
Parameters
- $imageuri : string
-
The image processor uri to this image
httpsRedirect()
Checks if protocol not https and redirects if https required
httpsRedirect([string $type = 'backend' ]) : mixed
Parameters
- $type : string = 'backend'
-
Tpye to redirect "backend" (default) or "frontend"
redirectURL()
General url redirection handler using header()
redirectURL(string $url[, string $statuscode = null ][, bool $allowexternal = false ]) : mixed
Parameters
- $url : string
-
A full qualified url
- $statuscode : string = null
-
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.
- $allowexternal : bool = false
-
True to allow redirections outside of the current domain (does not cover subdomains!). Default false.
Tags
sanitizeRedirect()
Sanitizes a "redirect" post to always be within the site
sanitizeRedirect(string $redirectTo) : string
Parameters
- $redirectTo : string
Return values
stringcallUserFunction()
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.
Parameters
- $function : string|array<string|int, mixed>
-
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
- $parameter : array<string|int, mixed>|mixed = array()
-
Parameters of the function/method as one dimensional array. Alternatively you also add separate argments like the original function defines them
Tags
deprecationNotice()
Logs a deprecated notice including traces in the debuglog
deprecationNotice(string $use[, bool|string $parameter = false ]) : mixed
Parameters
- $use : string
-
Additional message, e.g. what to use instead
- $parameter : bool|string = false
-
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
Tags
convertStrftimeFormat()
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
- %X => 'locale_preferreddate_time' -'%x' => 'locale_preferreddate_notime'
zpFormattedDate() can handle these internally
Parameters
- $format : string = ''
-
strftime() date format string
Tags
Return values
stringhasPrimaryScripts()
Returns true if the install is not a "clone"
hasPrimaryScripts() : mixed
zpErrorHandler()
Traps errors and insures thy are logged.
zpErrorHandler(int $errno[, string $errstr = '' ][, string $errfile = '' ][, string $errline = '' ]) : void|bool
Parameters
- $errno : int
- $errstr : string = ''
- $errfile : string = ''
- $errline : string = ''
Return values
void|boolfilesystemToInternal()
Converts a file system filename to UTF-8 for zenphoto internal storage
filesystemToInternal(string $filename) : string
Parameters
- $filename : string
-
the file name to convert
Return values
stringinternalToFilesystem()
Converts a Zenphoto Internal filename string to one compatible with the file system
internalToFilesystem(string $filename) : string
Parameters
- $filename : string
-
the file name to convert
Return values
stringsanitize_path()
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
Parameters
- $filename : string
-
is the path text to filter.
Return values
stringsanitize_numeric()
Checks if the input is numeric, rounds if so, otherwise returns false.
sanitize_numeric(mixed $num) : int
Parameters
- $num : mixed
-
the number to be sanitized
Return values
intsanitize_script()
removes script tags
sanitize_script(string $text) : string
Parameters
- $text : string
Return values
stringsanitize()
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
Parameters
- $input_string : string
-
is a string that needs cleaning.
- $sanitize_level : string = 3
-
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)
Return values
string —the sanitized string.
ksesProcess()
Internal "helper" function to apply the tag removal
ksesProcess(string $input_string, array<string|int, mixed> $allowed_tags) : string
Parameters
- $input_string : string
- $allowed_tags : array<string|int, mixed>
Return values
stringgetBare()
Cleans tags and some content.
getBare(type $content) : type
Parameters
- $content : type
Return values
typesanitize_string()
returns a sanitized string for the sanitize function
sanitize_string(mixed $input, string $sanitize_level) : string
Parameters
- $input : mixed
- $sanitize_level : string
-
See sanitize()
Return values
string —the sanitized string.
zp_error()
triggers an error
zp_error(string $message[, mixed $fatal = E_USER_ERROR ]) : mixed
Parameters
- $message : string
- $fatal : mixed = E_USER_ERROR
html_decode()
html_decode(mixed $string) : mixed
Parameters
- $string : mixed
html_encode()
encodes a pre-sanitized string to be used in an HTML text-only field (value, alt, title, etc.)
html_encode(string $str) : string
Parameters
- $str : string
Return values
stringhtml_encodeTagged()
HTML encodes the non-metatag part of the string.
html_encodeTagged(string $original[, bool $allowScript = true ]) : string
Parameters
- $original : string
-
string to be encoded
- $allowScript : bool = true
-
set to false to prevent pass-through of script tags.
Return values
stringhtml_pathurlencode()
Convenience wrapper of html_encode(pathurlencode($url)) Primarily intended for use with img src URLs
html_pathurlencode(string $url) : string
Parameters
- $url : string
Tags
Return values
stringmkdir_recursive()
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!
Parameters
- $pathname : string
-
The directory path to be created.
- $mode : mixed
Return values
bool —TRUE if exists or made or FALSE on failure.
debugLogBacktrace()
Logs the calling stack
debugLogBacktrace(string $message[, int $omit = 0 ][, string $logname = 'debug' ]) : mixed
Parameters
- $message : string
-
Message to prefix the backtrace
- $omit : int = 0
- $logname : string = 'debug'
-
Optional custom log name to log to, default "debug"
debugLogVar()
Records a Var to the debug log
debugLogVar(string $message[, mixed $var = '' ][, string $logname = 'debug' ]) : mixed
Parameters
- $message : string
-
message to insert in log [optional]
- $var : mixed = ''
-
the variable to record
- $logname : string = 'debug'
-
Optional custom log name to log to, default "debug"
zp_getCookie()
Returns the value of a cookie from either the cookies or from $_SESSION[]
zp_getCookie(string $name) : mixed
Parameters
- $name : string
-
the name of the cookie
zp_cookieEncode()
Encodes a cookie value tying it to the user IP
zp_cookieEncode( $value) : mixed
Parameters
zp_setCookie()
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
Parameters
- $name : string
-
The 'cookie' name
- $value : string
-
The value to be stored
- $time : timestamp = NULL
-
The time delta until the cookie expires
- $path : string = NULL
-
The path on the server in which the cookie will be available on
- $secure : bool = false
-
true if secure cookie
- $httponly : bool = false
-
true if access to this cookie should only be allowed via http (e.g. no access to JS etc.). Requires browser support though.
zp_clearCookie()
Clears a cookie
zp_clearCookie(string $name[, string $path = NULl ][, bool $secure = false ][, bool $httponly = false ]) : mixed
Parameters
- $name : string
-
The 'cookie' name
- $path : string = NULl
-
The path on the server in which the cookie will be available on
- $secure : bool = false
-
true if secure cookie
- $httponly : bool = false
-
true if access to this cookie should only be allowed via http (e.g. no access to JS etc.). Requires browser support though.
getSerializedArray()
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>
Parameters
- $string : string
- $disallow_classes : bool = false
-
Default false, if set to true the unserializing disallows classes. Set to true if using this on user submitted $_GET/$_POST/$_REQUEST data
Return values
array<string|int, mixed>updateConfigItem()
Updates an item in the configuration file
updateConfigItem(unknown_type $item, unknown_type $value, mixed $zp_cfg[, unknown_type $quote = true ]) : mixed
Parameters
- $item : unknown_type
- $value : unknown_type
- $zp_cfg : mixed
- $quote : unknown_type = true
storeConfig()
backs-up and updates the Zenphoto configuration file
storeConfig(string $zp_cfg) : mixed
Parameters
- $zp_cfg : string
zpRewriteURL()
Creates a "REWRITE" url given the query parameters that represent the link
zpRewriteURL(type $query) : string
Parameters
- $query : type
Return values
stringfix_path_redirect()
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()
zp_load_page([mixed $pagenum = NULL ]) : mixed
Parameters
- $pagenum : mixed = NULL
zp_load_gallery()
initializes the gallery.
zp_load_gallery() : mixed
zp_load_search()
Loads the search object.
zp_load_search() : mixed
zp_load_album()
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
Parameters
- $folder :
-
the folder name of the album to load. Ex: 'testalbum', 'test/subalbum', etc.
- $force_nocache : mixed = false
Return values
the —loaded album object on success, or (===false) on failure.
zp_load_image()
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
Parameters
- $folder :
-
is the folder name of the album this image is in. Ex: 'testalbum'
- $filename :
-
is the filename of the image to load.
Return values
the —loaded album object on success, or (===false) on failure.
load_zenpage_pages()
Loads a zenpage pages page Sets up $_zp_current_zenpage_page and returns it as the function result.
load_zenpage_pages( $titlelink) : object
Parameters
- $titlelink :
-
the titlelink of a zenpage page to setup a page object directly. Used for custom page scripts based on a zenpage page.
Return values
objectload_zenpage_news()
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
Parameters
- $request : array<string|int, mixed>
-
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
Return values
objectzp_load_request()
Figures out what is being accessed and calls the appropriate load function
zp_load_request() : bool
Return values
boolprepareIndexPage()
sets up for loading the index page
prepareIndexPage() : string
Return values
stringprepareAlbumPage()
sets up for loading an album page
prepareAlbumPage() : mixed
prepareImagePage()
sets up for loading an image page
prepareImagePage() : string
Return values
stringprepareCustomPage()
sets up for loading p=page pages
prepareCustomPage() : string
Return values
stringredirectionHandler()
Handles redirections via filter hook "redirection_handler".
redirectionHandler() : mixed
It is meant to perform redirections of pages that have been removed or renamed.
Tags
zp_register_filter()
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
Parameters
- $hook : string
-
the name of the zenphoto element to be filtered
- $function_name : callable
-
the name of the function that is to be called.
- $priority : int = NULL
-
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)
zp_filter_unique_id()
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
Parameters
- $hook : string
-
hook to which the function is attached
- $function : string|array<string|int, mixed>
-
used for creating unique id
- $priority : int|bool
-
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.
Return values
string —unique ID for usage as array key
zp_apply_filter()
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
Parameters
- $hook : string
-
the name of the zenphoto element
- $value : mixed = ''
-
the value of the element before filtering
zp_remove_filter()
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
Parameters
- $hook : string
-
The filter hook to which the function to be removed is hooked.
- $function_to_remove : callable
-
The name of the function which should be removed.
- $priority : int = NULL
-
optional. The priority of the function. If not supplied we will get it from zp_has_filter
- $accepted_args : int = 1
-
optional. The number of arguments the function accpets (default: 1).
Return values
bool —Whether the function was registered as a filter before it was removed.
zp_has_filter()
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
Parameters
- $hook : string
-
The name of the filter hook.
- $function_to_check : callable = false
-
optional. If specified, return the priority of that function on this hook or false if not attached.
Return values
int|bool —Optionally returns the priority on that hook for the specified function.
get_filterScript()
returns a list of scripts that have attached to the hook
get_filterScript(string $hook) : string
Parameters
- $hook : string
Return values
stringzp_filter_slot()
Returns the position of the function in the hook queue
zp_filter_slot( $hook, $function) : mixed
Parameters
getLanguageArray()
functions-i18n.php -- support functions for internationalization
getLanguageArray() : mixed
generateLanguageList()
Returns an array of available language locales.
generateLanguageList([mixed $all = false ]) : array<string|int, mixed>
Parameters
- $all : mixed = false
Return values
array<string|int, mixed>setMainDomain()
Sets the locale, etc. to the zenphoto domain details.
setMainDomain() : mixed
Returns the result of setupCurrentLocale()
gettext_th()
Gettext replacement function for separate translations of third party themes.
gettext_th(string $string[, string $theme = Null ]) : string
Parameters
- $string : string
-
The string to be translated
- $theme : string = Null
-
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.
Return values
stringngettext_th()
ngettext replacement function for separate translations of third party themes.
ngettext_th(string $msgid1, string $msgid2, int $n[, string $theme = NULL ]) : string
Parameters
- $msgid1 : string
- $msgid2 : string
- $n : int
- $theme : string = NULL
Return values
stringgettext_pl()
Gettext replacement function for separate translations of third party plugins within the root plugins folder.
gettext_pl(string $string, string $plugin) : string
Parameters
- $string : string
-
The string to be translated
- $plugin : string
-
The name of the plugin. Required.
Return values
stringngettext_pl()
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
Parameters
- $msgid1 : string
- $msgid2 : string
- $n : int
- $plugin : string
Return values
stringi18nSetLocale()
Wrapper function for setLocale() so that all the proper permutations are used Returns the result from the setLocale call
i18nSetLocale( $locale) : string
Parameters
Return values
stringsetupDomain()
Sets the translation domain and type for optional theme or plugin based translations
setupDomain([mixed $domain = NULL ][, $type = NULL ]) : mixed
Parameters
setupCurrentLocale()
Setup code for gettext translation Returns the result of the setlocale call
setupCurrentLocale([string $override = NULL ]) : mixed
Parameters
- $override : string = NULL
-
force locale to this
getLangAttributeLocale()
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
Parameters
- $locale : string = NULL
-
a locale like "en_US", if empty the current locale is used
Tags
Return values
stringparseHttpAcceptLanguage()
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.
Parameters
- $str : string = NULL
-
optional language string
Return values
array<string|int, mixed>validateLocale()
checks a "supplied" locale against the valid locales.
validateLocale(string $userlocale, mixed $source) : mixed
Returns a valid locale if one exists else returns NULL
Parameters
- $userlocale : string
- $source : mixed
getUserLocale()
Returns a saved (or posted) locale. Posted locales are stored as a cookie.
getUserLocale() : mixed
Sets the 'locale' option to the result (non-persistent)
get_language_string()
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
Parameters
- $dbstring : string
-
either a serialized languag string array or a single string
- $locale : string = NULL
-
optional locale of the translation desired
Return values
stringgetTimezones()
Returns a list of timezones
getTimezones() : unknown
Return values
unknowntimezoneDiff()
Returns the difference between the server timez one and the local (users) time zone
timezoneDiff(string $server, string $local) : int
Parameters
- $server : string
- $local : string
Return values
intgetAllTranslations()
returns a serialized "multilingual array" of translations Used for setting default options with multi-lingual strings.
getAllTranslations(string $text) : mixed
Parameters
- $text : string
-
to be translated
getLanguageSubdomains()
creates an SEO language prefix list
getLanguageSubdomains() : mixed
getLanguageText()
Returns a canonical language name string for the location
getLanguageText([string $loc = NULL ][, mixed $separator = NULL ]) : string
Parameters
- $loc : string = NULL
-
the location. If NULL use the current cookie
- $separator : mixed = NULL
Return values
stringgetSystemLocales()
Gets all locales suppported on the current server as a multidimensional array
getSystemLocales([bool $plainarray = false ]) : array<string|int, mixed>
Parameters
- $plainarray : bool = false
-
Default false for a multidimensial array grouped by locale base. Set to true to generate a single dimensional array with all locales.
Tags
Return values
array<string|int, mixed>getLanguageDisplayName()
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.
Parameters
- $locale : string
-
A vaild locale.
Tags
Return values
stringprintLangAttribute()
Prints the lang="" attribute for the main <html> element.
printLangAttribute([string $locale = null ]) : mixed
Parameters
- $locale : string = null
-
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
Tags
getFormattedLocaleDate()
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
Parameters
- $format : string = 'Y-m-dd'
-
An ICU dateformat string
- $datetime : string|int = ''
-
A date() compatible string or a timestamp. If empty "now" is used
Tags
Return values
stringimageError()
imageError(string $status_text, string $errormessage[, string $errorimg = 'err-imagegeneral.png' ][, string $image = '' ][, string $album = '' ][, string $newfilename = '' ]) : mixed
Parameters
- $status_text : string
- $errormessage : string
-
the error message to print if $_GET['debug'] is set.
- $errorimg : string = 'err-imagegeneral.png'
-
the filename of the error image to display for production. Defaults to 'err-imagegeneral.png'. Images should be located in /zp-core/images_errors .
- $image : string = ''
- $album : string = ''
- $newfilename : string = ''
Tags
imageDebug()
Prints debug information from the arguments to i.php.
imageDebug(string $album, string $image, array<string|int, mixed> $args, string $imgfile) : mixed
Parameters
- $album : string
-
alubm name
- $image : string
-
image name
- $args : array<string|int, mixed>
-
size/crop arguments
- $imgfile : string
-
the filename of the image
propSizes()
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
Parameters
- $size : int
- $width : int
- $height : int
- $w : int
- $h : int
- $thumb : int
- $image_use_side : int
- $dim : int
Return values
array<string|int, mixed>iptc_make_tag()
iptc_make_tag() function by Thies C. Arntzen
iptc_make_tag( $rec, $data, $value) : mixed
Parameters
cacheImage()
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
Parameters
- $newfilename : string
-
the name of the file when it is in the cache
- $imgfile : string
-
the image name
- $args : array<string|int, mixed>
-
the cropping arguments
- $allow_watermark : bool = false
-
set to true if image may be watermarked
- $theme : string = null
-
the current theme
- $album : string = null
-
the album containing the image
getImageRotation()
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
Parameters
- $imgfile : string
-
the image name
Tags
Return values
array<string|int, mixed>|falseaddWatermark()
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
Parameters
- $newim : resource|object
-
GD image resource or Imagick object
- $watermark_image : string
-
The path to the watermark to use
- $imgfile : string = null
-
Path to the image being processed (optionally for debugging only)
Tags
Return values
resource|objectisGDImage()
Checks if an processed image is a GD library image
isGDImage(mixed $image) : bool
Parameters
- $image : mixed
-
And Image resource (PHP < 8) or GDImage object (PHP 8+)
Tags
Return values
boolreconfigureAction()
Executes the configuration change code
reconfigureAction(int $mandatory) : mixed
Parameters
- $mandatory : int
-
0-3 0 means signature change where 1 means setup must autorun assuming a fresh install
checkSignature()
Checks details of configuration change
checkSignature(bool $auto) : type
Parameters
- $auto : bool
Tags
Return values
typesignatureChange()
Notification handler for configuration change
signatureChange([string $tab = NULL ][, string $subtab = NULL ]) : string
Parameters
- $tab : string = NULL
- $subtab : string = NULL
Return values
stringaddReconfigureNote()
Adds the reconfigure notification via filters
addReconfigureNote() : mixed
Tags
printReconfigureNote()
prints HTML for the configuration change notification
printReconfigureNote(array<string|int, mixed> $diff, type $needs, type $mandatory) : mixed
Parameters
- $diff : array<string|int, mixed>
- $needs : type
- $mandatory : type
Tags
getReconfigureNote()
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.
Parameters
- $diff : array<string|int, mixed>
- $needs : type
- $mandatory : type
Tags
Return values
array<string|int, mixed>printReconfigureError()
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
Parameters
- $mandatory : mixed
debuglogReconfigureNote()
Adds debuglog entries about the reconfigure note
debuglogReconfigureNote(array<string|int, mixed> $notice) : mixed
Parameters
- $notice : array<string|int, mixed>
-
reconfigure notice array as returned by getReconfigureNote()
ignoreSetupRunRequest()
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
Tags
isSetupProtected()
Checks if setup files are protected. Returns array of the protected files or empty array
isSetupProtected() : array<string|int, mixed>
Return values
array<string|int, mixed>unprotectSetupFiles()
Unprotectes setup files
unprotectSetupFiles() : mixed
protectSetupFiles()
Protects setup files
protectSetupFiles() : mixed
reconfigureCSS()
CSS for the configuration change notification
reconfigureCSS() : mixed
rewriteHandler()
"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()
getRules() : mixed
parseAllowedTags()
parses the allowed HTML tags for use by htmLawed
parseAllowedTags(string &$source) : array<string|int, mixed>
Parameters
- $source : string
-
by name, contains the string with the tag options
Tags
Return values
array<string|int, mixed> —the allowed_tags array.
checkObjectsThumb()
Search for a thumbnail for the image
checkObjectsThumb( $localpath) : string
Parameters
Return values
stringtruncate_string()
Returns a truncated string
truncate_string(string $string, int $length[, string $elipsis = '...' ]) : string
Parameters
- $string : string
-
souirce string
- $length : int
-
how long it should be
- $elipsis : string = '...'
-
the text to tack on indicating shortening
Return values
stringtidyHTML()
Fixes unbalanced HTML tags. Uses the library htmlawed or if available the native PHP extension tidy
tidyHTML(string $html) : string
Parameters
- $html : string
Return values
stringshortenContent()
Returns truncated html formatted content
shortenContent(string $articlecontent, int $shorten, string $shortenindicator[, bool $forceindicator = false ]) : string
Parameters
- $articlecontent : string
-
the source string
- $shorten : int
-
new size
- $shortenindicator : string
- $forceindicator : bool = false
-
set to true to include the indicator no matter what
Return values
stringlookupSortKey()
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
Parameters
- $sorttype : string
-
the 'Display" name of the sort
- $default : string
-
the default if $sorttype is empty
- $table : string
-
the database table being used.
Return values
stringzpFormattedDate()
Returns a formatted date for output
zpFormattedDate([string $format = '' ][, string|int $datetime = '' ][, bool $localized_date = null ]) : string
Parameters
- $format : 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.
- $datetime : string|int = ''
-
the date to be formatted. Can be a date string or a timestamp.
- $localized_date : bool = null
-
Default null to use the related option setting. Set to true to use localized dates. PHP intl extension required
Return values
stringgetDatetimeObject()
Returns a datetime object
getDatetimeObject([string|int $datetime = '' ]) : object
Parameters
- $datetime : string|int = ''
-
the date to be output. Can be a date string or a timestamp. If empty "now" is used
Tags
Return values
objectgetStandardDateFormats()
Returns an array with datetime (keys) and ICU dateformat (values) strings
getStandardDateFormats([string $type = "datetime" ]) : array<string|int, mixed>
Parameters
- $type : string = "datetime"
-
"date" for date formats without time, "time" for time formats, "datetime" for both combined
Tags
Return values
array<string|int, mixed>myts_date()
Simple SQL timestamp formatting function.
myts_date(string $format, int $mytimestamp) : string
Parameters
- $format : string
-
formatting template
- $mytimestamp : int
-
timestamp
Return values
stringzp_mail()
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
Parameters
- $subject : string
-
The subject of the email.
- $message : string
-
The message contents of the email.
- $email_list : array<string|int, mixed> = NULL
-
a list of email addresses to send to
- $cc_addresses : array<string|int, mixed> = NULL
-
a list of addresses to send copies to.
- $bcc_addresses : array<string|int, mixed> = NULL
-
a list of addresses to send blind copies to.
- $replyTo : string = NULL
-
reply-to address
Tags
Return values
stringsortByMultilingual()
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>
Parameters
- $dbresult : array<string|int, mixed>
-
the result of the DB query
- $field : string
-
the field name to sort on
- $descending : bool
-
the direction of the sort
Return values
array<string|int, mixed> —the sorted result
checkAlbumPassword()
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.
Parameters
- $album : string
-
album object or name of the album
- $hint : string = NULL
-
becomes populated with the password hint.
Return values
boolgetPluginFiles()
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>
Parameters
- $pattern : string
-
File system wildcard matching pattern to limit the search
- $folder : string = ''
-
subfolder within the plugin folders to search
- $stripsuffix : bool = true
-
set to true to remove the suffix from the key name in the array
Return values
array<string|int, mixed>getPlugin()
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":
- 1-theme folder file (if $inTheme is set): /themes/currenthemefolder/something.php
- 2-user plugin folder file: /plugins/something.php
- 3-zp-extensions file /zp-core/zp-extensions/something.php
First file found is used. Returns false if no file is found.
Parameters
- $plugin : string
-
is the name of the plugin file, typically something.php
- $inTheme : bool = false
-
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.
- $webpath : bool = false
-
return a WEBPATH rather than a SERVERPATH
Return values
string|falsegetEnabledPlugins()
Returns an array of the currently enabled plugins
getEnabledPlugins() : array<string|int, mixed>
Return values
array<string|int, mixed>extensionEnabled()
Returns if a plugin is enabled
extensionEnabled(string $extension) : bool
Parameters
- $extension : string
Return values
boolenableExtension()
Enables a plugin
enableExtension(string $extension, int $priority[, bool $persistent = true ]) : mixed
Parameters
- $extension : string
- $priority : int
- $persistent : bool = true
disableExtension()
Disables an extension
disableExtension(string $extension[, bool $persistent = true ]) : mixed
Parameters
- $extension : string
- $persistent : bool = true
Tags
getManagedAlbumList()
Populates and returns the $_zp_admin_album_list array
getManagedAlbumList() : array<string|int, mixed>
Return values
array<string|int, mixed>populateManagedObjectsList()
Returns a list of album names managed by $id
populateManagedObjectsList(string $type, int $id[, bool $rights = false ]) : array<string|int, mixed>
Parameters
- $type : string
-
which kind of object
- $id : int
-
admin ID
- $rights : bool = false
-
set true for album sub-rights
Return values
array<string|int, mixed>getAllSubAlbumIDs()
Returns an array of album ids whose parent is the folder
getAllSubAlbumIDs([string $albumfolder = '' ]) : array<string|int, mixed>
Parameters
- $albumfolder : string = ''
-
folder name if you want a album different >>from the current album
Return values
array<string|int, mixed>handleSearchParms()
recovers search parameters from stored cookie, clears the cookie
handleSearchParms(string $what[, string $album = NULL ][, string $image = NULL ]) : mixed
Parameters
- $what : string
-
the page type
- $album : string = NULL
-
Name of the album
- $image : string = NULL
-
Name of the image
galleryAlbumsPerPage()
Returns the number of album thumbs that go on a gallery page
galleryAlbumsPerPage() : int
Return values
intsetupTheme()
Returns the theme folder If there is an album theme, loads the theme options.
setupTheme([object $album = NULL ]) : string
Parameters
- $album : object = NULL
-
album object if override desired
Return values
stringgetAllTagsUnique()
Returns an array of unique tag names
getAllTagsUnique([bool $checkaccess = false ]) : array<string|int, mixed>
Parameters
- $checkaccess : bool = false
-
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.
Return values
array<string|int, mixed>getAllTagsCount()
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>
Parameters
- $exclude_unassigned : bool = false
-
Set to true if you wish to exclude tags that are not assigne to any item
- $checkaccess : bool = false
-
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.
Return values
array<string|int, mixed>getTagCountByAccess()
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
Parameters
- $tag : array<string|int, mixed>
-
Array representing a tag containing at least its name and id
Tags
Return values
intstoreTags()
Stores tags for an object
storeTags(array<string|int, mixed> $tags, int $id, string $tbl) : mixed
Parameters
- $tags : array<string|int, mixed>
-
the tag values
- $id : int
-
the record id of the album/image
- $tbl : string
-
database table of the object
readTags()
Retrieves the tags for an object Returns them in an array
readTags(int $id, string $tbl) : unknown
Parameters
- $id : int
-
the record id of the album/image
- $tbl : string
-
'albums' or 'images', etc.
Return values
unknowngenerateListFromArray()
Creates the body of a select list
generateListFromArray(array<string|int, mixed> $currentValue, array<string|int, mixed> $list, bool $descending, bool $localize) : mixed
Parameters
- $currentValue : array<string|int, mixed>
-
list of items to be flagged as checked
- $list : array<string|int, mixed>
-
the elements of the select list
- $descending : bool
-
set true for a ascending order sort. Set to null to keep the array as it is passed.
- $localize : bool
-
set true if the keys as description should be listed instead of the plain values
generateListFromFiles()
Generates a selection list from files found on disk
generateListFromFiles(strig $currentValue, string $root, string $suffix[, bool $descending = false ]) : mixed
Parameters
- $currentValue : strig
-
the current value of the selector
- $root : string
-
directory path to search
- $suffix : string
-
suffix to select for
- $descending : bool = false
-
set true to get a reverse order sort. Set to null to keep the array as it is passed.
generateAttributesFromArray()
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)
Parameters
- $attributes : array<string|int, mixed> = array()
-
key => value pairs of element attribute name and value. e.g. array('class' => 'someclass', 'id' => 'someid');
- $exclude : array<string|int, mixed> = array()
-
Names of attributes to exclude (in case already set otherwise)
Tags
Return values
stringgetLinkHTML()
getLinkHTML(string $url, string $text[, string $title = NULL ][, string $class = NULL ][, string $id = NULL ][, array<string|int, mixed> $extra_attr = array() ]) : mixed
Parameters
- $url : string
-
The link URL
- $text : string
-
The text to go with the link
- $title : string = NULL
-
Text for the title tag
- $class : string = NULL
-
optional class
- $id : string = NULL
-
optional id
- $extra_attr : array<string|int, mixed> = array()
-
Additional attributes as array of key => value pairs
printLinkHTML()
General link printing function
printLinkHTML(string $url, string $text[, string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
Parameters
- $url : string
-
The link URL
- $text : string
-
The text to go with the link
- $title : string = NULL
-
Text for the title tag
- $class : string = NULL
-
optional class
- $id : string = NULL
-
optional id
shuffle_assoc()
shuffles an array maintaining the keys
shuffle_assoc(array<string|int, mixed> &$array) : bool
Parameters
- $array : array<string|int, mixed>
Return values
boolsortByKey()
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.
Parameters
- $results : array<string|int, mixed>
- $sortkey : string
- $order : string
sortMultiArray()
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
Parameters
- $array : array<string|int, mixed>
-
The multidimensional array to be sorted
- $index : mixed
-
Which key(s) should be sorted by
- $descending : string = false
-
true for descending sortorder
- $natsort : bool = true
-
If natural order should be used. If available sorting will be locale aware.
- $case_sensitive : bool = false
-
If the sort should be case sensitive. Note if $natsort is true and locale aware sorting is available sorting is always case sensitive
- $preservekeys : bool = false
-
Default false,
- $remove_criteria : array<string|int, mixed> = array()
-
Array of indices to remove.
Tags
Return values
array<string|int, mixed>sortArray()
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.
Parameters
- $array : array<string|int, mixed>
-
The array to sort. The array is passed by reference
- $descending : string = false
-
true for descending sorts (default false)
- $natsort : bool = true
-
If natural order should be used (default true). If available sorting will be locale sensitive.
- $case_sensitive : bool = false
-
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
Tags
Return values
boolgetNotViewableAlbums()
Returns a list of album IDs that the current viewer is not allowed to see
getNotViewableAlbums() : array<string|int, mixed>
Return values
array<string|int, mixed>getNotViewableImages()
Returns a list of image IDs that the current viewer is not allowed to see
getNotViewableImages() : array<string|int, mixed>
Return values
array<string|int, mixed>isValidURL()
Checks to see if a URL is valid
isValidURL(string $url) : bool
Parameters
- $url : string
-
the URL being checked
Return values
boolsafe_fnmatch()
pattern match function Works with characters with diacritical marks where the PHP one does not.
safe_fnmatch(string $pattern, string $string) : bool
Parameters
- $pattern : string
-
pattern
- $string : string
-
haystack
Return values
boolisValidEmail()
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.
Parameters
- $email : string
-
An email address
Tags
Return values
boolzp_image_types()
returns a list of comment record 'types' for "images"
zp_image_types(string $quote) : string
Parameters
- $quote : string
-
quotation mark to use
Return values
stringdircopy()
Copies a directory recursively
dircopy(string $srcdir, string $dstdir) : the
Parameters
- $srcdir : string
-
the source directory.
- $dstdir : string
-
the destination directory.
Return values
the —total number of files copied.
byteConvert()
Returns a byte size from a size value (eg: 100M).
byteConvert(int $bytes) : string
Parameters
- $bytes : int
Return values
stringdateTimeConvert()
Converts a datetime to connoical form
dateTimeConvert(string $datetime[, bool $raw = false ]) : mixed
Parameters
- $datetime : string
-
input date/time string
- $raw : bool = false
-
set to true to return the timestamp otherwise you get a string
removeDateTimeZone()
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
Parameters
- $date : string
Tags
Return values
stringget_context()
get_context() : mixed
set_context()
set_context(mixed $context) : mixed
Parameters
- $context : mixed
in_context()
in_context(mixed $context) : mixed
Parameters
- $context : mixed
add_context()
add_context(mixed $context) : mixed
Parameters
- $context : mixed
rem_context()
rem_context(mixed $context) : mixed
Parameters
- $context : mixed
save_context()
save_context() : mixed
restore_context()
restore_context() : mixed
getContextObject()
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
Tags
Return values
bool|objzp_handle_password()
checks password posting
zp_handle_password([string $authType = NULL ][, mixed $check_auth = NULL ][, mixed $check_user = NULL ]) : mixed
Parameters
- $authType : string = NULL
-
override of athorization type
- $check_auth : mixed = NULL
- $check_user : mixed = NULL
zp_handle_password_single()
Handles a passwort
zp_handle_password_single([string $authType = NULL ][, string $check_auth = NULL ][, string $check_user = NULL ]) : bool
Parameters
- $authType : string = NULL
-
override of authorization type
- $check_auth : string = NULL
-
Password
- $check_user : string = NULL
-
User
Return values
boolgetOptionFromDB()
Gets an option directly from the database.
getOptionFromDB(string $key) : mixed
Parameters
- $key : string
setThemeOption()
Set options local to theme and/or album
setThemeOption(string $key, string $value, object $album, string $theme[, bool $default = false ]) : mixed
Parameters
- $key : string
- $value : string
- $album : object
- $theme : string
-
default theme
- $default : bool = false
-
set to true for setting default theme options (does not set the option if it already exists)
replaceThemeOption()
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
Parameters
- $oldkey : string
-
Old option name
- $newkey : string
-
New option name
Tags
purgeThemeOption()
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
Parameters
- $key : string
- $album : mixed = NULL
- $theme : mixed = NULL
- $allthemes : mixed = false
Tags
purgeThemeOptionTotal()
Deletes a theme option for all themes present or not
purgeThemeOptionTotal(string $key) : mixed
Parameters
- $key : string
Tags
setThemeOptionDefault()
Used to set default values for theme specific options
setThemeOptionDefault(string $key, mixed $value) : mixed
Parameters
- $key : string
- $value : mixed
getThemeOption()
Returns the value of a theme option
getThemeOption(string $option[, object $album = NULL ][, string $theme = NULL ]) : mixed
Parameters
- $option : string
-
option key
- $album : object = NULL
- $theme : string = NULL
-
default theme name
getUserIP()
Returns the viewer's IP address Deals with transparent proxies
getUserIP([bool $anonymize = null ]) : string
Parameters
- $anonymize : bool = null
-
If null (default) the backend option setting is used. Override with anonymize levels
- 0 (No anonymizing)
- 1 (Last fourth anonymized)
- 2 (Last half anonymized)
- 3 (Last three fourths anonymized)
- 4 (Full anonymization, no IP stored)
Return values
stringgetAnonymIP()
Anonymizing of IP addresses
getAnonymIP(mixed $ip[, bool $anonymize = null ]) : string
Parameters
- $ip : mixed
- $anonymize : bool = null
-
If null (default) the backend option setting is used. Override with anonymize levels
- 0 (No anonymizing)
- 1 (Last fourth anonymized)
- 2 (Last half anonymized)
- 3 (Last three fourths anonymized)
- 4 (Full anonymization, no IP stored)
Return values
stringseoFriendly()
Strips out and/or replaces characters from the string that are not "soe" friendly
seoFriendly(string $string) : string
Parameters
- $string : string
Return values
stringseoFriendlyJS()
emit the javascript seojs() function
seoFriendlyJS() : mixed
is_connected()
Returns true if there is an internet connection
is_connected([string $host = 'www.zenphoto.org' ]) : bool
Parameters
- $host : string = 'www.zenphoto.org'
-
optional host name to test
Return values
booldebug404()
produce debugging information on 404 errors
debug404(string $album, string $image, string $theme) : mixed
Parameters
- $album : string
- $image : string
- $theme : string
XSRFdefender()
Checks for Cross Site Request Forgeries
XSRFdefender(string $action) : mixed
Parameters
- $action : string
getXSRFToken()
returns an XSRF token
getXSRFToken(string $action) : mixed
Parameters
- $action : string
XSRFToken()
Emits a "hidden" input for the XSRF token
XSRFToken(string $action) : mixed
Parameters
- $action : string
cron_starter()
Starts a sechedule script run
cron_starter(string $script, array<string|int, mixed> $params, mixed $offsetPath[, bool $inline = false ]) : mixed
Parameters
- $script : string
-
The script file to load
- $params : array<string|int, mixed>
-
"POST" parameters
- $offsetPath : mixed
- $inline : bool = false
-
set to true to run the task "in-line". Set false run asynchronously
zp_loggedin()
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
Parameters
- $rights : bit = ALL_RIGHTS
-
rights required by the caller
Return values
boolread_exif_data_protected()
Provides an error protected read of image EXIF/IPTC data
read_exif_data_protected(string $path) : array<string|int, mixed>
Parameters
- $path : string
-
image path
Return values
array<string|int, mixed>getLanguageFlag()
fetches the path to the flag image
getLanguageFlag(string $lang) : string
Parameters
- $lang : string
-
whose flag
Return values
stringgetItemByID()
Gets an item object by id
getItemByID(string $table, int $id) : mixed
Parameters
- $table : string
-
database table to search
- $id : int
-
id of the item to get
reveal()
uses down and up arrow links to show and hide sections of HTML
reveal(string $content[, bool $visible = false ]) : mixed
Parameters
- $content : string
-
the id of the html section to be revealed
- $visible : bool = false
-
true if the content is initially visible
applyMacros()
Deals with the [macro parameters] substitutions
applyMacros(string $text) : string
See the macroList plugin for details
Parameters
- $text : string
Return values
stringgetMacros()
getMacros() : mixed
getNestedAlbumList()
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>
Parameters
- $subalbum :
-
root level album (NULL is the gallery)
- $levels :
-
how far to nest
- $checkalbumrights : = true
-
TRUE (Default) for album rights for backend usage, FALSE to skip for frontend usage
- $level : = array()
-
internal for keeping the sort order elements
Return values
array<string|int, mixed>setexifvars()
initializes the $_zp_exifvars array display state
setexifvars() : mixed
removeDir()
Recursively clears and removes a folder
removeDir(string $path[, mixed $within = false ]) : bool
Parameters
- $path : string
- $within : mixed = false
Return values
booltagURLs()
inserts location independent WEB path tags in place of site path tags
tagURLs(string $text) : mixed
Parameters
- $text : string
unTagURLs()
reverses tagURLs()
unTagURLs(string|array<string|int, mixed> $text) : string
Parameters
- $text : string|array<string|int, mixed>
Return values
stringupdateImageProcessorLink()
Searches out i.php image links and replaces them with cache links if image is cached
updateImageProcessorLink(string $text) : string
Parameters
- $text : string
Return values
stringpluginDebug()
pluginDebug(mixed $extension, mixed $priority, mixed $start) : mixed
Parameters
- $extension : mixed
- $priority : mixed
- $start : mixed
removeTrailingSlash()
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
Parameters
- $string : string
Tags
Return values
stringgetDataUsageNotice()
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>
Tags
Return values
array<string|int, mixed>printDataUsageNotice()
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
Tags
getCookieInfoData()
Returns an array with predefined info about general cookies set by the system and/or plugins
getCookieInfoData([string $section = null ]) : array<string|int, mixed>
Parameters
- $section : string = null
-
Name of the section to get: 'authentication', 'search', 'admin', 'cookie', 'various' or null (default) for the full array
Tags
Return values
array<string|int, mixed>getCookieInfoHTML()
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
Parameters
- $section : string = null
-
Name of the section to get: 'authentication', 'search', 'admin', 'cookie', 'various' or null (default) for the full array
- $sectionheadline : string = 'h2'
-
Add h2 to h6 to print as the section headline, h2 default.
Tags
Return values
stringprintCookieInfo()
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
Parameters
- $section : string = null
-
Name of the section to get: 'authentication', 'search', 'admin', 'cookie', 'various' or null (default) for the full array
- $sectionheadline : string = 'h2'
-
Add h2 to h6 to print as the section headline, h2 default.
Tags
getCookieInfoMacro()
Registers the content macro(s)
getCookieInfoMacro(array<string|int, mixed> $macros) : array<string|int, mixed>
Parameters
- $macros : array<string|int, mixed>
-
Passes through the array of already registered
Return values
array<string|int, mixed>getImageMetadataValue()
Gets a formatted metadata field value for display
getImageMetadataValue([string $type = '' ][, mixed $value = '' ][, string $name = '' ]) : mixed
Parameters
- $type : string = ''
-
The field type
- $value : mixed = ''
-
The field value
- $name : string = ''
-
The field name (Metadata Key)
Tags
printImageMetadataValue()
Prints a formatted metadata field value
printImageMetadataValue(string $type[, mixed $value = '' ][, string $name = '' ]) : mixed
Parameters
- $type : string
-
The field type
- $value : mixed = ''
-
The field value
- $name : string = ''
-
The field name (Metadata Key)
Tags
rc4()
encryption support functions
rc4(mixed $pass, mixed $message) : mixed
Parameters
- $pass : mixed
- $message : mixed
bindtextdomain()
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!
Parameters
- $domain : mixed
- $path : mixed
bind_textdomain_codeset()
bind_textdomain_codeset(mixed $domain, mixed $codeset) : mixed
Parameters
- $domain : mixed
- $codeset : mixed
textdomain()
textdomain(mixed $domain) : mixed
Parameters
- $domain : mixed
gettext()
gettext(mixed $msgid) : mixed
Parameters
- $msgid : mixed
ngettext()
ngettext(mixed $msgid1, mixed $msgid2, mixed $n) : mixed
Parameters
- $msgid1 : mixed
- $msgid2 : mixed
- $n : mixed
dgettext()
dgettext(mixed $plugin, mixed $string) : mixed
Parameters
- $plugin : mixed
- $string : mixed
dngettext()
dngettext(mixed $theme, mixed $msgid1, mixed $msgid2, mixed $n) : mixed
Parameters
- $theme : mixed
- $msgid1 : mixed
- $msgid2 : mixed
- $n : mixed
kses()
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
Parameters
- $string : type
- $allowed_html : type
- $allowed_protocols : type = array('http', 'https', 'ftp', 'news', 'nntp', 'telnet', 'gopher', 'mailto')
Return values
typekses_hook()
You add any kses hooks here.
kses_hook(mixed $string) : mixed
Parameters
- $string : mixed
kses_version()
This function returns kses' version number.
kses_version() : mixed
kses_split()
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
Parameters
- $string : mixed
- $allowed_html : mixed
- $allowed_protocols : mixed
kses_split2()
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
Parameters
- $matches : type
Tags
Return values
stringkses_attr()
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.
Parameters
- $element : type
- $attr : type
- $allowed_html : type
- $allowed_protocols : type
Return values
typekses_hair()
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
Parameters
- $attr : type
- $allowed_protocols : type
Return values
typekses_check_attr_val()
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
Parameters
- $value : type
- $vless : type
- $checkname : type
- $checkvalue : type
Return values
boolkses_bad_protocol()
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
Parameters
- $string : type
- $allowed_protocols : type
Return values
typekses_no_null()
This function removes any NULL characters in $string.
kses_no_null(type $string) : type
Parameters
- $string : type
Return values
typekses_stripslashes()
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
Parameters
- $string : type
Return values
typekses_array_lc()
This function goes through an array, and changes the keys to all lower case.
kses_array_lc(mixed $inarray) : mixed
Parameters
- $inarray : mixed
kses_js_entities()
This function removes the HTML JavaScript entities found in early versions of Netscape 4.
kses_js_entities(type $string) : type
Parameters
- $string : type
Return values
typekses_html_error()
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
Parameters
- $string : type
Return values
typekses_bad_protocol_once()
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
Parameters
- $string : type
- $allowed_protocols : type
Tags
Return values
typekses_bad_protocol_once2()
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
Parameters
- $matches : type
Tags
Return values
stringkses_normalize_entities()
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
Parameters
- $string : type
Return values
typekses_normalize_entities2()
This function helps kses_normalize_entities() to only accept 16 bit values and nothing more for &#number; entities.
kses_normalize_entities2(type $matches) : type
Parameters
- $matches : type
Return values
typekses_decode_entities()
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
Parameters
- $string : type
Return values
typemb_strtolower()
mb_strtolower(mixed $str) : mixed
Parameters
- $str : mixed
mb_strtoupper()
mb_strtoupper(mixed $str) : mixed
Parameters
- $str : mixed
mb_strlen()
mb_strlen(mixed $str) : mixed
Parameters
- $str : mixed
mb_substr()
mb_substr(mixed $str, mixed $start[, mixed $length = NULL ]) : mixed
Parameters
- $str : mixed
- $start : mixed
- $length : mixed = NULL
mb_strrpos()
mb_strrpos(mixed $haystack, mixed $needle) : mixed
Parameters
- $haystack : mixed
- $needle : mixed
mb_strpos()
mb_strpos(mixed $haystack, mixed $needle[, mixed $offset = 0 ]) : mixed
Parameters
- $haystack : mixed
- $needle : mixed
- $offset : mixed = 0
mb_substr_count()
mb_substr_count(mixed $haystack, mixed $needle) : mixed
Parameters
- $haystack : mixed
- $needle : mixed
processCommentBlock()
processCommentBlock(mixed $commentBlock) : mixed
Parameters
- $commentBlock : mixed
getOption()
getOption(mixed $key) : mixed
Parameters
- $key : mixed
setOption()
setOption(mixed $key, mixed $value[, mixed $persistent = true ]) : mixed
Parameters
- $key : mixed
- $value : mixed
- $persistent : mixed = true
setOptionDefault()
setOptionDefault(mixed $key, mixed $value) : mixed
Parameters
- $key : mixed
- $value : mixed
debugLog()
debugLog(mixed $message[, mixed $reset = false ]) : mixed
Parameters
- $message : mixed
- $reset : mixed = false
getRequestURI()
getRequestURI() : mixed
getVersion()
Returns the zenphoto version string
getVersion() : mixed
printVersion()
Prints the zenphoto version string
printVersion() : mixed
printZenJavascripts()
Print any Javascript required by zenphoto.
printZenJavascripts() : mixed
adminToolbox()
Prints the clickable drop down toolbox on any theme page with generic admin helpers
adminToolbox() : mixed
getGalleryTitle()
Returns the raw title of the gallery.
getGalleryTitle() : string
Return values
stringgetBareGalleryTitle()
Returns a text-only title of the gallery.
getBareGalleryTitle() : string
Return values
stringprintGalleryTitle()
Prints the title of the gallery.
printGalleryTitle() : mixed
printBareGalleryTitle()
printBareGalleryTitle() : mixed
getHeadTitle()
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> |Parameters
- $separator : string = ' | '
-
How you wish the parts to be separated
- $listparentalbums : bool = false
-
If the parent albums should be printed in reversed order before the current
- $listparentpages : mixed = false
printHeadTitle()
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
Parameters
- $separator : string = ' | '
-
How you wish the parts to be separated
- $listparentalbums : bool = true
-
If the parent albums should be printed in reversed order before the current
- $listparentpages : mixed = false
getGalleryDesc()
Returns the raw description of the gallery.
getGalleryDesc() : string
Return values
stringgetBareGalleryDesc()
Returns a text-only description of the gallery.
getBareGalleryDesc() : string
Return values
stringprintGalleryDesc()
Prints the description of the gallery.
printGalleryDesc() : mixed
printBareGalleryDesc()
printBareGalleryDesc() : mixed
getParentSiteTitle()
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
Tags
Return values
stringgetParentSiteURL()
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
Tags
Return values
stringgetMainSiteName()
getMainSiteName() : string
Tags
Return values
stringgetMainSiteURL()
getMainSiteURL() : string
Tags
Return values
stringgetGalleryIndexURL()
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!
Return values
stringgetStandardGalleryIndexURL()
Returns the url to the standard gallery index.php page
getStandardGalleryIndexURL([int $page = 1 ][, bool $webpath = null ]) : string
Parameters
- $page : int = 1
-
Pagenumber to append
- $webpath : bool = null
-
host path to be prefixed. If "false" is passed you will get a localized "WEBPATH"
Tags
Return values
stringgetCustomGalleryIndexURL()
Gets the custom gallery index url if one is set, otherwise false
getCustomGalleryIndexURL([int $page = 1 ][, bool $webpath = null ]) : string
Parameters
- $page : int = 1
-
Pagenumber for pagination
- $webpath : bool = null
-
host path to be prefixed. If "false" is passed you will get a localized "WEBPATH"
Tags
Return values
stringgetCustomGalleryIndexPage()
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
Return values
stringprintGalleryIndexURL()
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
Parameters
- $after : string = NULL
-
Text to append after and outside the link for breadcrumbs
- $text : string = NULL
-
Name of the link, if NULL "Gallery" is used
- $printHomeURL : bool = true
-
In case of a custom gallery index, display breadcrumb with home link (default is true)
Tags
getSiteHomeURL()
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
Tags
Return values
stringprintSiteHomeURL()
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
Parameters
- $after : string = NULL
-
Text after and outside the link for breadcrumbs
- $text : string = NULL
-
Text of the link, if NULL "Home"
printPrivacyPageLink()
If the privacy page url option is set this prints a link to it
printPrivacyPageLink([string $before = null ][, string $after = null ]) : mixed
Parameters
- $before : string = null
-
To print before the link
- $after : string = null
-
To print after the link
getNumAlbums()
Returns the number of albums.
getNumAlbums() : int
Return values
intgetCurrentTheme()
Returns the name of the currently active theme
getCurrentTheme() : string
Return values
stringnext_album()
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
Parameters
- $all : bool = false
-
true to go through all the albums
- $mine : bool = NULL
-
override the password checks
Tags
Return values
boolgetCurrentPage()
Returns the number of the current page without printing it.
getCurrentPage() : int
Return values
intgetAllAccessibleAlbums()
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
Parameters
- $obj : object
-
from whence to get the albums
- $albumlist : array<string|int, mixed>
-
collects the list
- $scan : bool
-
force scan for new images in the album folder
getTotalPages()
Returns the number of pages for the current object
getTotalPages([bool $one_image_page = false ]) : int
Parameters
- $one_image_page : bool = false
-
set to true if your theme collapses all image thumbs or their equivalent to one page. This is typical with flash viewer themes
Return values
intgetPageNumURL()
Returns the URL of the page number passed as a parameter
getPageNumURL(int $page[, int $total = null ]) : int
Parameters
- $page : int
-
Which page is desired
- $total : int = null
-
How many pages there are.
Return values
inthasNextPage()
Returns true if there is a next page
hasNextPage() : bool
Return values
boolgetNextPageURL()
Returns the URL of the next page. Use within If or while loops for pagination.
getNextPageURL() : string
Return values
stringprintNextPageURL()
Prints the URL of the next page.
printNextPageURL(string $text[, string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
Parameters
- $text : string
-
text for the URL
- $title : string = NULL
-
Text for the HTML title
- $class : string = NULL
-
Text for the HTML class
- $id : string = NULL
-
Text for the HTML id
hasPrevPage()
Returns TRUE if there is a previous page. Use within If or while loops for pagination.
hasPrevPage() : bool
Return values
boolgetPrevPageURL()
Returns the URL of the previous page.
getPrevPageURL() : string
Return values
stringprintPrevPageURL()
Returns the URL of the previous page.
printPrevPageURL(string $text[, string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
Parameters
- $text : string
-
The linktext that should be printed as a link
- $title : string = NULL
-
The text the html-tag "title" should contain
- $class : string = NULL
-
Insert here the CSS-class name you want to style the link with
- $id : string = NULL
-
Insert here the CSS-ID name you want to style the link with
printPageNav()
Prints a page navigation including previous and next page links
printPageNav(string $prevtext, string $separator, string $nexttext[, string $class = 'pagenav' ][, string $id = NULL ]) : mixed
Parameters
- $prevtext : string
-
Insert here the linktext like 'previous page'
- $separator : string
-
Insert here what you like to be shown between the prev and next links
- $nexttext : string
-
Insert here the linktext like "next page"
- $class : string = 'pagenav'
-
Insert here the CSS-class name you want to style the link with (default is "pagelist")
- $id : string = NULL
-
Insert here the CSS-ID name if you want to style the link with this
printPageList()
Prints a list of all pages.
printPageList([string $class = 'pagelist' ][, string $id = NULL ][, int $navlen = 9 ]) : mixed
Parameters
- $class : string = 'pagelist'
-
the css class to use, "pagelist" by default
- $id : string = NULL
-
the css id to use
- $navlen : int = 9
-
Number of navigation links to show (0 for all pages). Works best if the number is odd.
getPageNavList()
returns a page nav list.
getPageNavList(bool $_zp_one_image_page, int $navlen, bool $firstlast, int $current, int $total) : mixed
Parameters
- $_zp_one_image_page : bool
-
set to true if there is only one image page as, for instance, in flash themes
- $navlen : int
-
Number of navigation links to show (0 for all pages). Works best if the number is odd.
- $firstlast : bool
-
Add links to the first and last pages of you gallery
- $current : int
-
the current page
- $total : int
-
total number of pages
printPageListWithNav()
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
Parameters
- $prevtext : string
-
Insert here the linktext like 'previous page'
- $nexttext : string
-
Insert here the linktext like 'next page'
- $_zp_one_image_page : bool = false
-
set to true if there is only one image page as, for instance, in flash themes
- $nextprev : string = true
-
set to true to get the 'next' and 'prev' links printed
- $class : string = 'pagelist'
-
Insert here the CSS-class name you want to style the link with (default is "pagelist")
- $id : string = NULL
-
Insert here the CSS-ID name if you want to style the link with this
- $firstlast : bool = true
-
Add links to the first and last pages of you gallery
- $navlen : int = 9
-
Number of navigation links to show (0 for all pages). Works best if the number is odd.
makeAlbumCurrent()
Sets the album passed as the current album
makeAlbumCurrent(object $album) : mixed
Parameters
- $album : object
-
the album to be made current
getAlbumTitle()
Returns the raw title of the current album.
getAlbumTitle() : string
Return values
stringgetBareAlbumTitle()
Returns a text-only title of the current album.
getBareAlbumTitle() : string
Return values
stringgetAnnotatedAlbumTitle()
Returns an album title taged with of Not visible or password protected status
getAnnotatedAlbumTitle() : string
Return values
stringprintAnnotatedAlbumTitle()
printAnnotatedAlbumTitle() : mixed
printAlbumTitle()
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.
Tags
printBareAlbumTitle()
printBareAlbumTitle() : mixed
albumNumber()
Gets the 'n' for n of m albums
albumNumber() : int
Return values
intgetParentAlbums()
Returns an array of the names of the parents of the current album.
getParentAlbums([object $album = null ]) : array<string|int, mixed>
Parameters
- $album : object = null
-
optional album object to use inseted of the current album
Return values
array<string|int, mixed>getAlbumBreadcrumb()
returns the breadcrumb item for the current images's album
getAlbumBreadcrumb([string $title = NULL ]) : array<string|int, mixed>
Parameters
- $title : string = NULL
-
Text to be used as the URL title tag
Return values
array<string|int, mixed>printAlbumBreadcrumb()
prints the breadcrumb item for the current images's album
printAlbumBreadcrumb([string $before = '' ][, string $after = '' ][, string $title = NULL ]) : mixed
Parameters
- $before : string = ''
-
Text to place before the breadcrumb
- $after : string = ''
-
Text to place after the breadcrumb
- $title : string = NULL
-
Text to be used as the URL title attribute and text link
printSearchBreadcrumb()
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
Parameters
- $between : string = NULL
-
Insert here the text to be printed between the links
- $class : string = NULL
-
is the class for the link (if present)
- $search : string = NULL
-
text for a search page title
- $archive : string = NULL
-
text for an archive page title
- $format : string = 'F Y'
-
data format for archive page breadcrumb - A datetime format, if using localized dates an ICU dateformat
getParentBreadcrumb()
returns the breadcrumb navigation for album, gallery and image view.
getParentBreadcrumb() : array<string|int, mixed>
Return values
array<string|int, mixed>printParentBreadcrumb()
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
Parameters
- $before : string = NULL
-
Insert here the text to be printed before the links
- $between : string = NULL
-
Insert here the text to be printed between the links
- $after : string = NULL
-
Insert here the text to be printed after the links
- $truncate : mixed = NULL
-
if not empty, the max lenght of the description.
- $elipsis : string = NULL
-
the text to append to the truncated description
printHomeLink()
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
Parameters
- $before : string = ''
-
text to precede the link
- $after : string = ''
-
text to follow the link
- $title : string = NULL
-
Title text
- $class : string = NULL
-
optional css class
- $id : string = NULL
-
optional css id
getAlbumDate()
Returns the formatted date field of the album
getAlbumDate([string $format = null ]) : string
Parameters
- $format : string = null
-
optional format string for the date - A datetime format, if using localized dates an ICU dateformat
Return values
stringprintAlbumDate()
Prints the date of the current album
printAlbumDate([string $before = '' ][, string $format = NULL ]) : mixed
Parameters
- $before : string = ''
-
Insert here the text to be printed before the date.
- $format : string = NULL
-
A datetime format, if using localized dates an ICU dateformat
getAlbumLocation()
Returns the Location of the album.
getAlbumLocation() : string
Return values
stringprintAlbumLocation()
Prints the location of the album
printAlbumLocation() : mixed
Tags
getAlbumDesc()
Returns the raw description of the current album.
getAlbumDesc() : string
Return values
stringgetBareAlbumDesc()
Returns a text-only description of the current album.
getBareAlbumDesc() : string
Return values
stringprintAlbumDesc()
Prints description of the current album
printAlbumDesc() : mixed
Tags
printBareAlbumDesc()
printBareAlbumDesc() : mixed
getAlbumCustomData()
Returns the custom_data field of the current album
getAlbumCustomData() : string
Return values
stringprintAlbumCustomData()
Prints the custom_data field of the current album.
printAlbumCustomData() : mixed
Converts and displays line break in the admin field as
.
Tags
getAlbumData()
A composit for getting album data
getAlbumData(string $field) : string
Parameters
- $field : string
-
which field you want
Return values
stringprintAlbumData()
Prints arbitrary data from the album object
printAlbumData(string $field[, string $label = '' ]) : mixed
Parameters
- $field : string
-
the field name of the data desired
- $label : string = ''
-
text to label the field
Tags
getAlbumPage()
Returns the album page number of the current image
getAlbumPage([object $album = NULL ]) : int
Parameters
- $album : object = NULL
-
optional album object
Return values
intgetAlbumURL()
Returns the album link url of the current album.
getAlbumURL([object $album = NULL ]) : string
Parameters
- $album : object = NULL
-
optional album object
Return values
stringprintAlbumURL()
Prints the album link url of the current album.
printAlbumURL(string $text, string $title[, string $class = NULL ][, string $id = NULL ]) : mixed
Parameters
- $text : string
-
Insert the link text here.
- $title : string
-
Insert the title text here.
- $class : string = NULL
-
Insert here the CSS-class name with with you want to style the link.
- $id : string = NULL
-
Insert here the CSS-id name with with you want to style the link.
getAlbumThumb()
Returns the name of the defined album thumbnail image.
getAlbumThumb() : string
Return values
stringgetPasswordProtectImage()
Returns an <img> element of the password protect thumb substitute
getPasswordProtectImage([string $extra = '' ]) : string
Parameters
- $extra : string = ''
-
extra stuff to put in the HTML
Tags
Return values
stringgetPasswordProtectedImage()
Gets the URL to the password protected images
getPasswordProtectedImage() : string
Tags
Return values
stringprintPasswordProtectedImage()
Prints an image element with the password protected image.
printPasswordProtectedImage([string $extra = '' ]) : mixed
Parameters
- $extra : string = ''
-
extra attributes, trailing space required. Do not pass the width/height as it is taken from the image itself
Tags
printAlbumThumbImage()
Prints the album thumbnail image.
printAlbumThumbImage([string $alt = '' ][, string $class = '' ][, string $id = '' ][, string $title = '' ]) : mixed
Parameters
- $alt : string = ''
-
Insert the text for the alternate image name here.
- $class : string = ''
-
Insert here the CSS-class name with with you want to style the link.
- $id : string = ''
-
Insert here the CSS-id name with with you want to style the link.
- $title : string = ''
-
option title attribute
getCustomAlbumThumb()
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
Parameters
- $size : int = null
-
the size of the image to have
- $width : int = NULL
-
width
- $height : int = NULL
-
height
- $cropw : int = NULL
-
crop width
- $croph : int = NULL
-
crop height
- $cropx : int = NULL
-
crop part x axis
- $cropy : int = null
-
crop part y axis
- $effects : bool = NULL
-
image effects (e.g. set 'gray' to force grayscale)
Return values
stringprintCustomAlbumThumbImage()
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.
Parameters
- $alt : string = ''
-
Alt atribute text
- $size : int = null
-
size
- $width : int = NULL
-
width
- $height : int = NULL
-
height
- $cropw : int = NULL
-
cropwidth
- $croph : int = NULL
-
crop height
- $cropx : int = NULL
-
crop part x axis
- $cropy : int = null
-
crop part y axis
- $class : string = NULL
-
css class
- $id : string = NULL
-
css id
- $title : string = null
-
title attribute
- $maxspace : bool = false
-
true for maxspace image, false is default
Return values
stringgetMaxSpaceContainer()
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
Parameters
- $width : int
-
maxspace width
- $height : int
-
maxspace height
- $image : object
-
the image in question
- $thumb : bool = false
-
true if for a thumbnail
getCustomAlbumThumbMaxSpace()
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
Parameters
- $width : int
-
width
- $height : int
-
height
Return values
stringprintCustomAlbumThumbMaxSpace()
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
Parameters
- $alt : string = ''
-
Alt text for the url
- $width : int = null
-
width
- $height : int = null
-
height
- $class : string = NULL
-
Optional style class
- $id : string = NULL
-
Optional style id
- $title : string = null
-
Optional title attribute
getNextAlbum()
Returns the next album
getNextAlbum() : object
Return values
objectgetNextAlbumURL()
Get the URL of the next album in the gallery.
getNextAlbumURL() : string
Return values
stringgetPrevAlbum()
Returns the previous album
getPrevAlbum() : object
Return values
objectgetPrevAlbumURL()
Get the URL of the previous album in the gallery.
getPrevAlbumURL() : string
Return values
stringisImagePage()
Returns true if this page has image thumbs on it
isImagePage() : bool
Return values
boolisAlbumPage()
Returns true if this page has album thumbs on it
isAlbumPage() : bool
Return values
boolgetNumImages()
Returns the number of images in the album.
getNumImages() : int
Return values
intgetFirstPageImages()
getFirstPageImages([type $one_image_page = false ]) : type
Parameters
- $one_image_page : type = false
Tags
Return values
typenext_image()
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
Parameters
- $all : bool = false
-
set to true disable pagination
- $firstPageCount : int = NULL
-
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.
- $mine : bool = NULL
-
overridePassword the password check
Return values
boolmakeImageCurrent()
Sets the image passed as the current image
makeImageCurrent(object $image) : mixed
Parameters
- $image : object
-
the image to become current
getImageTitle()
Returns the raw title of the current image.
getImageTitle() : string
Return values
stringgetBareImageTitle()
Returns a text-only title of the current image.
getBareImageTitle() : string
Return values
stringgetAnnotatedImageTitle()
Returns the image title taged with not visible annotation.
getAnnotatedImageTitle() : string
Return values
stringprintAnnotatedImageTitle()
printAnnotatedImageTitle() : mixed
printImageTitle()
Prints title of the current image
printImageTitle() : mixed
Tags
printBareImageTitle()
printBareImageTitle() : mixed
imageNumber()
Returns the 'n' of n of m images
imageNumber() : int
Return values
intgetImageDate()
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
Parameters
- $format : string = null
-
A datetime format, if using localized dates an ICU dateformat
Return values
stringprintImageDate()
Prints the date of the current album
printImageDate([string $before = '' ][, string $format = null ]) : mixed
Parameters
- $before : string = ''
-
Insert here the text to be printed before the date.
- $format : string = null
-
A datetime format, if using localized dates an ICU dateformat
getImageLocation()
Returns the Location field of the current image
getImageLocation() : string
Return values
stringgetImageCity()
Returns the City field of the current image
getImageCity() : string
Return values
stringgetImageState()
Returns the State field of the current image
getImageState() : string
Return values
stringgetImageCountry()
Returns the Country field of the current image
getImageCountry() : string
Return values
stringgetImageDesc()
Returns the raw description of the current image.
getImageDesc() : string
new lines are replaced with
tags
Return values
stringgetBareImageDesc()
Returns a text-only description of the current image.
getBareImageDesc() : string
Return values
stringprintImageDesc()
Prints the description of the current image.
printImageDesc() : mixed
Converts and displays line breaks set in the admin field as
.
printBareImageDesc()
printBareImageDesc() : mixed
getImageData()
A composit for getting image data
getImageData(string $field) : string
Parameters
- $field : string
-
which field you want
Return values
stringgetImageCustomData()
Returns the custom_data field of the current image
getImageCustomData() : string
Return values
stringprintImageCustomData()
Prints the custom_data field of the current image.
printImageCustomData() : string
Converts and displays line breaks set in the admin field as
.
Return values
stringprintImageData()
Prints arbitrary data from the image object
printImageData(string $field[, string $label = '' ]) : mixed
Parameters
- $field : string
-
the field name of the data desired
- $label : string = ''
-
text to label the field.
Tags
getFullImageFilesize()
Returns the file size of the full original image
getFullImageFilesize() : int
Tags
Return values
inthasNextImage()
True if there is a next image
hasNextImage() : bool
Return values
boolhasPrevImage()
True if there is a previous image
hasPrevImage() : bool
Return values
boolgetNextImageURL()
Returns the url of the next image.
getNextImageURL() : string
Return values
stringgetPrevImageURL()
Returns the url of the previous image.
getPrevImageURL() : string
Return values
stringgetPrevImageThumb()
Returns the thumbnail of the previous image.
getPrevImageThumb() : string
Return values
stringgetNextImageThumb()
Returns the thumbnail of the next image.
getNextImageThumb() : string
Return values
stringgetImageURL()
Returns the url of the current image.
getImageURL() : string
Return values
stringprintImageURL()
Prints the link to the current image.
printImageURL(string $text, string $title[, string $class = NULL ][, string $id = NULL ]) : mixed
Parameters
- $text : string
-
text for the link
- $title : string
-
title tag for the link
- $class : string = NULL
-
optional style class for the link
- $id : string = NULL
-
optional style id for the link
getImageMetaData()
Returns the Metadata infromation from the current image
getImageMetaData([ $image = NULL ][, string $displayonly = true ]) : array<string|int, mixed>
Parameters
- $image : = NULL
-
optional image object
- $displayonly : string = true
-
set to true to return only the items selected for display
Return values
array<string|int, mixed>printImageMetadata()
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
Parameters
- $title : string = NULL
-
title tag for the class
- $toggle : bool = true
-
set to true to get a javascript toggle on the display of the data
- $id : string = 'imagemetadata'
-
style class id
- $class : string = null
-
style class
- $span : mixed = NULL
Tags
getSizeCustomImage()
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>
Parameters
- $size : int = null
-
size
- $width : int = NULL
-
width
- $height : int = NULL
-
height
- $cw : int = NULL
-
crop width
- $ch : int = NULL
-
crop height
- $cx : int = NULL
-
crop x axis
- $cy : int = NULL
-
crop y axis
- $image : obj = NULL
-
The image object for which the size is desired. NULL means the current image
- $type : string = 'image'
-
"image" (sizedimage) (default), "thumb" (thumbnail) required for using option settings for uncropped images
Return values
array<string|int, mixed>getSizeDefaultImage()
Returns an array [width, height] of the default-sized image.
getSizeDefaultImage([int $size = NULL ][, $image = NULL ]) : array<string|int, mixed>
Parameters
- $size : int = NULL
-
override the 'image_zize' option
- $image : = NULL
-
object the image for which the size is desired. NULL means the current image
Return values
array<string|int, mixed>getSizeFullImage()
Returns an array [width, height] of the original image.
getSizeFullImage([ $image = NULL ]) : array<string|int, mixed>
Parameters
Return values
array<string|int, mixed>getDefaultWidth()
The width of the default-sized image (in printDefaultSizedImage)
getDefaultWidth([mixed $size = NULL ][, $image = NULL ]) : int
Parameters
- $size : mixed = NULL
- $image : = NULL
-
object the image for which the size is desired. NULL means the current image
Return values
intgetDefaultHeight()
Returns the height of the default-sized image (in printDefaultSizedImage)
getDefaultHeight([mixed $size = NULL ][, $image = NULL ]) : int
Parameters
- $size : mixed = NULL
- $image : = NULL
-
object the image for which the size is desired. NULL means the current image
Return values
intgetFullWidth()
Returns the width of the original image
getFullWidth([ $image = NULL ]) : int
Parameters
Return values
intgetFullHeight()
Returns the height of the original image
getFullHeight([ $image = NULL ]) : int
Parameters
Return values
intisLandscape()
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
Parameters
Return values
boolgetDefaultSizedImage()
Returns the url to the default sized image.
getDefaultSizedImage([ $image = NULL ]) : string
Parameters
Return values
stringprintDefaultSizedImage()
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
Parameters
- $alt : string
-
Alt text
- $class : string = null
-
Optional style class
- $id : string = null
-
Optional style id
- $title : string = null
-
Optional title attribute
- $image : obj = null
-
optional image object, null means current image
getImageThumb()
Returns the url to the thumbnail of the current image.
getImageThumb([obj $image = null ]) : string
Parameters
- $image : obj = null
-
optional image object, null means current image
Return values
stringprintImageThumb()
printImageThumb(string $alt[, string $class = null ][, string $id = null ][, string $title = null ][, obj $image = null ]) : mixed
Parameters
- $alt : string
-
Alt text
- $class : string = null
-
optional class attribute
- $id : string = null
-
optional id attribute
- $title : string = null
-
optional title attribute
- $image : obj = null
-
optional image object, null means current image
getSizeDefaultThumb()
Gets the width and height of a default thumb for the <img> tag height/width
getSizeDefaultThumb([obj $image = NULL ]) : aray
Parameters
- $image : obj = NULL
-
Image object, if NULL the current image is used
Tags
Return values
araygetFullImageURL()
Returns the url to original image.
getFullImageURL([ $image = NULL ]) : string
It will return a protected image is the option "protect_full_image" is set
Parameters
Return values
stringgetUnprotectedImageURL()
Returns the "raw" url to the image in the albums folder
getUnprotectedImageURL([ $image = NULL ]) : string
Parameters
Return values
stringgetProtectedImageURL()
Returns an url to the password protected/watermarked current image
getProtectedImageURL([object $image = NULL ][, string $disposal = NULL ]) : string
Parameters
- $image : object = NULL
-
optional image object overrides the current image
- $disposal : string = NULL
-
set to override the 'protect_full_image' option. 'protected', "download", "unprotected" or "no-access"
Return values
stringgetSizedImageURL()
Returns a link to the current image custom sized to $size
getSizedImageURL(int $size) : mixed
Parameters
- $size : int
-
The size the image is to be
getCustomImageURL()
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
Parameters
- $size : int
-
the size of the image to have
- $width : int = NULL
-
width
- $height : int = NULL
-
height
- $cropw : int = NULL
-
crop width
- $croph : int = NULL
-
crop height
- $cropx : int = NULL
-
crop part x axis
- $cropy : int = NULL
-
crop part y axis
- $thumbStandin : bool = false
-
set true to inhibit watermarking
- $effects : bool = NULL
-
image effects (e.g. set gray to force to grayscale)
- $image : obj = null
-
optional image object, null means current image
Return values
string —$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.
printCustomSizedImage()
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.
Parameters
- $alt : string = ''
-
Alt text for the url
- $size : int = null
-
size
- $width : int = NULL
-
width
- $height : int = NULL
-
height
- $cropw : int = NULL
-
crop width
- $croph : int = NULL
-
crop height
- $cropx : int = NULL
-
crop x axis
- $cropy : int = NULL
-
crop y axis
- $class : string = NULL
-
Optional style class
- $id : string = NULL
-
Optional style id
- $thumbStandin : bool = false
-
set to true to treat as thumbnail
- $effects : bool = NULL
-
image effects (e.g. set gray to force grayscale)
- $title : string = null
-
Optional title attribute
- $type : string = 'image'
-
"image" (sizedimage) (default), "thumb" (thumbnail) required for using option settings for uncropped images
- $image : obj = null
-
optional image object, null means current image
- $maxspace : bool = false
-
true for maxspace, false default
getCustomSizedImageMaxSpace()
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.
Parameters
- $width : int
-
width
- $height : int
-
height
Return values
stringgetCustomSizedImageThumbMaxSpace()
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.
Parameters
- $width : int
-
width
- $height : int
-
height
Return values
stringprintCustomSizedImageThumbMaxSpace()
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
Parameters
- $alt : string = ''
-
Alt text for the url
- $width : int = null
-
width
- $height : int = null
-
height
- $class : string = NULL
-
Optional style class
- $id : string = NULL
-
Optional style id
- $title : string = null
-
optional title attribute
- $image : obj = null
-
optional image object, null means current image
printCustomSizedImageMaxSpace()
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
Parameters
- $alt : string = ''
-
Alt text for the url
- $width : int = null
-
width
- $height : int = null
-
height
- $class : string = NULL
-
Optional style class
- $id : string = NULL
-
Optional style id
- $thumb : mixed = false
- $title : string = null
-
optional title attribute
- $image : obj = null
-
optional image object, null means current image
printSizedImageURL()
Prints link to an image of specific size
printSizedImageURL(int $size, string $text, string $title[, string $class = NULL ][, string $id = NULL ]) : mixed
Parameters
- $size : int
-
how big
- $text : string
-
URL text
- $title : string
-
URL title
- $class : string = NULL
-
optional URL class
- $id : string = NULL
-
optional URL id
getTags()
Returns a list of tags for context of the page called where called
getTags() : string
Tags
Return values
stringprintTags()
Prints a list of tags, editable by admin
printTags([string $option = 'links' ][, string $preText = NULL ][, string $class = NULL ][, string $separator = ', ' ]) : mixed
Parameters
- $option : string = 'links'
-
links by default, if anything else the tags will not link to all other images with the same tag
- $preText : string = NULL
-
text to go before the printed tags
- $class : string = NULL
-
css class to apply to the div surrounding the UL list
- $separator : string = ', '
-
what charactor shall separate the tags
Tags
printAllTagsAs()
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
Parameters
- $option : string
-
"cloud" for tag cloud, "list" for simple list
- $class : string = ''
-
CSS class
- $sort : string = NULL
-
"results" for relevance list, "random" for random ordering, otherwise the list is alphabetical
- $counter : bool = FALSE
-
TRUE if you want the tag count within brackets behind the tag
- $links : bool = TRUE
-
set to TRUE to have tag search links included with the tag.
- $maxfontsize : int = 2
-
largest font size the cloud should display
- $maxcount : int = 50
-
the floor count for setting the cloud font size to $maxfontsize
- $mincount : int = 1
-
the minimum count for a tag to appear in the output
- $limit : int = NULL
-
set to limit the number of tags displayed to the top $numtags
- $minfontsize : int = 0.8
-
minimum font size the cloud should display
- $exclude_unassigned : bool = true
-
True or false if you wish to exclude tags that are not assigne to any item (default: true)
- $checkaccess : bool = false
-
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.
Tags
getAllDates()
Retrieves a list of all unique years & months from the images in the gallery
getAllDates([string $order = 'asc' ]) : array<string|int, mixed>
Parameters
- $order : string = 'asc'
-
set to 'desc' for the list to be in descending order
Return values
array<string|int, mixed>printAllDates()
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
Parameters
- $class : string = 'archive'
-
optional class
- $yearid : string = 'year'
-
optional class for "year"
- $monthid : string = 'month'
-
optional class for "month"
- $order : string = 'desc'
-
set to 'desc' for the list to be in descending order
getCustomPageURL()
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
Parameters
- $page : string
-
page name to include in URL
- $q : string = ''
-
query string to add to url
- $webpath : bool = null
-
host path to be prefixed. If "false" is passed you will get a localized "WEBPATH"
Return values
stringprintCustomPageURL()
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
Parameters
- $linktext : string
-
Text for the URL
- $page : string
-
page name to include in URL
- $q : string = ''
-
query string to add to url
- $prev : string = ''
-
text to insert before the URL
- $next : string = ''
-
text to follow the URL
- $class : string = NULL
-
optional class
isArchive()
tests if a search page is an "archive" page
isArchive() : bool
Return values
boolgetSearchURL()
Returns a search URL
getSearchURL(mixed $words, mixed $dates, mixed $fields, int $page[, array<string|int, mixed> $object_list = NULL ]) : string
Parameters
- $words : mixed
-
the search words target
- $dates : mixed
-
the dates that limit the search
- $fields : mixed
-
the fields on which to search
- $page : int
-
the page number for the URL
- $object_list : array<string|int, mixed> = NULL
-
the list of objects to search
Tags
Return values
stringprintSearchForm()
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..
Parameters
- $prevtext : string = NULL
-
text to go before the search form
- $id : string = 'search'
-
css id for the search form, default is 'search'
- $buttonSource : string = ''
-
optional path to the image for the button or if not a path to an image, this will be the button hint
- $buttontext : string = ''
-
optional text for the button ("Search" will be the default text)
- $iconsource : string = NULL
-
optional theme based icon for the search fields toggle
- $query_fields : array<string|int, mixed> = NULL
-
override selection for enabled fields with this list
- $object_list : mixed = NULL
- $within : string = NULL
-
set to true to search within current results, false to search fresh
- $enable_fieldselector : bool = null
-
True|false to enable/disable the search fields selector. Default null to use the option as set
Tags
getSearchWords()
Returns the a sanitized version of the search string
getSearchWords() : string
Tags
Return values
stringgetSearchDate()
Returns the date of the search
getSearchDate([string $format = 'F Y' ]) : string
Parameters
- $format : string = 'F Y'
-
A datetime format, if using localized dates an ICU dateformat
Tags
Return values
stringcheckForGuest()
returns the auth type of a guest login
checkForGuest([string &$hint = NULL ][, string &$show = NULL ]) : string
Parameters
- $hint : string = NULL
- $show : string = NULL
Return values
stringcheckAccess()
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.
Parameters
- $hint : string = NULL
-
the password hint
- $show : bool = NULL
-
whether there is a user associated with the password.
Tags
Return values
boolgetPageRedirect()
Returns a redirection link for the password form
getPageRedirect() : string
Return values
stringprintPasswordForm()
Prints the album password form
printPasswordForm(mixed $_password_hint[, mixed $_password_showuser = NULL ][, mixed $_password_showProtected = true ][, mixed $_password_redirect = NULL ]) : mixed
Parameters
- $_password_hint : mixed
- $_password_showuser : mixed = NULL
- $_password_showProtected : mixed = true
- $_password_redirect : mixed = NULL
Tags
printZenphotoLink()
prints the zenphoto logo and link
printZenphotoLink() : mixed
exposeZenPhotoInformations()
Expose some informations in a HTML comment
exposeZenPhotoInformations([string $obj = '' ][, array<string|int, mixed> $plugins = '' ][, string $theme = '' ]) : mixed
Parameters
- $obj : string = ''
-
the path to the page being loaded
- $plugins : array<string|int, mixed> = ''
-
list of activated plugins
- $theme : string = ''
-
The theme being used
getCodeblock()
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.
Parameters
- $number : int = 1
-
The codeblock you want to get
- $object : mixed = NULL
Return values
stringprintCodeblock()
Prints the content of a codeblock for an image, album or Zenpage newsarticle or page.
printCodeblock([int $number = 1 ][, mixed $what = NULL ]) : string
Parameters
- $number : int = 1
-
The codeblock you want to get
- $what : mixed = NULL
-
optonal object for which you want the codeblock
Return values
stringcheckPageValidity()
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
Parameters
- $request : bool
- $gallery_page : string
- $page : int
Return values
bool —will be true if all is well, false if a 404 error should occur
print404status()
print404status(mixed $album, mixed $image, mixed $obj) : mixed
Parameters
- $album : mixed
- $image : mixed
- $obj : mixed
getOwnerAuthor()
Gets current item's owner (gallery images and albums) or author (Zenpage articles and pages)
getOwnerAuthor([bool $fullname = false ]) : bool
Parameters
- $fullname : bool = false
-
If the owner/author has a real user account and there is a full name set it is returned
Tags
Return values
boolprintOwnerAuthor()
Prints current item's owner (gallery images and albums) or author (Zenpage articles and pages)
printOwnerAuthor([type $fullname = false ]) : mixed
Parameters
- $fullname : type = false
Tags
getOwnerAuthorURL()
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.
Tags
Return values
typeprintOwnerAuthorURL()
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.
Parameters
- $fullname : type = false
- $resulttype : type = 'all'
- $class : type = null
- $id : type = null
- $title : type = null
Tags
getUserURL()
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.
Parameters
- $username : string
-
The user name of a user. Note there is no check if the user name is actually valid!
- $resulttype : string = 'all'
-
'all' for owner and author, 'gallery' for owner of images/albums only, 'zenpage' for author of news articles and pages
Tags
Return values
string|nullprintUserURL()
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.
Parameters
- $username : string
-
The user name of a user.
- $resulttype : string = 'all'
-
'all' for owner and author, 'gallery' for owner of images/albums only, 'zenpage' for author of news articles and pages
- $linktext : string = null
-
The link text. If null the user name will be used
- $class : string = null
-
The CSS class to attach, default null.
- $id : type = null
-
The CSS id to attach, default null.
- $title : type = null
-
The title attribute to attach, default null so the user name is used
Tags
printCopyrightNotice()
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
Parameters
- $before : string = ''
-
Text to print before it
- $after : string = ''
-
Text to print after it Å“param bool $linked Default true to use the copyright URL if defined
- $linked : mixed = true
- $type : mixed = 'gallery'
Tags
printGalleryCopyrightNotice()
Display the site copyright notice if defined and display is enabled
printGalleryCopyrightNotice([string $before = '' ][, string $after = '' ][, mixed $linked = true ]) : mixed
Parameters
- $before : string = ''
-
Text to print before it
- $after : string = ''
-
Text to print after it Å“param bool $linked Default true to use the copyright URL if defined
- $linked : mixed = true
Tags
printImageCopyrightNotice()
Display the image copyright notice if defined and display iss enabled
printImageCopyrightNotice([string $before = '' ][, string $after = '' ][, mixed $linked = true ]) : mixed
Parameters
- $before : string = ''
-
Text to print before it
- $after : string = ''
-
Text to print after it Å“param bool $linked Default true to use the copyright URL if defined
- $linked : mixed = true
Tags
getCurrentPageAppendix()
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
Parameters
- $before : string = ' ('
-
Text to add before the page number. Default ' (';
- $after : string = ')'
-
Text to add ager the page number. Default ')';
Tags
Return values
stringprintCurrentPageAppendix()
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
Parameters
- $before : string = ' ('
-
Text to add before the page number. Default ' (';
- $after : string = ')'
-
Text to add ager the page number. Default ')';
Tags
gallerystats_filesize_r()
gallerystats_filesize_r(mixed $path) : mixed
Parameters
- $path : mixed
printBarGraph()
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
Parameters
- $sortorder : string = "mostimages"
-
"popular", "mostrated","toprated","mostcommented" or - only if $type = "albums"! - "mostimages"
- $type : string_type = "albums"
-
"albums", "images", "pages", "news", "tags"
- $from_number : mixed = 0
- $to_number : mixed = 10
printThumbNav()
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
Parameters
- $minitems : int = NULL
-
The minimum number of thumbs to be visible always if resized regarding responsiveness.
- $maxitems : int = NULL
-
The maximum number of thumbs to be visible always if resized regarding responsiveness.
- $width : int = NULL
-
Width Set to NULL if you want to use the backend plugin options.
- $height : int = NULL
-
Height Set to NULL if you want to use the backend plugin options.
- $cropw : int = NULL
-
Crop width Set to NULL if you want to use the backend plugin options.
- $croph : int = NULL
-
Crop heigth Set to NULL if you want to use the backend plugin options.
- $fullimagelink : bool = NULL
-
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.
- $mode : string = NULL
-
'horizontal','vertical', 'fade'
- $speed : int = NULL
-
The speed in miliseconds the slides advance when clicked
Tags
checkForUpdate()
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
Tags
Return values
string —If there is a more current version on the WEB, returns its version number otherwise returns FALSE
admin_showupdate()
Displays the "new version available" message on admin pages
admin_showupdate(mixed $tab, unknown_type $subtab) : mixed
Parameters
- $tab : mixed
- $subtab : unknown_type
get_AnyFile_suffixes()
get_AnyFile_suffixes() : mixed
comment_form_PaginationJS()
comment_form_PaginationJS() : mixed
comment_form_visualEditor()
comment_form_visualEditor() : mixed
comment_form_print10Most()
Admin overview summary
comment_form_print10Most() : mixed
getCommentAddress()
Processes the post of an address
getCommentAddress(int $i) : array<string|int, mixed>
Parameters
- $i : int
-
sequence number of the comment
Return values
array<string|int, mixed>getCommentErrors()
Returns an error message if a comment posting was not accepted
getCommentErrors() : string
Return values
stringprintCommentErrors()
Tool to output an error message if a comment posting was not accepted
printCommentErrors() : mixed
comment_form_addComment()
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
Parameters
- $name : string
-
Comment author name
- $email : string
-
Comment author email
- $website : string
-
Comment author website
- $comment : string
-
body of the comment
- $code : string
-
CAPTCHA code entered
- $code_ok : string
-
CAPTCHA hash expected
- $receiver : object
-
the object (image or album) to which to post the comment
- $ip : string
-
the IP address of the comment poster
- $private : bool
-
set to true if the comment is for the admin only
- $anon : bool
-
set to true if the poster wishes to remain anonymous
- $customdata : string
- $check : bit = false
-
bitmask of which fields must be checked. If set overrides the options
- $dataconfirmation : bool = null
-
True if data privacy confirmation required
- $textquiz_answer_user : string = ''
- $mathquiz_answer_user : string = ''
Return values
objectcommentFormUseCaptcha()
Use see if a captcha should be displayed
commentFormUseCaptcha() : bool
Return values
boolcomment_form_postcomment()
checks if comments are allowed and then processes them if so
comment_form_postcomment(string $error) : mixed
Parameters
- $error : string
comment_form_handle_comment()
Handles the POSTing of a comment
comment_form_handle_comment() : null|bool
Return values
null|boolgetCommentAuthorName()
Returns the comment author's name
getCommentAuthorName() : string
Return values
stringgetCommentAuthorEmail()
Returns the comment author's email
getCommentAuthorEmail() : string
Return values
stringgetCommentAuthorSite()
Returns the comment author's website
getCommentAuthorSite() : string
Return values
stringgetCommentAuthorLink()
Prints a link to the author
getCommentAuthorLink([string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
Parameters
- $title : string = NULL
-
URL title tag
- $class : string = NULL
-
optional class tag
- $id : string = NULL
-
optional id tag
printCommentAuthorLink()
Prints a link to the author
printCommentAuthorLink([string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
Parameters
- $title : string = NULL
-
URL title tag
- $class : string = NULL
-
optional class tag
- $id : string = NULL
-
optional id tag
getCommentDateTime()
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.
Parameters
- $format : string = NULL
-
A datetime format, if using localized dates an ICU dateformat
Return values
stringgetCommentBody()
Returns the body of the current comment
getCommentBody() : string
Return values
stringprintEditCommentLink()
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
Parameters
- $text : string
-
Link text
- $before : string = ''
-
text to go before the link
- $after : string = ''
-
text to go after the link
- $title : string = NULL
-
title text
- $class : string = NULL
-
optional css clasee
- $id : string = NULL
-
optional css id
getLatestComments()
Gets latest comments for images, albums, news and pages
getLatestComments(int $number[, string|array<string|int, mixed> $type = "all" ][, int $id = NULL ]) : mixed
Parameters
- $number : int
-
how many comments you want.
- $type : string|array<string|int, mixed> = "all"
-
"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
- $id : int = NULL
-
the record id of element to get the comments for if $type != "all"
printLatestComments()
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
Parameters
- $number : int
-
how many comments you want.
- $shorten : int = '123'
-
how many characters you want to show in the excerpt.
- $type : string = "all"
-
"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
- $item : int = NULL
-
the record id of element to get the comments for if $type != "all".
- $ulid : string = 'showlatestcomments'
-
id for the
- element.
- $shortenindicator : string = '...'
-
indicator to show that the string is truncated.
getCommentCount()
Retuns the count of comments on the current image
getCommentCount() : int
Return values
intnext_comment()
Iterate through comments; use the ZP_COMMENT context.
next_comment([bool $desc = false ]) : bool
Return true if there are more comments
Parameters
- $desc : bool = false
-
set true for desecnding order
Return values
boolgetCommentStored()
Returns the data from the last comment posted
getCommentStored([bool $numeric = false ]) : array<string|int, mixed>
Parameters
- $numeric : bool = false
-
Set to true for old themes to get 0->6 indices rather than descriptive ones
Return values
array<string|int, mixed>commentReply()
Takes a comment and makes the body of an email.
commentReply(obj $obj, string $author, string $fullcomment) : string
Parameters
- $obj : obj
-
Object of the item commented on
- $author : string
-
Comment author
- $fullcomment : string
-
The comment itself
Return values
stringcommentsAllowed()
Returns true if all the right conditions are set to allow comments for the $type
commentsAllowed(string $type) : bool
Parameters
- $type : string
-
Which comments
Return values
boolgetComments()
Gets an array of comments for the current admin
getComments(int $number) : array<string|int, mixed>
Parameters
- $number : int
-
how many comments desired
Tags
Return values
array<string|int, mixed>fetchComments()
Gets an array of comments for the current admin
fetchComments(int $number) : array<string|int, mixed>
Parameters
- $number : int
-
how many comments desired
Tags
Return values
array<string|int, mixed>isCommentFormRequiredField()
Checks if a field is required
isCommentFormRequiredField(string $option) : bool
Parameters
- $option : string
-
The field option name
Tags
Return values
boolgetCommentFormRequiredFieldMark()
Gets the star to mark required field names
getCommentFormRequiredFieldMark(string $option) : string
Parameters
- $option : string
-
The field option name
Tags
Return values
stringgetCommentFormRequiredFieldAttr()
Returns the required attribute if the field is required
getCommentFormRequiredFieldAttr(string $option) : string
Parameters
- $option : string
-
The field option name
Tags
Return values
stringisCommentFormReadonlyField()
Checks if the field should be set to readonly
isCommentFormReadonlyField(bool $disabled) : mixed
Parameters
- $disabled : bool
-
return bool
Tags
getCommentFormReadonlyFieldAttr()
Gets the readonly attribute for disabled fields
getCommentFormReadonlyFieldAttr(bool $disabled) : string
Parameters
- $disabled : bool
Tags
Return values
stringprintCommentFormFieldAttributes()
Prints the combined required and readonly attributes as needed
printCommentFormFieldAttributes(string $option, bool $disabled[, string $autocomplete_value = 'on' ]) : mixed
Parameters
- $option : string
-
The field option name
- $disabled : bool
- $autocomplete_value : string = 'on'
-
Default "on" if autocomplete is ebabled
Tags
getCommentformFormAutocompleteAttr()
Returns the autocomplete attribute for the form depending if autocomplete is enabled
getCommentformFormAutocompleteAttr() : string
Tags
Return values
stringgetCommentformAutocompleteAttr()
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
Parameters
- $value : string = "on"
-
Default "on" if autocomplete is ebabled
- $skip_off : bool = false
-
Set to true to skip returing autocomplete="off"
Tags
Return values
stringprintCommentformAutocompleteAttr()
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
Parameters
- $value : string = "on"
-
Default "on" if autocomplete is ebabled
- $skip_off : bool = false
-
Set to true to skip printing autocomplete="off"
Tags
getQuizFieldQuestion()
Gets the the question to a quiz field if the field is enabled and setup correctly
getQuizFieldQuestion([string $which = '' ]) : string|bool
Parameters
- $which : string = ''
Tags
Return values
string|boolprintCommentForm()
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
Parameters
- $showcomments : bool = true
-
defaults to true for showing list of comments
- $addcommenttext : string = NULL
-
alternate text for "Add a comment:"
- $addheader : bool = true
-
set true to display comment count header
- $comment_commententry_mod : string = ''
-
use to add styles, classes to the comment form div
- $desc_order : bool = false
-
default false, set to true to change the comment order to descending ( = newst to oldest)
getField()
Retrieves the post field if it exists
getField(string $field[, int $level = 3 ]) : string
Parameters
- $field : string
- $level : int = 3
Tags
Return values
stringprintContactForm()
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.
Parameters
- $subject_override : string = ''
-
set to override the subject.
Tags
showOrNotShowField()
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.
Parameters
- $option : string
-
The option value
Tags
Return values
boolcheckRequiredField()
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...
Parameters
- $option : string
-
the option value
Tags
Return values
stringprintContactFormMacro()
Buffers the contact form print out so it can be passed to its content macro
printContactFormMacro([type $subject_override = '' ]) : type
Parameters
- $subject_override : type = ''
Tags
Return values
typegetContactFormMacros()
Registers the content macro(s)
getContactFormMacros(array<string|int, mixed> $macros) : array<string|int, mixed>
Parameters
- $macros : array<string|int, mixed>
-
Passes through the array of already registered
Tags
Return values
array<string|int, mixed>defaultCodeblocks_codebox()
defaultCodeblocks_codebox(mixed $current, mixed $object, mixed $number) : mixed
Parameters
- $current : mixed
- $object : mixed
- $number : mixed
setThemeColumns()
controls the thumbnail layout of themes.
setThemeColumns() : mixed
Uses the theme options: albums_per_row albums_per_page images_per_row images_per_page
Tags
getMimeString()
Returns the mimetype for a suffix
getMimeString(string $suffix) : string
Parameters
- $suffix : string
-
Suffix without . to get the mimetype for
Tags
Return values
stringnewAlbum()
Wrapper instantiation function for albums. Do not instantiate directly
newAlbum(string $folder8[, bool $cache = true ][, bool $quiet = false ]) : Album
Parameters
- $folder8 : string
-
the name of the folder (inernal character set)
- $cache : bool = true
-
true if the album should be fetched from the cache
- $quiet : bool = false
-
true to supress error messages
Tags
Return values
AlbumisAlbumClass()
Returns true if the object is a zenphoto 'album'
isAlbumClass([object $album = NULL ]) : bool
Parameters
- $album : object = NULL
Tags
Return values
boolgetUrAlbum()
Returns the oldest ancestor of an alubm;
getUrAlbum(string $album) : object
Parameters
- $album : string
-
an album object
Tags
Return values
objectnewImage()
Returns a new "image" object based on the file extension
newImage(object $album, string $filename[, bool $quiet = false ]) : object
Parameters
- $album : object
-
the owner album
- $filename : string
-
the filename
- $quiet : bool = false
-
set true to supress error messages (used by loadimage)
Tags
Return values
objectisImageClass()
Returns true if the object is a zenphoto 'image'
isImageClass([object $image = NULL ]) : bool
Parameters
- $image : object = NULL
Tags
Return values
boolsearch_quote()
encloses search word in quotes if needed
search_quote(string $word) : string
Parameters
- $word : string
Tags
Return values
stringisImageVideo()
Returns video argument of the current Image.
isImageVideo([object $image = NULL ]) : bool
Parameters
- $image : object = NULL
-
optional image object
Tags
Return values
boolisImagePhoto()
Returns true if the image is a standard photo type
isImagePhoto([object $image = NULL ]) : bool
Parameters
- $image : object = NULL
-
optional image object
Tags
Return values
boolreplaceOption()
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
Parameters
- $oldkey : string
-
Old option name
- $newkey : string
-
New option name
Tags
is_valid_email_zp()
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.
Parameters
- $input_email : string
-
email address?
Tags
Return values
boolgenAlbumList()
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
Parameters
- $list : array<string|int, mixed>
-
The array to fill with the album list
- $curAlbum : obj = NULL
-
Optional object of the album to start with
- $rights : int = UPLOAD_RIGHTS
-
Rights constant to filter album access by.
Tags
getAllAlbums()
Returns a list of all albums decendent from an album
getAllAlbums([object $album = NULL ]) : array<string|int, mixed>
Parameters
- $album : object = NULL
-
optional album. If absent the current album is used
Tags
Return values
array<string|int, mixed>printPopularAlbums()
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
Parameters
- $number : mixed = 5
- $showtitle : mixed = false
- $showdate : mixed = false
- $showdesc : mixed = false
- $desclength : mixed = 40
- $showstatistic : mixed = 'hitcounter'
- $width : mixed = NULL
- $height : mixed = NULL
- $crop : mixed = NULL
- $albumfolder : mixed = ''
- $firstimglink : mixed = false
- $threshold : mixed = 0
- $collection : mixed = false
Tags
printLatestAlbums()
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
Parameters
- $number : mixed = 5
- $showtitle : mixed = false
- $showdate : mixed = false
- $showdesc : mixed = false
- $desclength : mixed = 40
- $showstatistic : mixed = ''
- $width : mixed = NULL
- $height : mixed = NULL
- $crop : mixed = NULL
- $albumfolder : mixed = ''
- $firstimglink : mixed = false
- $collection : mixed = false
Tags
printMostRatedAlbums()
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
Parameters
- $number : mixed = 5
- $showtitle : mixed = false
- $showdate : mixed = false
- $showdesc : mixed = false
- $desclength : mixed = 40
- $showstatistic : mixed = ''
- $width : mixed = NULL
- $height : mixed = NULL
- $crop : mixed = NULL
- $albumfolder : mixed = ''
- $firstimglink : mixed = false
- $threshold : mixed = 0
- $collection : mixed = false
Tags
printTopRatedAlbums()
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
Parameters
- $number : mixed = 5
- $showtitle : mixed = false
- $showdate : mixed = false
- $showdesc : mixed = false
- $desclength : mixed = 40
- $showstatistic : mixed = ''
- $width : mixed = NULL
- $height : mixed = NULL
- $crop : mixed = NULL
- $albumfolder : mixed = ''
- $firstimglink : mixed = false
- $threshold : mixed = 0
- $collection : mixed = false
Tags
printLatestUpdatedAlbums()
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
Parameters
- $number : mixed = 5
- $showtitle : mixed = false
- $showdate : mixed = false
- $showdesc : mixed = false
- $desclength : mixed = 40
- $showstatistic : mixed = ''
- $width : mixed = NULL
- $height : mixed = NULL
- $crop : mixed = NULL
- $albumfolder : mixed = ''
- $firstimglink : mixed = false
- $collection : mixed = false
Tags
printPopularImages()
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
Parameters
- $number : mixed = 5
- $albumfolder : mixed = ''
- $showtitle : mixed = false
- $showdate : mixed = false
- $showdesc : mixed = false
- $desclength : mixed = 40
- $showstatistic : mixed = ''
- $width : mixed = NULL
- $height : mixed = NULL
- $crop : mixed = NULL
- $collection : mixed = false
- $fullimagelink : mixed = false
- $threshold : mixed = 0
Tags
printTopRatedImages()
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
Parameters
- $number : mixed = 5
- $albumfolder : mixed = ""
- $showtitle : mixed = false
- $showdate : mixed = false
- $showdesc : mixed = false
- $desclength : mixed = 40
- $showstatistic : mixed = ''
- $width : mixed = NULL
- $height : mixed = NULL
- $crop : mixed = NULL
- $collection : mixed = false
- $fullimagelink : mixed = false
- $threshold : mixed = 0
Tags
printMostRatedImages()
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
Parameters
- $number : mixed = 5
- $albumfolder : mixed = ''
- $showtitle : mixed = false
- $showdate : mixed = false
- $showdesc : mixed = false
- $desclength : mixed = 40
- $showstatistic : mixed = ''
- $width : mixed = NULL
- $height : mixed = NULL
- $crop : mixed = NULL
- $collection : mixed = false
- $fullimagelink : mixed = false
- $threshold : mixed = 0
Tags
printLatestImages()
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
Parameters
- $number : mixed = 5
- $albumfolder : mixed = ''
- $showtitle : mixed = false
- $showdate : mixed = false
- $showdesc : mixed = false
- $desclength : mixed = 40
- $showstatistic : mixed = ''
- $width : mixed = NULL
- $height : mixed = NULL
- $crop : mixed = NULL
- $collection : mixed = false
- $fullimagelink : mixed = false
Tags
printLatestImagesByDate()
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
Parameters
- $number : mixed = 5
- $albumfolder : mixed = ''
- $showtitle : mixed = false
- $showdate : mixed = false
- $showdesc : mixed = false
- $desclength : mixed = 40
- $showstatistic : mixed = ''
- $width : mixed = NULL
- $height : mixed = NULL
- $crop : mixed = NULL
- $collection : mixed = false
- $fullimagelink : mixed = false
Tags
printLatestImagesByMtime()
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
Parameters
- $number : mixed = 5
- $albumfolder : mixed = ''
- $showtitle : mixed = false
- $showdate : mixed = false
- $showdesc : mixed = false
- $desclength : mixed = 40
- $showstatistic : mixed = ''
- $width : mixed = NULL
- $height : mixed = NULL
- $crop : mixed = NULL
- $collection : mixed = false
- $fullimagelink : mixed = false
Tags
filterImageQuery()
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
Parameters
- $result : object
-
query result
- $source : string
-
album object if this is search within the album
Tags
getRandomImages()
Returns a randomly selected image from the gallery. (May be NULL if none exists)
getRandomImages([bool $daily = false ]) : object
Parameters
- $daily : bool = false
-
set to true and the picture changes only once a day.
Tags
Return values
objectgetRandomImagesAlbum()
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
Parameters
- $rootAlbum : mixed = NULL
-
optional album object/folder from which to get the image.
- $daily : bool = false
-
set to true to change picture only once a day.
Tags
Return values
objectprintRandomImages()
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
Parameters
- $number : int = 5
-
how many images
- $class : string = null
-
optional class
- $option : string = 'all'
-
what you want selected: all for all images, album for selected ones from an album
- $rootAlbum : mixed = ''
-
optional album object/folder from which to get the image.
- $width : int = NULL
-
the width/cropwidth of the thumb if crop=true else $width is longest size.
- $height : int = NULL
-
the height/cropheight of the thumb if crop=true else not used
- $crop : bool = NULL
-
'true' (default) if the thumb should be cropped, 'false' if not
- $fullimagelink : bool = false
-
'false' (default) for the image page link , 'true' for the unprotected full image link (to use Colorbox for example)
Tags
cleanHTML()
fixes unbalanced HTML tags. Used by shortenContent when PHP tidy is not present
cleanHTML(string $html) : string
Parameters
- $html : string
Tags
Return values
stringgetTotalImagesIn()
Returns the count of all the images in the album and any subalbums
getTotalImagesIn(object $album) : int
Parameters
- $album : object
-
The album whose image count you want
Tags
Return values
intcheckPublishDates()
checks if the item has expired
checkPublishDates(array<string|int, mixed> $row) : mixed
Parameters
- $row : array<string|int, mixed>
-
database row of the object
Tags
getPHPFiles()
getPHPFiles(type $folder, type $exclude) : string
Parameters
- $folder : type
- $exclude : type
Tags
Return values
stringformatList()
formatList(type $title, type $subject, type $pattern) : bool
Parameters
- $title : type
- $subject : type
- $pattern : type
Tags
Return values
boollistUses()
listUses(type $files, type $base, type $pattern) : type
Parameters
- $files : type
- $base : type
- $pattern : type
Tags
Return values
typelistDBUses()
listDBUses(type $pattern) : bool
Parameters
- $pattern : type
Tags
Return values
boolprintBarGraph()
Prints a table with a bar graph of the values.
printBarGraph() : mixed
printdownloadList()
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
Parameters
- $dir : string = ''
-
An optional different folder to generate the list that overrides the folder set on the option.
- $listtype : string = 'ol'
-
"ol" or "ul" for the type of HTML list you want to use
- $filters : array<string|int, mixed> = array()
-
an array of files to exclude from the list. Standard items are Array( '.', '..','.DS_Store','Thumbs.db','.htaccess','.svn')
- $excludesuffixes : array<string|int, mixed> = ''
-
an array of file suffixes (without trailing dot to exclude from the list (e.g. "jpg")
- $sort : string = 'desc'
-
'asc" or "desc" (default) for alphabetical ascending or descending list
getdownloadList()
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>
Parameters
- $dir8 : string
-
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
- $filters8 : array<string|int, mixed>
-
an array of files to exclude from the list. Standard items are '.', '..','.DS_Store','Thumbs.db','.htaccess','.svn'
- $excludesuffixes : array<string|int, mixed>
-
an array of file suffixes (without trailing dot to exclude from the list (e.g. "jpg")
- $sort : string
-
'asc" or "desc" (default) for alphabetical ascending or descending list
Return values
array<string|int, mixed>getDownloadURL()
Gets the download url for a file
getDownloadURL(string $file) : mixed
Parameters
- $file : string
-
the path to a file to get a download link.
printDownloadURL()
Prints a download link for a file, depending on the plugin options including the downloadcount and filesize
printDownloadURL(string $file[, string $linktext = NULL ]) : mixed
Parameters
- $file : string
-
the path to a file to print a download link.
- $linktext : string = NULL
-
Optionally how you wish to call the link. Set/leave to NULL to use the filename.
printFullImageDownloadURL()
Prints the dwnload url link for a full image
printFullImageDownloadURL([string $linktext = null ][, obj $imageobj = null ]) : mixed
Parameters
- $linktext : string = null
-
Linktext for the download
- $imageobj : obj = null
-
Optional image object to use, otherwise the current image if available
Tags
printDownloadAlbumZipURL()
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.
Parameters
- $linktext : string = NULL
- $albumobj : object = NULL
- $fromcache : bool = NULL
-
if true get the images from the cache
printLanguageSelector()
prints a form for selecting a locale The POST handling is by getUserLocale() called in functions.php
printLanguageSelector([mixed $flags = NULL ]) : mixed
Parameters
- $flags : mixed = NULL
elFinderAutoloader()
elFinderAutoloader(mixed $name) : mixed
Parameters
- $name : mixed
access()
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)
Parameters
- $attr : string
-
attribute name (read|write|locked|hidden)
- $path : string
-
file path relative to volume root directory started with directory separator
- $data : mixed
- $volume : mixed
Return values
bool|nullaccessImage()
accessImage(mixed $attr, mixed $path, mixed $data, mixed $volume) : mixed
Parameters
- $attr : mixed
- $path : mixed
- $data : mixed
- $volume : mixed
accessAlbums()
accessAlbums(mixed $attr, mixed $path, mixed $data, mixed $volume) : mixed
Parameters
- $attr : mixed
- $path : mixed
- $data : mixed
- $volume : mixed
imagecreatefrombmp()
imagecreatefrombmp(mixed $filename_or_stream_or_binary) : mixed
Parameters
- $filename_or_stream_or_binary : mixed
elFinder_admin_tabs()
elFinder_admin_tabs(mixed $tabs) : mixed
Parameters
- $tabs : mixed
elFinder_tinymce()
elFinder_tinymce(mixed $discard) : mixed
Parameters
- $discard : mixed
printAddToFavorites()
printAddToFavorites(mixed $obj[, mixed $add = NULL ][, mixed $remove = NULL ]) : mixed
Parameters
- $obj : mixed
- $add : mixed = NULL
- $remove : mixed = NULL
getFavoritesURL()
getFavoritesURL() : mixed
printFavoritesURL()
Prints links to the favorites "albums"
printFavoritesURL([type $text = NULL ][, mixed $before = NULL ][, mixed $between = NULL ][, mixed $after = NULL ]) : mixed
Parameters
- $text : type = NULL
- $before : mixed = NULL
- $between : mixed = NULL
- $after : mixed = NULL
Tags
getFeaturedImage()
Returns the image object if an featured image is assigned, otherwise false
getFeaturedImage([obj $obj = NULL ]) : mixed
Parameters
- $obj : obj = NULL
-
Object of the Zenpage article, category you want the featured image to get return mixed
getSizedFeaturedImage()
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
Parameters
- $obj : obj = NULL
-
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 : int = NULL
-
size
- $width : int = NULL
-
width
- $height : int = NULL
-
height
- $cropw : int = NULL
-
crop width
- $croph : int = NULL
-
crop height
- $cropx : int = NULL
-
crop x axis
- $cropy : int = NULL
-
crop y axis
- $thumb : bool = false
-
set to true to treat as thumbnail. Multimedia items are not used then
- $effects : bool = NULL
-
set to desired image effect (e.g. 'gray' to force gray scale)
- $maxspace : bool = false
-
Set $width and height and this to true (default false) to get a maxspace image. Other size paramaters will be ignored
Tags
Return values
stringprintSizedFeaturedImage()
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
Parameters
- $obj : obj = NULL
-
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 : string = ''
-
Alt text of the img element
- $size : int = NULL
-
size
- $width : int = NULL
-
width
- $height : int = NULL
-
height
- $cropw : int = NULL
-
crop width
- $croph : int = NULL
-
crop height
- $cropx : int = NULL
-
crop x axis
- $cropy : int = NULL
-
crop y axis
- $class : string = NULL
-
Class of the img element
- $id : string = NULL
-
Id of the img element
- $thumb : bool = false
-
set to true to treat as thumbnail. Multimedia items are not used then
- $effects : bool = NULL
-
set to desired image effect (e.g. 'gray' to force gray scale)
- $maxspace : bool = false
-
Set $width and height and this to true (default false) to get a maxspace image. Other size paramaters will be ignored
Return values
stringgetFeaturedImageThumb()
Gets the default thumb size of a featured image
getFeaturedImageThumb([obj $obj = null ]) : string
Parameters
- $obj : obj = null
-
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
Tags
Return values
stringprintFeaturedImageThumb()
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
Parameters
- $alt : string = null
-
Alt text
- $class : string = null
-
optional class attribute
- $id : string = NULL
-
optional id attribute
- $title : string = null
-
optional title attribute
- $obj : obj = null
-
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
Tags
log_message()
log_message(mixed $class, mixed $msg) : mixed
Parameters
- $class : mixed
- $msg : mixed
Tags
get_instance()
get_instance() : mixed
Tags
omsAdditions()
omsAdditions() : mixed
Tags
getGeoCoord()
$returns coordinate informations for an image
getGeoCoord( $image) : mixed
Parameters
Tags
addGeoCoord()
Add a point to a map object
addGeoCoord( $map, $coord) : mixed
Parameters
Tags
getImageGeodata()
Gathers the data for an image
getImageGeodata( $image, $map) : mixed
Parameters
Tags
getAlbumGeodata()
Gathers the map data for an album
getAlbumGeodata( $album, $map) : mixed
Parameters
Tags
printGoogleMap()
Output the google map
printGoogleMap([string $text = NULL ][, string $id = NULL ][, string $hide = NULL ][, object $obj = NULL ][, function $callback = NULL ]) : mixed
Parameters
- $text : string = NULL
-
text for the "toggle" link that shows/hides the map. Set empty to omit (then Map is always displayed)
- $id : string = NULL
-
used to set the IDs for the toggle href element ($id_toggle) and the map element ($id_data)
- $hide : string = NULL
-
initial map state: "hide", "show", or "colorbox"
- $obj : object = NULL
-
optional image/album object. Pass string for generic map and use callback to set points
- $callback : function = NULL
-
optional callback function to set map options.
Tags
getHitcounter()
returns the hitcounter for the current page or for the object passed
getHitcounter([object $obj = NULL ]) : string
Parameters
- $obj : object = NULL
-
the album or page object for which the hitcount is desired
Return values
stringgetTotalHitcounter()
Gets the total hitcounter sum of one or several items
getTotalHitcounter([array<string|int, mixed> $items = array() ]) : int
Parameters
- $items : array<string|int, mixed> = array()
-
an array with one or more item table names, e.g. array('albums', 'images', 'news', 'news_categories', 'pages')
Tags
Return values
intgetAlbumStatistic()
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>
Parameters
- $number : int = 5
-
the number of albums to get
- $option : string = ''
-
"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...)
- $albumfolder : string = ''
-
The name of an album to get only the statistc for its direct subalbums
- $threshold : int = 0
-
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)
- $sortdirection : mixed = 'desc'
- $collection : bool = false
-
only if $albumfolder is set: true if you want to get statistics to include all subalbum levels
Return values
array<string|int, mixed>printAlbumStatistic()
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
Parameters
- $number : string
-
the number of albums to get
- $option : string
-
"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...)
- $showtitle : bool = false
-
if the album title should be shown
- $showdate : bool = false
-
if the album date should be shown
- $showdesc : bool = false
-
if the album description should be shown
- $desclength : int = 40
-
the length of the description to be shown
- $showstatistic : string = ''
-
"hitcounter" for showing the hitcounter (views), "rating" for rating, "rating+hitcounter" for both.
- $width : int = NULL
-
the width/cropwidth of the thumb if crop=true else $width is longest size. (Default 85px)
- $height : int = NULL
-
the height/cropheight of the thumb if crop=true else not used. (Default 85px)
- $crop : bool = NULL
-
'true' (default) if the thumb should be cropped, 'false' if not
- $albumfolder : mixed = ''
- $firstimglink : mixed = false
- $threshold : int = 0
-
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)
- $collection : bool = false
-
only if $albumfolder is set: true if you want to get statistics to include all subalbum levels
printAlbumStatisticItem()
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
Parameters
- $album : array<string|int, mixed>
-
the array with album objects that getAlbumsStatistic() submitted
- $option : string
-
"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...)
- $showtitle : bool = false
-
if the album title should be shown
- $showdate : bool = false
-
if the album date should be shown
- $showdesc : bool = false
-
if the album description should be shown
- $desclength : int = 40
-
the length of the description to be shown
- $showstatistic : string = ''
-
"hitcounter" for showing the hitcounter (views), "rating" for rating, "rating+hitcounter" for both.
- $width : int = NULL
-
the width/cropwidth of the thumb if crop=true else $width is longest size. (Default 85px)
- $height : int = NULL
-
the height/cropheight of the thumb if crop=true else not used. (Default 85px)
- $crop : bool = NULL
-
'true' (default) if the thumb should be cropped, 'false' if not
- $firstimglink : bool = false
-
'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
getImageStatistic()
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>
Parameters
- $number : string
-
the number of images to get
- $option : string
-
"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...)
- $albumfolder : string = ''
-
foldername of an specific album
- $collection : bool = false
-
only if $albumfolder is set: true if you want to get statistics from this album and all of its subalbums
- $threshold : int = 0
-
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)
- $sortdirection : mixed = 'desc'
Return values
array<string|int, mixed>printImageStatistic()
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
Parameters
- $number : string
-
the number of albums to get
- $option : string
-
"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...)
- $albumfolder : string = ''
-
foldername of an specific album
- $showtitle : bool = false
-
if the image title should be shown
- $showdate : bool = false
-
if the image date should be shown
- $showdesc : bool = false
-
if the image description should be shown
- $desclength : int = 40
-
the length of the description to be shown
- $showstatistic : string = ''
-
"hitcounter" for showing the hitcounter (views), "rating" for rating, "rating+hitcounter" for both.
- $width : int = NULL
-
the width/cropwidth of the thumb if crop=true else $width is longest size. (Default 85px)
- $height : int = NULL
-
the height/cropheight of the thumb if crop=true else not used. (Default 85px)
- $crop : bool = NULL
-
'true' (default) if the thumb should be cropped, 'false' if not
- $collection : bool = false
-
only if $albumfolder is set: true if you want to get statistics from this album and all of its subalbums
- $fullimagelink : bool = false
-
'false' (default) for the image page link , 'true' for the unprotected full image link (to use Colorbox for example)
- $threshold : int = 0
-
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)
Return values
stringcheckIfNew()
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
Parameters
- $mode : string = "image"
-
What to check "image" or "album".
- $timerange : int = 604800
-
The time range the item should be considered new. Default is 604800 (unix time seconds = ca. 7 days)
Return values
boolgetNumAllSubalbums()
Gets the number of all subalbums of all subalbum levels of either the current album or $albumobj
getNumAllSubalbums(object $albumobj[, string $pre = '' ]) : bool
Parameters
- $albumobj : object
-
Optional album object to check
- $pre : string = ''
-
Optional text you want to print before the number
Return values
boolgetPictureOfTheDay()
Returns an randomly selected image objecet from the gallery per day.
getPictureOfTheDay([string $albumfolder = '' ][, bool $collection = false ]) : object|nill
Returns null on failure
Parameters
- $albumfolder : string = ''
-
foldername of an specific album. If not set from all images in the gallery
- $collection : bool = false
-
only if $albumfolder is set: true if you want to get statistics from this album and all of its subalbums
Tags
Return values
object|nillgetjPlayerSkins()
Gets the skin names and css files
getjPlayerSkins() : mixed
Tags
getjPlayerSkinCSS()
Gets the css files for a skin. Helper function for getjPlayerSkins().
getjPlayerSkinCSS(mixed $skins, mixed $dir) : mixed
Parameters
- $skins : mixed
- $dir : mixed
Tags
printjPlayerPlaylist()
jplayer class theme function wrapper for user convenience
printjPlayerPlaylist([type $option = "playlist" ][, type $albumfolder = "" ]) : mixed
Parameters
- $option : type = "playlist"
- $albumfolder : type = ""
Tags
macro_admin_tabs()
macro_admin_tabs(mixed $tabs) : mixed
Parameters
- $tabs : mixed
macroList_show()
macroList_show(mixed $macro, mixed $detail) : mixed
Parameters
- $macro : mixed
- $detail : mixed
markRelease_button()
markRelease_button(mixed $buttons) : mixed
Parameters
- $buttons : mixed
updateItemsSortorder()
Updates the sortorder of the pages list in the database
updateItemsSortorder() : mixed
printItemsListTable()
Prints the table part of a single page item for the sortable pages list
printItemsListTable(mixed $item, bool $flag) : mixed
Parameters
- $item : mixed
- $flag : bool
-
set to true to flag the element as having a problem with nesting level
printItemsList()
Prints the sortable pages list returns true if nesting levels exceede the database container
printItemsList(mixed $items) : bool
Parameters
- $items : mixed
Return values
boolprintItemEditLink()
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
Parameters
- $item : array<string|int, mixed>
-
Array of the menu item
printItemStatusDropdown()
Prints the item status selector to choose if all items or only hidden or visible should be listed
printItemStatusDropdown() : mixed
getMenuSetSelector()
returns the menu set selector
getMenuSetSelector(string $active) : mixed
Parameters
- $active : string
-
true if changing the selection shuld reload to the new selection
publishItem()
Sets a menu item to published/visible
publishItem(int $id, string $show, string $menuset) : mixed
Parameters
- $id : int
-
id of the item
- $show : string
-
published status.
- $menuset : string
-
chosen menu set
addSubalbumMenus()
adds (sub)albums to menu base with their gallery sorting order intact
addSubalbumMenus(string $menuset, int $id, string $link, string $sort) : mixed
Parameters
- $menuset : string
-
chosen menu set
- $id : int
-
table id of the parent.
- $link : string
-
folder name of the album
- $sort : string
-
xxx-xxx-xxx style sort order for album
addalbumsToDatabase()
Adds albums to the menu set. Returns the next sort order base
addalbumsToDatabase(string $menuset[, string $base = NULL ]) : int
Parameters
- $menuset : string
-
current menu set
- $base : string = NULL
-
starting "sort order"
Return values
intaddPagesToDatabase()
Adds Zenpage pages to the menu set
addPagesToDatabase(string $menuset[, mixed $base = NULL ]) : int
Parameters
- $menuset : string
-
current menu set
- $base : mixed = NULL
Return values
intaddCategoriesToDatabase()
Adds Zenpage news categories to the menu set
addCategoriesToDatabase(string $menuset[, mixed $base = NULL ]) : mixed
Parameters
- $menuset : string
-
chosen menu set
- $base : mixed = NULL
addItem()
Adds an menu item set via POST
addItem(mixed &$reports) : array<string|int, mixed>
Parameters
- $reports : mixed
Return values
array<string|int, mixed>updateMenuItem()
Updates a menu item (custom link, custom page only) set via POST
updateMenuItem(mixed &$reports) : mixed
Parameters
- $reports : mixed
deleteItem()
Deletes a menu item set via GET
deleteItem(mixed &$reports) : mixed
Parameters
- $reports : mixed
printAlbumsSelector()
Prints all albums of the Zenphoto gallery as a partial drop down menu (<option></option> parts).
printAlbumsSelector(string $current) : string
Parameters
- $current : string
-
set to the album name selected (if any)
Return values
stringprintZenpagePagesSelector()
Prints all available pages in Zenpage
printZenpagePagesSelector(string $current) : string
Parameters
- $current : string
-
set to the page selected (if any)
Return values
stringprintZenpageNewsCategorySelector()
Prints all available articles or categories in Zenpage
printZenpageNewsCategorySelector(string $current) : string
Parameters
- $current : string
-
set to category selected (if any)
Return values
stringprintCustomPageSelector()
Prints the selector for custom pages
printCustomPageSelector(mixed $current) : string
Parameters
- $current : mixed
Return values
stringunpublishedZenphotoItemCheck()
checks if a album or image is un-published and returns a '*'
unpublishedZenphotoItemCheck(mixed $obj[, mixed $dropdown = true ]) : string
Parameters
- $obj : mixed
- $dropdown : mixed = true
Return values
stringprocessMenuBulkActions()
Processes the check box bulk actions
processMenuBulkActions() : mixed
menu_admin_toolbox_global()
Add menu to the admin toolbox
menu_admin_toolbox_global(mixed $zf) : mixed
Parameters
- $zf : mixed
menu_tabs()
Adds menu manager to admin tabs
menu_tabs( $tabs) : unknown
Parameters
Return values
unknowngetMenuItems()
Gets the menu items
getMenuItems(string $menuset, string $visible) : array<string|int, mixed>
Parameters
- $menuset : string
-
the menu tree desired
- $visible : string
Return values
array<string|int, mixed>getItem()
Gets a menu item by its id
getItem(int $id) : array<string|int, mixed>
Parameters
- $id : int
-
id of the item
Return values
array<string|int, mixed>checkChosenMenuset()
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
Parameters
- $default : mixed = 'default'
Return values
stringcheckChosenItemStatus()
Checks if the menu item is set visible or not
checkChosenItemStatus() : string
Return values
stringgetItemTitleAndURL()
Gets the title, url and name of a menu item
getItemTitleAndURL(mixed $item) : array<string|int, mixed>
Parameters
- $item : mixed
Return values
array<string|int, mixed>getMenuVisibility()
Gets the menu visibility
getMenuVisibility() : string
Return values
stringinventMenuItem()
"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.
Parameters
- $menuset : string
- $visibility : string
- $field : string = 'sort_order'
-
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)
Return values
int|array<string|int, mixed>|stringgetCurrentMenuItem()
Returns the data of the current menu item
getCurrentMenuItem(string $menuset[, string $field = 'sort_order' ]) : int|array<string|int, mixed>|string
Parameters
- $menuset : string
-
current menu set
- $field : string = 'sort_order'
-
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'
Tags
Return values
int|array<string|int, mixed>|stringgetMenumanagerPredicessor()
Returns the link to the predicessor of the current menu item
getMenumanagerPredicessor([string $menuset = 'default' ]) : string
Parameters
- $menuset : string = 'default'
-
current menu set
Return values
stringprintMenumanagerPrevLink()
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
Parameters
- $text : string
- $menuset : string = 'default'
- $title : string = NULL
- $class : string = NULL
- $id : string = NULL
getMenumanagerSuccessor()
Returns the successor link of the current menu item
getMenumanagerSuccessor([string $menuset = 'default' ]) : string
Parameters
- $menuset : string = 'default'
Return values
stringprintMenumanagerNextLink()
Gets the link to the next menu item
printMenumanagerNextLink(string $text[, string $menuset = 'default' ][, string $title = NULL ][, string $class = NULL ][, string $id = NULL ]) : mixed
Parameters
- $text : string
- $menuset : string = 'default'
-
current menu set
- $title : string = NULL
- $class : string = NULL
- $id : string = NULL
printMenuemanagerPageListWithNav()
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
Parameters
- $prevtext : string
-
Insert here the linktext like 'previous page'
- $nexttext : mixed
- $menuset : string = 'default'
-
current menu set
- $class : string = 'pagelist'
-
the css class to use, "pagelist" by default
- $nextprev : string = true
-
set to true to get the 'next' and 'prev' links printed
- $id : string = NULL
-
the css id to use
- $firstlast : bool = true
-
Add links to the first and last pages of you gallery
- $navlen : int = 9
-
Number of navigation links to show (0 for all pages). Works best if the number is odd.
printMenuemanagerPageList()
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
Parameters
- $menuset : mixed = 'default'
- $class : string = 'pagelist'
-
Insert here the CSS-class name you want to style the link with (default is "pagelist")
- $id : string = NULL
-
Insert here the CSS-ID name if you want to style the link with this
- $firstlast : bool = true
-
Add links to the first and last pages of you gallery
- $navlen : int = 9
-
Number of navigation links to show (0 for all pages). Works best if the number is odd.
getParentMenuItems()
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
Parameters
- $menuset : string = 'default'
-
current menu set
- $currentitem : array<string|int, mixed> = null
-
Optional array of the menu item to get parents of. Default null for the current item
Return values
array<string|int, mixed>|falseprintMenumanagerBreadcrumb()
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.
Parameters
- $menuset : string = 'default'
-
current menu set
- $before : string = ''
-
before text
- $between : string = ' | '
-
between text
- $after : string = ' | '
-
after text
getMenuFromLink()
Returns the menu item corresponding to $link
getMenuFromLink(string $link[, string $menuset = 'default' ]) : array<string|int, mixed>
Parameters
- $link : string
- $menuset : string = 'default'
Return values
array<string|int, mixed>submenuOf()
Returns true if the current menu item is a sub item of $link
submenuOf(string $link[, string $menuset = 'default' ]) : bool
Parameters
- $link : string
-
possible parent
- $menuset : string = 'default'
-
current menuset
Return values
boolcreateMenuIfNotExists()
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
Parameters
- $menuitems : array<string|int, 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
- $menuset : string = 'default'
-
current menuset
getMenuItemChilds()
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
Parameters
- $menuset : string = 'default'
-
current menu set
- $allchilds : bool = false
-
Set to false (default) for the next level childs, true for childs of all further levels
- $currentitem : mixed = null
Return values
array<string|int, mixed>|falseisCurrentitemParent()
Checks if the item $item is a parent item of the current item
isCurrentitemParent([string $menuset = 'default' ][, array<string|int, mixed> $item = array() ]) : bool
Parameters
- $menuset : string = 'default'
-
Name of the menuset to use
- $item : array<string|int, mixed> = array()
-
Array of the item to check
Return values
boolisPublicMenuItem()
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
Parameters
- $menuset : string
- $item : array<string|int, mixed>
-
The menu item array of the menu item to check
- $itemarray : array<string|int, mixed>
-
The item array of the menu item to check as returned by getItemTitleAndURL()
Tags
Return values
boolprintCustomMenu()
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
Parameters
- $menuset : string = 'default'
-
the menu tree to output
- $option : string = 'list'
-
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 : string = ''
-
CSS id of the top level list
- $css_class_topactive : string = ''
-
class of the active item in the top level list
- $css_class : string = ''
-
CSS class of the sub level list(s)
- $css_class_active : string = ''
-
CSS class of the sub level list(s)
- $showsubs : int = 0
-
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".
- $counter : bool = false
-
TRUE (FALSE default) if you want the count of articles for Zenpage news categories or images/subalbums for albums.
Return values
stringgetSelectedLayout()
Gets the selected layout page for this item. Returns false if nothing is selected.
getSelectedLayout(object $obj, string $type) : string|false
Parameters
- $obj : object
-
the object being selected
- $type : string
-
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"
Return values
string|falsecheckParentLayouts()
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
Parameters
- $obj : object
-
the object being selected
- $type : string
-
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"
Return values
array<string|int, mixed>|falsecheckLayoutUseForImages()
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
Parameters
- $obj : object
-
the album
Return values
array<string|int, mixed>|falselayoutSelector()
returns the layout selector for an object.
layoutSelector(mixed $html, object $obj[, mixed $prefix = '' ]) : string
Parameters
- $html : mixed
- $obj : object
- $prefix : mixed = ''
Return values
stringlayoutSelector_album()
returns the layout selectors for an album.
layoutSelector_album(mixed $html, object $obj[, mixed $prefix = '' ]) : string
Parameters
- $html : mixed
- $obj : object
- $prefix : mixed = ''
Tags
Return values
stringgetLayoutSelector()
Worker function for creating layout selectors. Returns the HTML
getLayoutSelector(object $obj, string $type, string $text[, string $prefix = '' ][, bool $secondary = false ]) : string
Parameters
- $obj : object
- $type : string
- $text : string
- $prefix : string = ''
-
Default empty
- $secondary : bool = false
-
Default false
Return values
stringgetLayout()
Gets the select layout page and returns it to the load_theme_script filter
getLayout(string $path) : string
Parameters
- $path : string
-
Path of the layout file
Return values
stringsaveLayoutSelection()
Saves the layout page assignment via filter on the backend
saveLayoutSelection(string $message, object $obj) : string
Parameters
- $message : string
-
Message (not used)
- $obj : object
-
Object of the item to assign the layout
Return values
stringsaveZenphotoLayoutSelection()
Saves the layout page assignment via filter on the backend for images and albums
saveZenphotoLayoutSelection(object $obj, string $prefix) : string
Parameters
- $obj : object
-
Object of the item to assign the layout
- $prefix : string
Return values
stringdeleteLayoutSelection()
processes object removals if they have been assigned layouts
deleteLayoutSelection(bool $allow, object $obj) : bool
Parameters
- $allow : bool
-
we just return this since we have no need to abort the remove
- $obj : object
-
the object being removed
Return values
boolcopyLayoutSelection()
Copies the layout selection
copyLayoutSelection(int $newid, obj $obj) : mixed
Parameters
- $newid : int
-
ID of the item to copy to
- $obj : obj
-
Object of the original item return int
printOpenStreetMap()
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.
Parameters
- $geodata : array<string|int, mixed> = NULL
-
Array of the geodata to create and display markers. See the constructor of the openStreetMap Class for the require structure
- $width : string = NULL
-
Width with unit, e.g. 100%, 100px, 100em
- $height : string = NULL
-
Height with unit, e.g. 100px, 100em
- $mapcenter : array<string|int, mixed> = NULL
-
geodata array(lat,lng);
- $zoom : int = NULL
-
Number of the zoom 0 -
- $fitbounds : array<string|int, mixed> = NULL
-
geodata array('min' => array(lat,lng), 'max => array(lat,lng))
- $class : string = ''
-
Class name to attach to the map element
- $mapnumber : int = NULL
-
If calling more than one map per page an unique number is required
- $obj : obj = NULL
-
Image or album object to skip current image or album and also $geodata
- $minimap : bool = false
-
True to show the minimap in the lower right corner
Tags
printPagedThumbsNav()
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.
Parameters
- $imagesperpage : int = ''
-
How many thumbs you want to display per list page
- $counter : bool = false
-
If you want to show the counter of the type "Images 1 - 10 of 20 (1/3)"
- $prev : string = ''
-
The previous thumb list link text
- $next : string = ''
-
The next thumb list link text
- $width : int = NULL
-
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
- $height : int = NULL
-
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
- $crop : bool = NULL
-
Enter 'true' or 'false' to override the admin plugin option setting, enter NULL to use the admin plugin option (default)
- $placeholders : bool = NULL
-
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".
- $showpagelist : bool = false
-
Enter 'true' or 'false' if you want to a list of the pages available. Can be styled via "#pagedthumbsnav-pagelist".
- $pagelistprevnext : mixed = false
- $pagelistlength : mixed = 6
zenphoto_PHPMailer()
zenphoto_PHPMailer(mixed $msg, mixed $email_list, mixed $subject, mixed $message, mixed $from_mail, mixed $from_name, mixed $cc_addresses, mixed $replyTo) : mixed
Parameters
- $msg : mixed
- $email_list : mixed
- $subject : mixed
- $message : mixed
- $from_mail : mixed
- $from_name : mixed
- $cc_addresses : mixed
- $replyTo : mixed
printAlbumMenu()
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.
Parameters
- $option : string
-
"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)
- $showcount : bool = NULL
-
true for a image counter or subalbum count in brackets behind the album name, false for no image numbers or leave blank
- $css_id : string = ''
-
insert css id for the main album list, leave empty if you don't use (only list mode)
- $css_class_topactive : string = ''
-
insert css class for the active link in the main album list (only list mode)
- $css_class : string = ''
-
insert css class for the sub album lists (only list mode)
- $css_class_active : string = ''
-
insert css class for the active link in the sub album lists (only list mode)
- $indexname : string = "Gallery Index"
-
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)
- $showsubs : int = NULL
-
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".
- $firstimagelink : bool = false
-
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
- $keeptopactive : bool = false
-
If set to TRUE the toplevel album entry will stay marked as active if within its subalbums ("list" only)
Tags
printAlbumMenuList()
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.
Parameters
- $option : string
-
"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
- $showcount : bool = NULL
-
true for a image counter in brackets behind the album name, false for no image numbers or leave empty
- $css_id : string = ''
-
insert css id for the main album list, leave empty if you don't use (only list mode)
- $css_class_topactive : mixed = ''
- $css_class : string = ''
-
insert css class for the sub album lists (only list mode)
- $css_class_active : string = ''
-
insert css class for the active link in the sub album lists (only list mode)
- $indexname : string = "Gallery Index"
-
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.
- $showsubs : int = NULL
-
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".
- $firstimagelink : bool = false
-
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
- $keeptopactive : bool = false
-
If set to TRUE the toplevel album entry will stay marked as active if within its subalbums ("list" only)
- $startlist : bool = true
-
set to true to output the UL tab (false automatically if you use 'omit-top' or 'list-sub')
- $limit : int = NULL
-
truncation of display text
Return values
html —list of the albums
printAlbumMenuListAlbum()
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
Parameters
- $albums : array<string|int, mixed>
-
albums array
- $folder : string
- $option : string
-
see printAlbumMenuList
- $showcount : string
-
see printAlbumMenuList
- $showsubs : int
-
see printAlbumMenuList
- $css_class : string
-
see printAlbumMenuList
- $css_class_topactive : string
-
see printAlbumMenuList
- $css_class_active : string
-
see printAlbumMenuList
- $firstimagelink : bool
-
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
- $keeptopactive : bool
-
If set to TRUE the toplevel album entry will stay marked as active if within its subalbums ("list" only)
- $limit : int = NULL
-
truncation of display text
printAlbumMenuJump()
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.
Parameters
- $option : string = "count"
-
"count" for a image counter in brackets behind the album name, "" = for no image numbers
- $indexname : string = "Gallery Index"
-
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.
- $firstimagelink : bool = false
-
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
- $showsubs : mixed = NULL
- $skipform : bool = false
-
If set to false this prints a full form option select list (default), if set to true it will only print the options
checkSelectedAlbum()
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
Parameters
- $checkalbum : string
-
The album folder name to check
- $option : string
-
"index" for index level, "album" for album level
Return values
string —returns nothing or "selected"
unpublishSubalbums()
unpublishSubalbums(mixed $album) : mixed
Parameters
- $album : mixed
printRating()
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.
Parameters
- $vote : bool = 3
-
set to false to disable voting
- $object : object = NULL
-
optional object for the ratings target. If not set, the current page object is used
- $text : bool = true
-
if false, no annotation text is displayed
getRating()
Returns the current rating of an object
getRating([object $object = NULL ]) : float
Parameters
- $object : object = NULL
-
optional ratings target. If not supplied, the current script object is used
Return values
floatprintRegistrationForm()
Parses the verification and registration if they have occurred places the user registration form
printRegistrationForm([string $thanks = NULL ]) : mixed
Parameters
- $thanks : string = NULL
-
the message shown on successful registration
Tags
printRegisterURL()
prints the link to the register user page
printRegisterURL(string $_linktext[, string $prev = '' ][, string $next = '' ][, string $class = NULL ]) : mixed
Parameters
- $_linktext : string
-
text for the link
- $prev : string = ''
-
text to insert before the URL
- $next : string = ''
-
text to follow the URL
- $class : string = NULL
-
optional class
Tags
getRelatedItems()
getRelatedItems([mixed $type = 'news' ][, mixed $album = NULL ]) : mixed
Parameters
- $type : mixed = 'news'
- $album : mixed = NULL
createRelatedItemsResultArray()
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.
Parameters
- $result : array<string|int, mixed>
-
array with search results
- $type : string
-
"albums", "images", "news", "pages"
printRelatedItems()
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
Parameters
- $number : int = 5
-
Number of items to get
- $type : string = 'news'
-
'albums', 'images','news','pages', "all" for all combined.
- $specific : string = NULL
-
If $type = 'albums' or 'images' name of album
- $excerpt : bool = NULL
-
If a text excerpt (gallery items: description; Zenpage items: content) should be shown. NULL for none or number of length
- $thumb : bool = false
-
For $type = 'albums' or 'images' if a thumb should be shown (default size as set on the options)
- $date : mixed = false
rulesList()
rulesList() : type
Tags
Return values
typegetRSSLink()
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
Parameters
- $option : string
-
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
- $lang : string = NULL
-
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.
- $addl : string = NULL
-
provided additional data for feeds (e.g. album object for album feeds, $categorylink for zenpage categories
printRSSLink()
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
Parameters
- $option : string
-
type of RSS: See getRSSLink for details
- $prev : string
-
text to before before the link
- $linktext : string
-
title of the link
- $next : string
-
text to appear after the link
- $printIcon : bool = true
-
print an RSS icon beside it? if true, the icon is zp-core/images/rss.png
- $class : string = null
-
css class
- $lang : string = ''
-
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.
- $addl : string = NULL
-
provided additional data for feeds (e.g. album object for album feeds, $categorylink for zenpage categories
printRSSHeaderLink()
Prints the RSS link for use in the HTML HEAD
printRSSHeaderLink(string $option, string $linktext[, string $lang = '' ][, string $addl = NULL ]) : mixed
Parameters
- $option : string
-
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
- $linktext : string
-
title of the link
- $lang : string = ''
-
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.
- $addl : string = NULL
-
provided additional data for feeds (e.g. album object for album feeds, $categorylink for zenpage categories
executeRSS()
executeRSS() : mixed
seo_cleanup_button()
seo_cleanup_button(mixed $buttons) : mixed
Parameters
- $buttons : mixed
getE()
getE(mixed $e) : mixed
Parameters
- $e : mixed
cleanAlbum()
cleanAlbum(mixed $obj) : mixed
Parameters
- $obj : mixed
checkFolder()
checkFolder(mixed $album, mixed $album_cleaned) : mixed
Parameters
- $album : mixed
- $album_cleaned : mixed
printSlideShowLink()
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.
Parameters
- $linktext : string = NULL
-
Text for the link
- $linkstyle : string = Null
-
Style of Text for the link
Tags
printSlideShow()
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!
Parameters
- $heading : bool = true
-
set to true (default) to emit the slideshow breadcrumbs in flash mode
- $speedctl : bool = false
-
controls whether an option box for controlling transition speed is displayed
- $albumobj : obj = NULL
-
The object of the album to show the slideshow of. If set this overrides the POST data of the printSlideShowLink()
- $imageobj : obj = NULL
-
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.
- $width : int = NULL
-
The width of the images (jQuery mode). If set this overrides the size the slideshow_width plugin option that otherwise is used.
- $height : int = NULL
-
The heigth of the images (jQuery mode). If set this overrides the size the slideshow_height plugin option that otherwise is used.
- $crop : bool = false
-
Set to true if you want images cropped width x height (jQuery mode only)
- $shuffle : bool = false
-
Set to true if you want random (shuffled) order
- $linkslides : bool = false
-
Set to true if you want the slides to be linked to their image pages (jQuery mode only)
- $controls : bool = true
-
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)
Tags
getAllTagsFromAlbum()
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>
Parameters
- $albumname : string
-
folder name of the album to get the tags from ($subalbums = true this is the base albums)- This value is mandatory.
- $subalbums : bool = false
-
TRUE if the tags of subalbum should be. FALSE is default
- $mode : string = 'images'
-
"images" for image tags, "albums" for album tags."images" is default.
Return values
array<string|int, mixed>getAllTagsFromZenpage()
Gets all tags used by either all Zenpage news articles or pages.
getAllTagsFromZenpage([string $mode = 'news' ]) : mixed
Parameters
- $mode : string = 'news'
-
"news" for Zenpage news article tags, "pages" for Zenpage pages tags
printAllTagsFromZenpage()
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
Parameters
- $mode : string = 'news'
-
"news" for Zenpage news article tags, "pages" for Zenpage pages tags
- $separator : string = ''
-
how to separate the entries
- $class : string = ''
-
css classs to style the list
- $showcounter : int = true
-
if the tag count should be shown (no counter if $mode = "all")
- $tagcloud : bool = true
-
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
- $size_min : integere = 1
-
smallest font size the cloud should display
- $size_max : int = 5
-
largest font size the cloud should display
- $count_min : int = 1
-
the minimum count for a tag to appear in the output
- $count_max : int = 50
-
the floor count for setting the cloud font size to $size_max
printAllTagsFromAlbum()
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
Parameters
- $albumname : string = ""
-
folder name of the album to get the tags from ($subalbums = true this is the base albums)
- $subalbums : bool = false
-
TRUE if the tags of subalbum should be. FALSE is default
- $mode : string = 'images'
-
"images" for image tags, "albums" for album tags, "all" for both mixed
- $separator : string = ''
-
how to separate the entries
- $class : string = ''
-
css classs to style the list
- $showcounter : int = true
-
if the tag count should be shown (no counter if $mode = "all")
- $tagcloud : bool = true
-
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
- $size_min : integere = 1
-
smallest font size the cloud should display
- $size_max : int = 5
-
largest font size the cloud should display
- $count_min : int = 1
-
the minimum count for a tag to appear in the output
- $count_max : int = 50
-
the floor count for setting the cloud font size to $size_max
printAllTags()
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.
Parameters
- $tags : array<string|int, mixed>
-
array of tags with the fields count, id, and name (as passed by the specific printAllTagsFrom.... functions)
- $mode : string
-
"images" for image tags, "albums" for album tags, "all" for images and albums mixed or "news" for Zenpage news articles, "pages" for Zenpage pages
- $separator : string = ''
-
how to separate the entries
- $class : string = ''
-
css classs to style the list
- $showcounter : int = true
-
if the tag count should be shown (no counter if $mode = "all")
- $tagcloud : bool = true
-
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
- $size_min : integere = 1
-
smallest font size the cloud should display
- $size_max : int = 5
-
largest font size the cloud should display
- $count_min : int = 1
-
the minimum count for a tag to appear in the output
- $count_max : int = 50
-
the floor count for setting the cloud font size to $size_max
getAllTagsFromAlbum_multi_unique()
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
Parameters
- $array : array<string|int, mixed>
Return values
array<string|int, mixed>tagSuggestJS_admin()
tagSuggestJS_admin() : mixed
tagSuggestJS_frontend()
tagSuggestJS_frontend() : mixed
tagSuggestJS()
tagSuggestJS([mixed $exclude_unassigned = false ][, mixed $checkaccess = false ]) : mixed
Parameters
- $exclude_unassigned : mixed = false
- $checkaccess : mixed = false
printFullAlbumsList()
Prints all albums of the Zenphoto gallery as a partial drop down menu (<option></option> parts).
printFullAlbumsList() : string
Return values
stringprintSubLevelAlbums()
Recursive helper function for printFullAlbumsList() to get all sub albums of each top level album
printSubLevelAlbums(mixed &$albumobj) : string
Parameters
- $albumobj : mixed
Return values
stringunpublishedZenphotoItemCheck()
checks if a album or image is un-published and returns a '*'
unpublishedZenphotoItemCheck(mixed $obj[, mixed $dropdown = true ]) : string
Parameters
- $obj : mixed
- $dropdown : mixed = true
Return values
stringshortentitle()
shortens a string, truncate_string() was not exact enough.
shortentitle( $title, $length) : string
Parameters
Return values
stringprintImageslist()
Prints the images and/or albums as thumbnails of the selected album
printImageslist( $number) : string
Parameters
Return values
stringgetImageType()
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.
Parameters
- $imageobj : mixed
Return values
stringprintNewsArticlesList()
Prints all available articles in Zenpage
printNewsArticlesList(mixed $number) : string
Parameters
- $number : mixed
Return values
stringcheckAlbumForImages()
Checks if an album has images for display on the form
checkAlbumForImages() : bool
Return values
boolshowZenphotoOptions()
Checks if the full Zenphoto include form options should be shown
showZenphotoOptions() : bool
Return values
boolprintTinyPageNav()
Prints the page navigation for albums or Zenpage news articles
printTinyPageNav([ $pagestotal = "" ][, $currentpage = "" ][, $mode = 'images' ]) : string
Parameters
- $pagestotal : = ""
-
int The number page in total
- $currentpage : = ""
-
int Number of the current page
- $mode : = 'images'
-
string 'images' or 'articles'
Return values
stringprintZenpageItems()
Prints the Zenpage items as a partial dropdown (pages, news articles, categories)
printZenpageItems() : string
Return values
stringprintAllNestedList()
Prints all available pages or categories in Zenpage
printAllNestedList() : string
Return values
stringunpublishedZenpageItemCheck()
checks if a news article or page is un-published and/or protected and returns a '*'
unpublishedZenpageItemCheck(mixed $page) : string
Parameters
- $page : mixed
Return values
stringsetTinyZenpageLocale()
Set the locale for gettext translation of this plugin. Somehow ZenPhoto's setupDomain() does not work here.
setTinyZenpageLocale() : mixed
..
printTinyZenpageCategorySelector()
Prints the dropdown menu for the category selector for the news articles list
printTinyZenpageCategorySelector([mixed $currentpage = '' ]) : mixed
Parameters
- $currentpage : mixed = ''
printFullAlbumsList()
Prints all albums of the Zenphoto gallery as a partial drop down menu (<option></option> parts).
printFullAlbumsList() : string
Return values
stringprintSubLevelAlbums()
Recursive helper function for printFullAlbumsList() to get all sub albums of each top level album
printSubLevelAlbums(mixed &$albumobj) : string
Parameters
- $albumobj : mixed
Return values
stringunpublishedZenphotoItemCheck()
checks if a album or image is un-published and returns a '*'
unpublishedZenphotoItemCheck(mixed $obj[, mixed $dropdown = true ]) : string
Parameters
- $obj : mixed
- $dropdown : mixed = true
Return values
stringshortentitle()
shortens a string, truncate_string() was not exact enough.
shortentitle( $title, $length) : string
Parameters
Return values
stringprintImageslist()
Prints the images and/or albums as thumbnails of the selected album
printImageslist( $number) : string
Parameters
Return values
stringgetImageType()
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.
Parameters
- $imageobj : mixed
Return values
stringprintNewsArticlesList()
Prints all available articles in Zenpage
printNewsArticlesList(mixed $number) : string
Parameters
- $number : mixed
Return values
stringcheckAlbumForImages()
Checks if an album has images for display on the form
checkAlbumForImages() : bool
Return values
boolshowZenphotoOptions()
Checks if the full Zenphoto include form options should be shown
showZenphotoOptions() : bool
Return values
boolprintTinyPageNav()
Prints the page navigation for albums or Zenpage news articles
printTinyPageNav([ $pagestotal = "" ][, $currentpage = "" ][, $mode = 'images' ]) : string
Parameters
- $pagestotal : = ""
-
int The number page in total
- $currentpage : = ""
-
int Number of the current page
- $mode : = 'images'
-
string 'images' or 'articles'
Return values
stringprintZenpageItems()
Prints the Zenpage items as a partial dropdown (pages, news articles, categories)
printZenpageItems() : string
Return values
stringprintAllNestedList()
Prints all available pages or categories in Zenpage
printAllNestedList() : string
Return values
stringunpublishedZenpageItemCheck()
checks if a news article or page is un-published and/or protected and returns a '*'
unpublishedZenpageItemCheck(mixed $page) : string
Parameters
- $page : mixed
Return values
stringsetTinyZenpageLocale()
Set the locale for gettext translation of this plugin. Somehow ZenPhoto's setupDomain() does not work here.
setTinyZenpageLocale() : mixed
..
printTinyZenpageCategorySelector()
Prints the dropdown menu for the category selector for the news articles list
printTinyZenpageCategorySelector([mixed $currentpage = '' ]) : mixed
Parameters
- $currentpage : mixed = ''
tinymce4ConfigJS()
tinymce4ConfigJS(mixed $mode) : mixed
Parameters
- $mode : mixed
getTinyMCE4ConfigFiles()
getTinyMCE4ConfigFiles(mixed $mode) : mixed
Parameters
- $mode : mixed
upload_head()
upload_head() : mixed
upload_extra()
upload_extra(mixed $uploadlimit, mixed $passedalbum) : mixed
Parameters
- $uploadlimit : mixed
- $passedalbum : mixed
upload_form()
upload_form(mixed $uploadlimit, mixed $passedalbum) : mixed
Parameters
- $uploadlimit : mixed
- $passedalbum : mixed
httpUploadHandler()
httpUploadHandler(mixed $uploadHandlers) : mixed
Parameters
- $uploadHandlers : mixed
httpUploadHandler_admin_tabs()
httpUploadHandler_admin_tabs(mixed $tabs) : mixed
Parameters
- $tabs : mixed
jQueryUpload_headers()
jQueryUpload_headers() : mixed
jQueryUpload_head()
jQueryUpload_head() : mixed
upload_head()
upload_head() : mixed
upload_extra()
upload_extra(mixed $uploadlimit, mixed $passedalbum) : mixed
Parameters
- $uploadlimit : mixed
- $passedalbum : mixed
upload_form()
upload_form(mixed $uploadlimit, mixed $passedalbum) : mixed
Parameters
- $uploadlimit : mixed
- $passedalbum : mixed
jQueryUploadHandler()
jQueryUploadHandler(mixed $uploadHandlers) : mixed
Parameters
- $uploadHandlers : mixed
jQueryUploadHandler_admin_tabs()
jQueryUploadHandler_admin_tabs(mixed $tabs) : mixed
Parameters
- $tabs : mixed
printUserLogin_out()
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;
Parameters
- $before : string = ''
-
before text
- $after : string = ''
-
after text
- $showLoginForm : int = NULL
-
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.)
- $logouttext : string = NULL
-
optional replacement text for "Logout"
user_mailing_list_button()
user_mailing_list_button(mixed $buttons) : mixed
Parameters
- $buttons : mixed
getExpiryDatePost()
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
Return values
stringprocessTags()
processes the taglist save
processTags(object $object) : mixed
Parameters
- $object : object
-
the object on which the save happened
updatePage()
Updates or adds a page and returns the object of that page
updatePage(array<string|int, mixed> &$reports[, bool $newpage = false ]) : object
Parameters
- $reports : array<string|int, mixed>
-
report display
- $newpage : bool = false
-
true if it is a new page
Return values
objectdeletePage()
Deletes a page (and also if existing its subpages) from the database
deletePage(mixed $titlelink) : mixed
Parameters
- $titlelink : mixed
printPagesListTable()
Prints the table part of a single page item for the sortable pages list
printPagesListTable(object $page, bool $flag) : mixed
Parameters
- $page : object
-
The array containing the single page
- $flag : bool
-
set to true to flag the element as having a problem with nesting level
updateArticle()
Updates or adds a news article and returns the object of that article
updateArticle(array<string|int, mixed> &$reports[, bool $newarticle = false ]) : object
Parameters
- $reports : array<string|int, mixed>
-
display
- $newarticle : bool = false
-
true if a new article
Return values
objectdeleteArticle()
Deletes an news article from the database
deleteArticle(mixed $titlelink) : mixed
Parameters
- $titlelink : mixed
printArticleCategories()
Print the categories of a news article for the news articles list
printArticleCategories(obj $obj) : mixed
Parameters
- $obj : obj
-
object of the news article
printPageArticleTags()
Print the categories of a news article for the news articles list
printPageArticleTags(obj $obj) : mixed
Parameters
- $obj : obj
-
object of the news article
printCategorySelection()
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
Parameters
- $id : int = ''
-
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.
- $option : string = ''
-
"all" to show all categories if creating a new article without categories assigned, empty if editing an existing article that already has categories assigned.
printArticleDatesDropdown()
Prints the dropdown menu for the date archive selector for the news articles list
printArticleDatesDropdown(mixed $pagenumber) : mixed
Parameters
- $pagenumber : mixed
getNewsAdminOption()
Compiles an option parameter list
getNewsAdminOption(array<string|int, mixed> $test) : array<string|int, mixed>
Parameters
- $test : array<string|int, mixed>
-
array of parameter=>type elements. type=0:string type=1:numeric
Return values
array<string|int, mixed>getNewsAdminOptionPath()
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
Parameters
- $list : array<string|int, mixed>
-
an parameter array of item=>value for instance, the result of getNewsAdminOption()
Return values
stringprintUnpublishedDropdown()
Prints the dropdown menu for the published/un-publishd selector for the news articles list
printUnpublishedDropdown() : mixed
printSortOrderDropdown()
Prints the dropdown menu for the sortorder selector for the news articles list
printSortOrderDropdown() : mixed
printCategoryDropdown()
Prints the dropdown menu for the category selector for the news articles list
printCategoryDropdown() : mixed
printArticlesPerPageDropdown()
Prints the dropdown menu for the articles per page selector for the news articles list
printArticlesPerPageDropdown(mixed $pagenumber, mixed $articles_page) : mixed
Parameters
- $pagenumber : mixed
- $articles_page : mixed
printAuthorDropdown()
Prints the dropdown menu all authors that currently are authors of news articles
printAuthorDropdown() : mixed
updateCategory()
Updates or adds a category
updateCategory(array<string|int, mixed> &$reports[, bool $newcategory = false ]) : mixed
Parameters
- $reports : array<string|int, mixed>
-
the results display
- $newcategory : bool = false
-
true if a new article
deleteCategory()
Deletes a category (and also if existing its subpages) from the database
deleteCategory(mixed $titlelink) : mixed
Parameters
- $titlelink : mixed
printCategoryListSortableTable()
Prints the list entry of a single category for the sortable list
printCategoryListSortableTable(array<string|int, mixed> $cat, string $flag) : string
Parameters
- $cat : array<string|int, mixed>
-
Array storing the db info of the category
- $flag : string
-
If the category is protected
Return values
stringprintCategoryCheckboxListEntry()
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
Parameters
- $cat : mixed
- $articleid : mixed
- $option : string
-
"all" to show all categories if creating a new article without categories assigned, empty if editing an existing article that already has categories assigned.
- $class : mixed = ''
printNestedItemsList()
Prints the nested list for pages and categories
printNestedItemsList([string $listtype = 'cats-sortablelist' ][, $obj = '' ][, string $option = '' ][, mixed $class = 'nestedItem' ]) : string
Parameters
- $listtype : string = 'cats-sortablelist'
-
'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 : = ''
-
$obj Optional, default empty. Passing an articledid is deprecated and will be removed in ZenphotoCMS 2.0.
- listtype = 'cats-checkboxlist': Object 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.
- listtype = 'pages-sortablelist': Object of the page object to show sub pages of or empty for all
- $option : string = ''
-
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.
- $class : mixed = 'nestedItem'
Return values
string —| bool
updateItemSortorder()
Updates the sortorder of the items list in the database
updateItemSortorder([string $mode = 'pages' ]) : array<string|int, mixed>
Parameters
- $mode : string = 'pages'
-
'pages' or 'categories'
Return values
array<string|int, mixed>checkForEmptyTitle()
Checks if no title has been provide for items on new item creation
checkForEmptyTitle(string $titlefield, string $type[, mixed $truncate = true ]) : string
Parameters
- $titlefield : string
-
The title field
- $type : string
-
'page', 'news' or 'category'
- $truncate : mixed = true
Return values
stringzenpagePublish()
Publishes a page or news article
zenpagePublish(object $obj, int $show) : string
Parameters
- $obj : object
- $show : int
-
the value for publishing
Return values
stringskipScheduledPublishing()
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
Parameters
- $obj : object
- $type : string = 'futuredate'
-
"futuredate" or "expiredate"
Tags
Return values
stringcheckHitcounterDisplay()
Checks if there are hitcounts and if they are displayed behind the news article, page or category title
checkHitcounterDisplay(string $item) : string
Parameters
- $item : string
-
The array of the current news article, page or category in the list.
Return values
stringgetNewsPagesStatistic()
returns an array of how many pages, articles, categories and news or pages comments we got.
getNewsPagesStatistic(string $option) : mixed
Parameters
- $option : string
-
What the statistic should be shown of: "news", "pages", "categories"
printPagesStatistic()
printPagesStatistic() : mixed
printNewsStatistic()
printNewsStatistic() : mixed
printCategoriesStatistic()
printCategoriesStatistic() : mixed
zenpageJSCSS()
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()
printZenpageIconLegend() : mixed
authorSelector()
Prints a dropdown to select the author of a page or news article (Admin rights users only)
authorSelector([mixed $author = NULL ]) : mixed
Parameters
- $author : mixed = NULL
printPublishIconLink()
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
Parameters
- $obj : obj
-
Object of the page or news article to check
- $type : mixed = ''
- $linkback : mixed = ''
Tags
checkIfChecked()
Checks if a checkbox is selected and checks it if.
checkIfChecked(string $field) : mixed
Parameters
- $field : string
-
the array field of an item array to be checked (for example "permalink" or "comments on")
checkIfLockedPage()
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.
Parameters
- $page : object
-
The array of the page or article to check
Return values
boolcheckIfLockedNews()
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.
Parameters
- $news : mixed
Return values
boolis_AdminEditPage()
Checks if the current admin-edit.php page is called for news articles or for pages.
is_AdminEditPage(string $page) : bool
Parameters
- $page : string
-
What you want to check for, "page" or "newsarticle"
Return values
boolprocessZenpageBulkActions()
Processes the check box bulk actions
processZenpageBulkActions(mixed $type) : mixed
Parameters
- $type : mixed
zenpageBulkActionMessage()
zenpageBulkActionMessage(mixed $action) : mixed
Parameters
- $action : mixed
createTitlelink()
Creates the titlelink from the title passed.
createTitlelink(string|array<string|int, mixed> $title, string $date) : type
Parameters
- $title : string|array<string|int, mixed>
-
The title respectively language array of titles
- $date : string
-
The date the article is saved
Tags
Return values
typecheckTitlelinkDuplicate()
Checks if a title link of this itemtype already exists
checkTitlelinkDuplicate(string $titlelink, string $itemtype) : bool
Parameters
- $titlelink : string
-
The titlelink to check
- $itemtype : string
Tags
Return values
booladdDateToTitlelink()
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!
Parameters
- $titlelink : string
-
The titleink (e.g. as created by createTitleink())
Tags
Return values
stringgetNewsIndexURL()
Returns the full path of the news index page
getNewsIndexURL([int $page = '' ]) : string
Parameters
- $page : int = ''
-
Page number to append, default empty (page 1)
Return values
stringgetNewsArchiveURL()
Returns the full path of the news archive page
getNewsArchiveURL(string $date) : string
Parameters
- $date : string
-
the date of the archive page
Return values
stringRSS_Tags()
RSS_Tags(mixed $item, mixed $type) : mixed
Parameters
- $item : mixed
- $type : mixed
RSS_Channel()
RSS_Channel(mixed $channel) : mixed
Parameters
- $channel : mixed
RSS_Retrieve()
RSS_Retrieve(mixed $url) : mixed
Parameters
- $url : mixed
printNews()
printNews() : mixed
zenphoto_sendmail()
zenphoto_sendmail(type $msg, type $email_list, type $subject, type $message, type $from_mail, type $from_name, type $cc_addresses, type $replyTo) : type
Parameters
- $msg : type
- $email_list : type
- $subject : type
- $message : type
- $from_mail : type
- $from_name : type
- $cc_addresses : type
- $replyTo : type