[ticket/12060] Further clarifying new event docblocks as much as possible

PHPBB3-12060
This commit is contained in:
Matt Friedman 2013-12-16 23:54:55 -08:00
parent 01c4235f00
commit 4665e3df21
3 changed files with 17 additions and 14 deletions

View file

@ -14,7 +14,7 @@ acp_bbcodes_edit_fieldsets_after
=== ===
* Location: adm/style/acp_bbcodes.html * Location: adm/style/acp_bbcodes.html
* Since: 3.1.0-a3 * Since: 3.1.0-a3
* Purpose: Add settings to edit BBCodes form * Purpose: Add settings to BBCode add/edit form
acp_forums_normal_settings_append acp_forums_normal_settings_append
=== ===

View file

@ -111,12 +111,13 @@ class acp_bbcodes
$bbcode_tokens = array('TEXT', 'SIMPLETEXT', 'INTTEXT', 'IDENTIFIER', 'NUMBER', 'EMAIL', 'URL', 'LOCAL_URL', 'RELATIVE_URL', 'COLOR'); $bbcode_tokens = array('TEXT', 'SIMPLETEXT', 'INTTEXT', 'IDENTIFIER', 'NUMBER', 'EMAIL', 'URL', 'LOCAL_URL', 'RELATIVE_URL', 'COLOR');
/** /**
* Event to modify custom bbcode template before displaying the add/edit form * Modify custom bbcode template data before we display the add/edit form
* *
* @event core.acp_bbcodes_edit_add * @event core.acp_bbcodes_edit_add
* @var string action Type of the action: add|edit * @var string action Type of the action: add|edit
* @var array tpl_ary Array with bbcodes add/edit data * @var array tpl_ary Array with custom bbcode add/edit data
* @var int bbcode_id The id of the bbcode (being edited) * @var int bbcode_id When editing: the bbcode id,
* when creating: 0
* @var array bbcode_tokens Array of bbcode tokens * @var array bbcode_tokens Array of bbcode tokens
* @since 3.1.0-a3 * @since 3.1.0-a3
*/ */
@ -143,12 +144,13 @@ class acp_bbcodes
$sql_ary = $hidden_fields = array(); $sql_ary = $hidden_fields = array();
/** /**
* Event to modify custom bbcode data before modify/create * Modify custom bbcode data before the modify/create action
* *
* @event core.acp_bbcodes_modify_create * @event core.acp_bbcodes_modify_create
* @var string action Type of the action: modify|create * @var string action Type of the action: modify|create
* @var array sql_ary Array with new bbcode data * @var array sql_ary Array with new bbcode data
* @var int bbcode_id The id of the bbcode (being modified) * @var int bbcode_id When editing: the bbcode id,
* when creating: 0
* @var bool display_on_posting Display bbcode on posting form * @var bool display_on_posting Display bbcode on posting form
* @var string bbcode_match The bbcode usage string to match * @var string bbcode_match The bbcode usage string to match
* @var string bbcode_tpl The bbcode HTML replacement string * @var string bbcode_tpl The bbcode HTML replacement string
@ -349,7 +351,7 @@ class acp_bbcodes
); );
/** /**
* Event to modify custom bbcode template data before displaying the form * Modify custom bbcode template data before we display the form
* *
* @event core.acp_bbcodes_display_form * @event core.acp_bbcodes_display_form
* @var string action Type of the action: modify|create * @var string action Type of the action: modify|create
@ -374,7 +376,7 @@ class acp_bbcodes
); );
/** /**
* Event to modify display of custom bbcodes in the form * Modify display of custom bbcodes in the form
* *
* @event core.acp_bbcodes_display_bbcodes * @event core.acp_bbcodes_display_bbcodes
* @var array row Array with current bbcode data * @var array row Array with current bbcode data

View file

@ -1252,12 +1252,13 @@ class parse_message extends bbcode_firstpass
* Use this event to modify the text after it is parsed * Use this event to modify the text after it is parsed
* *
* @event core.modify_format_display_text_after * @event core.modify_format_display_text_after
* @var string text The text to parse * @var string text The message text to parse
* @var string uid The BBCode UID * @var string uid The bbcode uid
* @var bool allow_bbcode Allow BBCodes switch * @var bool allow_bbcode Do we allow bbcodes
* @var bool allow_magic_url Allow magic urls switch * @var bool allow_magic_url Do we allow magic urls
* @var bool allow_smilies Allow smilies switch * @var bool allow_smilies Do we allow smilies
* @var bool update_this_message Update message switch * @var bool update_this_message Do we update the internal message
* with the parsed result
* @since 3.1.0-a3 * @since 3.1.0-a3
*/ */
$vars = array('text', 'uid', 'allow_bbcode', 'allow_magic_url', 'allow_smilies', 'update_this_message'); $vars = array('text', 'uid', 'allow_bbcode', 'allow_magic_url', 'allow_smilies', 'update_this_message');