TreeController

Controller providing data to the page tree

Internal

This class is a specific Backend controller implementation and is not considered part of the Public TYPO3 API.

Table of Contents

Properties

$addDomainName  : bool
Option to prefix the domain name of sys_domains when outputting the tree items, set via userTS.
$addIdAsPrefix  : bool
Option to prefix the page ID when outputting the tree items, set via userTS.
$alternativeEntryPoints  : array<string|int, mixed>
Used in the record link picker to limit the page tree only to a specific list of alternative entry points for selecting only from a list of pages
$backgroundColors  : array<string|int, mixed>
An array of background colors for a branch in the tree, set via userTS.
$expandAllNodes  : bool
When set to true all nodes returend by API will be expanded
$expandedState  : array<string|int, mixed>
Contains the state of all items that are expanded.
$hiddenRecords  : array<string|int, mixed>
A list of pages not to be shown.
$iconFactory  : IconFactory
Instance of the icon factory, to be used for generating the items.
$levelsToFetch  : int
Number of tree levels which should be returned on the first page tree load
$pageTreeRepository  : PageTreeRepository
$showMountPathAboveMounts  : bool
Option to add the rootline path above each mount point, set via userTS.
$uriBuilder  : UriBuilder
$useNavTitle  : bool
Option to use the nav_title field for outputting in the tree items, set via userTS.
$userHasAccessToModifyPagesAndToDefaultLanguage  : bool

Methods

__construct()  : mixed
Constructor to set up common objects needed in various places.
fetchConfigurationAction()  : ResponseInterface
Returns page tree configuration in JSON
fetchDataAction()  : ResponseInterface
Returns JSON representing page tree
fetchReadOnlyConfigurationAction()  : ResponseInterface
filterDataAction()  : ResponseInterface
Returns JSON representing page tree filtered by keyword
setTemporaryMountPointAction()  : ResponseInterface
Sets a temporary mount point
calculateBackgroundColors()  : mixed
getAllEntryPointPageTrees()  : array<string|int, mixed>
Fetches all pages for all tree entry points the user is allowed to see
getAllowedMountPoints()  : array<string|int, int>
Get allowed mountpoints. Returns temporary mountpoint when temporary mountpoint is used.
getBackendUser()  : BackendUserAuthentication
getDokTypes()  : array<string|int, mixed>
Returns the list of doktypes to display in page tree toolbar drag area
getDomainNameForPage()  : string
Returns the first configured domain name for a page
getLanguageService()  : LanguageService|null
getMountPointPath()  : string
Returns the mount point path for a temporary mount or the given id
getWorkspaceService()  : WorkspaceService
initializeConfiguration()  : mixed
initializePageTreeRepository()  : PageTreeRepository
isDragMoveAllowed()  : bool
Check if drag-move in the svg tree is allowed for the user
pagesToFlatArray()  : array<string|int, mixed>
Converts nested tree structure produced by PageTreeRepository to a flat, one level array and also adds visual representation information to the data.
resolvePageCssClassNames()  : string
Fetches possible css class names to be used when a record was modified in a workspace

Properties

$addDomainName

Option to prefix the domain name of sys_domains when outputting the tree items, set via userTS.

protected bool $addDomainName = false

$addIdAsPrefix

Option to prefix the page ID when outputting the tree items, set via userTS.

protected bool $addIdAsPrefix = false

$alternativeEntryPoints

Used in the record link picker to limit the page tree only to a specific list of alternative entry points for selecting only from a list of pages

protected array<string|int, mixed> $alternativeEntryPoints = []

$backgroundColors

An array of background colors for a branch in the tree, set via userTS.

protected array<string|int, mixed> $backgroundColors = []

$expandAllNodes

When set to true all nodes returend by API will be expanded

protected bool $expandAllNodes = false

$expandedState

Contains the state of all items that are expanded.

protected array<string|int, mixed> $expandedState = []

$hiddenRecords

A list of pages not to be shown.

protected array<string|int, mixed> $hiddenRecords = []

$iconFactory

Instance of the icon factory, to be used for generating the items.

protected IconFactory $iconFactory

$levelsToFetch

Number of tree levels which should be returned on the first page tree load

protected int $levelsToFetch = 2

