class PageList extends PageList (View source)

Constants

PAGE_VERSION_ACTIVE

PAGE_VERSION_RECENT

PAGE_VERSION_RECENT_UNAPPROVED

PAGE_VERSION_SCHEDULED

SITE_TREE_CURRENT

SITE_TREE_ALL

Properties

protected $sortColumnParameter from  ItemList
protected $sortDirectionParameter from  ItemList
protected $paginationPageParameter from  ItemList
protected $sortBy from  ItemList
protected $sortByDirection from  ItemList
protected $sortBySearchColumn from  ItemList
protected bool $enableAutomaticSorting

Determines whether the list should automatically always sort by a column that's in the automatic sort.

from  PageList
protected array $autoSortColumns

Columns in this array can be sorted via the request.

from  PageList
protected $itemsPerPage from  ItemList
protected $debug from  ItemList
protected Pagination $pagination from  ItemList
protected QueryBuilder $query from  ItemList
protected StickyRequest $searchRequest from  ItemList
protected Closure $permissionsChecker from  PageList
protected Tree $siteTree from  PageList
protected int $pageVersionToRetrieve

Which version to attempt to retrieve.

from  PageList
protected $isFulltextSearch

Whether this is a search using fulltext.

from  PageList
protected bool $includeSystemPages

Whether to include system pages in this query. NOTE: There really isn't a reason to set this to true unless you're doing something pretty custom or deep in the core.

from  PageList
protected $includeAliases
protected bool $includeInactivePages

Whether to include inactive (deleted) pages in the query.

from  PageList

Methods

executeSortBy($column, $direction = 'asc')

No description

from  ItemList
executeSanitizedSortBy($column, $direction = 'asc')

No description

from  ItemList
executeGetResults()

No description

from  ItemList
getResult($queryRow)

No description

from  PageList
debugStart()

No description

from  ItemList
debugStop()

No description

from  ItemList
array
getAutoSortColumns()

No description

from  ItemList
debug()

No description

from  ItemList
isDebugged()

No description

from  ItemList
sortBy($field, $direction = 'asc')

No description

from  ItemList
sortBySearchColumn(Column $column, $direction = null)

No description

from  ItemList
getSearchByColumn()

No description

from  ItemList
sanitizedSortBy($field, $direction = 'asc')

No description

from  ItemList
getResults()

Returns a full array of results.

from  ItemList
getActiveSortColumn()

No description

from  ItemList
isActiveSortColumn($field)

No description

from  ItemList
disableAutomaticSorting()

No description

from  ItemList
getSortClassName($column)

No description

from  ItemList
getSortURL($column, $dir = 'asc', $url = false)

No description

from  ItemList
getActiveSortDirection()

No description

from  ItemList
getQuerySortColumnParameter()

No description

from  ItemList
loadQueryStringPagingVariable()

Get paging parameter from Concrete configuration

from  ItemList
from  ItemList
setItemsPerPage($itemsPerPage)

No description

from  ItemList
int
getItemsPerPage()

No description

from  ItemList
int
getTotalResults()

Returns the total results in this item list.

from  PageList
getPagination() deprecated

Deprecated – call the pagination factory directly.

from  ItemList
performAutomaticSorting(StickyRequest $request = null)

No description

from  ItemList
setupAutomaticSorting(StickyRequest $request = null)

No description

get() deprecated

No description

from  ItemList
setNameSpace(mixed $nameSpace)

Allow to modify the auto-pagination parameters and the auto-sorting parameters

from  ItemList
createQuery()

No description

from  PageList
QueryBuilder
finalizeQuery(QueryBuilder $query)

No description

__construct(StickyRequest $req = null)

No description

from  PageList
getSearchRequest()

No description

from  ItemList
getQueryObject()

No description

from  ItemList
deliverQueryObject()

No description

from  ItemList
filter($field, $value, $comparison = '=') deprecated

No description

from  ItemList
ensureSelected($field)

No description

from  ItemList
__clone()

No description

from  ItemList
__call($nm, $a)

Magic method for setting up additional filtering by attributes.

filterByAttribute(mixed $handle, mixed $value, mixed $comparison = '=')

Filters by an attribute.

getAttributeKeyClassName()

No description

from  PageList
getPermissionsChecker()

No description

from  PageList
setSiteTreeObject(TreeInterface $tree)

No description

from  PageList
setSiteTreeToAll()

No description

from  PageList
setSiteTreeToCurrent()

No description

from  PageList
includeSystemPages()

No description

from  PageList
setPermissionsChecker(Closure $checker = null)

No description

from  PageList
ignorePermissions()

No description

from  PageList
enablePermissions()

No description

from  PageList
includeAliases()

No description

from  PageList
includeInactivePages()

No description

from  PageList
isFulltextSearch()

No description

from  PageList
setPageVersionToRetrieve($pageVersionToRetrieve)

No description

from  PageList
filterBySite(Site $site)

No description

from  PageList
mixed
getPaginationAdapter()

Returns the standard pagination adapter. This is used for non-permissioned objects and is typically something like DoctrineDbalAdapter

