Bug #87497

TCA ctrl typeicon_column reference falsely claims default icon is `iconfile` value

Added by Leonie Philine Bitto 8 months ago. Updated 5 months ago.

Status:
New
Priority:
Must have
Assignee:
-
Category:
Documentation
Start date:
2019-01-19
Due date:
% Done:

0%

TYPO3 Version:
9
PHP Version:
Tags:
Complexity:
no-brainer
Is Regression:
Sprint Focus:

Description

There is a false claim in [1], saying:

"the default icon is the one defined with the iconfile value."

This is false:

\TYPO3\CMS\Core\Imaging\IconFactory::mapRecordTypeToIconIdentifier() skips 'tcarecords-' . $table . '-default' altogether, when isset($GLOBALS['TCA'][$table]['ctrl']['typeicon_column']) evaluates to true.

Therefore, typeicon_column must always contain a default key mapping to an existing icon (which means you need to duplicate iconfile, but this time as icon identifier rather than as file path).
iconfile is not even considered (e.g. in the List > New Record view) for typeicon_column-enabled tables.

You can choose if this is a code bug in \TYPO3\CMS\Core\Imaging\IconFactory::mapRecordTypeToIconIdentifier() or a documentation bug in [1].

---
[1] https://docs.typo3.org/typo3cms/TCAReference/Ctrl/#ctrl-reference-typeicon-column

History

#1 Updated by Benni Mack 5 months ago

  • Target version changed from next-patchlevel to Candidate for patchlevel

Also available in: Atom PDF