MediaWiki master
MediaWiki\SpecialPage\LoginSignupSpecialPage Class Reference

Holds shared logic for login and account creation pages. More...

Inherits MediaWiki\SpecialPage\AuthManagerSpecialPage.

Inherited by MediaWiki\Specials\SpecialCreateAccount, and MediaWiki\Specials\SpecialUserLogin.

Collaboration diagram for MediaWiki\SpecialPage\LoginSignupSpecialPage:

Public Member Functions

 execute ( $subPage)
 
 onAuthChangeFormFields (array $requests, array $fieldInfo, array &$formDescriptor, $action)
 Change the form descriptor that determines how a field will look in the authentication form.Called from fieldInfoToFormDescriptor().

Stability: stable
to override
Parameters
AuthenticationRequest[]$requests
array$fieldInfoField information array (union of all AuthenticationRequest::getFieldInfo() responses).
array&$formDescriptorHTMLForm descriptor. The special key 'weight' can be set to change the order of the fields.
string$actionAuthentication type (one of the AuthManager::ACTION_* constants)

 
- Public Member Functions inherited from MediaWiki\SpecialPage\AuthManagerSpecialPage
 getRequest ()
 Get the WebRequest being used for this instance.
 
 handleFormSubmit ( $data)
 Submit handler callback for HTMLForm.
 
- Public Member Functions inherited from MediaWiki\SpecialPage\SpecialPage
 __construct ( $name='', $restriction='', $listed=true, $function=false, $file='', $includable=false)
 Default constructor for special pages Derivative classes should call this from their constructor Note that if the user does not have the required level, an error message will be displayed by the default execute() method, without the global function ever being called.
 
 addHelpLink ( $to, $overrideBaseUrl=false)
 Adds help link with an icon via page indicators.
 
 checkPermissions ()
 Checks if userCanExecute, and if not throws a PermissionsError.
 
 checkReadOnly ()
 If the wiki is currently in readonly mode, throws a ReadOnlyError.
 
 doesWrites ()
 Indicates whether this special page may perform database writes.
 
 getAssociatedNavigationLinks ()
 Return an array of strings representing page titles that are discoverable to end users via UI.
 
 getAuthority ()
 Shortcut to get the Authority executing this instance.
 
 getConfig ()
 Shortcut to get main config object.
 
 getContentLanguage ()
 Shortcut to get content language.
 
 getContext ()
 Gets the context this SpecialPage is executed in.
 
 getDescription ()
 Returns the name that goes in the \<h1\> in the special page itself, and also the name that will be listed in Special:Specialpages.
 
 getFinalGroupName ()
 Get the group that the special page belongs in on Special:SpecialPage Use this method, instead of getGroupName to allow customization of the group name from the wiki side.
 
 getFullTitle ()
 Return the full title, including $par.
 
 getLanguage ()
 Shortcut to get user's language.
 
 getLinkRenderer ()
 
 getLocalName ()
 Get the localised name of the special page.
 
 getName ()
 Get the canonical, unlocalized name of this special page without namespace.
 
 getOutput ()
 Get the OutputPage being used for this instance.
 
 getPageTitle ( $subpage=false)
 Get a self-referential title object.
 
 getRestriction ()
 Get the permission that a user must have to execute this page.
 
 getShortDescription (string $path='')
 Similar to getDescription but takes into account sub pages and designed for display in tabs.
 
 getSkin ()
 Shortcut to get the skin being used for this instance.
 
 getUser ()
 Shortcut to get the User executing this instance.
 
 including ( $x=null)
 Whether the special page is being evaluated via transclusion.
 
 isCached ()
 Is this page cached? Expensive pages are cached or disabled in miser mode.
 
 isExpensive ()
 Is this page expensive (for some definition of expensive)? Expensive pages are disabled or cached in miser mode.
 
 isIncludable ()
 Whether it's allowed to transclude the special page via {{Special:Foo/params}}.
 
 isListed ()
 Whether this special page is listed in Special:SpecialPages.
 
 isRestricted ()
 Can be overridden by subclasses with more complicated permissions schemes.
 
 maxIncludeCacheTime ()
 How long to cache page when it is being included.
 
 msg ( $key,... $params)
 Wrapper around wfMessage that sets the current context.
 
 prefixSearchSubpages ( $search, $limit, $offset)
 Return an array of subpages beginning with $search that this special page will accept.
 
 requireLogin ( $reasonMsg='exception-nologin-text', $titleMsg='exception-nologin')
 If the user is not logged in, throws UserNotLoggedIn error.
 
 requireNamedUser ( $reasonMsg='exception-nologin-text', $titleMsg='exception-nologin')
 If the user is not logged in or is a temporary user, throws UserNotLoggedIn.
 
 run ( $subPage)
 Entry point.
 
 setContentLanguage (Language $contentLanguage)
 Set content language.
 
 setContext ( $context)
 Sets the context this SpecialPage is executed in.
 
 setHookContainer (HookContainer $hookContainer)
 
 setLinkRenderer (LinkRenderer $linkRenderer)
 
 setSpecialPageFactory (SpecialPageFactory $specialPageFactory)
 
 userCanExecute (User $user)
 Checks if the given user (identified by an object) can execute this special page (as defined by $mRestriction).
 

