ZenphotoCMS 1.6.3

WEBdocs extends TextObject
in package

zpcore

plugins

classwebdocs

Core class for handling "non-image" files

Text type files can be displayed in place of an image in themes

supports files of the following types: .txt .htm .html The contents of these files are "dumpped" into a SPAN sized to a 24x36 ratioed box based on your theme "image size" option. This has a class of "textobject" so it can be styled.

What this plugin really is for is to serve as a model of how a plugin can be made to handle file types that zenphoto does not handle natively.

Some key points to note:

The naming convention for these plugins is class-«handler class».php.
The statement setting the plugin_is_filter variable must be near the front of the file. This is important as it is the indicator to the Zenphoto plugin loader to load the script at the same point that other object modules are loaded.
These objects are extension to the zenphoto "Image" class. This means they have all the properties of an image plus whatever you add. Of course you will need to override some of the image class functions to implement the functionality of your new class.
There is one VERY IMPORTANT method that you must provide which is not part of the "Image" base class. That getContent() method. This method is called by template-functions.php in place of where it would normally put a URL to the image to show. This method must do everything needed to cause your image object to be viewable by the browser.

So, briefly, the first four lines of code below are the standard plugin interface to Admin. There is one small wrinkle you might notice--the code for 'plugin_description' includes a test which sets the variable $disable. As you might expect, there were some changes needed to zenphoto in order to get this concept to work. $disable is set to true if the revision of zenphoto that is attempting to load this plugin is lower than the one where the implementation first appeared. The interface variable 'plugin_disable' is set to this value telling Admin not to allow enabling of the plugin if the release level is too low.

The line that follows insures that the plugin will not load when it should be disabled--just in case.

Then there is a call on addPlginType(«file extension», «Object Name»); This function registers the plugin as the handler for files with the specified extension. If the plugin can handle more than one file extension, make a call to the registration function for each extension that it handles.

The rest is the object class for handling these files.

The code of the object instantiation function is mostly required. Plugin "images" follow the lead of videos in that if there is a real image file with the same name save the suffix, it will be considered the thumb image of the object. This image is fetched by the call on checkObjectsThumb(). There is also code in the getThumb() method to deal with this property.

Since text files have no natural height and width, we set them based on the image size option. This happens after the call PersistentObject(). The rest of the code there sets up the default title.

getThumb() is responsible for generating the thumbnail image for the object. As above, if there is a similar named real image, it will be used. Otherwise [for this object implementation] we will use a thumbnail image provided with the plugin. The particular form of the file name used when there is no thumb stand-in image allows zenphoto to choose an image in the plugin folder.

Properties

$album : mixed
$albumlink : mixed
$albumname : mixed
$albumnamealbum : mixed
$comments : mixed
$displayname : mixed
$encwebpath : mixed
$exists : mixed
$filemtime : mixed
$filename : mixed
$imagefolder : mixed
$imagetype : mixed
$loaded : mixed
$localpath : mixed
$manage_rights : mixed
$manage_some_rights : mixed
$objectsThumb : mixed
$sidecars : mixed
$table : mixed
$thumbdimensions : mixed
$transient : mixed
$view_rights : mixed
$webpath : mixed
$id : mixed
$index : mixed
$is_protected : mixed
$is_public : mixed
$sortorder : mixed
$watermark : mixed
$watermarkDefault : mixed
$cache_by : mixed
$commentcount : mixed
$data : mixed
$tempdata : mixed
$unique_set : mixed
$updates : mixed
$use_cache : mixed

Methods