from  PageList
checkPermissions($mixed)

No description

from  PageList
filterByPageTypeHandle(mixed $ptHandle)

Filters by type of collection (using the handle field).

from  PageList
filterByPageTemplate(Template $template)

Filters by page template.

from  PageList
filterByDateAdded(string $date, mixed $comparison = '=')

Filters by date added.

from  PageList
filterByNumberOfChildren($number, string $comparison = '>')

Filter by number of children.

from  PageList
filterByDateLastModified($date, string $comparison = '=')

Filter by last modified date.

from  PageList
filterByPublicDate(string $date, mixed $comparison = '=')

Filters by public date.

from  PageList
filterByPackage(Package $package)

Filters by package.

from  PageList
filterByPagesWithCustomStyles()

Displays only those pages that have style customizations.

from  PageList
filterByUserID(mixed $uID)

Filters by user ID).

from  PageList
filterByPageTypeID($ptID)

Filters by page type ID.

from  PageList
filterByParentID($cParentID)

Filters by parent ID.

from  PageList
filterByName($name, bool $exact = false)

Filters a list by page name.

from  PageList
filterByPath($path, bool $includeAllChildren = true)

Filter a list by page path.

from  PageList
filterByKeywords($keywords)

Filters keyword fields by keywords (including name, description, content, and attributes.

from  PageList
filterByFulltextKeywords($keywords)

No description

from  PageList
filterByTopic(mixed $topic)

Filters by topic. Doesn't look at specific attributes –instead, actually joins to the topics table.

from  PageList
filterByBlockType(BlockType $bt)

Filters a page list by a particular block type occurring in the version of a page.

from  PageList
filterByContainer(Container $container)

Filters a page list by a particular container occurring in a page

from  PageList
filterByCacheSettings($value)

No description

from  PageList
sortByDisplayOrder()

Sorts this list by display order.

from  PageList
sortByDisplayOrderDescending()

Sorts this list by display order descending.

from  PageList
sortByDateModified()

Sorts this list by date modified ascending.

from  PageList
sortByDateModifiedDescending()

Sorts this list by date modified descending.

from  PageList
sortByCollectionIDAscending()

Sorts by ID in ascending order.

from  PageList
sortByPublicDate()

Sorts this list by public date ascending order.

from  PageList
sortByName()

Sorts by name in ascending order.

from  PageList
sortByNameDescending()

Sorts by name in descending order.

from  PageList
sortByPublicDateDescending()

Sorts this list by public date descending order.

from  PageList
sortByRelevance()

Sorts by fulltext relevance (requires that the query be fulltext-based.

from  PageList
filterByCollectionTypeHandle(mixed $ctHandle) deprecated

No description

from  PageList
filterByCollectionTypeID(mixed $ctID) deprecated

No description

from  PageList
ignoreAliases() deprecated

This does nothing.

from  PageList
displayUnapprovedPages() deprecated

No description

from  PageList
selectDistinct()

No description

from  PageList
filterByMissingTargets($targets)

No description

Details

protected executeSortBy($column, $direction = 'asc')

No description

Parameters

$column
$direction

protected executeSanitizedSortBy($column, $direction = 'asc')

No description

Parameters

$column
$direction

executeGetResults()

No description

getResult($queryRow)

No description

Parameters

$queryRow

debugStart()

No description

debugStop()

No description

array getAutoSortColumns()

No description

Return Value

array

debug()

No description

isDebugged()

No description

sortBy($field, $direction = 'asc')

No description

Parameters

$field
$direction

sortBySearchColumn(Column $column, $direction = null)

No description

Parameters

Column $column
$direction

getSearchByColumn()

No description

sanitizedSortBy($field, $direction = 'asc')

No description

Parameters

$field
$direction

getResults()

Returns a full array of results.

getActiveSortColumn()

No description

isActiveSortColumn($field)

No description

Parameters

$field

disableAutomaticSorting()

No description

getSortClassName($column)

No description

Parameters

$column

getSortURL($column, $dir = 'asc', $url = false)

No description

Parameters

$column
$dir
$url

getActiveSortDirection()

No description

getQuerySortColumnParameter()

No description

getQueryPaginationPageParameter()

No description

protected loadQueryStringPagingVariable()

Get paging parameter from Concrete configuration

getQuerySortDirectionParameter()

No description

setItemsPerPage($itemsPerPage)

No description

Parameters

$itemsPerPage

int getItemsPerPage()

No description

Return Value

int

int getTotalResults()

Returns the total results in this item list.

Return Value

int

Pagination getPagination() deprecated

deprecated

Deprecated – call the pagination factory directly.

Return Value

Pagination

performAutomaticSorting(StickyRequest $request = null)

No description

Parameters

StickyRequest $request

setupAutomaticSorting(StickyRequest $request = null)

No description

Parameters

StickyRequest $request

get() deprecated

deprecated

No description

setNameSpace(mixed $nameSpace)

Allow to modify the auto-pagination parameters and the auto-sorting parameters

Parameters

mixed $nameSpace

Content that will be added to the parameters

createQuery()

No description

QueryBuilder finalizeQuery(QueryBuilder $query)

No description

Parameters

QueryBuilder $query

Return Value

QueryBuilder

__construct(StickyRequest $req = null)

No description

Parameters

StickyRequest $req

StickyRequest|null getSearchRequest()

No description

Return Value

StickyRequest|null

getQueryObject()

No description

deliverQueryObject()

No description

filter($field, $value, $comparison = '=') deprecated

deprecated

No description

Parameters

$field
$value
$comparison

protected ensureSelected($field)

No description

Parameters

$field

__clone()

No description

__call($nm, $a)

Magic method for setting up additional filtering by attributes.

Parameters

$nm
$a

Exceptions

Exception

filterByAttribute(mixed $handle, mixed $value, mixed $comparison = '=')

Filters by an attribute.

Parameters

mixed $handle
mixed $value
mixed $comparison

Exceptions

InvalidAttributeException

protected getAttributeKeyClassName()

No description

PagerManagerInterface getPagerManager()

No description

Return Value

PagerManagerInterface

getPermissionsChecker()

No description

VariableFactory getPagerVariableFactory()

No description

Return Value

VariableFactory

setSiteTreeObject(TreeInterface $tree)

No description

Parameters

TreeInterface $tree

setSiteTreeToAll()

No description

setSiteTreeToCurrent()

No description

includeSystemPages()

No description

setPermissionsChecker(Closure $checker = null)

No description

Parameters

Closure $checker

ignorePermissions()

No description

enablePermissions()

No description

includeAliases()

No description

includeInactivePages()

No description

isFulltextSearch()

No description

setPageVersionToRetrieve($pageVersionToRetrieve)

No description

Parameters

$pageVersionToRetrieve

filterBySite(Site $site)

No description

Parameters

Site $site

mixed getPaginationAdapter()

Returns the standard pagination adapter. This is used for non-permissioned objects and is typically something like DoctrineDbalAdapter

Return Value

mixed

checkPermissions($mixed)

No description

Parameters

$mixed

filterByPageTypeHandle(mixed $ptHandle)

Filters by type of collection (using the handle field).

Parameters

mixed $ptHandle

filterByPageTemplate(Template $template)

Filters by page template.

Parameters

Template $template

filterByDateAdded(string $date, mixed $comparison = '=')

Filters by date added.

Parameters

string $date
mixed $comparison

filterByNumberOfChildren($number, string $comparison = '>')

Filter by number of children.

Parameters

$number
string $comparison

filterByDateLastModified($date, string $comparison = '=')

Filter by last modified date.

Parameters

$date
string $comparison

filterByPublicDate(string $date, mixed $comparison = '=')

Filters by public date.

Parameters

string $date
mixed $comparison

filterByPackage(Package $package)

Filters by package.

Parameters

Package $package

filterByPagesWithCustomStyles()

Displays only those pages that have style customizations.

filterByUserID(mixed $uID)

Filters by user ID).

Parameters

mixed $uID

filterByPageTypeID($ptID)

Filters by page type ID.

Parameters

$ptID

filterByParentID($cParentID)

Filters by parent ID.

Parameters

$cParentID

filterByName($name, bool $exact = false)

Filters a list by page name.

Parameters

$name
bool $exact

filterByPath($path, bool $includeAllChildren = true)

Filter a list by page path.

Parameters

$path
bool $includeAllChildren

filterByKeywords($keywords)

Filters keyword fields by keywords (including name, description, content, and attributes.

Parameters

$keywords

filterByFulltextKeywords($keywords)

No description

Parameters

$keywords

filterByTopic(mixed $topic)

Filters by topic. Doesn't look at specific attributes –instead, actually joins to the topics table.

Parameters

mixed $topic

filterByBlockType(BlockType $bt)

Filters a page list by a particular block type occurring in the version of a page.

Parameters

BlockType $bt

filterByContainer(Container $container)

Filters a page list by a particular container occurring in a page

Parameters

Container $container

filterByCacheSettings($value)

No description

Parameters

$value

sortByDisplayOrder()

Sorts this list by display order.

sortByDisplayOrderDescending()

Sorts this list by display order descending.

sortByDateModified()

Sorts this list by date modified ascending.

sortByDateModifiedDescending()

Sorts this list by date modified descending.

sortByCollectionIDAscending()

Sorts by ID in ascending order.

sortByPublicDate()

Sorts this list by public date ascending order.

sortByName()

Sorts by name in ascending order.

sortByNameDescending()

Sorts by name in descending order.

sortByPublicDateDescending()

Sorts this list by public date descending order.

sortByRelevance()

Sorts by fulltext relevance (requires that the query be fulltext-based.

filterByCollectionTypeHandle(mixed $ctHandle) deprecated

deprecated

No description

Parameters

mixed $ctHandle

filterByCollectionTypeID(mixed $ctID) deprecated

deprecated

No description

Parameters

mixed $ctID

ignoreAliases() deprecated

deprecated

This does nothing.

displayUnapprovedPages() deprecated

deprecated

No description

protected selectDistinct()

No description

filterByMissingTargets($targets)

No description

Parameters

$targets