Concrete\Core\Page\Page | ConcreteCMS API

class Page extends Collection implements ObjectInterface, ObjectInterface, AssignableObjectInterface, TreeInterface, SiteAggregateInterface, ExportableInterface (View source)

The page object in Concrete encapsulates all the functionality used by a typical page and their contents including blocks, page metadata, page permissions.

Traits

AssignableObjectTrait

Properties

	$error		from ConcreteObject
int\|null deprecated	$cID	The collection ID.	from Collection
protected Version\|null	$vObj	The collection version object.	from Collection
protected string\|null	$cHandle	The collection handle.	from Collection
protected string\|null	$cDateAdded	The date/time when the collection has been created.	from Collection
protected string\|null	$cDateModified	The date/time when the collection was last modified.	from Collection
protected array	$attributes		from Collection
Tree\|null deprecated	$siteTree
protected PageController\|null	$controller	The page controller.
protected int[]\|null	$blocksAliasedFromMasterCollection	The list of block IDs that are alias.
protected int\|null	$cPointerOriginalID	The original cID of a page (if it's a page alias).
protected int\|null	$cPointerOriginalSiteTreeID	The original siteTreeID of a page (if it's a page alias).
protected string\|null	$cPointerExternalLink	The link for the aliased page.
protected bool\|int\|null	$cPointerExternalLinkNewWindow	Should the alias link to be opened in a new window?
protected bool\|int\|null	$isMasterCollection	Is this page a page default?
protected int\|null	$cInheritPermissionsFromCID	The ID of the page from which this page inherits permissions from.
protected bool	$cIsSystemPage	Is this a system page?
protected int\|null	$siteTreeID	The site tree ID.

Methods

loadError($error)

No description

from ConcreteObject

isError()

No description

from ConcreteObject

getError()

No description

from ConcreteObject

setPropertiesFromArray($arr)

No description

from ConcreteObject

static

camelcase($file)

No description

from ConcreteObject

static

uncamelcase($string)

No description

from ConcreteObject

__destruct()

Destruct the class instance.

static Collection

getByID(int $cID, string|int|false $version = 'RECENT')

Get a page given its ID.

static Collection|null

getByHandle(string $handle)

Get a Collection by handle (provided that it's not a Page handle).

from Collection

static int

reindexPendingPages()

(Re)Index all the collections that are marked as to be (re)indexed.

from Collection

static Collection

createCollection(array $data)

Create a new Collection instance.

from Collection

int|null

getCollectionID()

Get the collection ID.

from Collection

string|null

getCollectionHandle()

Get the page handle.

string|null

getCollectionDateLastModified()

Get the date/time when the collection was last modified.

from Collection

string|null

getCollectionDateAdded()

Get the date/time when the collection has been created.

from Collection

int

getVersionID()

Get the ID of the currently loaded version.

from Collection

Version|null

getVersionObject()

Get the currently loaded version object.

from Collection

Collection

addCollection(array $data)

Create a new Collection instance, using the same theme as this instance (if it's a Page instance).

from Collection

loadVersionObject(string|int $cvID = 'ACTIVE')

Load a specific collection version (you can retrieve it with the getVersionObject() method).

from Collection

$this|Page

getVersionToModify()

Get the Collection instance to be modified (this instance if it's a new or master Collection, a clone otherwise).

from Collection

string

getNextVersionComments()

Get the automatic comment for the next collection version.

from Collection

bool|null

reindex(IndexedSearch|false $index = false, bool $actuallyDoReindex = true)

(Re)Index the contents of this collection (or mark the collection as to be reindexed if $actuallyDoReindex is falsy and the concrete.page.search.always_reindex configuration key is falsy).

from Collection

PageValue

setAttribute(string|CollectionKey $ak, AbstractValue|mixed $value, bool $doReindexImmediately = true)

Set the attribute value for the currently loaded collection version.

from Collection

mixed|null

getAttribute(string|CollectionKey $akHandle, string|false $displayMode = false)

Return the value of the attribute with the handle $akHandle of the currently loaded version (if it's loaded).

from Collection

PageValue|null

getAttributeValueObject(string|CollectionKey $akHandle, bool $createIfNotExists = false)

Return the attribute value object with the handle $akHandle of the currently loaded version (if it's loaded).

from Collection

clearCollectionAttributes(int[] $retainAKIDs = [])

Delete the values of the attributes associated to the currently loaded collection version.

from Collection

clearAttribute(string|CollectionKey $ak, bool $doReindexImmediately = true)

Delete the value of a specific attribute key associated to the currently loaded collection version.

from Collection

PageKey[]

getSetCollectionAttributes()

Get the list of attribute keys for which the currently loaded collection version has values.

from Collection

Area|null

getArea(string $arHandle)

Get an existing area associated to this collection.

from Collection

bool

hasAliasedContent()

Does this collection contain blocks that are aliased in other pages?

from Collection

CustomStyle|null

getAreaCustomStyle(Area $area, bool $force = false)

Get the custom style of an area in the currently loaded collection version.

from Collection

setCustomStyleSet(Area $area, StyleSet $set)

Set the custom style of an area in the currently loaded collection version.

from Collection

resetAreaCustomStyle(Area $area)

Delete all the custom styles of an area of the currently loaded collection version.

from Collection

string|null

outputCustomStyleHeaderItems(bool $return = false)

Retrieve all custom style rules that should be inserted into the header on a page, whether they are defined in areas or blocks.

from Collection

null|false

relateVersionEdits(Collection $oc)

Associate the edits of another collection to this collection.

from Collection

int|false

getPageTypeID()

Get the Collection Type ID.

refreshCache()

Empty the collection-related cache.

from Collection

Block[]

getGlobalBlocks()

Get the blocks contained in the all the global areas.

from Collection

Block[]

getBlocks(string|false $arHandle = false)

List the blocks in the currently loaded collection version (or in a specific area within it).

from Collection

array

getBlockIDs(string|false $arHandle = false)

List the block IDs and the associated area handles in the currently loaded collection version (or in a specific area within it).

from Collection

Block

addBlock(BlockType $bt, string|Area $a, array $data)

Add a new block to a specific area of the page.

int

getCollectionAreaDisplayOrder(string $arHandle, bool $ignoreVersions = false)

Get the next value of the display order (to be used when adding new blocks to an area).

from Collection

rescanDisplayOrder(string $arHandle)

Fix the display order properties for all the blocks within the collection/area.

from Collection

addFeature(Feature $fe)

Associate a feature to the currently loaded collection version.

from Collection

CollectionVersionAssignment[]

getFeatureAssignments()

Get the list of assigned features.

from Collection

markModified()

Update the last edit date/time.

from Collection

delete()

Delete this page and all its child pages.

Collection

duplicateCollection()

Create a clone of this collection, and all its versions, contents and attributes.

from Collection

Page

cloneVersion(string|null $versionComments, bool $createEmpty = false)

Clone the currently loaded version and returns a Page instance containing the new version.

from Collection

PageValue|null

getAttributeValue(string|CollectionKey $ak) deprecated

No description

from Collection

mixed|null

getCollectionAttributeValue(string|CollectionKey $akHandle) deprecated

No description

from Collection

getCollectionTypeID() deprecated

No description

assignPermissions($userOrGroup, $permissions = [], $accessType = Key::ACCESS_TYPE_INCLUDE, $cascadeToChildren = true)

No description

from AssignableObjectTrait

__construct()

Initialize collection until we populate it.

static Page

getByPath(string $path, string $version = 'RECENT', TreeInterface $tree = null)

Get a page given its path.

CategoryInterface

getObjectAttributeCategory()

No description

ItemInterface

getExporter()

No description

getPermissionResponseClassName()

No description

getPermissionAssignmentClassName()

No description

getPermissionObjectKeyCategoryHandle()

No description

stdClass

getJSONObject()

Return a representation of the Page object as something easily serializable.

PageController

getPageController()

Get the page controller.

getPermissionObjectIdentifier()

No description

bool

isEditMode()

Is the page in edit mode?

int

getPackageID()

Get the package ID for a page (page thats added by a package) (returns 0 if its not in a package).

string|null

getPackageHandle()

Get the handle the the package that added this page.

false

isArrangeMode() deprecated

No description

forceCheckIn()

Forces the page to be checked in if its checked out.

static

forceCheckInForAllPages()

No description

bool

isAdminArea()

Is this a dashboard page?

static Page

getFromRequest(Request $request)

Uses a Request object to determine which page to load. Queries by path and then by cID.

processArrangement(int $area_id, int $moved_block_id, int[] $block_order)

Persist the data associated to a block when it has been moved around in the page.

bool|null

isCheckedOut()

Is the page checked out?

string

getCollectionCheckedOutUserName()

Gets the user that is editing the current page.

bool

isCheckedOutByMe()

Checks if the page is checked out by the current user.

bool

isGeneratedCollection()

Checks if the page is a single page.

setPermissionsToOverride()

No description

setChildPermissionsToOverride()

No description

removePermissions(Group|Group[]|User|UserInfo|User $userOrGroup, string[] $permissions = [])

Remove specific permission keys for a specific access entity (user, group, group combination).

static Page

getDraftsParentPage(Site $site = null)

Get the drafts parent page for a specific site.

static Page[]

getDrafts(Site $site)

Get the list of draft pages in a specific site.

bool

isPageDraft()

Is this a draft page?

setController(PageController|null $controller)

Set the page controller.

PageController

getController() deprecated

No description

assignPermissionSet(SimpleXMLElement $px)

This is the legacy function that is called just by xml. We pass these values in as though they were the old ones.

int

addCollectionAlias(mixed $c)

Make an alias to a page.

updateCollectionAliasExternal(string $cName, string $cLink, bool $newWindow = 0)

Update the name, link, and to open in a new window for an external link.

int

addCollectionAliasExternal(string $cName, string $cLink, bool $newWindow = 0)

Add a new external link as a child of this page.

bool

isSystemPage()

Returns true if a page is a system page. A system page is either a page that is outside the site tree (has a site tree ID of 0) or a page that is in the site tree, but whose parent starts at 0. That means its a root level page. Why do we need this separate boolean then? Because we need to easily be able to filter all pages by whether they're a system page even if we don't necessarily know where their starting page is.

string

getCollectionIcon()

Gets the icon for a page (also fires the on_page_get_icon event).

int|null

removeThisAlias()

Remove an external link/alias.

array

populateRecursivePages(array $pages, array $pageRow, int $cParentID, int $level, bool $includeThisPage = true)

Create an array containing data about child pages.

int

queueForDeletionSort(array $a, array $b)

Sort a list of pages, so that the order is correct for the deletion.

int

queueForDuplicationSort(array $a, array $b)

Sort a list of pages, so that the order is correct for the duplication.

queueForDeletion()

Add this page and its subpages to the Delete Page queue.

queueForDeletionRequest(Queue|null $queue = null, bool $includeThisPage = true)

Add this page and its subpages to the Delete Page Requests queue (or to a custom queue).

queueForDuplication(Page $destination, bool $includeParent = true)

Add this page and its subpages to the Copy Page queue.

export(SimpleXMLElement $pageNode) deprecated

No description

int|null

getCollectionCheckedOutUserID()

Get the uID for a page that is checked out (if any).

string

getCollectionPath()

Get the path of this page.

PagePath|null

getCollectionPathObject()

Returns the PagePath object for the current page.

PagePath

addAdditionalPagePath(string $cPath, bool $commit = true)

Add a non-canonical page path to the current page.

setCanonicalPagePath(string $cPath, bool $isAutoGenerated = false)

Set the canonical page path for a page.

PagePath[]

getPagePaths()

Get all the page paths of this page.

PagePath[]

getAdditionalPagePaths()

Get all the non-canonical page paths of this page.

clearPagePaths()

Clears all page paths for a page.

string

getCollectionLink(bool $appendBaseURL = false)

Returns full url for the current page.

int|null

getSiteTreeID()

No description

Site

getSite()

No description

Tree|null

getSiteTreeObject()

No description

static

getCollectionPathFromID(mixed $cID)

Returns the path for a page from its cID.

int|null

getCollectionUserID()

Get the uID of the page author (if any).

string|null

getCollectionTypeName() deprecated

No description

string|null

getPageTypeName()

Get the display name of the page type (if available).

Type|null

getPageTypeObject()

Get the page type object.

int

getPageTemplateID()

Get the Page Template ID.

Template|null

getPageTemplateObject()

Get the Page Template Object (if available).

string|false

getPageTemplateHandle()

Get the handle of the Page Template (if available).

string|false

getPageTypeHandle()

Get the handle of the Page Type (if available).

string|false

getCollectionTypeHandle() deprecated

No description

int|null

getCollectionThemeID()

Get the theme ID for the collection (if available).

bool

isBlockAliasedFromMasterCollection(Block $b)

Check if a block is an alias from a page default.

Theme

getCollectionThemeObject()

Get the collection's theme object.

string

getCollectionName()

Get the page name.

int

getCollectionPointerID()

Get the collection ID for the aliased page (returns 0 unless used on an actual alias).

string|null

getCollectionPointerExternalLink()

Get the link for the aliased page.

bool|int|null

openCollectionPointerExternalLinkInNewWindow()

Should the alias link to be opened in a new window?

bool

isAliasPage()

Is this page an alias page of another page?

bool

isAliasPageOrExternalLink()

Is this page an alias page or an external link?

bool

isAlias() deprecated

No description

bool

isExternalLink()

Is this page an external link?

int

getCollectionPointerOriginalID()

Get the original cID of a page (if it's a page alias).

string

getCollectionFilename()

Get the file name of a page (single pages).

string

getCollectionDatePublic()

Get the date/time when the current version was made public (or a falsy value if the current version doesn't have public date).

DateTime|null

getCollectionDatePublicObject()

Get the date/time when the current version was made public (or NULL value if the current version doesn't have public date).

string

getCollectionDescription()

Get the description of a page.

int|null

getCollectionParentID()

Ges the cID of the parent page.

static int|null

getCollectionParentIDFromChildID(int $cID)

Get the parent cID of a page given its cID.

int[]

getCollectionParentIDs()

Get an array containint this cParentID and aliased parentIDs.

bool|int|null

isMasterCollection()

Is this page a page default?

bool|int|null

overrideTemplatePermissions()

Are template permissions overriden?

int|null

getCollectionDisplayOrder()

Get the position of the page in the sitemap, relative to its parent page.

setTheme(Theme $pl)

Set the theme of this page.

setPageType(Type $type = null)

Set the theme for a page using the page object.

setPermissionsInheritanceToTemplate()

Set the permissions of sub-collections added beneath this permissions to inherit from the template.

setPermissionsInheritanceToOverride()

Set the permissions of sub-collections added beneath this permissions to inherit from the parent.

int|null

getPermissionsCollectionID()

Get the ID of the page from which this page inherits permissions from.

string|null

getCollectionInheritance()

Where permissions should be inherited from? 'PARENT' or 'TEMPLATE' or 'OVERRIDE'.

int|null

getParentPermissionsCollectionID()

Get the ID of the page from which the parent page page inherits permissions from.

Page

getPermissionsCollectionObject()

Get the page from which this page inherits permissions from.

int

getMasterCollectionID()

Get the master page of this page, given its page template and page type.

int|null

getOriginalCollectionID()

Get the ID of the original collection.

int|null

getNumChildren()

Get the number of child pages.

int

getNumChildrenDirect()

Get the number of child pages (direct children only).

Page|false

getFirstChild(string $sortColumn = 'cDisplayOrder asc')

Get the first child of the current page, or null if there is no child.

int[]

getCollectionChildrenArray(bool $oneLevelOnly = 0)

Get the list of child page IDs, sorted by their display order.

Page[]

getCollectionChildren()

Get the immediate children of the this page.

bool

canMoveCopyTo(Collection $cobj)

Check if a collection is this page itself or one of its sub-pages.

updateCollectionName(string $name)

Update the collection name.

bool

hasPageThemeCustomizations()

Does this page have theme customizations?

resetCustomThemeStyles()

Clears the custom theme styles for this page.

CustomStyle

setCustomStyleObject(Theme $pt, ValueList $valueList, Preset|null|false $selectedPreset = false, CustomCssRecord $customCssRecord = null)

Set the custom style for this page for a specific theme.

string

getPageWrapperClass()

Get the CSS class to be used to wrap the whole page contents.

writePageThemeCustomizations()

Write the page theme customization CSS files to the cache directory.

static

resetAllCustomStyles()

Clears the custom theme styles for every page.

update(array $data)

Update the data of this page.

clearPagePermissions()

Clear all the page permissions.

inheritPermissionsFromParent()

Set this page permissions to be inherited from its parent page.

inheritPermissionsFromDefaults()

Set this page permissions to be inherited from its parent type defaults.

setPermissionsToManualOverride()

Set this page permissions to be manually specified.

rescanAreaPermissions()

Rescan the page areas ensuring that they are inheriting permissions properly.

setOverrideTemplatePermissions(bool|int $cOverrideTemplatePermissions)

Are template permissions overriden?

updatePermissionsCollectionID(int|string $cParentIDString, mixed $npID)

Set the child pages of a list of parent pages to inherit permissions from the specified page (provided that they previouly had the same inheritance page as this page).

acquireAreaPermissions(int $permissionsCollectionID)

Acquire the area permissions, copying them from the inherited ones.

acquirePagePermissions(int $permissionsCollectionID)

Acquire the page permissions, copying them from the inherited ones.

updateGroupsSubCollection(int|string $cParentIDString) deprecated

No description

SiblingRelation[]

getPageRelations()

Get the relations of this page.

move(mixed $nc)

Move this page under a new parent page.

Page

duplicateAll(null|mixed $nc = null, bool $preserveUserID = false, Site $site = null)

Duplicate this page and all its child pages and return the new Page created.

Page

duplicate(null|mixed $nc = null, bool $preserveUserID = false, TreeInterface $site = null)

Duplicate this page and return the new Page created.

moveToTrash()

Move this page and all its child pages to the trash.

rescanChildrenDisplayOrder()

Regenerate the display order of the child pages.

bool

isHomePage()

Is this the homepage for the site tree this page belongs to?

int|null

getSiteHomePageID()

Get the ID of the homepage for the site tree this page belongs to.

bool

isLocaleHomePage() deprecated

No description

static int|null

getHomePageID(Page|int $page = null)

Get the ID of the home page.

PagePath

getAutoGeneratedPagePathObject()

Get a new PagePath object with the computed canonical page path.

int

getNextSubPageDisplayOrder()

Get the next available display order of child pages.

string

generatePagePath()

Get the URL-slug-based path to the current page (including any suffixes) in a string format. Does so in real time.

rescanCollectionPath()

Recalculate the canonical page path for the current page and its sub-pages, based on its current version, URL slug, etc.

updateDisplayOrder(int $displayOrder, int|null $cID = 0)

Set a new display order for this page (or for another page given its ID).

movePageDisplayOrderToTop()

Make this page the first child of its parent.

movePageDisplayOrderToBottom()

Make this page the first child of its parent.

movePageDisplayOrderToSibling(Page $c, string $position = 'before')

Move this page before of after another page.

rescanSystemPageStatus()

Recalculate the "is a system page" state.

bool

isInTrash()

Is this page in the trash?

moveToRoot()

Make this page child of nothing, thus moving it to the root level.

deactivate()

Mark this page as non active.

setPageToDraft()

Mark this page as non draft.

activate()

Mark this page as active.

bool

isActive()

Is this page marked as active?

setPageIndexScore(float $score)

Set the page index score (used by a PageList for instance).

float

getPageIndexScore()

Get the page index score (as set by a PageList for instance).

string

getPageIndexContent()

Get the indexed content of this page.

static Page

addHomePage(TreeInterface $siteTree = null)

Add the home page to the system. Typically used only by the installation program.

Page

add(mixed $pt, array $data, mixed $template = false)

Add a new page, child of this page.

CustomStyle|null

getCustomStyleObject()

Get the custom style for the currently loaded page version (if any).

int|null

getCollectionFullPageCaching()

Get the full-page cache flag (-1: use global setting; 0: no; 1: yes - NULL if page is not loaded).

string|null

getCollectionFullPageCachingLifetime()

Get the full-page cache lifetime criteria ('default': use default lifetime; 'forever': no expiration; 'custom': custom lifetime value - see getCollectionFullPageCachingLifetimeCustomValue(); other: use the default lifetime - NULL if page is not loaded).

int|null

getCollectionFullPageCachingLifetimeCustomValue()

Get the full-page cache custom lifetime in minutes (to be used if getCollectionFullPageCachingLifetime() is 'custom').

int

getCollectionFullPageCachingLifetimeValue()

Get the actual full-page cache lifespan (in seconds).

static Page

addStatic(array $data, TreeInterface $parent = null)

Create a new page.

static Page|null

getCurrentPage()

Get the currently requested page.

int

getPageDraftTargetParentPageID()

Get the ID of the draft parent page ID.

setPageDraftTargetParentPageID(int $cParentID)

Set the ID of the draft parent page ID.

populatePage(mixed $cInfo, string $where, string|int $cvID)

Read the data from the database.

_getNumChildren(int $cID, bool $oneLevelOnly = 0, string $sortColumn = 'cDisplayOrder asc')

Populate the childrenCIDArray property (called by the getCollectionChildrenArray() method).

_duplicateAll(mixed $cParent, mixed $cNewParent, bool $preserveUserID = false, Site $site = null)

Duplicate all the child pages of a specific page which has already have been duplicated.

string

computeCanonicalPagePath()

Get the canonical path string of this page .

_associateMasterCollectionBlocks(int $newCID, mixed $masterCID, bool $cAcquireComposerOutputControls)

Duplicate the master collection blocks/permissions to a newly created page.

_associateMasterCollectionAttributes(int $newCID, mixed $masterCID)

Duplicate the master collection attributes to a newly created page.

acquireAreaStylesFromDefaults(Template $template)

Copy the area styles from a page template.

static string[]

translatePermissionsXMLToKeys(SimpleXMLElement $node)

No description

Details

Parameters

int	$cID	The collection ID
string\|int\|false	$version	the collection version ('RECENT' for the most recent version, 'ACTIVE' for the currently published version, 'SCHEDULED' for the currently scheduled version, a falsy value to not load the collection version, or an integer to retrieve a specific version ID)

Return Value

Collection

If the collection is not found, you'll get an empty Collection instance

in Collection at line 123
`static Collection|null getByHandle(string $handle)`

Get a Collection by handle (provided that it's not a Page handle).

If there's there's no collection with the specified handle, a new Collection will be created.

Parameters

string

$handle

the collection handle

Return Value

Collection|null

return NULL if $handle is the handle of an existing page

in Collection at line 157
`static int reindexPendingPages()`

(Re)Index all the collections that are marked as to be (re)indexed.

Return Value

int	returns the number of reindexed pages

in Collection at line 193
`static Collection createCollection(array $data)`

Create a new Collection instance.

Parameters

array

$data

{

@var int|null $cID The ID of the collection to create (if unspecified or NULL: database autoincrement value)
@var string $handle The collection handle (default: NULL)
@var string $name The collection name (default: empty string)
@var string $cDescription The collection description (default: NULL)
@var string $cDatePublic The collection publish date/time in format 'YYYY-MM-DD hh:mm:ss' (default: now)
@var bool $cvIsApproved Is the collection version approved (default: true)
@var bool $cvIsNew Is the collection to be considered "new"? (default: true if $cvIsApproved is false, false if $cvIsApproved is true)
@var int|null $pThemeID The collection theme ID (default: NULL)
@var int|null $pTemplateID The collection template ID (default: NULL)
@var int|null $uID The ID of the collection author (default: NULL)

string

Example: 'Version 2'

in Collection at line 413
`bool|null reindex(IndexedSearch|false $index = false, bool $actuallyDoReindex = true)`

(Re)Index the contents of this collection (or mark the collection as to be reindexed if $actuallyDoReindex is falsy and the concrete.page.search.always_reindex configuration key is falsy).

Parameters

IndexedSearch\|false	$index	the IndexedSearch instance that indexes the collection content (if falsy: we'll create a new instance of it)
bool	$actuallyDoReindex	Set to true to always reindex the collection immediately (otherwise we'll look at the concrete.page.search.always_reindex configuration key)

Return Value

bool|null

Return false if the collection can't be indexed, NULL otherwise

in Collection at line 471
`PageValue setAttribute(string|CollectionKey $ak, AbstractValue|mixed $value, bool $doReindexImmediately = true)`

Set the attribute value for the currently loaded collection version.

Parameters

string\|CollectionKey	$ak	the attribute key (or its handle)
AbstractValue\|mixed	$value	an attribute value object, or the data needed by the attribute controller to create the attribute value object
bool	$doReindexImmediately

Return Value

PageValue

in Collection at line 496
`mixed|null getAttribute(string|CollectionKey $akHandle, string|false $displayMode = false)`

Return the value of the attribute with the handle $akHandle of the currently loaded version (if it's loaded).

Parameters

string\|CollectionKey	$akHandle	the attribute key (or its handle)
string\|false	$displayMode	makes The format of the attribute value

Return Value

mixed|null

Examples

When you need the raw attribute value or object, use this:
<code>
$c = Page::getCurrentPage();
$attributeValue = $c->getAttribute('attribute_handle');
</code>

If you need the formatted output supported by some attribute, use this:
<code>
$c = Page::getCurrentPage();
$attributeValue = $c->getAttribute('attribute_handle', 'display');
</code>

An attribute type like "date" will then return the date in the correct format just like other attributes will show you a nicely formatted output and not just a simple value or object.

in Collection at line 511
`PageValue|null getAttributeValueObject(string|CollectionKey $akHandle, bool $createIfNotExists = false)`

Return the attribute value object with the handle $akHandle of the currently loaded version (if it's loaded).

Parameters

string\|CollectionKey	$akHandle	the attribute key (or its handle)
bool	$createIfNotExists

Return Value

PageValue|null

in Collection at line 523
`clearCollectionAttributes(int[] $retainAKIDs = [])`

Delete the values of the attributes associated to the currently loaded collection version.

Parameters

int[]

$retainAKIDs

a list of attribute key IDs to keep (their values won't be deleted)

in Collection at line 550
`clearAttribute(string|CollectionKey $ak, bool $doReindexImmediately = true)`

Delete the value of a specific attribute key associated to the currently loaded collection version.

Parameters

string\|CollectionKey	$ak	the attribute key (or its handle)
bool	$doReindexImmediately

Parameters

Area	$area	the area for which you want the custom styles
bool	$force	Set to true to retrieve a CustomStyle even if the area does not define any custom style

Return Value

CustomStyle|null

return NULL if the area does not have any custom style and $force is false, a CustomStyle instance otherwise

in Collection at line 649
`setCustomStyleSet(Area $area, StyleSet $set)`

Set the custom style of an area in the currently loaded collection version.

Parameters

Area	$area
StyleSet	$set

in Collection at line 670
`resetAreaCustomStyle(Area $area)`

Delete all the custom styles of an area of the currently loaded collection version.

Parameters

Area

$area

in Collection at line 690
`string|null outputCustomStyleHeaderItems(bool $return = false)`

Retrieve all custom style rules that should be inserted into the header on a page, whether they are defined in areas or blocks.

Parameters

bool

$return

set to true to return the HTML that defines the styles, false to add it to the current View instance

Return Value

string|null

in Collection at line 811
`null|false relateVersionEdits(Collection $oc)`

Associate the edits of another collection to this collection.

Parameters

Collection

$oc

the collection that has been modified

Return Value

null|false

return false if the other collection is already associated to this collection, NULL otherwise

Examples

If a global area is modified inside this collection, you need to call $page->relateVersionEdits($globalArea)

Return Value

array

Return a list of arrays, each one is a dictionary like ['bID' => , 'arHandle' => ]

at line 2619
`Block addBlock(BlockType $bt, string|Area $a, array $data)`

Add a new block to a specific area of the page.

Parameters

BlockType	$bt	the type of block to be added
string\|Area	$a	the area instance (or its handle) to which the block should be added to
array	$data	The data of the block. This data depends on the specific block type. Common values are: 'uID' to specify the ID of the author (if not specified: we'll use the current user), 'bName' to specify the block name.

Return Value

Block

in Collection at line 1036
`int getCollectionAreaDisplayOrder(string $arHandle, bool $ignoreVersions = false)`

Get the next value of the display order (to be used when adding new blocks to an area).

Parameters

string	$arHandle	The handle of the area
bool	$ignoreVersions	Set to true to ignore the collection version

Return Value

int

in Collection at line 1072
`rescanDisplayOrder(string $arHandle)`

Fix the display order properties for all the blocks within the collection/area.

Parameters

string

$arHandle

the handle of the area to be processed

in Collection at line 1100
`addFeature(Feature $fe)`

Associate a feature to the currently loaded collection version.

Parameters

Feature

Page

in Collection at line 1217
`PageValue|null getAttributeValue(string|CollectionKey $ak) deprecated`

deprecated Use of getAttributeValueObject()

No description

Parameters

string|CollectionKey

$ak

Return Value

PageValue|null

in Collection at line 1229
`mixed|null getCollectionAttributeValue(string|CollectionKey $akHandle) deprecated`

deprecated use the getAttribute() method

No description

Parameters

string|CollectionKey

$akHandle

Return Value

mixed|null

at line 1435
`getCollectionTypeID() deprecated`

deprecated use the getPageTypeID() method

No description

in AssignableObjectTrait at line 14
`assignPermissions($userOrGroup, $permissions = [], $accessType = Key::ACCESS_TYPE_INCLUDE, $cascadeToChildren = true)`

No description

Parameters

	$userOrGroup
	$permissions
	$accessType
	$cascadeToChildren

at line 143
`__construct()`

Initialize collection until we populate it.

at line 162
`static Page getByPath(string $path, string $version = 'RECENT', TreeInterface $tree = null)`

Get a page given its path.

Parameters

string	$path	the page path (example: /path/to/page)
string	$version	the page version ('RECENT' for the most recent version, 'ACTIVE' for the currently published version, 'SCHEDULED' for the currently scheduled version, or an integer to retrieve a specific version ID)
TreeInterface	$tree

No description

Return Value

false

at line 410
`forceCheckIn()`

at line 703
`static Page getDraftsParentPage(Site $site = null)`

Get the drafts parent page for a specific site.

Parameters

Site

$site

If not specified, we'll use the default site

Return Value

Page

at line 719
`static Page[] getDrafts(Site $site)`

Get the list of draft pages in a specific site.

Parameters

Site

$site

Return Value

Page[]

at line 740
`bool isPageDraft()`

Is this a draft page?

Return Value

bool

at line 754
`setController(PageController|null $controller)`

Set the page controller.

Parameters

PageController|null

$controller

at line 764
`PageController getController() deprecated`

deprecated use the getPageController() method

No description

Return Value

PageController

at line 776
`private assignPermissionSet(SimpleXMLElement $px)`

This is the legacy function that is called just by xml. We pass these values in as though they were the old ones.

Parameters

SimpleXMLElement

$px

at line 812
`int addCollectionAlias(mixed $c)`

Make an alias to a page.

Parameters

mixed

Return Value

int	The ID of the new collection

at line 868
`updateCollectionAliasExternal(string $cName, string $cLink, bool $newWindow = 0)`

Update the name, link, and to open in a new window for an external link.

Parameters

string	$cName
string	$cLink
bool	$newWindow

at line 892
`int addCollectionAliasExternal(string $cName, string $cLink, bool $newWindow = 0)`

Add a new external link as a child of this page.

Parameters

string	$cName
string	$cLink
bool	$newWindow

Return Value

int	The ID of the new collection

Parameters

array	$pages	the previously loaded data
array	$pageRow	The data of current parent page (it must contain cID and optionally cDisplayOrder)
int	$cParentID	The parent page ID
int	$level	The current depth level
bool	$includeThisPage	Should $pageRow itself be added to the resulting array?

Return Value

array

Every array item contains the following keys: {

@var int $cID @var int $cDisplayOrder @var int $cParentID @var int $level @var int $total }

at line 1080
`int queueForDeletionSort(array $a, array $b)`

Sort a list of pages, so that the order is correct for the deletion.

Parameters

array	$a
array	$b

Return Value

int

at line 1100
`int queueForDuplicationSort(array $a, array $b)`

Sort a list of pages, so that the order is correct for the duplication.

Parameters

array	$a
array	$b

Return Value

int

at line 1127
`queueForDeletion()`

Add this page and its subpages to the Delete Page queue.

at line 1151
`queueForDeletionRequest(Queue|null $queue = null, bool $includeThisPage = true)`

Add this page and its subpages to the Delete Page Requests queue (or to a custom queue).

Parameters

Queue\|null	$queue	the custom queue to add the pages to
bool	$includeThisPage	Include this page itself in the page to be added to the queue?

at line 1172
`queueForDuplication(Page $destination, bool $includeParent = true)`

Add this page and its subpages to the Copy Page queue.

Parameters

Page	$destination	the destination parent page where the pages will be copied to
bool	$includeParent	Include this page itself in the page to be added to the queue?

at line 1193
`export(SimpleXMLElement $pageNode) deprecated`

deprecated use the \Concrete\Core\Page\Exporter class

No description

Parameters

SimpleXMLElement

Returns the path for a page from its cID.

Parameters

mixed

$cID

at line 1392
`int|null getCollectionUserID()`

Get the uID of the page author (if any).

Return Value

int|null

at line 1412
`string|null getCollectionTypeName() deprecated`

deprecated use the getPageTypeName() method

Get the parent cID of a page given its cID.

Parameters

$pl

at line 1837
`setPageType(Type $type = null)`

Set the theme for a page using the page object.

Parameters

Type

Collection

$cobj

Return Value

bool

at line 2075
`updateCollectionName(string $name)`

Update the collection name.

Parameters

string

array

$data

Recognized keys are {

@var string $cHandle
@var string $cName
@var string $cDescription
@var string $cDatePublic
@var int $ptID
@var int $pTemplateID
@var int $uID
@var string $$cFilename
@var int $cCacheFullPageContent -1: use the default settings; 0: no; 1: yes
@var int $cCacheFullPageContentLifetimeCustom
@var string $cCacheFullPageContentOverrideLifetime

}

at line 2409
`clearPagePermissions()`

Clear all the page permissions.

at line 2419
`inheritPermissionsFromParent()`

Set this page permissions to be inherited from its parent page.

at line 2436
`inheritPermissionsFromDefaults()`

Set this page permissions to be inherited from its parent type defaults.

at line 2459
`setPermissionsToManualOverride()`

Set this page permissions to be manually specified.

at line 2480
`rescanAreaPermissions()`

Rescan the page areas ensuring that they are inheriting permissions properly.

at line 2495
`setOverrideTemplatePermissions(bool|int $cOverrideTemplatePermissions)`

Are template permissions overriden?

Parameters

bool|int

$cOverrideTemplatePermissions

at line 2511
`updatePermissionsCollectionID(int|string $cParentIDString, mixed $npID)`

Set the child pages of a list of parent pages to inherit permissions from the specified page (provided that they previouly had the same inheritance page as this page).

Parameters

int\|string	$cParentIDString	A comma-separeted list of parent page IDs
mixed	$npID

at line 2535
`acquireAreaPermissions(int $permissionsCollectionID)`

Acquire the area permissions, copying them from the inherited ones.

Parameters

int

$permissionsCollectionID

the ID of the collection from which the page previously inherited permissions from

at line 2569
`acquirePagePermissions(int $permissionsCollectionID)`

Acquire the page permissions, copying them from the inherited ones.

Parameters

int

$permissionsCollectionID

the ID of the collection from which the page previously inherited permissions from

at line 2591
`updateGroupsSubCollection(int|string $cParentIDString) deprecated`

deprecated is this function still useful? There's no reference to it in the core

No description

Parameters

int|string

$cParentIDString

at line 2667
`SiblingRelation[] getPageRelations()`

Get the relations of this page.

Return Value

SiblingRelation[]

at line 2691
`move(mixed $nc)`

Move this page under a new parent page.

Parameters

mixed

$nc

at line 2782
`Page duplicateAll(null|mixed $nc = null, bool $preserveUserID = false, Site $site = null)`

Duplicate this page and all its child pages and return the new Page created.

Parameters

null\|mixed	$nc
bool	$preserveUserID	Set to true to preserve the original page author IDs
Site	$site	the destination site (used if $toParentPage is NULL)

Return Value

Page

at line 2800
`Page duplicate(null|mixed $nc = null, bool $preserveUserID = false, TreeInterface $site = null)`

Duplicate this page and return the new Page created.

Parameters

null\|mixed	$nc
bool	$preserveUserID	Set to true to preserve the original page author IDs
TreeInterface	$site	the destination site (used if $toParentPage is NULL)

Return Value

Page

at line 2900
`moveToTrash()`

Move this page and all its child pages to the trash.

at line 2937
`rescanChildrenDisplayOrder()`

Regenerate the display order of the child pages.

at line 2958
`bool isHomePage()`

Is this the homepage for the site tree this page belongs to?

Return Value

bool

at line 2968
`int|null getSiteHomePageID()`

Get the ID of the homepage for the site tree this page belongs to.

Return Value

int|null

Returns NULL if there's no default locale

at line 2978
`bool isLocaleHomePage() deprecated`

deprecated use the isHomePage() method

No description

Return Value

bool

at line 2990
`static int|null getHomePageID(Page|int $page = null)`

Get the ID of the home page.

Parameters

Page|int

$page

the page (or its ID) for which you want the home (if not specified, we'll use the default locale site tree)

Return Value

Parameters

int	$displayOrder
int\|null	$cID	The page ID to set the display order for (if empty, we'll use this page)

at line 3182
`movePageDisplayOrderToTop()`

Make this page the first child of its parent.

at line 3201
`movePageDisplayOrderToBottom()`

Make this page the first child of its parent.

at line 3218
`movePageDisplayOrderToSibling(Page $c, string $position = 'before')`

Move this page before of after another page.

Parameters

Page	$c
string	$position	'before' or 'after'

at line 3248
`rescanSystemPageStatus()`

Recalculate the "is a system page" state.

Looks at the current page. If the site tree ID is 0, sets system page to true. If the site tree is not user, looks at where the page falls in the hierarchy. If it's inside a page at the top level that has 0 as its parent, then it is considered a system page.

at line 3288
`bool isInTrash()`

Is this page in the trash?

Return Value

bool

at line 3296
`moveToRoot()`

Make this page child of nothing, thus moving it to the root level.

at line 3307
`deactivate()`

Mark this page as non active.

at line 3316
`setPageToDraft()`

Mark this page as non draft.

at line 3326
`activate()`

Mark this page as active.

at line 3337
`bool isActive()`

Is this page marked as active?

Return Value

bool

at line 3347
`setPageIndexScore(float $score)`

Set the page index score (used by a PageList for instance).

Parameters

float

$score

at line 3357
`float getPageIndexScore()`

Get the page index score (as set by a PageList for instance).

Return Value

float

at line 3367
`string getPageIndexContent()`

Get the indexed content of this page.

Return Value

string

at line 3381
`static Page addHomePage(TreeInterface $siteTree = null)`

Add the home page to the system. Typically used only by the installation program.

Parameters

TreeInterface

$siteTree

Return Value

Page

at line 3444
`Page add(mixed $pt, array $data, mixed $template = false)`

Add a new page, child of this page.

Parameters

mixed $pt

array

$data

Supported keys: {

@var int|null $uID The ID of the page author (if unspecified or NULL: current user)
@var int|null $pkgID the ID of the package that creates this page
@var string $cName The page name
@var string $name (used if cName is not specified)
@var int|null $cID The ID of the page to create (if unspecified or NULL: database autoincrement value)
@var int|bool $cIsActive Is the page to be considered as active?
@var int|bool $cIsDraft Is the page to be considered as draft?
@var string $cHandle The page handle
@var string $cDescription The page description (default: NULL)
@var string $cDatePublic The page publish date/time in format 'YYYY-MM-DD hh:mm:ss' (default: now)
@var bool $cvIsApproved Is the page version approved (default: true)
@var bool $cvIsNew Is the page to be considered "new"? (default: true if $cvIsApproved is false, false if $cvIsApproved is true)
@var bool $cAcquireComposerOutputControls

}

Return Value

string|null

at line 3638
`int|null getCollectionFullPageCachingLifetimeCustomValue()`

Get the full-page cache custom lifetime in minutes (to be used if getCollectionFullPageCachingLifetime() is 'custom').

Return Value

int|null

at line 3787
`protected populatePage(mixed $cInfo, string $where, string|int $cvID)`

Read the data from the database.

Parameters

mixed	$cInfo	The argument of the $where condition
string	$where	The SQL 'WHERE' part
string\|int	$cvID

at line 3833
`protected _getNumChildren(int $cID, bool $oneLevelOnly = 0, string $sortColumn = 'cDisplayOrder asc')`

Populate the childrenCIDArray property (called by the getCollectionChildrenArray() method).

Parameters

int	$cID
bool	$oneLevelOnly
string	$sortColumn

at line 3860
`protected _duplicateAll(mixed $cParent, mixed $cNewParent, bool $preserveUserID = false, Site $site = null)`

Duplicate all the child pages of a specific page which has already have been duplicated.

Parameters

mixed	$cParent
mixed	$cNewParent
bool	$preserveUserID	Set to true to preserve the original page author IDs
Site	$site	the destination site

at line 3886
`protected string computeCanonicalPagePath()`

Get the canonical path string of this page .

This happens before any uniqueness checks get run.

Return Value

string

at line 3921
`protected _associateMasterCollectionBlocks(int $newCID, mixed $masterCID, bool $cAcquireComposerOutputControls)`

Duplicate the master collection blocks/permissions to a newly created page.

Parameters

int	$newCID	the ID of the newly created page
mixed	$masterCID
bool	$cAcquireComposerOutputControls

at line 3963
`protected _associateMasterCollectionAttributes(int $newCID, mixed $masterCID)`

Duplicate the master collection attributes to a newly created page.

Parameters

int	$newCID	the ID of the newly created page
mixed	$masterCID

at line 3983
`protected acquireAreaStylesFromDefaults(Template $template)`

Copy the area styles from a page template.

Parameters

Template

$template

at line 4015
`static private string[] translatePermissionsXMLToKeys(SimpleXMLElement $node)`

No description

Parameters

SimpleXMLElement

$node

Return Value

string[]

Page

Traits

Properties

Methods

Details

in ConcreteObject at line 10 loadError($error)

Parameters

in ConcreteObject at line 15 isError()

in ConcreteObject at line 25 getError()

in ConcreteObject at line 30 setPropertiesFromArray($arr)

Parameters

in ConcreteObject at line 37 static camelcase($file)

Parameters

in ConcreteObject at line 42 static uncamelcase($string)

Parameters

at line 148 __destruct()

at line 210 static Collection getByID(int $cID, string|int|false $version = 'RECENT')

Parameters

Return Value

in Collection at line 123 static Collection|null getByHandle(string $handle)

Parameters

Return Value

in Collection at line 157 static int reindexPendingPages()

Return Value

in Collection at line 193 static Collection createCollection(array $data)

Parameters

Return Value

in Collection at line 278 int|null getCollectionID()

Return Value

at line 1402 string|null getCollectionHandle()

Return Value

in Collection at line 300 string|null getCollectionDateLastModified()

Return Value

Examples

in Collection at line 312 string|null getCollectionDateAdded()

Return Value

Examples

in Collection at line 322 int getVersionID()

Return Value

in Collection at line 332 Version|null getVersionObject()

Return Value

in Collection at line 355 Collection addCollection(array $data)

Parameters

Return Value

in Collection at line 370 loadVersionObject(string|int $cvID = 'ACTIVE')

Parameters

in Collection at line 380 $this|Page getVersionToModify()

Return Value

in Collection at line 397 string getNextVersionComments()

Return Value

in Collection at line 413 bool|null reindex(IndexedSearch|false $index = false, bool $actuallyDoReindex = true)

Parameters

Return Value

in Collection at line 471 PageValue setAttribute(string|CollectionKey $ak, AbstractValue|mixed $value, bool $doReindexImmediately = true)

Parameters

Return Value

in Collection at line 496 mixed|null getAttribute(string|CollectionKey $akHandle, string|false $displayMode = false)

Parameters

Return Value

Examples

in Collection at line 511 PageValue|null getAttributeValueObject(string|CollectionKey $akHandle, bool $createIfNotExists = false)

Parameters

Return Value

in Collection at line 523 clearCollectionAttributes(int[] $retainAKIDs = [])

Parameters

in Collection at line 550 clearAttribute(string|CollectionKey $ak, bool $doReindexImmediately = true)

Parameters

in Collection at line 560 PageKey[] getSetCollectionAttributes()

Return Value

in Collection at line 579 Area|null getArea(string $arHandle)

Parameters

Return Value

in Collection at line 589 bool hasAliasedContent()

Return Value

in Collection at line 624 CustomStyle|null getAreaCustomStyle(Area $area, bool $force = false)

Parameters

Return Value

in Collection at line 649 setCustomStyleSet(Area $area, StyleSet $set)

Parameters

in Collection at line 670 resetAreaCustomStyle(Area $area)

in ConcreteObject at line 10
`loadError($error)`

in ConcreteObject at line 15
`isError()`

in ConcreteObject at line 25
`getError()`

in ConcreteObject at line 30
`setPropertiesFromArray($arr)`

in ConcreteObject at line 37
`static camelcase($file)`

in ConcreteObject at line 42
`static uncamelcase($string)`

at line 148
`__destruct()`

at line 210
`static Collection getByID(int $cID, string|int|false $version = 'RECENT')`

in Collection at line 123
`static Collection|null getByHandle(string $handle)`

in Collection at line 157
`static int reindexPendingPages()`

in Collection at line 193
`static Collection createCollection(array $data)`

in Collection at line 278
`int|null getCollectionID()`

at line 1402
`string|null getCollectionHandle()`

in Collection at line 300
`string|null getCollectionDateLastModified()`

in Collection at line 312
`string|null getCollectionDateAdded()`

in Collection at line 322
`int getVersionID()`

in Collection at line 332
`Version|null getVersionObject()`

in Collection at line 355
`Collection addCollection(array $data)`

in Collection at line 370
`loadVersionObject(string|int $cvID = 'ACTIVE')`

in Collection at line 380
`$this|Page getVersionToModify()`

in Collection at line 397
`string getNextVersionComments()`

in Collection at line 413
`bool|null reindex(IndexedSearch|false $index = false, bool $actuallyDoReindex = true)`

in Collection at line 471
`PageValue setAttribute(string|CollectionKey $ak, AbstractValue|mixed $value, bool $doReindexImmediately = true)`

in Collection at line 496
`mixed|null getAttribute(string|CollectionKey $akHandle, string|false $displayMode = false)`

in Collection at line 511
`PageValue|null getAttributeValueObject(string|CollectionKey $akHandle, bool $createIfNotExists = false)`

in Collection at line 523
`clearCollectionAttributes(int[] $retainAKIDs = [])`

in Collection at line 550
`clearAttribute(string|CollectionKey $ak, bool $doReindexImmediately = true)`

in Collection at line 560
`PageKey[] getSetCollectionAttributes()`

in Collection at line 579
`Area|null getArea(string $arHandle)`

in Collection at line 589
`bool hasAliasedContent()`

in Collection at line 624
`CustomStyle|null getAreaCustomStyle(Area $area, bool $force = false)`

in Collection at line 649
`setCustomStyleSet(Area $area, StyleSet $set)`

in Collection at line 670
`resetAreaCustomStyle(Area $area)`

in Collection at line 690
`string|null outputCustomStyleHeaderItems(bool $return = false)`

in Collection at line 811
`null|false relateVersionEdits(Collection $oc)`

at line 1445
`int|false getPageTypeID()`

in Collection at line 847
`refreshCache()`

in Collection at line 857
`Block[] getGlobalBlocks()`

in Collection at line 888
`Block[] getBlocks(string|false $arHandle = false)`

in Collection at line 912
`array getBlockIDs(string|false $arHandle = false)`

at line 2619
`Block addBlock(BlockType $bt, string|Area $a, array $data)`

in Collection at line 1036
`int getCollectionAreaDisplayOrder(string $arHandle, bool $ignoreVersions = false)`

in Collection at line 1072
`rescanDisplayOrder(string $arHandle)`

in Collection at line 1100
`addFeature(Feature $fe)`

in Collection at line 1116
`CollectionVersionAssignment[] getFeatureAssignments()`

in Collection at line 1128
`markModified()`

at line 2816
`delete()`

in Collection at line 1179
`Collection duplicateCollection()`

in Collection at line 1197
`Page cloneVersion(string|null $versionComments, bool $createEmpty = false)`

in Collection at line 1217
`PageValue|null getAttributeValue(string|CollectionKey $ak) deprecated`

in Collection at line 1229
`mixed|null getCollectionAttributeValue(string|CollectionKey $akHandle) deprecated`

at line 1435
`getCollectionTypeID() deprecated`

in AssignableObjectTrait at line 14
`assignPermissions($userOrGroup, $permissions = [], $accessType = Key::ACCESS_TYPE_INCLUDE, $cascadeToChildren = true)`

at line 143
`__construct()`

at line 162
`static Page getByPath(string $path, string $version = 'RECENT', TreeInterface $tree = null)`

at line 195
`CategoryInterface getObjectAttributeCategory()`

at line 239
`ItemInterface getExporter()`

at line 249
`getPermissionResponseClassName()`

at line 259
`getPermissionAssignmentClassName()`

at line 269
`getPermissionObjectKeyCategoryHandle()`

at line 279
`stdClass getJSONObject()`

at line 302
`PageController getPageController()`

at line 343
`getPermissionObjectIdentifier()`

at line 361
`bool isEditMode()`