Protected Member Functions

 beforeExecute ( $subPage)
 
 getAuthForm (array $requests, $action)
 Generates a form from the given request.
 
 getBenefitsContainerHtml ()
 The HTML to be shown in the "benefits to signing in / creating an account" section of the signup/login page.
 
 getFieldDefinitions (array $fieldInfo)
 Create a HTMLForm descriptor for the core login fields.
 
 getGroupName ()
 Under which header this special page is listed in Special:SpecialPages See messages 'specialpages-group-*' for valid names This method defaults to group 'other'.
 
 getNoticeHtml ()
 Generates the HTML for a notice box to be displayed to a temporary user.
 
 getPageHtml ( $formHtml)
 Add page elements which are outside the form.
 
 getPreservedParams ( $options=[])
 Returns URL query parameters which should be preserved between authentication requests.These should be used when generating links such as form submit or language switch.These parameters will be preserved in:

  • successive authentication steps (the form submit URL and the return URL for redirecting providers);
  • links that reload the same form somehow (e.g. language switcher links);
  • links for switching between the login and create account forms.
Stability: stable
to override
Parameters
array$options(since 1.43)
  • reset (bool, default false): Reset the authentication process, i.e. omit parameters which are related to continuing in-progress authentication.
  • withToken (bool, default false): Include CSRF token Before 1.43, this was a boolean flag identical to the current 'withToken' option. That usage is deprecated.
Returns
array Array of parameter name => parameter value.

 
 getTokenName ()
 Returns the name of the CSRF token (under which it should be found in the POST or GET data).
 
 hasSessionCookie ()
 Check if a session cookie is present.
 
 isSignup ()
 
 load ( $subPage)
 Load data from request.
 
 logAuthResult ( $success, $status=null)
 Logs to the authmanager-stats channel.
 
 mainLoginForm (array $requests, $msg='', $msgtype='error')
 
 makeLanguageSelector ()
 Produce a bar of links which allow the user to select another language during login/registration but retain "returnto".
 
 makeLanguageSelectorLink ( $text, $lang)
 Create a language selector link for a particular language Links back to this page preserving type and returnto.
 
 postProcessFormDescriptor (&$formDescriptor, $requests)
 
 setRequest (array $data, $wasPosted=null)
 Override the POST data, GET data from the real request is preserved.
 
 showExtraInformation ()
 Show extra information such as password recovery information, link from login to signup, CTA etc? Such information should only be shown on the "landing page", ie.
 
 showSuccessPage ( $type, $title, $msgname, $injected_html, $extraMessages)
 Show the success page.
 
 successfulAction ( $direct=false, $extraMessages=null)
 
