[feature/add_events] Rename override to overwrite, made docs 79 chars/line

PHPBB3-9550
This commit is contained in:
David King 2012-08-21 11:25:52 -04:00
parent 008cf967ab
commit 6c6b179dd4

View file

@ -2239,34 +2239,35 @@ function append_sid($url, $params = false, $is_amp = true, $session_id = false)
$params = false; $params = false;
} }
$append_sid_override = false; $append_sid_overwrite = false;
/** /**
* This event can either supplement or override the append_sid() function * This event can either supplement or override the append_sid() function
* *
* To override this function, the event must set $append_sid_override to * To override this function, the event must set $append_sid_overwrite to
* the new URL value, which will be returned following the event * the new URL value, which will be returned following the event
* *
* @event core.append_sid * @event core.append_sid
* @var string url The url the session id needs to be * @var string url The url the session id needs
* appended to (can have params) * to be appended to (can have
* @var mixed params String or array of additional url * params)
* parameters * @var mixed params String or array of additional
* url parameters
* @var bool is_amp Is url using & (true) or * @var bool is_amp Is url using & (true) or
* & (false) * & (false)
* @var bool|string session_id Possibility to use a custom session * @var bool|string session_id Possibility to use a custom
* id (string) instead of the global * session id (string) instead of
* one (false) * the global one (false)
* @var bool|string append_sid_override Overwrite function (string URL) * @var bool|string append_sid_overwrite Overwrite function (string
* or not (false) * URL) or not (false)
* @since 3.1-A1 * @since 3.1-A1
*/ */
$vars = array('url', 'params', 'is_amp', 'session_id', 'append_sid_override'); $vars = array('url', 'params', 'is_amp', 'session_id', 'append_sid_overwrite');
extract($phpbb_dispatcher->trigger_event('core.append_sid', compact($vars))); extract($phpbb_dispatcher->trigger_event('core.append_sid', compact($vars)));
if ($append_sid_override) if ($append_sid_overwrite)
{ {
return $append_sid_override; return $append_sid_overwrite;
} }
// The following hook remains for backwards compatibility, though use of // The following hook remains for backwards compatibility, though use of