$showMountPathAboveMounts

Option to add the rootline path above each mount point, set via userTS.

protected bool $showMountPathAboveMounts = false

$useNavTitle

Option to use the nav_title field for outputting in the tree items, set via userTS.

protected bool $useNavTitle = false

$userHasAccessToModifyPagesAndToDefaultLanguage

protected bool $userHasAccessToModifyPagesAndToDefaultLanguage = false

Methods

__construct()

Constructor to set up common objects needed in various places.

public __construct() : mixed

fetchConfigurationAction()

Returns page tree configuration in JSON

public fetchConfigurationAction() : ResponseInterface
Return values
ResponseInterface

fetchDataAction()

Returns JSON representing page tree

public fetchDataAction(ServerRequestInterface $request) : ResponseInterface
Parameters
$request : ServerRequestInterface
Return values
ResponseInterface

fetchReadOnlyConfigurationAction()

public fetchReadOnlyConfigurationAction(ServerRequestInterface $request) : ResponseInterface
Parameters
$request : ServerRequestInterface
Return values
ResponseInterface

filterDataAction()

Returns JSON representing page tree filtered by keyword

public filterDataAction(ServerRequestInterface $request) : ResponseInterface
Parameters
$request : ServerRequestInterface
Return values
ResponseInterface

setTemporaryMountPointAction()

Sets a temporary mount point

public setTemporaryMountPointAction(ServerRequestInterface $request) : ResponseInterface
Parameters
$request : ServerRequestInterface
Tags
throws
RuntimeException
Return values
ResponseInterface

calculateBackgroundColors()

protected calculateBackgroundColors(array<string|int, mixed> $pageIds) : mixed
Parameters
$pageIds : array<string|int, mixed>

getAllEntryPointPageTrees()

Fetches all pages for all tree entry points the user is allowed to see

protected getAllEntryPointPageTrees([int $startPid = 0 ][, string $query = '' ]) : array<string|int, mixed>
Parameters
$startPid : int = 0
$query : string = ''

The search query can either be a string to be found in the title or the nav_title of a page or the uid of a page.

Return values
array<string|int, mixed>

getAllowedMountPoints()

Get allowed mountpoints. Returns temporary mountpoint when temporary mountpoint is used.

protected getAllowedMountPoints() : array<string|int, int>
Return values
array<string|int, int>

getDokTypes()

Returns the list of doktypes to display in page tree toolbar drag area

protected getDokTypes() : array<string|int, mixed>

Note: The list can be filtered by the user TypoScript option "options.pageTree.doktypesToShowInNewPageDragArea".

Return values
array<string|int, mixed>

getDomainNameForPage()

Returns the first configured domain name for a page

protected getDomainNameForPage(int $pageId) : string
Parameters
$pageId : int
Return values
string

getMountPointPath()

Returns the mount point path for a temporary mount or the given id

protected getMountPointPath(int $uid) : string
Parameters
$uid : int
Return values
string

initializeConfiguration()

protected initializeConfiguration(ServerRequestInterface $request) : mixed
Parameters
$request : ServerRequestInterface

isDragMoveAllowed()

Check if drag-move in the svg tree is allowed for the user

protected isDragMoveAllowed() : bool
Return values
bool

pagesToFlatArray()

Converts nested tree structure produced by PageTreeRepository to a flat, one level array and also adds visual representation information to the data.

protected pagesToFlatArray(array<string|int, mixed> $page, int $entryPoint[, int $depth = 0 ][, array<string|int, mixed> $inheritedData = [] ]) : array<string|int, mixed>

The result is intended to be used as JSON result - dumping data directly to HTML might lead to XSS!

Parameters
$page : array<string|int, mixed>
$entryPoint : int
$depth : int = 0
$inheritedData : array<string|int, mixed> = []
Return values
array<string|int, mixed>

resolvePageCssClassNames()

Fetches possible css class names to be used when a record was modified in a workspace

protected resolvePageCssClassNames(array<string|int, mixed> $page) : string
Parameters
$page : array<string|int, mixed>

Page record (workspace overlaid)

Return values
string —

CSS class names to be applied


        

        
    




    

    

                            

            

                            
    

        On this page

        
    


            

                    

        

    

        

            
Search results