ZenpagePage
extends ZenpageItems
in package
zenpage page class
Tags
Table of Contents
Properties
- $comments : mixed
- $exists : mixed
- $loaded : mixed
- $manage_rights : mixed
- $manage_some_rights : mixed
- $parent : mixed
- $parents : mixed
- $table : mixed
- $transient : mixed
- $urparent : mixed
- $view_rights : mixed
- $id : mixed
- $is_protected : mixed
- $is_public : mixed
- $sortdirection : mixed
- $sortSticky : mixed
- $sorttype : mixed
- $cache_by : mixed
- $commentcount : mixed
- $data : mixed
- $tempdata : mixed
- $unique_set : mixed
- $updates : mixed
- $use_cache : mixed
Methods
- __construct() : mixed
- Class instantiator
- __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
- 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 the item is password protected and if the password has been entered
- checkforGuest() : mixed
- Checks if user is allowed to access the page
- 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
- copy() : mixed
- duplicates an article
- 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.
- getAuthor() : string
- Returns the author
- 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
- getCustomData() : string
- returns the custom data field
- getData() : array<string|int, mixed>
- returns the database record of the object
- getDateTime() : int
- Returns the unformatted date
- getDefaultSortorder() : string
- Gets a default sortorder for a page.
- getExpireDate() : string
- Returns the expired date if available,
- getExtraContent() : string
- Returns the extra content
- getHitcounter() : int
- Returns the hitcount
- getID() : string
- Returns the id
- 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 full path to a specific page
- getLocked() : string
- Returns the locked status , "1" if locked (only used on the admin)
- getName() : string
- Returns the name (titlelink)
- getPages() : array<string|int, mixed>
- Gets the sub pages of a page
- getParent() : obj|null
- Gets the parent page object based on the parentid set
- getParentID() : string
- Returns the partent id
- getParents() : array<string|int, mixed>
- Gets the parent pages' name recursivly to the page
- getPassword() : string
- Returns the password
- getPasswordHint() : string
- Returns the password hint
- getPermalink() : string
- Returns the perma link status (only used on admin)
- getShow() : bool
- Returns true published
- getSortOrder() : string
- Returns the sort order
- getTags() : string
- Returns the tag data
- getTitle() : string
- Returns the title
- getTitlelink() : string
- Returns the titlelink
- getUrParent() : mixed
- Gets the object of the oldest ancester of the page or category. Returns the object of the page/category itself if there is no urparent
- getUser() : string
- Returns the guest user
- 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
- 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
- }
- isMyItem() : mixed
- Checks if user is author of page
- isProtected() : bool
- Checks if the item is password protected. Checks if the password has been entered *
- isProtectedByParent() : bool
- Returns true if not protected but protection is inherited by a parent
- isPublic() : bool
- Returns true if this page is published and also all of its parents.
- isPublished() : bool
- Returns true if the item itself is published
- isUnpublishedByParent() : bool
- Returns true if itself published but unpublished status is inheretited by a parent
- 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.
- remove() : mixed
- Deletes a page (and also if existing its subpages) from the database
- 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.
- setAuthor() : mixed
- sets the author attribute
- setCodeblock() : mixed
- set the codeblocks as an serialized array
- setCommentsAllowed() : mixed
- Sets the comments allowed flag
- setContent() : mixed
- Set the content datum
- setCustomData() : mixed
- Sets the custom data field
- setDateTime() : mixed
- Stores the date
- setDefaultSortorder() : mixed
- Sets a default sortorder for a page.
- setExpireDate() : mixed
- sets the expire date
- setExtraContent() : mixed
- sets the extra content
- 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
- setLocked() : mixed
- sets the locked status , "1" if locked (only used on the admin)
- setName() : mixed
- sets the name (title link)
- setParentID() : mixed
- Sets the ParentID field
- setPassword() : mixed
- Sets the encrypted password
- setPasswordHint() : mixed
- Sets the password hint
- setPermalink() : mixed
- setPublished() : mixed
- Stores the published value
- setShow() : mixed
- Stores the published value
- setSortOrder() : mixed
- Stores the sort order
- setTags() : mixed
- Stores tag information
- setTitle() : mixed
- Stores the title
- setTitlelink() : mixed
- sets the title link
- setUser() : mixed
- Sets the guest user
- 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
- load() : false
- Load the data array from the database, using the unique id set to get the unique record.
Properties
$comments
public
mixed
$comments
= \NULL
$exists
public
mixed
$exists
= \false
$loaded
public
mixed
$loaded
= \false
$manage_rights
public
mixed
$manage_rights
= \MANAGE_ALL_PAGES_RIGHTS
$manage_some_rights
public
mixed
$manage_some_rights
= \ZENPAGE_PAGES_RIGHTS
$parent
public
mixed
$parent
= \null
$parents
public
mixed
$parents
= \null
$table
public
mixed
$table
$transient
public
mixed
$transient
$urparent
public
mixed
$urparent
= \null
$view_rights
public
mixed
$view_rights
= \ALL_PAGES_RIGHTS
$id
protected
mixed
$id
= 0
$is_protected
protected
mixed
$is_protected
= \null
$is_public
protected
mixed
$is_public
= \null
$sortdirection
protected
mixed
$sortdirection
$sortSticky
protected
mixed
$sortSticky
= \true
$sorttype
protected
mixed
$sorttype
$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
Methods
__construct()
Class instantiator
public
__construct(mixed $titlelink[, mixed $allowCreate = NULL ]) : mixed
Parameters
- $titlelink : mixed
- $allowCreate : mixed = NULL
__toString()
"Magic" function to return a string identifying the object when it is treated as a string
public
__toString() : string
Return values
stringaddComment()
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
objectcheckAccess()
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.
Tags
Return values
boolcheckForGuest()
Checks if the item is password protected and if the password has been entered
public
checkForGuest([ &$hint = NULL ][, &$show = NULL ]) : mixed
Parameters
checkforGuest()
Checks if user is allowed to access the page
public
checkforGuest([ &$hint = NULL ][, &$show = NULL ]) : mixed
Parameters
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
boolcheckScheduledPublishing()
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
Tags
Return values
intclearCache()
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
Tags
clearObjectCache()
Shortcut to clear the cache of the current object class only
public
clearObjectCache() : mixed
Tags
copy()
duplicates an article
public
copy(string $newtitle) : mixed
Parameters
- $newtitle : string
-
the title for the new article
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
getAuthor()
Returns the author
public
getAuthor([bool $fullname = false ]) : string
Parameters
- $fullname : bool = false
-
Set to true to get the full name (if the author is a vaild user of the site and has the full name defined)
Return values
stringgetCodeblock()
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
intgetComments()
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
boolgetContent()
Returns the content
public
getContent([mixed $locale = NULL ]) : string
Parameters
- $locale : mixed = NULL
Return values
stringgetCustomData()
returns the custom data field
public
getCustomData([mixed $locale = NULL ]) : string
Parameters
- $locale : mixed = NULL
Return values
stringgetData()
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
intgetDefaultSortorder()
Gets a default sortorder for a page.
public
getDefaultSortorder() : string
Use this before save()
a) If you created an new item after you set a parentid and no new specific sortorder b) You updated the parentid without setting specific new sortorder
The sortorder takes care of existing categories on the level and adds the item after existing ones.
Tags
Return values
stringgetExpireDate()
Returns the expired date if available,
public
getExpireDate() : string
Tags
Return values
stringgetExtraContent()
Returns the extra content
public
getExtraContent([mixed $locale = NULL ]) : string
Parameters
- $locale : mixed = NULL
Return values
stringgetHitcounter()
Returns the hitcount
public
getHitcounter() : int
Return values
intgetID()
Returns the id
public
getID() : string
Return values
stringgetLastChange()
Returns the last change user
public
getLastChange() : string
Return values
stringgetLastChangeUser()
Returns the last change user
public
getLastChangeUser() : string
Tags
Return values
stringgetLevel()
Gets the level based on the sort order if the theme object is hierachical. Otherwise returns 1 (top level)
public
getLevel() : int
Tags
Return values
intgetLink()
Returns full path to a specific page
public
getLink([string $path = null ]) : string
Parameters
- $path : string = null
-
Default null, optionally pass a path constant like WEBPATH or FULLWEBPATH
Return values
stringgetLocked()
Returns the locked status , "1" if locked (only used on the admin)
public
getLocked() : string
Return values
stringgetName()
Returns the name (titlelink)
public
getName() : string
Tags
Return values
stringgetPages()
Gets the sub pages of a page
public
getPages([bool $published = NULL ][, bool $directchilds = true ][, int $number = NULL ][, string $sorttype = NULL ][, string $sortdirection = NULL ][, string $author = null ]) : array<string|int, mixed>
Parameters
- $published : bool = NULL
-
TRUE for published or FALSE for all pages including un-published
- $directchilds : bool = true
-
Default true to get only the direct sub level pages, set to false to get all levels
- $number : int = NULL
-
number of pages to get (NULL by default for all)
- $sorttype : string = NULL
-
NULL for the standard order as sorted on the backend, "title", "date", "popular", "mostrated", "toprated", "random"
- $sortdirection : string = NULL
-
false for ascending, true for descending
- $author : string = null
-
Optional author name to get the pages of
Return values
array<string|int, mixed>getParent()
Gets the parent page object based on the parentid set
public
getParent() : obj|null
Tags
Return values
obj|nullgetParentID()
Returns the partent id
public
getParentID() : string
Return values
stringgetParents()
Gets the parent pages' name recursivly to the page
public
getParents() : array<string|int, mixed>
Return values
array<string|int, mixed>getPassword()
Returns the password
public
getPassword() : string
Return values
stringgetPasswordHint()
Returns the password hint
public
getPasswordHint([mixed $locale = NULL ]) : string
Parameters
- $locale : mixed = NULL
Return values
stringgetPermalink()
Returns the perma link status (only used on admin)
public
getPermalink() : string
Return values
stringgetShow()
Returns true published
public
getShow() : bool
Tags
Return values
boolgetSortOrder()
Returns the sort order
public
getSortOrder() : string
Return values
stringgetTags()
Returns the tag data
public
getTags() : string
Return values
stringgetTitle()
Returns the title
public
getTitle([mixed $locale = NULL ]) : string
Parameters
- $locale : mixed = NULL
Return values
stringgetTitlelink()
Returns the titlelink
public
getTitlelink() : string
Tags
Return values
stringgetUrParent()
Gets the object of the oldest ancester of the page or category. Returns the object of the page/category itself if there is no urparent
public
getUrParent() : mixed
Tags
getUser()
Returns the guest user
public
getUser() : string
Return values
stringhasExpiration()
Returns true if the item will be automatically unpublished by a not yet reached future expire date
public
hasExpiration() : bool
Tags
Return values
boolhasExpired()
Returns true if the items has been unpublished after reaching the set expire date.
public
hasExpired() : bool
Tags
Return values
boolhasExpireDate()
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
Tags
Return values
boolhasFutureDate()
Returns the future date (publishdate for gallery, date for Zenpage items) if set to the future only
public
hasFutureDate() : string
Tags
Return values
string —| null
hasInactiveExpiration()
Returns true if a future expiredate is set but the item is unpublished
public
hasInactiveExpiration() : bool
Tags
Return values
boolhasInactivePublishSchedule()
Returns true if the item has a future date but is not published
public
hasInactivePublishSchedule() : bool
Tags
Return values
boolhasPublishSchedule()
Returns true if the item will be automatically published by a future date set
public
hasPublishSchedule() : bool
Tags
Return values
boolhasTag()
Checks if an object has a tag assigned.
public
hasTag(string $checktag) : bool
Parameters
- $checktag : string
-
tag to check for
Return values
boolinstantiate()
}
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
isMyItem()
Checks if user is author of page
public
isMyItem([bit $action = LIST_RIGHTS ]) : mixed
Parameters
- $action : bit = LIST_RIGHTS
-
User rights level, default LIST_RIGHTS
returns true of access is allowed
isProtected()
Checks if the item is password protected. Checks if the password has been entered *
public
isProtected() : bool
Tags
Return values
boolisProtectedByParent()
Returns true if not protected but protection is inherited by a parent
public
isProtectedByParent() : bool
Tags
Return values
boolisPublic()
Returns true if this page is published and also all of its parents.
public
isPublic() : bool
Tags
Return values
boolisPublished()
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)
Tags
Return values
boolisUnpublishedByParent()
Returns true if itself published but unpublished status is inheretited by a parent
public
isUnpublishedByParent() : bool
Tags
Return values
boolisVisible()
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
Tags
Return values
boolmove()
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
remove()
Deletes a page (and also if existing its subpages) from the database
public
remove() : mixed
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
setAuthor()
sets the author attribute
public
setAuthor(mixed $a) : mixed
Parameters
- $a : mixed
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
setContent()
Set the content datum
public
setContent( $c) : mixed
Parameters
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
setDefaultSortorder()
Sets a default sortorder for a page.
public
setDefaultSortorder() : mixed
Use this before save()
a) If you created an new item after you set a parentid and no new specific sortorder b) You updated the parentid without setting specific new sortorder
The sortorder takes care of existing categories on the level and adds the item after existing ones.
Tags
setExpireDate()
sets the expire date
public
setExpireDate(mixed $ed) : mixed
Parameters
- $ed : mixed
setExtraContent()
sets the extra content
public
setExtraContent(mixed $ec) : mixed
Parameters
- $ec : 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
Tags
setLocked()
sets the locked status , "1" if locked (only used on the admin)
public
setLocked(mixed $l) : mixed
Parameters
- $l : mixed
setName()
sets the name (title link)
public
setName( $v) : mixed
Parameters
Tags
setParentID()
Sets the ParentID field
public
setParentID( $v) : mixed
Parameters
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
setPermalink()
public
setPermalink(mixed $v) : mixed
Parameters
- $v : mixed
setPublished()
Stores the published value
public
setPublished(bool $published) : mixed
Parameters
- $published : bool
-
True if the item is published
Tags
setShow()
Stores the published value
public
setShow(bool $show) : mixed
Parameters
- $show : bool
-
True if the album is published
Tags
setSortOrder()
Stores the sort order
public
setSortOrder(string $sortorder) : mixed
Parameters
- $sortorder : string
-
image sort order
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
setTitlelink()
sets the title link
public
setTitlelink( $v) : mixed
Parameters
Tags
setUser()
Sets the guest user
public
setUser(string $user) : mixed
Parameters
- $user : string
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
getFromCache()
check the cache for presence of the entry and return it if found
private
getFromCache() : 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.