__construct() : TextObject: creates a WEBdocs (image standin)
__toString() : string: "Magic" function to return a string identifying the object when it is treated as a string
addComment() : object: Adds comments to the album assumes data is coming straight from GET or POST
calculateAspectRatio() : mixed: Calculate the aspect ratio from width and height
checkAccess() : mixed: Checks if viewing of object is allowed by rights or protection status
checkChanges() : bool: By default the object is saved if there are any updates within the property `$updates` no matter if these are actual changes to existing data.
checkforGuest() : mixed: Checks if guest is loggedin for the album
checkForGuest() : mixed: Checks if the item is password protected and if the password has been entered
checkPublishDates() : bool: Checks if the item is either expired or needs to be scheduled published
checkScheduledPublishing() : int: Checks if the item has expired or is in scheduled publishing
clearCache() : mixed: Clears the object cache by setting it to an empty array completely or a specific object (class name) cache.
clearObjectCache() : mixed: Shortcut to clear the cache of the current object class only
common_instantiate() : mixed: Handles class common instantiation
copy() : mixed: Copy this record to another unique set. Checks if the record exists there first, if so returns false. If successful returns true. No changes are made to this object and no other objects are created, just the database entry.
copyCacheFiles() : mixed: Copies the cache files of the image to another cache folder
countHit() : mixed: counts visits to the object
get() : mixed: Get the value of a variable. If $current is false, return the value as of the last save of this object.
getAlbum() : object: Returns the album that holds this image
getAlbumName() : string: Retuns the folder name of the album that holds this image
getCacheFiles() : array<string|int, mixed>: Gets the cache files of the image
getCity() : string: Returns the city field of the image
getCodeblock() : array<string|int, mixed>: Returns the codeblocks as an serialized array
getCommentCount() : int: Returns the count of comments in the album. Ignores comments in moderation
getComments() : array<string|int, mixed>: Returns an array of comments for this album
getCommentsAllowed() : bool: Retuns true if comments are allowed
getContent() : string: Returns the content of the text file
getCopyright() : string: Returns the copyright field of the image
getCopyrightNotice() : string|null: Returns the content of the copyright field if set.
getCopyrightRightsholder() : mixed: Gets the general option "copyright_image_rightsholder" respectively "copyright_image_rightsholder_custom" If set to "none" the following fallbacks are tried.
getCopyrightURL() : string: Gets the image copyright URL
getCountry() : string: Returns the country field of the image
getCredit() : string: Returns the credit field of the image
getCustomData() : string: returns the custom data field
getCustomImage() : string: Get a custom sized version of this image based on the parameters.
getData() : array<string|int, mixed>: returns the database record of the object
getDateTime() : int: Returns the unformatted date
getDesc() : string: Returns the description
getExpireDate() : string: Returns the expired date if available,
getFileName() : string: Returns the image filename
getFilesize() : int|false: Returns the filesize in bytes of the full image
getFullImage() : string: Returns a path to the original image in the original folder.
getFullImageURL() : mixed: returns URL to the original image
getGeodata() : array<string|int, mixed>: If there is valid GPS data returns key value array with "long" and "lat" keys otherwise an empty array
getHeight() : int: Returns the height of the image
getHitcounter() : int: Returns the hitcount
getID() : string: Returns the id
getImageFootprint() : string: Returns the disk size of the image
getIndex() : int: Get the index of this image in the album, taking sorting into account.
getLastChange() : string: Returns the last change user
getLastChangeUser() : string: Returns the last change user
getLevel() : int: Gets the level based on the sort order if the theme object is hierachical. Otherwise returns 1 (top level)
getLink() : string: Returns a path urlencoded image page link for the image
getLocation() : string: Returns the location field of the image
getMetaData() : array<string|int, mixed>: Returns an array of EXIF data
getName() : string: Returns the image filename
getNextImage() : object: Returns the next Image.
getOrientation() : bool|string: Returns 'is_square', 'is_landscape', 'is_portrait' if the original image's widht and height match.
getOwner() : string: Gets the owner of the image
getParentID() : string: Returns the partent id
getPassword() : null: Gets the password if set
getPasswordHint() : string: Returns the password hint
getPrevImage() : object: Return the previous Image
getPublishDate() : string: Returns the publish date
getShow() : bool: Returns true published
getSizedImage() : string: Returns a path to a sized version of the image
getSortOrder() : string: Returns the sort order
getState() : string: Returns the state field of the image
getTags() : string: Returns the tag data
getThumb() : string: Get a default-sized thumbnail of this image.
getThumbCropping() : mixed: Returns an array of cropping parameters. Used as a "helper" function for various inherited getThumb() methods
getThumbDimensions() : array<string|int, mixed>: Returns an array with widht and height the thumb. Here this is just a wrapper for getWidth() and getHeight()
getThumbHeight() : int: Returns the height of the image. Here just the same as getHeight().
getThumbImageFile() : s: Returns the image file name for the thumbnail image.
getThumbWidth() : int: Returns the width of the thumb. Here just the same as getWidth().
getTitle() : string: Returns the title
getUser() : string: Returns the guest user
getWatermark() : string: Returns the custom watermark name
getWidth() : int: Returns the width of the image
getWMUse() : bool: Returns the custom watermark usage
hasExpiration() : bool: Returns true if the item will be automatically unpublished by a not yet reached future expire date
hasExpired() : bool: Returns true if the items has been unpublished after reaching the set expire date.
hasExpireDate() : bool: Returns true if the item has a proper expire date set no matter if it has expired already or will expire in the future
hasFutureDate() : string: Returns the future date (publishdate for gallery, date for Zenpage items) if set to the future only
hasInactiveExpiration() : bool: Returns true if a future expiredate is set but the item is unpublished
hasInactivePublishSchedule() : bool: Returns true if the item has a future date but is not published
hasMetaData() : bool: Returns true if the image has any meta data
hasPublishSchedule() : bool: Returns true if the item will be automatically published by a future date set
hasTag() : bool: Checks if an object has a tag assigned.
instantiate() : bool: }
isImageClass() : bool: Returns true if the object is a zenphoto 'image'
isLandscape() : bool: Returns true if the image has landscape orientation
isMyItem() : mixed: Checks basic access rights of an object
isPhoto() : bool: Returns true if the image is a "photo"
isPortrait() : bool: Returns true if the image has portrait orientation
isProtected() : bool: Checks if the item is password protected. Checks if the password has been entered *
isProtectedByParent() : bool: Check if the item is not protected itself but protection is inherited by a parent. Checks if the password has been entered.
isPublic() : bool: Returns true if this object is published and does not inherit any unpublish status by a parent
isPublished() : bool: Returns true if the item itself is published
isSquare() : bool: Returns true if the image is a square
isUnpublishedByParent() : bool: Returns true if itself published but unpublished status is inheretited by a parent
isVideo() : bool: Returns true if the image is an "video" file
isVisible() : bool: Checks if the current item is visible (= listed) to the current visitor via rights, publish status or protection status
move() : mixed: Change one or more values of the unique set assigned to this record.
moveCacheFiles() : bool: Moves the cache files of the image to another cache folder
newImage() : object: Returns a new "image" object based on the file extension
remove() : bool: Deletes object from the database
removeCacheFiles() : mixed: Removes cached files
rename() : bool: Renames an image to a new filename, keeping it in the same album. Convenience for move($image->album, $newfilename).
renameCacheFiles() : bool: Renames the cache files of the image Alias of moveCacheFiles()
save() : mixed: Save the updates made to this object since the last update. Returns true if successful, false if not.
set() : mixed: Set a variable in this object. Does not persist to the database until save() is called. So, IMPORTANT: Call save() after set() to persist.
setCity() : mixed: Stores the city field of the image
setCodeblock() : mixed: set the codeblocks as an serialized array
setCommentsAllowed() : mixed: Sets the comments allowed flag
setCopyright() : mixed: Stores the text for the copyright field of the image
setCountry() : mixed: Stores the country field of the image
setCredit() : mixed: Stores the credit field of the image
setCustomData() : mixed: Sets the custom data field
setDateTime() : mixed: Stores the date
setDesc() : mixed: Stores the description
setExpireDate() : mixed: sets the expire date
setLastChange() : mixed: stores the current date in the format 'Y-m-d H:i:s' as the last change date
setLastchangeUser() : mixed: stores the last change user
setLocation() : mixed: Stores the location field of the image
setOwner() : mixed
setParentID() : mixed: Sets the ParentID field
setPassword() : mixed: Sets the encrypted password
setPasswordHint() : mixed: Sets the password hint
setPublishDate() : mixed: sets the publish date
setPublished() : mixed: Stores the published value
setShow() : mixed: Stores the published value
setSortOrder() : mixed: Stores the sort order
setState() : mixed: Stores the state field of the image
setTags() : mixed: Stores tag information
setTitle() : mixed: Stores the title
setUpdatedDateAlbum() : mixed: Sets the current date to the images'album and all of its parent albums recursively
setUser() : mixed: Sets the guest user
setWatermark() : mixed: Set custom watermark
setWMUse() : mixed: Sets the custom watermark usage
updateDimensions() : mixed: Update this object's values for width and height.
updateMetaData() : mixed: Parses Exif/IPTC data
classSetup() : bool: generic "image" class setup code Returns true if valid image.
fileChanged() : bool: Returns true if the file has changed since last time we looked
setDefaults() : mixed: Sets default values for new objects using the set() method.
addToCache() : mixed: add the entry to the cache
getFromCache() : mixed: check the cache for presence of the entry and return it if found
getIPTCTag() : string: Fetches a single tag from IPTC data
getIPTCTagArray() : array<string|int, mixed>: Fetches the IPTC array for a single tag.
load() : false: Load the data array from the database, using the unique id set to get the unique record.
prepIPTCString() : string: Returns the IPTC data converted into UTF8

