Project

General

Profile

Actions
Copy link

Story #17855

closed

php-docs for all hooks

Added by Bernhard Kraft over 16 years ago. Updated over 6 years ago.

Status:
Closed
Priority:
Could have
Assignee:
-
Category:
Documentation
Target version:
7 LTS
Start date:
2007-11-27
Due date:
% Done:

0%

Estimated time:
TYPO3 Version:
4.2
PHP Version:
4.3
Tags:
Sprint Focus:

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  <>
 * @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
@Karol Linkiewicz ... Link to wiki.typo3.org unique for each hook

RFC ?

(issue imported from #M6841)

Actions
Copy link

Also available in: Atom PDF