- Protected Member Functions inherited from MediaWiki\SpecialPage\AuthManagerSpecialPage
 addTabIndex (&$formDescriptor)
 Adds a sequential tabindex starting from 1 to all form elements.
 
 displayForm ( $status)
 Display the form.
 
 fieldInfoToFormDescriptor (array $requests, array $fieldInfo, $action)
 Turns a field info array into a form descriptor.
 
 getAuthFormDescriptor ( $requests, $action)
 Generates a HTMLForm descriptor array from a set of authentication requests.
 
 getContinueAction ( $action)
 Gets the _CONTINUE version of an action.
 
 getDefaultAction ( $subPage)
 Get the default action for this special page if none is given via URL/POST data.
 
 getLoginSecurityLevel ()
 
 getRequestBlacklist ()
 Allows blacklisting certain request types.
 
 getToken ()
 Returns the CSRF token.
 
 handleReauthBeforeExecute ( $subPage)
 Handle redirection when the user needs to (re)authenticate.
 
 handleReturnBeforeExecute ( $subPage)
 Handle redirection from the /return subpage.
 
 hasOwnSubmitButton (AuthenticationRequest $req)
 Checks whether the given AuthenticationRequest has its own submit button.
 
 isActionAllowed ( $action)
 Checks whether AuthManager is ready to perform the action.
 
 isContinued ()
 Returns true if this is not the first step of the authentication.
 
 loadAuth ( $subPage, $authAction=null, $reset=false)
 Load or initialize $authAction, $authRequests and $subPage.
 
 messageKey ( $defaultKey)
 Return custom message key.
 
 needsSubmitButton (array $requests)
 Returns true if the form built from the given AuthenticationRequests needs a submit button.
 
 performAuthenticationStep ( $action, array $requests)
 
 trySubmit ()
 Attempts to do an authentication step with the submitted data.
 
- Protected Member Functions inherited from MediaWiki\SpecialPage\SpecialPage
 addFeedLinks ( $params)
 Adds RSS/atom links.
 
 afterExecute ( $subPage)
 Gets called after.
 
 authorizeAction (?string $action=null)
 Utility function for authorizing an action to be performed by the special page.
 
 buildPrevNextNavigation ( $offset, $limit, array $query=[], $atend=false, $subpage=false)
 Generate (prev x| next x) (20|50|100...) type links for paging.
 
 checkLoginSecurityLevel ( $level=null)
 Verifies that the user meets the security level, possibly reauthenticating them in the process.
 
 displayRestrictionError ()
 Output an error message telling the user what access level they have to have.
 
 getAuthManager ()
 
 getCacheTTL ()
 
 getHookContainer ()
 
 getHookRunner ()
 
 getRobotPolicy ()
 Return the robot policy.
 
 getSpecialPageFactory ()
 
 getSubpagesForPrefixSearch ()
 Return an array of subpages that this special page will accept for prefix searches.
 
 outputHeader ( $summaryMessageKey='')
 Outputs a summary message on top of special pages By default the message key is the canonical name of the special page May be overridden, i.e.
 
 prefixSearchString ( $search, $limit, $offset, SearchEngineFactory $searchEngineFactory=null)
 Perform a regular substring search for prefixSearchSubpages.
 
 setAuthManager (AuthManager $authManager)
 Set the injected AuthManager from the special page constructor.
 
 setHeaders ()
 Sets headers - this should be called from the execute() method of all derived classes!
 
 setReauthPostData (array $data)
 Record preserved POST data after a reauthentication.
 
 useTransactionalTimeLimit ()
 Call wfTransactionalTimeLimit() if this request was POSTed.
 

Protected Attributes

HTMLForm null $authForm
 
 $mAction
 
 $mDisplay = 'page'
 
 $mEntryError = ''
 
 $mEntryErrorType = 'error'
 
 $mFromHTTP
 
 $mLoaded = false
 
 $mLoadedRequest = false
 
 $mPosted
 
string string $mReturnTo
 The title of the page to return to after authentication finishes, or the empty string when there is no return target.
 
string string $mReturnToAnchor
 The fragment part of the URL to return to after authentication finishes.
 
string string $mReturnToQuery
 The query string part of the URL to return to after authentication finishes.
 
 $mSecureLoginUrl
 
 $mStickHTTPS
 
 $mToken
 
bool $proxyAccountCreation
 True if the user if creating an account for someone else.
 
string $securityLevel
 
User $targetUser
 FIXME another flag for passing data.
 