$album


    public
        mixed
    $album

$albumlink


    public
        mixed
    $albumlink

$albumname


    public
        mixed
    $albumname

$albumnamealbum


    public
        mixed
    $albumnamealbum

$comments


    public
        mixed
    $comments
     = \NULL

$displayname


    public
        mixed
    $displayname

$encwebpath


    public
        mixed
    $encwebpath
     = ''

$exists


    public
        mixed
    $exists
     = \false

$filemtime


    public
        mixed
    $filemtime

$filename


    public
        mixed
    $filename

$imagefolder


    public
        mixed
    $imagefolder

$imagetype


    public
        mixed
    $imagetype
     = ''

$loaded


    public
        mixed
    $loaded
     = \false

$localpath


    public
        mixed
    $localpath

$manage_rights


    public
        mixed
    $manage_rights
     = \ADMIN_RIGHTS

$manage_some_rights


    public
        mixed
    $manage_some_rights
     = \ADMIN_RIGHTS

$objectsThumb


    public
        mixed
    $objectsThumb
     = \NULL

$sidecars


    public
        mixed
    $sidecars
     = array()

$table


    public
        mixed
    $table

$thumbdimensions


    public
        mixed
    $thumbdimensions
     = \null

$transient


    public
        mixed
    $transient

$view_rights


    public
        mixed
    $view_rights
     = \VIEW_ALL_RIGHTS

$webpath


    public
        mixed
    $webpath

$id


    protected
        mixed
    $id
     = 0

$index


    protected
        mixed
    $index

$is_protected


    protected
        mixed
    $is_protected
     = \null

$is_public


    protected
        mixed
    $is_public
     = \null

$sortorder


    protected
        mixed
    $sortorder

$watermark


    protected
        mixed
    $watermark
     = \NULL

$watermarkDefault


    protected
        mixed
    $watermarkDefault
     = \NULL

$cache_by


    private
        mixed
    $cache_by

$commentcount


    private
        mixed
    $commentcount

$data


    private
        mixed
    $data
     = \NULL

$tempdata


    private
        mixed
    $tempdata
     = \NULL

$unique_set


    private
        mixed
    $unique_set
     = \NULL

$updates


    private
        mixed
    $updates
     = \NULL

$use_cache


    private
        mixed
    $use_cache
     = \false

__construct()

creates a WEBdocs (image standin)


    public
                    __construct(object $album, string $filename[, mixed $quiet = false ]) : TextObject

Parameters

$album : object: the owner album
$filename : string: the filename of the text file
$quiet : mixed = false

Return values

TextObject

__toString()

"Magic" function to return a string identifying the object when it is treated as a string


    public
                    __toString() : string

Return values

string

addComment()

Adds comments to the album assumes data is coming straight from GET or POST


    public
                    addComment(string $name, string $email, string $website, string $comment, string $code, string $code_ok, string $ip, bool $private, bool $anon, string $customdata, bool $dataconfirmation) : 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
