ExportPageTreeView

class \TYPO3\CMS\Impexp\View\ExportPageTreeView

Extends
AbstractTreeView

Extension of the page tree class. Used to get the tree of pages to export.

Table of Contents

Properties

$bank  : int
Points to the current mountpoint key
$buffer_idH  : array
$ids  : array
$ids_hierarchy  : array
$makeHTML  : int
If 1, HTML code is also accumulated in ->tree array during rendering of the tree
$orderByFields  : string
Field for ORDER BY. Is set by function init.
$orig_ids_hierarchy  : array
$tree  : array
$clause  : string
WHERE clause used for selecting records for the tree. Is set by function init.
$defaultList  : string
List of other fields which are ALLOWED to set (here, based on the "pages" table!)
$expandAll  : bool
If set, then ALL items will be expanded, regardless of stored settings.
$fieldArray  : array
Default set of fields selected from the tree table.
$parentField  : string
Defines the field of $table which is the parent id field (like pid for table pages).
$table  : string
Database table to get the tree data from.

Methods

__construct()  : mixed
Constructor
addField()  : mixed
Adds a fieldname to the internal array ->fieldArray
buildTreeByLevels()  : void
Construction of the tree structure with predefined depth.
expandNext()  : bool
Returns TRUE/FALSE if the next level for $id should be expanded - based on the ->expandAll flag.
getTree()  : int
Fetches the data for the tree
init()  : mixed
Init function REMEMBER to feed a $clause which will filter out non-readable pages!
printTree()  : string
Compiles the HTML code for displaying the structure found inside the ->tree array
reset()  : mixed
Resets the tree, recs, ids, ids_hierarchy and orig_ids_hierarchy internal variables. Use it if you need it.
buildTree()  : void
Creation of a tree structure with predefined depth to prepare the export.
getBackendUser()  : BackendUserAuthentication
getCount()  : int
Returns the number of records having the parent id, $uid
getDataInit()  : mixed
Getting the tree data: Selecting/Initializing data pointer to items for a certain parent id.
getDataNext()  : array|bool
Getting the tree data: next entry
getIcon()  : string
Get the icon markup for the row
getLanguageService()  : LanguageService
getPageIcon()  : string
Get page icon for the row.
getTitleAttrib()  : string
Creates title attribute content for pages.
getTitleStr()  : string
Returns the title for the input record. If blank, a "no title" label (localized) will be returned.
PM_ATagWrap()  : string
Wrap the plus/minus icon in a link
PMicon()  : string
Wrapping Plus/Minus icon, unused in Export Page Tree

Properties

$bank

Points to the current mountpoint key

public int $bank = 0

$ids_hierarchy

public array $ids_hierarchy = []

$makeHTML

If 1, HTML code is also accumulated in ->tree array during rendering of the tree

public int $makeHTML = 1

$orderByFields

Field for ORDER BY. Is set by function init.

public string $orderByFields = ''

Tags

see
init()

$orig_ids_hierarchy

public array $orig_ids_hierarchy = []

$clause

WHERE clause used for selecting records for the tree. Is set by function init.

protected string $clause = ''

Tags

see
init()

$defaultList

List of other fields which are ALLOWED to set (here, based on the "pages" table!)

protected string $defaultList = 'uid,pid,tstamp,sorting,deleted,perms_userid,perms_groupid,p…
Show the full value'uid,pid,tstamp,sorting,deleted,perms_userid,perms_groupid,perms_user,perms_group,perms_everybody,crdate'

Tags

see
addField()

$expandAll

If set, then ALL items will be expanded, regardless of stored settings.

protected bool $expandAll = false

$fieldArray

Default set of fields selected from the tree table.