- Protected Attributes inherited from MediaWiki\SpecialPage\AuthManagerSpecialPage
string $authAction
 one of the AuthManager::ACTION_* constants.
 
AuthenticationRequest[] $authRequests
 
bool $isReturn
 True if the current request is a result of returning from a redirect flow.
 
WebRequest null $savedRequest
 If set, will be used instead of the real request.
 
string $subPage
 Subpage of the special page.
 
- Protected Attributes inherited from MediaWiki\SpecialPage\SpecialPage
IContextSource $mContext
 Current request context.
 
bool $mIncludable
 Whether the special page can be included in an article.
 
bool $mIncluding
 Whether or not this special page is being included from an article.
 
string $mName
 The canonical name of this special page Also used as the message key for the default.
 
string $mRestriction
 Minimum user level required to access this page, or "" for anyone.
 

Additional Inherited Members

- Static Public Member Functions inherited from MediaWiki\SpecialPage\SpecialPage
static getSafeTitleFor ( $name, $subpage=false)
 Get a localised Title object for a page name with a possibly unvalidated subpage.
 
static getTitleFor ( $name, $subpage=false, $fragment='')
 Get a localised Title object for a specified special page name If you don't need a full Title object, consider using TitleValue through getTitleValueFor() below.
 
static getTitleValueFor ( $name, $subpage=false, $fragment='')
 Get a localised TitleValue object for a specified special page name.
 
static newSearchPage (User $user)
 Get the users preferred search page.
 
- Static Protected Member Functions inherited from MediaWiki\SpecialPage\AuthManagerSpecialPage
static getField (array $array, $fieldName, $default=null)
 Get an array value, or a default if it does not exist.
 
static mapFieldInfoTypeToFormDescriptorType ( $type)
 Maps AuthenticationRequest::getFieldInfo() types to HTMLForm types.
 
static mapSingleFieldInfo ( $singleFieldInfo, $fieldName)
 Maps an authentication field configuration for a single field (as returned by AuthenticationRequest::getFieldInfo()) to a HTMLForm field descriptor.
 
static mergeDefaultFormDescriptor (array $fieldInfo, array $formDescriptor, array $defaultFormDescriptor)
 Apply defaults to a form descriptor, without creating non-existent fields.
 
static sortFormDescriptorFields (array &$formDescriptor)
 Sort the fields of a form descriptor by their 'weight' property.
 
- Static Protected Member Functions inherited from MediaWiki\SpecialPage\SpecialPage
static prefixSearchArray ( $search, $limit, array $subpages, $offset)
 Helper function for implementations of prefixSearchSubpages() that filter the values in memory (as opposed to making a query).
 
- Static Protected Attributes inherited from MediaWiki\SpecialPage\AuthManagerSpecialPage
static string[] $allowedActions
 The list of actions this special page deals with.
 
static array $messages = []
 Customized messages.
 

Detailed Description

Holds shared logic for login and account creation pages.

Definition at line 61 of file LoginSignupSpecialPage.php.

Member Function Documentation

◆ beforeExecute()

MediaWiki\SpecialPage\LoginSignupSpecialPage::beforeExecute ( $subPage)
protected
Stability: stable
to override
Parameters
string | null$subPage
Returns
bool|void

Reimplemented from MediaWiki\SpecialPage\AuthManagerSpecialPage.

Reimplemented in MediaWiki\Specials\SpecialUserLogin.

Definition at line 255 of file LoginSignupSpecialPage.php.

References MediaWiki\SpecialPage\AuthManagerSpecialPage\$subPage.

◆ execute()

MediaWiki\SpecialPage\LoginSignupSpecialPage::execute ( $subPage)
Parameters
string | null$subPage

Reimplemented from MediaWiki\SpecialPage\SpecialPage.

Definition at line 265 of file LoginSignupSpecialPage.php.