$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
$dataconfirmation : bool: true or false if data privacy confirmation was required

Return values

object

calculateAspectRatio()

Calculate the aspect ratio from width and height


    public
            static        calculateAspectRatio([int $width = null ][, int $height = null ][, string $separator = ':' ]) : mixed

Parameters

$width : int = null
$height : int = null
$separator : string = ':': Separator for the aspect ratio. Defaul ":"

checkAccess()

Checks if viewing of object is allowed by rights or protection status


    public
                    checkAccess([string &$hint = NULL ][, string &$show = NULL ]) : mixed

Parameters

$hint : string = NULL
$show : string = NULL

checkChanges()

By default the object is saved if there are any updates within the property `$updates` no matter if these are actual changes to existing data.


    public
                    checkChanges([bool $update = true ]) : bool

This checks that and internally updates the $updates property with the actual changes obky so you optionally can skip unnecessary object saves.

Standard object fields lastchange and lastchangeuser are exclude because lastchange always changes and both make no sense if there is no actual content change at all.

This can be used before calling the save() method or enabled within the save() method optionally

Parameters

$update : bool = true: True (default) to also update the $updates property with changes found or clear it. False to only check for changes.

Return values

bool

checkforGuest()

Checks if guest is loggedin for the album


    public
                    checkforGuest([unknown_type &$hint = NULL ][, unknown_type &$show = NULL ]) : mixed

Parameters

$hint : unknown_type = NULL
$show : unknown_type = NULL

checkForGuest()

Checks if the item is password protected and if the password has been entered


    public
                    checkForGuest([ &$hint = NULL ][,  &$show = NULL ]) : mixed

Parameters

$hint : = NULL
$show : = NULL

checkPublishDates()

Checks if the item is either expired or needs to be scheduled published


    public
                    checkPublishDates() : bool

Unpublishes the item if expired (saves to db) or scheduled (temporary) and returns false if expired or scheduled.

Return values

bool

checkScheduledPublishing()

Checks if the item has expired or is in scheduled publishing


    public
            static        checkScheduledPublishing(array<string|int, mixed> $row) : int

Returns 1 if expired, 2 if in scheduled future publishing

Parameters

$row : array<string|int, mixed>: database row of the object

Return values

int

clearCache()

Clears the object cache by setting it to an empty array completely or a specific object (class name) cache.


    public
            static        clearCache([mixed $class = null ]) : mixed

Note: You normally never need to use this. But on certain occasions it may be necessary to avoid memory issues if you loop through a lot of object creations.

Parameters

$class : mixed = null

clearObjectCache()

Shortcut to clear the cache of the current object class only


    public
                    clearObjectCache() : mixed

common_instantiate()

Handles class common instantiation


    public
                    common_instantiate( $album,  $filename[, mixed $quiet = false ]) : mixed

Parameters

$album :
$filename :
$quiet : mixed = false

copy()

Copy this record to another unique set. Checks if the record exists there first, if so returns false. If successful returns true. No changes are made to this object and no other objects are created, just the database entry.


    public
                    copy(mixed $new_unique_set) : mixed

A call to copy is instant, it does not require a save() following it.

Parameters

$new_unique_set : mixed

copyCacheFiles()

Copies the cache files of the image to another cache folder


    public
                    copyCacheFiles(object $newalbum) : mixed

Parameters

$newalbum : object: Target album object

countHit()

counts visits to the object


    public
                    countHit() : mixed

get()

Get the value of a variable. If $current is false, return the value as of the last save of this object.


    public
                    get(mixed $var[, mixed $current = true ]) : mixed

Parameters

$var : mixed
$current : mixed = true

getAlbum()

Returns the album that holds this image


    public
                    getAlbum() : object

Return values

object

getAlbumName()

Retuns the folder name of the album that holds this image


    public
                    getAlbumName() : string

Return values

string

getCacheFiles()

Gets the cache files of the image


    public
                    getCacheFiles() : array<string|int, mixed>

Return values

array<string|int, mixed>

getCity()

Returns the city field of the image


    public
                    getCity([mixed $locale = NULL ]) : string

Parameters

$locale : mixed = NULL

Return values

string

getCodeblock()

Returns the codeblocks as an serialized array


    public
                    getCodeblock() : array<string|int, mixed>

Return values

array<string|int, mixed>

getCommentCount()

Returns the count of comments in the album. Ignores comments in moderation


    public
                    getCommentCount() : int

Return values

int

getComments()

Returns an array of comments for this album


    public
                    getComments([bool $moderated = false ][, bool $private = false ][, bool $desc = false ]) : array<string|int, mixed>

Parameters

$moderated : bool = false: if false, ignores comments marked for moderation
$private : bool = false: if false ignores private comments
$desc : bool = false: set to true for descending order

Return values

array<string|int, mixed>

getCommentsAllowed()

Retuns true if comments are allowed


    public
                    getCommentsAllowed() : bool

Return values

bool

getContent()

Returns the content of the text file


    public
                    getContent([int $w = NULL ][, int $h = NULL ]) : string

Parameters

$w : int = NULL: optional width
$h : int = NULL: optional height

Return values

string

getCopyright()

Returns the copyright field of the image


    public
                    getCopyright([mixed $locale = NULL ]) : string

Parameters

$locale : mixed = NULL

Return values

string

getCopyrightNotice()

Returns the content of the copyright field if set.


    public
                    getCopyrightNotice([string $locale = null ]) : string|null

