Manual:Hooks/AuthPreserveQueryParams
AuthPreserveQueryParams | |
---|---|
Available from version 1.43.0 Used when an authentication page generates an URL which is in some sense part of the authentication process | |
Define function: | public static function onAuthPreserveQueryParams( array &$params, array $options ) { ... }
|
Attach hook: | In extension.json:
{
"Hooks": {
"AuthPreserveQueryParams": "MediaWiki\\Extension\\MyExtension\\Hooks::onAuthPreserveQueryParams"
}
}
|
Called from: | File(s): includes/specialpage/Hooks/AuthManagerSpecialPage.php |
Interface: | AuthPreserveQueryParamsHook.php |
For more information about attaching hooks, see Manual:Hooks .
For examples of extensions using this hook, see Category:AuthPreserveQueryParams extensions.
Details
[edit]array &$params
- Query parameters to preserve, name => value.array $options
- Information about the purpose of the URL that's being generated.reset
(bool, default false): Reset the authentication process, i.e. omit parameters which are related to continuing in-progress authentication. This is used e.g. in the link for switching from the login form to the signup form.
Usage
[edit]This hook gets called any time an authentication page generates an URL which is in some sense part of the authentication process (e.g. a language switcher link, the login form's action URL, or the return URL for a remote identity provider) and needs to determine which of the current query parameters to preserve in that URL.