References MediaWiki\SpecialPage\LoginSignupSpecialPage\$mFromHTTP, MediaWiki\SpecialPage\AuthManagerSpecialPage\$subPage, $url, MediaWiki\SpecialPage\SpecialPage\checkPermissions(), MediaWiki\SpecialPage\SpecialPage\getAuthManager(), MediaWiki\SpecialPage\SpecialPage\getConfig(), MediaWiki\SpecialPage\SpecialPage\getContext(), MediaWiki\SpecialPage\AuthManagerSpecialPage\getContinueAction(), MediaWiki\SpecialPage\AuthManagerSpecialPage\getDefaultAction(), MediaWiki\SpecialPage\SpecialPage\getFullTitle(), MediaWiki\MediaWikiServices\getInstance(), MediaWiki\SpecialPage\SpecialPage\getOutput(), MediaWiki\SpecialPage\SpecialPage\getPageTitle(), MediaWiki\SpecialPage\LoginSignupSpecialPage\getPreservedParams(), MediaWiki\SpecialPage\AuthManagerSpecialPage\getRequest(), MediaWiki\SpecialPage\AuthManagerSpecialPage\getToken(), MediaWiki\SpecialPage\LoginSignupSpecialPage\getTokenName(), MediaWiki\SpecialPage\SpecialPage\getUser(), MediaWiki\SpecialPage\AuthManagerSpecialPage\isActionAllowed(), MediaWiki\SpecialPage\LoginSignupSpecialPage\isSignup(), MediaWiki\SpecialPage\LoginSignupSpecialPage\load(), MediaWiki\SpecialPage\AuthManagerSpecialPage\loadAuth(), MediaWiki\SpecialPage\LoginSignupSpecialPage\logAuthResult(), MediaWiki\SpecialPage\LoginSignupSpecialPage\mainLoginForm(), PROTO_HTTPS, MediaWiki\MainConfigNames\SecureLogin, MediaWiki\SpecialPage\SpecialPage\setContext(), MediaWiki\SpecialPage\SpecialPage\setHeaders(), MediaWiki\SpecialPage\LoginSignupSpecialPage\setRequest(), MediaWiki\SpecialPage\LoginSignupSpecialPage\successfulAction(), MediaWiki\SpecialPage\AuthManagerSpecialPage\trySubmit(), and wfAppendQuery().

◆ getAuthForm()

MediaWiki\SpecialPage\LoginSignupSpecialPage::getAuthForm ( array $requests,
$action )
protected

Generates a form from the given request.

Parameters
AuthenticationRequest[]$requests
string$actionAuthManager action name
Returns
HTMLForm

Reimplemented from MediaWiki\SpecialPage\AuthManagerSpecialPage.

Definition at line 754 of file LoginSignupSpecialPage.php.

References MediaWiki\MainConfigNames\ForceHTTPS, getContext(), getRequest(), and MediaWiki\MainConfigNames\SecureLogin.

Referenced by MediaWiki\SpecialPage\LoginSignupSpecialPage\mainLoginForm().

◆ getBenefitsContainerHtml()

MediaWiki\SpecialPage\LoginSignupSpecialPage::getBenefitsContainerHtml ( )
protected

The HTML to be shown in the "benefits to signing in / creating an account" section of the signup/login page.

Stability: unstable
Experimental method added in 1.38. As noted in the comment from 2015 for getPageHtml, this should use a template.
Returns
string

Definition at line 668 of file LoginSignupSpecialPage.php.

References MediaWiki\SpecialPage\SpecialPage\getOutput(), MediaWiki\SpecialPage\SpecialPage\getUser(), and MediaWiki\SpecialPage\SpecialPage\msg().

Referenced by MediaWiki\SpecialPage\LoginSignupSpecialPage\getPageHtml().

◆ getFieldDefinitions()

MediaWiki\SpecialPage\LoginSignupSpecialPage::getFieldDefinitions ( array $fieldInfo)
protected

◆ getGroupName()

MediaWiki\SpecialPage\LoginSignupSpecialPage::getGroupName ( )
protected

Under which header this special page is listed in Special:SpecialPages See messages 'specialpages-group-*' for valid names This method defaults to group 'other'.

Stability: stable
to override
Returns
string
Since
1.21

Reimplemented from MediaWiki\SpecialPage\SpecialPage.

Reimplemented in MediaWiki\Specials\SpecialCreateAccount, and MediaWiki\Specials\SpecialUserLogin.