If not it tries the following fallbacks:

IPTCCopyright field
EXIFCopyright field
"copyright_image_notice" option
Owner

Parameters

$locale : string = null

Return values

string|null

getCopyrightRightsholder()

Gets the general option "copyright_image_rightsholder" respectively "copyright_image_rightsholder_custom" If set to "none" the following fallbacks are tried.


    public
                    getCopyrightRightsholder() : mixed

EXIFArtist
VideoArtist (for multimedia "images") – IPTCByLine
the owner (fullname if available)

getCopyrightURL()

Gets the image copyright URL


    public
                    getCopyrightURL() : string

Return values

string

getCountry()

Returns the country field of the image


    public
                    getCountry([mixed $locale = NULL ]) : string

Parameters

$locale : mixed = NULL

Return values

string

getCredit()

Returns the credit field of the image


    public
                    getCredit([mixed $locale = NULL ]) : string

Parameters

$locale : mixed = NULL

Return values

string

getCustomData()

returns the custom data field


    public
                    getCustomData([mixed $locale = NULL ]) : string

Parameters

$locale : mixed = NULL

Return values

string

getCustomImage()

Get a custom sized version of this image based on the parameters.


    public
                    getCustomImage(int $size, int $width, int $height, int $cropw, int $croph, int $cropx, int $cropy[, bool $thumbStandin = false ][, bool $effects = NULL ]) : string

Parameters

$size : int: size
$width : int: width
$height : int: height
$cropw : int: crop width
$croph : int: crop height
$cropx : int: crop x axis
$cropy : int: crop y axis
$thumbStandin : bool = false: set to true to treat as thumbnail
$effects : bool = NULL: set to desired image effect (e.g. 'gray' to force gray scale)

Return values

string

getData()

returns the database record of the object


    public
                    getData() : array<string|int, mixed>

Return values

array<string|int, mixed>

getDateTime()

Returns the unformatted date


    public
                    getDateTime() : int

Return values

int

getDesc()

Returns the description


    public
                    getDesc([mixed $locale = NULL ]) : string

Parameters

$locale : mixed = NULL

Return values

string

getExpireDate()

Returns the expired date if available,


    public
                    getExpireDate() : string

Return values

string

getFileName()

Returns the image filename


    public
                    getFileName() : string

Return values

string

getFilesize()

Returns the filesize in bytes of the full image


    public
                    getFilesize() : int|false

Return values

int|false

getFullImage()

Returns a path to the original image in the original folder.


    public
                    getFullImage([string $path = WEBPATH ]) : string

Parameters

$path : string = WEBPATH: the "path" to the image. Defaults to the simple WEBPATH

Return values

string

getFullImageURL()

returns URL to the original image


    public
                    getFullImageURL([string $path = WEBPATH ]) : mixed

Parameters

$path : string = WEBPATH: the "path" to the image. Defaults to the simple WEBPATH

getGeodata()

If there is valid GPS data returns key value array with "long" and "lat" keys otherwise an empty array


    public
                    getGeodata() : array<string|int, mixed>

Return values

array<string|int, mixed>

getHeight()

Returns the height of the image


    public
                    getHeight() : int

Return values

int

getHitcounter()

Returns the hitcount


    public
                    getHitcounter() : int

Return values

int

getID()

Returns the id


    public
                    getID() : string

Return values

string

getImageFootprint()

Returns the disk size of the image


    public
                    getImageFootprint() : string

Return values

string

getIndex()

Get the index of this image in the album, taking sorting into account.


    public
                    getIndex([bool $use_realalbum = false ]) : int

Parameters

$use_realalbum : bool = false: If the image is wihtin a dynamic album this is the index within it, set to true to get the index of the actual physical album the image belongs

Return values

int

getLastChange()

Returns the last change user


    public
                    getLastChange() : string

Return values

string

getLastChangeUser()

Returns the last change user


    public
                    getLastChangeUser() : string

Return values

string

getLevel()

Gets the level based on the sort order if the theme object is hierachical. Otherwise returns 1 (top level)


    public
                    getLevel() : int

Return values

int

getLink()

Returns a path urlencoded image page link for the image


    public
                    getLink([string $path = null ]) : string

Parameters

$path : string = null: Default null, optionally pass a path constant like WEBPATH or FULLWEBPATH

Return values

string

getLocation()

Returns the location field of the image


    public
                    getLocation([mixed $locale = NULL ]) : string

Parameters

$locale : mixed = NULL

Return values

string

getMetaData()

Returns an array of EXIF data


    public
                    getMetaData([string $displayonly = true ][, bool $hide_empty = true ]) : array<string|int, mixed>

Parameters

$displayonly : string = true: set to true to return only the items selected for display (default true)
$hide_empty : bool = true: Hide empty meta data fields (default true)

Return values

array<string|int, mixed>

getName()

Returns the image filename


    public
                    getName() : string

Return values

string

getNextImage()

Returns the next Image.


    public
                    getNextImage() : object

Return values

object

getOrientation()

Returns 'is_square', 'is_landscape', 'is_portrait' if the original image's widht and height match.


    public
                    getOrientation([string $type = 'image' ]) : bool|string

Parameters

$type : string = 'image': 'image' or 'thumb' - the latter may be different on non image "image items"

Return values

bool|string

getOwner()

Gets the owner of the image


    public
                    getOwner([bool $fullname = false ]) : string

Parameters