protected array $fieldArray = ['uid', 'pid', 'title', 'is_siteroot', 'doktype', 'nav_title…
Show the full value['uid', 'pid', 'title', 'is_siteroot', 'doktype', 'nav_title', 'mount_pid', 'php_tree_stop', 't3ver_state', 'hidden', 'starttime', 'endtime', 'fe_group', 'module', 'extendToSubpages', 'nav_hide', 't3ver_wsid']

Make SURE that these fields names listed herein are actually possible to select from $this->table (if that variable is set to a TCA table name)

Tags

see
addField()

$parentField

Defines the field of $table which is the parent id field (like pid for table pages).

protected string $parentField = 'pid'

$table

Database table to get the tree data from.

protected string $table = 'pages'

Leave blank if data comes from an array.

Methods

__construct()

Constructor

public __construct() : mixed

addField()

Adds a fieldname to the internal array ->fieldArray

public addField(string $field[, bool $noCheck = false ]) : mixed

Parameters

$field : string

Field name to

$noCheck : bool = false

If set, the fieldname will be set no matter what. Otherwise the field name must either be found as key in $GLOBALS['TCA'][$table]['columns'] or in the list ->defaultList

buildTreeByLevels()

Construction of the tree structure with predefined depth.

public buildTreeByLevels(int $pid, int $levels) : void

Parameters

$pid : int

Page ID

$levels : int

Page tree levels

expandNext()

Returns TRUE/FALSE if the next level for $id should be expanded - based on the ->expandAll flag.

public expandNext(int $id) : bool

Extending parent function

Parameters

$id : int

Record id/key

Tags

see
PageTreeView::expandNext()

Return values

bool

getTree()

Fetches the data for the tree

public getTree(int $uid[, int $depth = 999 ][, string $depthData = '' ]) : int

Parameters

$uid : int

item id for which to select subitems (parent id)

$depth : int = 999

Max depth (recursivity limit)

$depthData : string = ''

HTML-code prefix for recursive calls.

Return values

int —

The count of items on the level

init()

Init function REMEMBER to feed a $clause which will filter out non-readable pages!

public init([string $clause = '' ][, string $orderByFields = '' ]) : mixed

Parameters

$clause : string = ''

Part of where query which will filter out non-readable pages.

$orderByFields : string = ''

Record ORDER BY field

printTree()

Compiles the HTML code for displaying the structure found inside the ->tree array

public printTree([array|string $treeArr = '' ]) : string

Parameters

$treeArr : array|string = ''

"tree-array" - if blank string, the internal ->tree array is used.

Return values

string —

The HTML code for the tree

reset()

Resets the tree, recs, ids, ids_hierarchy and orig_ids_hierarchy internal variables. Use it if you need it.

public reset() : mixed

buildTree()

Creation of a tree structure with predefined depth to prepare the export.

protected buildTree(int $pid, int $levels, bool $checkSub) : void

Parameters

$pid : int

Page ID

$levels : int

Page tree levels

$checkSub : bool

Should root page be checked for sub pages?

getCount()

Returns the number of records having the parent id, $uid

protected getCount(int $uid) : int

Parameters

$uid : int

Id to count subitems for

Return values

int

getDataInit()

Getting the tree data: Selecting/Initializing data pointer to items for a certain parent id.

protected getDataInit(int $parentId) : mixed

For tables: This will make a database query to select all children to "parent" For arrays: This will return key to the ->dataLookup array

Parameters

$parentId : int

parent item id

Return values

mixed —

Data handle (Tables: An sql-resource, arrays: A parentId integer. -1 is returned if there were NO subLevel.)

getDataNext()

Getting the tree data: next entry

protected getDataNext(mixed &$res) : array|bool

Parameters

$res : mixed

Data handle

Tags

see
getDataInit()

Return values

array|bool —

item data array OR FALSE if end of elements.

getIcon()

Get the icon markup for the row

protected getIcon(array $row) : string

Parameters

$row : array

The row to get the icon for

Return values

string —

The icon markup, wrapped into a span tag, with the records title as title attribute

getPageIcon()

Get page icon for the row.

protected getPageIcon(array $row) : string

Parameters

$row : array

Return values

string —

Icon image tag.

getTitleAttrib()

Creates title attribute content for pages.

protected getTitleAttrib(array $row) : string

Uses API function in \TYPO3\CMS\Backend\Utility\BackendUtility which will retrieve lots of useful information for pages.

Parameters

$row : array

The table row.

Return values

string

getTitleStr()

Returns the title for the input record. If blank, a "no title" label (localized) will be returned.

protected getTitleStr(array $row[, int $titleLen = 30 ]) : string

Do NOT htmlspecialchar the string from this function - has already been done.

Parameters

$row : array

The input row array (where the key "title" is used for the title)

$titleLen : int = 30

Title length (30)

Return values

string —

The title.

PM_ATagWrap()

Wrap the plus/minus icon in a link

protected PM_ATagWrap([string $bMark = '' ][, bool $isOpen = false ]) : string

Parameters

$bMark : string = ''

If set, the link will have an anchor point (=$bMark) and a name attribute (=$bMark)

$isOpen : bool = false

Return values

string —

Link-wrapped input string

PMicon()

Wrapping Plus/Minus icon, unused in Export Page Tree

protected PMicon(mixed $row, mixed $a, mixed $c, mixed $nextCount, mixed $isOpen) : string

Parameters

$row : mixed

Record for the entry

$a : mixed

The current entry number

$c : mixed

The total number of entries. If equal to $a, a "bottom" element is returned.

$nextCount : mixed

The number of sub-elements to the current element.

$isOpen : mixed

The element was expanded to render subelements if this flag is set.

Return values

string —

Image tag with the plus/minus icon.

On this page