Definition at line 1259 of file LoginSignupSpecialPage.php.

◆ getNoticeHtml()

MediaWiki\SpecialPage\LoginSignupSpecialPage::getNoticeHtml ( )
protected

Generates the HTML for a notice box to be displayed to a temporary user.

Returns
string HTML representing the notice box

Definition at line 1311 of file LoginSignupSpecialPage.php.

References getUser().

Referenced by MediaWiki\SpecialPage\LoginSignupSpecialPage\getPageHtml().

◆ getPageHtml()

◆ getPreservedParams()

MediaWiki\SpecialPage\LoginSignupSpecialPage::getPreservedParams ( $options = [])
protected

Returns URL query parameters which should be preserved between authentication requests.These should be used when generating links such as form submit or language switch.These parameters will be preserved in:

  • successive authentication steps (the form submit URL and the return URL for redirecting providers);
  • links that reload the same form somehow (e.g. language switcher links);
  • links for switching between the login and create account forms.
Stability: stable
to override
Parameters
array$options(since 1.43)
  • reset (bool, default false): Reset the authentication process, i.e. omit parameters which are related to continuing in-progress authentication.
  • withToken (bool, default false): Include CSRF token Before 1.43, this was a boolean flag identical to the current 'withToken' option. That usage is deprecated.
Returns
array Array of parameter name => parameter value.

Reimplemented from MediaWiki\SpecialPage\AuthManagerSpecialPage.

Definition at line 225 of file LoginSignupSpecialPage.php.

References MediaWiki\SpecialPage\LoginSignupSpecialPage\$mDisplay, $params, MediaWiki\SpecialPage\SpecialPage\getConfig(), MediaWiki\SpecialPage\LoginSignupSpecialPage\isSignup(), and MediaWiki\MainConfigNames\SecureLogin.

Referenced by MediaWiki\SpecialPage\LoginSignupSpecialPage\execute(), and MediaWiki\SpecialPage\LoginSignupSpecialPage\load().

◆ getTokenName()

MediaWiki\SpecialPage\LoginSignupSpecialPage::getTokenName ( )
protected

Returns the name of the CSRF token (under which it should be found in the POST or GET data).

Stability: stable
to override
Returns
string

Reimplemented from MediaWiki\SpecialPage\AuthManagerSpecialPage.

Reimplemented in MediaWiki\Specials\SpecialCreateAccount, and MediaWiki\Specials\SpecialUserLogin.

Definition at line 1200 of file LoginSignupSpecialPage.php.

Referenced by MediaWiki\SpecialPage\LoginSignupSpecialPage\execute(), and MediaWiki\SpecialPage\LoginSignupSpecialPage\load().

◆ hasSessionCookie()

MediaWiki\SpecialPage\LoginSignupSpecialPage::hasSessionCookie ( )
protected

Check if a session cookie is present.

This will not pick up a cookie set during this request, but is meant to ensure that the client is returning the cookie which was set on a previous pass through the system.

Returns
bool

Definition at line 1181 of file LoginSignupSpecialPage.php.

References $wgInitialSessionId, and getRequest().

Referenced by MediaWiki\Specials\SpecialCreateAccount\successfulAction(), and MediaWiki\Specials\SpecialUserLogin\successfulAction().

◆ isSignup()

◆ load()

◆ logAuthResult()

MediaWiki\SpecialPage\LoginSignupSpecialPage::logAuthResult ( $success,
$status = null )
abstractprotected

Logs to the authmanager-stats channel.

Parameters
bool$success
string | null$statusError message key

Reimplemented in MediaWiki\Specials\SpecialCreateAccount, and MediaWiki\Specials\SpecialUserLogin.

Referenced by MediaWiki\SpecialPage\LoginSignupSpecialPage\execute().

◆ mainLoginForm()

MediaWiki\SpecialPage\LoginSignupSpecialPage::mainLoginForm ( array $requests,
$msg = '',
$msgtype = 'error' )
protected

◆ makeLanguageSelector()

MediaWiki\SpecialPage\LoginSignupSpecialPage::makeLanguageSelector ( )
protected

