Public Member Functions
	__construct ($table, $config)

array	queryTable (&$params, $recursionCounter=0)

Protected Member Functions
	prepareSelectStatement ()

string TYPO3 CMS Core Database Query Expression CompositeExpression	buildConstraintBlock (string $searchString)

array	splitSearchString (string $searchString)

array	getAvailablePageIds (int $id, int $depth=0)

	prepareOrderByStatement ()

	manipulateRecord (&$row)

bool	checkRecordAccess ($row, $uid)

	makeWorkspaceOverlay (&$row)

string	getRecordPath (&$row, $uid)

string	getLabel ($row)

array	renderRecord ($row, $entry)

LanguageService	getLanguageService ()

QueryBuilder	getQueryBuilderForTable ($table)

Protected Attributes
string	$table = ''

string	$mmForeignTable = ''

array	$config = array( )

array	$allowedPages = array( )

int	$maxItems = 10

array	$params = array( )

IconFactory	$iconFactory

QueryBuilder	$queryBuilder

Detailed Description

Default implementation of a handler class for an ajax record selector.

Normally other implementations should be inherited from this one. queryTable() should not be overwritten under normal circumstances.

Definition at line 38 of file SuggestWizardDefaultReceiver.php.

Constructor & Destructor Documentation

◆ __construct()

TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::__construct	(	$table,
		$config
	)

The constructor of this class

Parameters

string	$table	‪The table to query
array	$config	‪The configuration (TCA overlaid with TSconfig) to use for this selector

Definition at line 89 of file SuggestWizardDefaultReceiver.php.

References TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\$config, $GLOBALS, TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\$table, TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\getAvailablePageIds(), TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\getQueryBuilderForTable(), TYPO3\CMS\Core\Utility\GeneralUtility\intExplode(), TYPO3\CMS\Core\Type\Bitmask\Permission\PAGE_SHOW, and TYPO3\CMS\Core\Database\Query\QueryHelper\stripLogicalOperatorPrefix().

Member Function Documentation

◆ buildConstraintBlock()

string TYPO3 CMS Core Database Query Expression CompositeExpression TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::buildConstraintBlock ( string $searchString )

protected

Creates OR constraints for each split searchWord.

Parameters

string $searchString

Returns: ‪string|\TYPO3\CMS\Core\Database\Query\Expression\CompositeExpression

Definition at line 246 of file SuggestWizardDefaultReceiver.php.

References $GLOBALS, TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\$table, TYPO3\CMS\Core\Utility\MathUtility\canBeInterpretedAsInteger(), and TYPO3\CMS\Core\Utility\GeneralUtility\trimExplode().

Referenced by TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\prepareSelectStatement().

◆ checkRecordAccess()

bool TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::checkRecordAccess	(	$row,
		$uid
	)

protected

Selects whether the logged in Backend User is allowed to read a specific record

Parameters

array	$row
int	$uid

Returns: ‪bool

Definition at line 332 of file SuggestWizardDefaultReceiver.php.

References $GLOBALS, TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\$table, TYPO3\CMS\Core\Type\Bitmask\Permission\PAGE_SHOW, and TYPO3\CMS\Backend\Utility\BackendUtility\readPageAccess().

Referenced by TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\queryTable().

◆ getAvailablePageIds()

array TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::getAvailablePageIds	(	int	$id,
		int	$depth = `0`
	)

protected

Get array of page ids from given page id and depth

Parameters

int	$id	‪Page id.
int	$depth	‪Depth to go down.

Returns: ‪array of all page ids

Definition at line 286 of file SuggestWizardDefaultReceiver.php.

Referenced by TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\__construct().

◆ getLabel()

string TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::getLabel ( $row )

protected

Returns a label for a given record; usually only a wrapper for \TYPO3\CMS\Backend\Utility\BackendUtility::getRecordTitle

Parameters

array $row ‪The record to get the label for

Returns: ‪string The label

Definition at line 393 of file SuggestWizardDefaultReceiver.php.

References TYPO3\CMS\Backend\Utility\BackendUtility\getRecordTitle().

Referenced by TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\queryTable().

◆ getLanguageService()