$fullname : bool = false: Set to true to get the full name (if the owner is a vaild user of the site and has the full name defined)

Return values

string

getParentID()

Returns the partent id


    public
                    getParentID() : string

Return values

string

getPassword()

Gets the password if set


    public
                    getPassword() : null

Placeholder for all child classes. Needs to be properly overriden there if password functionality is available

Return values

null

getPasswordHint()

Returns the password hint


    public
                    getPasswordHint([mixed $locale = NULL ]) : string

Parameters

$locale : mixed = NULL

Return values

string

getPrevImage()

Return the previous Image


    public
                    getPrevImage() : object

Return values

object

getPublishDate()

Returns the publish date


    public
                    getPublishDate() : string

Return values

string

getShow()

Returns true published


    public
                    getShow() : bool

Return values

bool

getSizedImage()

Returns a path to a sized version of the image


    public
                    getSizedImage(int $size) : string

Parameters

$size : int: how big an image is wanted

Return values

string

getSortOrder()

Returns the sort order


    public
                    getSortOrder() : string

Return values

string

getState()

Returns the state field of the image


    public
                    getState([mixed $locale = NULL ]) : string

Parameters

$locale : mixed = NULL

Return values

string

getTags()

Returns the tag data


    public
                    getTags() : string

Return values

string

getThumb()

Get a default-sized thumbnail of this image.


    public
                    getThumb([mixed $type = 'image' ]) : string

Parameters

$type : mixed = 'image'

Return values

string

getThumbCropping()

Returns an array of cropping parameters. Used as a "helper" function for various inherited getThumb() methods


    public
                    getThumbCropping(mixed $ts, mixed $sw, mixed $sh) : mixed

Parameters

$ts : mixed
$sw : mixed
$sh : mixed

getThumbDimensions()

Returns an array with widht and height the thumb. Here this is just a wrapper for getWidth() and getHeight()


    public
                    getThumbDimensions() : array<string|int, mixed>

Child (base) class handlers of non image file formats (e.g. video, textobject) where the actual "image" and the sidecar thumb are not the same file need to override this and provide the actual dimensions of the thumb using zp_getImageDims($thumbfile). Otherwise thumb generation may be distorted.

Return values

array<string|int, mixed>

getThumbHeight()

Returns the height of the image. Here just the same as getHeight().


    public
                    getThumbHeight() : int

Return values

int

getThumbImageFile()

Returns the image file name for the thumbnail image.


    public
                    getThumbImageFile([string $path = NULL ]) : s

Parameters

$path : string = NULL: override path

Return values

getThumbWidth()

Returns the width of the thumb. Here just the same as getWidth().


    public
                    getThumbWidth() : int

Return values

int

getTitle()

Returns the title


    public
                    getTitle([mixed $locale = NULL ]) : string

Parameters

$locale : mixed = NULL

Return values

string

getUser()

Returns the guest user


    public
                    getUser() : string

Return values

string

getWatermark()

Returns the custom watermark name


    public
                    getWatermark() : string

Return values

string

getWidth()

Returns the width of the image


    public
                    getWidth() : int

Return values

int

getWMUse()

Returns the custom watermark usage


    public
                    getWMUse() : bool

Return values

bool

hasExpiration()

Returns true if the item will be automatically unpublished by a not yet reached future expire date


    public
                    hasExpiration() : bool

Return values

bool

hasExpired()

Returns true if the items has been unpublished after reaching the set expire date.


    public
                    hasExpired() : bool

Return values

bool

hasExpireDate()

Returns true if the item has a proper expire date set no matter if it has expired already or will expire in the future


    public
                    hasExpireDate() : bool

Return values

bool

hasFutureDate()

Returns the future date (publishdate for gallery, date for Zenpage items) if set to the future only


    public
                    hasFutureDate() : string

Return values

string —

| null

hasInactiveExpiration()

Returns true if a future expiredate is set but the item is unpublished


    public
                    hasInactiveExpiration() : bool

Return values

bool

hasInactivePublishSchedule()

Returns true if the item has a future date but is not published


    public
                    hasInactivePublishSchedule() : bool

Return values

bool

hasMetaData()

Returns true if the image has any meta data


    public
                    hasMetaData() : bool

Return values

bool

hasPublishSchedule()

Returns true if the item will be automatically published by a future date set


    public
                    hasPublishSchedule() : bool

Return values

bool

hasTag()

Checks if an object has a tag assigned.


    public
                    hasTag(string $checktag) : bool

Parameters

$checktag : string: tag to check for

Return values

bool

instantiate()

}


    public
                    instantiate( $tablename,  $unique_set[,  $cache_by = NULL ][,  $use_cache = true ][,  $is_transient = false ][,  $allowCreate = true ]) : bool

Prime instantiator for Zenphoto objects

Parameters

$tablename :: The name of the database table
$unique_set :: An array of unique fields
$cache_by : = NULL
$use_cache : = true
$is_transient : = false: Set true to prevent database insertion
$allowCreate : = true: Set true to allow a new object to be made.

Return values

bool —

will be true if the unique_set does not already exist

isImageClass()

Returns true if the object is a zenphoto 'image'


    public
            static        isImageClass([object $image = NULL ]) : bool

Parameters

$image : object = NULL

Return values

bool

isLandscape()

Returns true if the image has landscape orientation


    public
                    isLandscape([string $type = 'image' ]) : bool

Parameters

$type : string = 'image': 'image' or 'thumb' - the latter may be different on non image "image items"