Produce a bar of links which allow the user to select another language during login/registration but retain "returnto".

Returns
string

Definition at line 1210 of file LoginSignupSpecialPage.php.

Referenced by MediaWiki\SpecialPage\LoginSignupSpecialPage\getPageHtml().

◆ makeLanguageSelectorLink()

MediaWiki\SpecialPage\LoginSignupSpecialPage::makeLanguageSelectorLink ( $text,
$lang )
protected

Create a language selector link for a particular language Links back to this page preserving type and returnto.

Parameters
string$textLink text
string$langLanguage code
Returns
string

Definition at line 1237 of file LoginSignupSpecialPage.php.

References MediaWiki\MediaWikiServices\getInstance().

◆ onAuthChangeFormFields()

MediaWiki\SpecialPage\LoginSignupSpecialPage::onAuthChangeFormFields ( array $requests,
array $fieldInfo,
array & $formDescriptor,
$action )

Change the form descriptor that determines how a field will look in the authentication form.Called from fieldInfoToFormDescriptor().

Stability: stable
to override
Parameters
AuthenticationRequest[]$requests
array$fieldInfoField information array (union of all AuthenticationRequest::getFieldInfo() responses).
array&$formDescriptorHTMLForm descriptor. The special key 'weight' can be set to change the order of the fields.
string$actionAuthentication type (one of the AuthManager::ACTION_* constants)

Reimplemented from MediaWiki\SpecialPage\AuthManagerSpecialPage.

Definition at line 807 of file LoginSignupSpecialPage.php.

◆ postProcessFormDescriptor()

MediaWiki\SpecialPage\LoginSignupSpecialPage::postProcessFormDescriptor ( & $formDescriptor,
$requests )
protected
Parameters
array&$formDescriptor
array$requests

Definition at line 1267 of file LoginSignupSpecialPage.php.

References getRequest(), and getUser().

◆ setRequest()

MediaWiki\SpecialPage\LoginSignupSpecialPage::setRequest ( array $data,
$wasPosted = null )
protected

Override the POST data, GET data from the real request is preserved.

Used to preserve POST data over a HTTP redirect.

Stability: stable
to override
Parameters
array$data
bool | null$wasPosted

Reimplemented from MediaWiki\SpecialPage\AuthManagerSpecialPage.

Definition at line 129 of file LoginSignupSpecialPage.php.

Referenced by MediaWiki\SpecialPage\LoginSignupSpecialPage\execute().

◆ showExtraInformation()

MediaWiki\SpecialPage\LoginSignupSpecialPage::showExtraInformation ( )
protected

Show extra information such as password recovery information, link from login to signup, CTA etc? Such information should only be shown on the "landing page", ie.

when the user is at the first step of the authentication process.

Returns
bool

Definition at line 820 of file LoginSignupSpecialPage.php.

Referenced by MediaWiki\SpecialPage\LoginSignupSpecialPage\getPageHtml().

◆ showSuccessPage()

MediaWiki\SpecialPage\LoginSignupSpecialPage::showSuccessPage ( $type,
$title,
$msgname,
$injected_html,
$extraMessages )
protected

Show the success page.

Parameters
string$typeCondition of return to; see executeReturnTo
string | Message$titlePage's title
string$msgname
string$injected_html
StatusValue | null$extraMessages

Definition at line 510 of file LoginSignupSpecialPage.php.

References MediaWiki\SpecialPage\SpecialPage\getContext(), MediaWiki\SpecialPage\SpecialPage\getName(), MediaWiki\SpecialPage\SpecialPage\getOutput(), MediaWiki\SpecialPage\SpecialPage\getUser(), wfDeprecated(), and wfEscapeWikiText().

Referenced by MediaWiki\Specials\SpecialCreateAccount\successfulAction(), and MediaWiki\Specials\SpecialUserLogin\successfulAction().

◆ successfulAction()

MediaWiki\SpecialPage\LoginSignupSpecialPage::successfulAction ( $direct = false,
$extraMessages = null )
abstractprotected
Parameters
bool$directTrue if the action was successful just now; false if that happened pre-redirection (so this handler was called already)
StatusValue | null$extraMessages
Returns
void

