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
$BE_USER  : BackendUserAuthentication|string
Needs to be initialized with $GLOBALS['BE_USER'] Done by default in init()
$buffer_idH  : 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!)
$fieldArray  : array
Default set of fields selected from the tree table.
$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
$parentField  : string
Defines the field of $table which is the parent id field (like pid for table pages).
$stored  : array
Holds (session stored) information about which items in the tree are unfolded and which are not.
$table  : string
Database table to get the tree data from.
$thisScript  : string
$title  : string
$tree  : array
$expandAll  : bool
If set, then ALL items will be expanded, regardless of stored settings.

Methods

__construct()  : mixed
Constructor
addField()  : mixed
Adds a fieldname to the internal array ->fieldArray
addTagAttributes()  : string
Adds attributes to image tag.
buildTreeByExpandedState()  : void
Construction of the tree structure according to the state of folding of the page tree module.
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 data in $this->stored[][] and ->expandAll flag.
getCount()  : int
Returns the number of records having the parent id, $uid
getDataCount()  : int
Getting the tree data: Counting elements in resource
getDataFree()  : mixed
Getting the tree data: frees data handle
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
getRootIcon()  : string
Returns the root icon for a tree/mountpoint (defaults to the globe)
getRootRecord()  : array
Returns root record for uid (<=0)
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.
getTree()  : int
Fetches the data for the tree
init()  : mixed
Init function REMEMBER to feed a $clause which will filter out non-readable pages!
PM_ATagWrap()  : string
Wrap the plus/minus icon in a link
PMicon()  : string
Wrapping Plus/Minus icon, unused in Export Page Tree
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.
determineScriptUrl()  : mixed
Sets the script url depending on being a module or script request
getBackendUser()  : BackendUserAuthentication
getLanguageService()  : LanguageService
getPageIcon()  : string
Get page icon for the row.
getThisScript()  : string
syncPageTreeState()  : void
Sync folding state of EXT:impexp page tree with the official page tree module

Properties

$bank

Points to the current mountpoint key

public int $bank = 0

$clause

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

public string $clause = ''

Tags

see
init()

$defaultList

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

public 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,cruser_id'

Tags

see
addField()

$fieldArray

Default set of fields selected from the tree table.

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

$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 = []

$parentField

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

public string $parentField = 'pid'

$stored

Holds (session stored) information about which items in the tree are unfolded and which are not.

public array $stored = []

$table

Database table to get the tree data from.

public string $table = 'pages'

Leave blank if data comes from an array.

$expandAll

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

protected bool $expandAll = false

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

addTagAttributes()

Adds attributes to image tag.

public addTagAttributes(string $icon, string $attr) : string

Parameters

$icon : string

Icon image tag

$attr : string

Attributes to add, eg. ' border="0"'

Return values

string —

Image tag, modified with $attr attributes added.

buildTreeByExpandedState()

Construction of the tree structure according to the state of folding of the page tree module.

public buildTreeByExpandedState(int $pid) : void

Parameters

$pid : int

Page ID

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 data in $this->stored[][] and ->expandAll flag.

public expandNext(int $id) : bool

Extending parent function

Parameters

$id : int

Record id/key

Tags

see
PageTreeView::expandNext()

Return values

bool

getCount()

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

public getCount(int $uid) : int

Parameters

$uid : int

Id to count subitems for

Return values

int

getDataCount()

Getting the tree data: Counting elements in resource

public getDataCount(mixed &$res) : int

Parameters

$res : mixed

Data handle

Tags

see
getDataInit()

Return values

int —

number of items

getDataFree()

Getting the tree data: frees data handle

public getDataFree(mixed &$res) : mixed

Parameters

$res : mixed

Data handle

getDataInit()

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

public 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

public 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

public 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

getRootIcon()

Returns the root icon for a tree/mountpoint (defaults to the globe)

public getRootIcon(array $rec) : string

Parameters

$rec : array

Record for root.

Return values

string —

Icon image tag.

getRootRecord()

Returns root record for uid (<=0)

public getRootRecord() : array

Return values

array —

Array with title/uid keys with values of $this->title/0 (zero)

getTitleAttrib()

Creates title attribute content for pages.

public 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.

public 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.

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

PM_ATagWrap()

Wrap the plus/minus icon in a link

public 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

public 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.

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?

determineScriptUrl()

Sets the script url depending on being a module or script request

protected determineScriptUrl() : mixed

getPageIcon()

Get page icon for the row.

protected getPageIcon(array $row) : string

Parameters

$row : array

Return values

string —

Icon image tag.

getThisScript()

protected getThisScript() : string

Return values

string

syncPageTreeState()

Sync folding state of EXT:impexp page tree with the official page tree module

protected syncPageTreeState() : void
On this page