Return values

bool

isMyItem()

Checks basic access rights of an object


    public
                    isMyItem([bit $action = LIST_RIGHTS ]) : mixed

Parameters

$action : bit = LIST_RIGHTS: User rights level, default LIST_RIGHTS

isPhoto()

Returns true if the image is a "photo"


    public
                    isPhoto() : bool

Return values

bool

isPortrait()

Returns true if the image has portrait orientation


    public
                    isPortrait([string $type = 'image' ]) : bool

Parameters

$type : string = 'image': 'image' or 'thumb' - the latter may be different on non image "image items"

Return values

bool

isProtected()

Checks if the item is password protected. Checks if the password has been entered *


    public
                    isProtected() : bool

Return values

bool

isProtectedByParent()

Check if the item is not protected itself but protection is inherited by a parent. Checks if the password has been entered.


    public
                    isProtectedByParent() : bool

Return values

bool

isPublic()

Returns true if this object is published and does not inherit any unpublish status by a parent


    public
                    isPublic() : bool

Child classes with any hierachic structure need to override and extend this method to cover inheritance.

Return values

bool

isPublished()

Returns true if the item itself is published


    public
                    isPublished([bool $use_dbvalue = false ]) : bool

Parameters

$use_dbvalue : bool = false: Set to true to use the actual db value stored and not the possibly temporary modified value (e.g. if in scheduled publishing or expiration)

Return values

bool

isSquare()

Returns true if the image is a square


    public
                    isSquare([string $type = 'image' ]) : bool

Parameters

$type : string = 'image': 'image' or 'thumb' - the latter may be different on non image "image items"

Return values

bool

isUnpublishedByParent()

Returns true if itself published but unpublished status is inheretited by a parent


    public
                    isUnpublishedByParent() : bool

Return values

bool

isVideo()

Returns true if the image is an "video" file


    public
                    isVideo() : bool

Return values

bool

isVisible()

Checks if the current item is visible (= listed) to the current visitor via rights, publish status or protection status


    public
                    isVisible([bit $action = LIST_RIGHTS ]) : bool

Convenience wrapper for various methods.

Parameters

$action : bit = LIST_RIGHTS: User rights level, default LIST_RIGHTS

Return values

bool

move()

Change one or more values of the unique set assigned to this record.


    public
                    move(mixed $new_unique_set) : mixed

Checks if the record already exists first, if so returns false. If successful returns true and changes $this->unique_set A call to move is instant, it does not require a save() following it.

Parameters

$new_unique_set : mixed

moveCacheFiles()

Moves the cache files of the image to another cache folder


    public
                    moveCacheFiles(object $newalbum, string $newfilename) : bool

Parameters

$newalbum : object: Target album object
$newfilename : string: Album folder name of the cache folder (album/subalbum/…)

Return values

bool

newImage()

Returns a new "image" object based on the file extension


    public
            static        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)

Return values

object

remove()

Deletes object from the database


    public
                    remove() : bool

Return values

bool

removeCacheFiles()

Removes cached files


    public
                    removeCacheFiles() : mixed

rename()

Renames an image to a new filename, keeping it in the same album. Convenience for move($image->album, $newfilename).


    public
                    rename(string $newfilename) : bool

Returns true on success and false on failure.

Parameters

$newfilename : string: the new file name of the image file.

Return values

bool

renameCacheFiles()

Renames the cache files of the image Alias of moveCacheFiles()


    public
                    renameCacheFiles(mixed $newfilename) : bool

Parameters

$newfilename : mixed

Return values

bool

save()

Save the updates made to this object since the last update. Returns true if successful, false if not.


    public
                    save([bool $checkupdates = false ]) : mixed

Parameters

$checkupdates : bool = false: Default false. If true the internal $updates property is checked for actual changes so unnecessary saving is skipped. Applies to already existing objects only.

set()

Set a variable in this object. Does not persist to the database until save() is called. So, IMPORTANT: Call save() after set() to persist.


    public
                    set(mixed $var, mixed $value) : mixed

If the requested variable is not in the database, sets it in temp storage, which won't be persisted to the database.

Parameters

$var : mixed
$value : mixed

setCity()

Stores the city field of the image


    public
                    setCity(string $city) : mixed

Parameters

$city : string: text for the city

setCodeblock()

set the codeblocks as an serialized array


    public
                    setCodeblock(mixed $cb) : mixed

Parameters

$cb : mixed

setCommentsAllowed()

Sets the comments allowed flag


    public
                    setCommentsAllowed(bool $commentson) : mixed

Parameters

$commentson : bool: true if they are allowed

setCopyright()

Stores the text for the copyright field of the image


    public
                    setCopyright(string $copyright) : mixed

Parameters

$copyright : string: text for the copyright field

setCountry()

Stores the country field of the image


    public
                    setCountry(string $country) : mixed

Parameters

$country : string: text for the country filed

setCredit()

Stores the credit field of the image


    public
                    setCredit(string $credit) : mixed

Parameters

$credit : string: text for the credit field

setCustomData()

Sets the custom data field


    public
                    setCustomData(string $val) : mixed

Parameters

$val : string: the value to be put in custom_data

setDateTime()

Stores the date


    public
                    setDateTime(string $datetime) : mixed

Parameters

$datetime : string: formatted date

setDesc()

Stores the description


    public
                    setDesc(string $desc) : mixed

Parameters

$desc : string: description text

setExpireDate()