LanguageService TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::getLanguageService ( )

protected

Returns: ‪LanguageService

Definition at line 425 of file SuggestWizardDefaultReceiver.php.

References $GLOBALS.

◆ getQueryBuilderForTable()

QueryBuilder TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::getQueryBuilderForTable ( $table )

protected

Parameters

string $table

Returns: ‪QueryBuilder

Definition at line 434 of file SuggestWizardDefaultReceiver.php.

References TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\$table.

Referenced by TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\__construct().

◆ getRecordPath()

string TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::getRecordPath	(	&	$row,
			$uid
	)

protected

Returns the path for a record. Is the whole path for all records except pages - for these the last part is cut off, because it contains the pagetitle itself, which would be double information

The path is returned uncut, cutting has to be done by calling function.

Parameters

array	$row	‪The row
int	$uid	‪UID of the record

Returns: ‪string The record-path

Definition at line 373 of file SuggestWizardDefaultReceiver.php.

References TYPO3\CMS\Backend\Utility\BackendUtility\getRecordPath().

Referenced by TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\queryTable().

◆ makeWorkspaceOverlay()

TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::makeWorkspaceOverlay ( & $row )

protected

Overlay the given record with its workspace-version, if any

Parameters

array $row ‪The record to get the workspace version for

Definition at line 355 of file SuggestWizardDefaultReceiver.php.

References $GLOBALS, TYPO3\CMS\Backend\Utility\BackendUtility\isTableWorkspaceEnabled(), and TYPO3\CMS\Backend\Utility\BackendUtility\workspaceOL().

Referenced by TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\queryTable().

◆ manipulateRecord()

TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::manipulateRecord ( & $row )

protected

Manipulate a record before using it to render the selector; may be used to replace a MM-relation etc.

Parameters

array $row

Definition at line 321 of file SuggestWizardDefaultReceiver.php.

Referenced by TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\queryTable().

◆ prepareOrderByStatement()

TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::prepareOrderByStatement ( )

protected

Prepares the clause by which the result elements are sorted. See description of ORDER BY in SQL standard for reference.

Definition at line 304 of file SuggestWizardDefaultReceiver.php.

References $GLOBALS, and TYPO3\CMS\Core\Database\Query\QueryHelper\parseOrderBy().

Referenced by TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\queryTable().

◆ prepareSelectStatement()

TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::prepareSelectStatement ( )

protected

Prepare the statement for selecting the records which will be returned to the selector. May also return some other records (e.g. from a mm-table) which will be used later on to select the real records

Definition at line 212 of file SuggestWizardDefaultReceiver.php.

References TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\buildConstraintBlock(), TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\splitSearchString(), and TYPO3\CMS\Core\Database\Query\QueryHelper\stripLogicalOperatorPrefix().

Referenced by TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\queryTable().

◆ queryTable()

array TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::queryTable	(	&	$params,
			$recursionCounter = `0`
	)

Queries a table for records and completely processes them

Returns a two-dimensional array of almost finished records; the only need to be put into a -structure

If you subclass this class, you will most likely only want to overwrite the functions called from here, but not this function itself

Parameters

array	$params
int	$recursionCounter	‪The parent object

Returns: ‪array Array of rows or FALSE if nothing found

Definition at line 140 of file SuggestWizardDefaultReceiver.php.

◆ renderRecord()

array TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::renderRecord	(	$row,
		$entry
	)

protected

Calls a user function for rendering the page.

This user function should manipulate $entry, especially $entry['text'].

Parameters

array	$row	‪The row
array	$entry	‪The entry to render

Returns: ‪array The rendered entry (will be put into a later on

Definition at line 407 of file SuggestWizardDefaultReceiver.php.

References TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\$params, and TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\$table.

Referenced by TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver\queryTable().

◆ splitSearchString()

array TYPO3\CMS\Backend\Form\Wizard\SuggestWizardDefaultReceiver::splitSearchString ( string $searchString )

protected

Splits the search string by space This allows searching for 'elements basic' and will find results like "elements rte basic" To search for whole phrases enclose by double-quotes: '"elements basic"', results in empty result

Parameters

string $searchString