Issue Story Closed

#17855php-docs for all hooks

Bernhard Kraft 11/27/07, 13:49 updated 01/13/18, 00:49

Description

Currently there is no common documentation for all hooks in the core.

As they are quite important to extension programmers it would be nice to have a place where all information about hooks is collected.

All hooks should get marked with php-doc comments and some unique identifier.

There should be a link to a wiki page for each hook where extension programmers and other volunteers can add “special” information about the hooks and about extensions which utilize those.

Proposed example for php-doc for an hook:

/**
 * hook       renderListHeader: Allows to change the contents of columns/cells of the Web>List table headers
 * date       2007-11-20
 * request    Bernhard Kraft  <krafbtkraftb.at>
 * @usage      Above each listed table in Web>List a header row is shown. Containing the labels of all shown fields and additional icons to create new records for this table or perform special clipboard tasks like mark and copy all listed records to clipboard, etc.
*/

hook ... Method name: Hook description
date … Date when added
@request … Developer who requested the hook
@usage … Minimal explanation of how the hook gets used
@link … Link to wiki.typo3.org unique for each hook

RFC ?

(issue imported from #M6841)

Reviews 0

No change resolves or names this issue in its commit message, and no comment links one.