sets the expire date


    public
                    setExpireDate(mixed $ed) : mixed

Parameters

$ed : mixed

setLastChange()

stores the current date in the format 'Y-m-d H:i:s' as the last change date


    public
                    setLastChange() : mixed

setLastchangeUser()

stores the last change user


    public
                    setLastchangeUser(mixed $a) : mixed

Parameters

$a : mixed

setLocation()

Stores the location field of the image


    public
                    setLocation(string $location) : mixed

Parameters

$location : string: text for the location

setOwner()


    public
                    setOwner(mixed $owner) : mixed

Parameters

$owner : mixed

setParentID()

Sets the ParentID field


    public
                    setParentID( $v) : mixed

Parameters

$v :: id of the parent

setPassword()

Sets the encrypted password


    public
                    setPassword(string $pwd) : mixed

Parameters

$pwd : string: the cleartext password

setPasswordHint()

Sets the password hint


    public
                    setPasswordHint(string $hint) : mixed

Parameters

$hint : string: the hint text

setPublishDate()

sets the publish date


    public
                    setPublishDate(mixed $ed) : mixed

Parameters

$ed : mixed

setPublished()

Stores the published value


    public
                    setPublished(bool $published) : mixed

Parameters

$published : bool: True if the item is published

setShow()

Stores the published value


    public
                    setShow(bool $show) : mixed

Parameters

$show : bool: True if the album is published

setSortOrder()

Stores the sort order


    public
                    setSortOrder(string $sortorder) : mixed

Parameters

$sortorder : string: image sort order

setState()

Stores the state field of the image


    public
                    setState(string $state) : mixed

Parameters

$state : string: text for the state

setTags()

Stores tag information


    public
                    setTags(string $tags) : mixed

Parameters

$tags : string: the tag list

setTitle()

Stores the title


    public
                    setTitle(string $title) : mixed

Parameters

$title : string: the title

setUpdatedDateAlbum()

Sets the current date to the images'album and all of its parent albums recursively


    public
                    setUpdatedDateAlbum() : mixed

setUser()

Sets the guest user


    public
                    setUser(string $user) : mixed

Parameters

$user : string

setWatermark()

Set custom watermark


    public
                    setWatermark(string $wm) : mixed

Parameters

$wm : string

setWMUse()

Sets the custom watermark usage


    public
                    setWMUse( $use) : mixed

Parameters

$use :

updateDimensions()

Update this object's values for width and height.


    public
                    updateDimensions() : mixed

updateMetaData()

Parses Exif/IPTC data


    public
                    updateMetaData() : mixed

classSetup()

generic "image" class setup code Returns true if valid image.


    protected
                    classSetup(object &$album, string $filename) : bool

Parameters

$album : object: the images' album
$filename : string: of the image

Return values

bool

fileChanged()

Returns true if the file has changed since last time we looked


    protected
                    fileChanged() : bool

Return values

bool

setDefaults()

Sets default values for new objects using the set() method.


    protected
                    setDefaults() : mixed

Should do nothing in the base class; subclasses should override.

addToCache()

add the entry to the cache


    private
                    addToCache( $entry) : mixed

Parameters

$entry :

getFromCache()

check the cache for presence of the entry and return it if found


    private
                    getFromCache() : mixed

getIPTCTag()

Fetches a single tag from IPTC data


    private
                    getIPTCTag(string $tag, mixed $iptc) : string

Parameters

$tag : string: the metadata tag sought
$iptc : mixed

Return values

string

getIPTCTagArray()

Fetches the IPTC array for a single tag.


    private
                    getIPTCTagArray(string $tag, mixed $iptc) : array<string|int, mixed>

Parameters

$tag : string: the metadata tag sought
$iptc : mixed

Return values

array<string|int, mixed>

load()

Load the data array from the database, using the unique id set to get the unique record.


    private
                    load(bool $allowCreate) : false

Parameters

$allowCreate : bool: set to true to enable new object creation.

Return values

false —

if the record already exists, true if a new record was created.

prepIPTCString()

Returns the IPTC data converted into UTF8


    private
                    prepIPTCString(string $iptcstring, string $characterset) : string

Parameters

$iptcstring : string: the IPTC data
$characterset : string: the internal encoding of the data

Return values

string

WEBdocs extends TextObject in package zpcore plugins classwebdocs

Table of Contents

Properties

Methods

Properties

$album

$albumlink

$albumname

$albumnamealbum

$comments

$displayname

$encwebpath

$exists

$filemtime

$filename

$imagefolder

$imagetype

$loaded

$localpath

$manage_rights

$manage_some_rights

$objectsThumb

$sidecars

$table

$thumbdimensions

$transient

$view_rights

$webpath

$id

$index

$is_protected

$is_public

$sortorder

$watermark

$watermarkDefault

$cache_by

$commentcount

$data

$tempdata

$unique_set

$updates

$use_cache

Methods

__construct()

Parameters

Tags

Return values

__toString()

Return values

addComment()

Parameters

Return values

calculateAspectRatio()

Parameters

Tags

checkAccess()

Parameters

checkChanges()

Parameters

Tags

Return values

checkforGuest()

Parameters

checkForGuest()

Parameters

checkPublishDates()

Return values

checkScheduledPublishing()

Parameters

Tags

Return values

clearCache()

Parameters

Tags

clearObjectCache()

Tags

common_instantiate()

Parameters

copy()

Parameters

WEBdocs extends TextObject
in package

zpcore

plugins

classwebdocs