Reimplemented in MediaWiki\Specials\SpecialCreateAccount, and MediaWiki\Specials\SpecialUserLogin.

Referenced by MediaWiki\SpecialPage\LoginSignupSpecialPage\execute().

Member Data Documentation

◆ $authForm

HTMLForm null MediaWiki\SpecialPage\LoginSignupSpecialPage::$authForm
protected

◆ $mAction

MediaWiki\SpecialPage\LoginSignupSpecialPage::$mAction
protected

Definition at line 86 of file LoginSignupSpecialPage.php.

◆ $mDisplay

MediaWiki\SpecialPage\LoginSignupSpecialPage::$mDisplay = 'page'
protected

◆ $mEntryError

MediaWiki\SpecialPage\LoginSignupSpecialPage::$mEntryError = ''
protected

Definition at line 90 of file LoginSignupSpecialPage.php.

◆ $mEntryErrorType

MediaWiki\SpecialPage\LoginSignupSpecialPage::$mEntryErrorType = 'error'
protected

Definition at line 91 of file LoginSignupSpecialPage.php.

◆ $mFromHTTP

MediaWiki\SpecialPage\LoginSignupSpecialPage::$mFromHTTP
protected

◆ $mLoaded

MediaWiki\SpecialPage\LoginSignupSpecialPage::$mLoaded = false
protected

Definition at line 94 of file LoginSignupSpecialPage.php.

◆ $mLoadedRequest

MediaWiki\SpecialPage\LoginSignupSpecialPage::$mLoadedRequest = false
protected

Definition at line 95 of file LoginSignupSpecialPage.php.

◆ $mPosted

MediaWiki\SpecialPage\LoginSignupSpecialPage::$mPosted
protected

Definition at line 85 of file LoginSignupSpecialPage.php.

◆ $mReturnTo

string string MediaWiki\SpecialPage\LoginSignupSpecialPage::$mReturnTo
protected

The title of the page to return to after authentication finishes, or the empty string when there is no return target.

Typically comes from the 'returnto' URL parameter. Validating and normalizing is the caller's responsibility.

Definition at line 70 of file LoginSignupSpecialPage.php.

◆ $mReturnToAnchor

string string MediaWiki\SpecialPage\LoginSignupSpecialPage::$mReturnToAnchor
protected

The fragment part of the URL to return to after authentication finishes.

When not empty, should include the '#' character. Typically comes from the 'returntoanchor' URL parameter.

Definition at line 83 of file LoginSignupSpecialPage.php.

◆ $mReturnToQuery

string string MediaWiki\SpecialPage\LoginSignupSpecialPage::$mReturnToQuery
protected

The query string part of the URL to return to after authentication finishes.

Typically comes from the 'returntoquery' URL parameter.

Definition at line 76 of file LoginSignupSpecialPage.php.

◆ $mSecureLoginUrl

MediaWiki\SpecialPage\LoginSignupSpecialPage::$mSecureLoginUrl
protected

Definition at line 96 of file LoginSignupSpecialPage.php.

◆ $mStickHTTPS

MediaWiki\SpecialPage\LoginSignupSpecialPage::$mStickHTTPS
protected

Definition at line 88 of file LoginSignupSpecialPage.php.

◆ $mToken

MediaWiki\SpecialPage\LoginSignupSpecialPage::$mToken
protected

Definition at line 87 of file LoginSignupSpecialPage.php.

◆ $proxyAccountCreation

bool MediaWiki\SpecialPage\LoginSignupSpecialPage::$proxyAccountCreation
protected

True if the user if creating an account for someone else.

Flag used for internal communication, only set at the very end.

Definition at line 105 of file LoginSignupSpecialPage.php.

◆ $securityLevel

string MediaWiki\SpecialPage\LoginSignupSpecialPage::$securityLevel
protected

◆ $targetUser

User MediaWiki\SpecialPage\LoginSignupSpecialPage::$targetUser
protected

FIXME another flag for passing data.

Definition at line 107 of file LoginSignupSpecialPage.php.


The documentation for this class was generated from the following file: