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

Inheritance diagram for LoginSignupSpecialPage:

[legend]

Collaboration diagram for LoginSignupSpecialPage:

[legend]

Public Member Functions
	__construct ( $name)

	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. More...

	showReturnToPage ( $type, $returnTo='', $returnToQuery='', $stickHTTPS=false)
	Add a "return to" link or redirect to it. More...

Public Member Functions inherited from AuthManagerSpecialPage
	getRequest ()
	Get the WebRequest being used for this instance. More...

	handleFormSubmit ( $data)
	Submit handler callback for HTMLForm. More...

Public Member Functions inherited from 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. More...

	addHelpLink ( $to, $overrideBaseUrl=false)
	Adds help link with an icon via page indicators. More...

	checkPermissions ()
	Checks if userCanExecute, and if not throws a PermissionsError. More...

	checkReadOnly ()
	If the wiki is currently in readonly mode, throws a ReadOnlyError. More...

	displayRestrictionError ()
	Output an error message telling the user what access level they have to have. More...

	doesWrites ()
	Indicates whether this special page may perform database writes. More...

	getConfig ()
	Shortcut to get main config object. More...

	getContext ()
	Gets the context this SpecialPage is executed in. More...

	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. More...

	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. More...

	getFullTitle ()
	Return the full title, including $par. More...

	getLanguage ()
	Shortcut to get user's language. More...

	getLinkRenderer ()

	getLocalName ()
	Get the localised name of the special page. More...

	getName ()
	Get the name of this Special Page. More...

	getOutput ()
	Get the OutputPage being used for this instance. More...

	getPageTitle ( $subpage=false)
	Get a self-referential title object. More...

	getRestriction ()
	Get the permission that a user must have to execute this page. More...

	getSkin ()
	Shortcut to get the skin being used for this instance. More...

	getTitle ( $subpage=false)
	Get a self-referential title object. More...

	getUser ()
	Shortcut to get the User executing this instance. More...

	including ( $x=null)
	Whether the special page is being evaluated via transclusion. More...

	isCached ()
	Is this page cached? Expensive pages are cached or disabled in miser mode. More...

	isExpensive ()
	Is this page expensive (for some definition of expensive)? Expensive pages are disabled or cached in miser mode. More...

	isIncludable ()
	Whether it's allowed to transclude the special page via {{Special:Foo/params}}. More...

	isListed ()
	Whether this special page is listed in Special:SpecialPages. More...

	isRestricted ()
	Can be overridden by subclasses with more complicated permissions schemes. More...

	listed ( $x=null)
	Get or set whether this special page is listed in Special:SpecialPages. More...

	maxIncludeCacheTime ()
	How long to cache page when it is being included. More...

	msg ( $key)
	Wrapper around wfMessage that sets the current context. More...

	outputHeader ( $summaryMessageKey='')
	Outputs a summary message on top of special pages Per default the message key is the canonical name of the special page May be overridden, i.e. More...

	prefixSearchSubpages ( $search, $limit, $offset)
	Return an array of subpages beginning with $search that this special page will accept. More...

	requireLogin ( $reasonMsg='exception-nologin-text', $titleMsg='exception-nologin')
	If the user is not logged in, throws UserNotLoggedIn error. More...

	run ( $subPage)
	Entry point. More...

	setContext ( $context)
	Sets the context this SpecialPage is executed in. More...

	setHeaders ()
	Sets headers - this should be called from the execute() method of all derived classes! More...

	setLinkRenderer (LinkRenderer $linkRenderer)

	setListed ( $listed)
	Set whether this page is listed in Special:Specialpages, at run-time. More...

	userCanExecute (User $user)
	Checks if the given user (identified by an object) can execute this special page (as defined by $mRestriction). More...

Protected Member Functions
	beforeExecute ( $subPage)
	Gets called before. More...

	getAuthForm (array $requests, $action, $msg='', $msgType='error')
	Generates a form from the given request. More...

	getBCFieldDefinitions ( $fieldDefinitions, $template)
	Adds fields provided via the deprecated UserLoginForm / UserCreateForm hooks. More...

	getFakeTemplate ( $msg, $msgType)
	Temporary B/C method to handle extensions using the UserLoginForm/UserCreateForm hooks. More...

	getFieldDefinitions ( $template)
	Create a HTMLForm descriptor for the core login fields. More...

	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'. More...

	getPageHtml ( $formHtml)
	Add page elements which are outside the form. More...

	getPreservedParams ( $withToken=false)
	Returns URL query parameters which can be used to reload the page (or leave and return) while preserving all information that is necessary for authentication to continue. More...

	getReturnToQueryStringFragment ()
	Returns a string that can be appended to the URL (without encoding) to preserve the return target. More...

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

	hasSessionCookie ()
	Check if a session cookie is present. More...

	isSignup ()

	load ( $subPage)
	Load data from request. More...

	logAuthResult ( $success, $status=null)
	Logs to the authmanager-stats channel. More...

	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". More...

	makeLanguageSelectorLink ( $text, $lang)
	Create a language selector link for a particular language Links back to this page preserving type and returnto. More...

	postProcessFormDescriptor (&$formDescriptor, $requests)

	setRequest (array $data, $wasPosted=null)
	Override the POST data, GET data from the real request is preserved. More...

	setSessionUserForCurrentRequest ()
	Replace some globals to make sure the fact that the user has just been logged in is reflected in the current request. More...

	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. More...

	showSuccessPage ( $type, $title, $msgname, $injected_html, $extraMessages)
	Show the success page. More...

	successfulAction ( $direct=false, $extraMessages=null)

Protected Member Functions inherited from AuthManagerSpecialPage
	addTabIndex (&$formDescriptor)
	Adds a sequential tabindex starting from 1 to all form elements. More...

	displayForm ( $status)
	Display the form. More...

	fieldInfoToFormDescriptor (array $requests, array $fieldInfo, $action)
	Turns a field info array into a form descriptor. More...

	getAuthForm (array $requests, $action)

	getAuthFormDescriptor ( $requests, $action)
	Generates a HTMLForm descriptor array from a set of authentication requests. More...

	getContinueAction ( $action)
	Gets the _CONTINUE version of an action. More...

	getDefaultAction ( $subPage)
	Get the default action for this special page, if none is given via URL/POST data. More...

	getLoginSecurityLevel ()
	Tells if the special page does something security-sensitive and needs extra defense against a stolen account (e.g. More...

	getRequestBlacklist ()
	Allows blacklisting certain request types. More...

	getToken ()
	Returns the CSRF token. More...

	handleReauthBeforeExecute ( $subPage)
	Handle redirection when the user needs to (re)authenticate. More...

	handleReturnBeforeExecute ( $subPage)
	Handle redirection from the /return subpage. More...

	hasOwnSubmitButton (AuthenticationRequest $req)
	Checks whether the given AuthenticationRequest has its own submit button. More...

	isActionAllowed ( $action)
	Checks whether AuthManager is ready to perform the action. More...

	isContinued ()
	Returns true if this is not the first step of the authentication. More...

	loadAuth ( $subPage, $authAction=null, $reset=false)
	Load or initialize $authAction, $authRequests and $subPage. More...

	messageKey ( $defaultKey)
	Return custom message key. More...

	needsSubmitButton (array $requests)
	Returns true if the form built from the given AuthenticationRequests needs a submit button. More...

	performAuthenticationStep ( $action, array $requests)

	trySubmit ()
	Attempts to do an authentication step with the submitted data. More...

Protected Member Functions inherited from SpecialPage
	addFeedLinks ( $params)
	Adds RSS/atom links. More...

	afterExecute ( $subPage)
	Gets called after. More...

	checkLoginSecurityLevel ( $level=null)
	Verifies that the user meets the security level, possibly reauthenticating them in the process. More...

	getCacheTTL ()

	getRobotPolicy ()
	Return the robot policy. More...

	getSubpagesForPrefixSearch ()
	Return an array of subpages that this special page will accept for prefix searches. More...

	prefixSearchString ( $search, $limit, $offset)
	Perform a regular substring search for prefixSearchSubpages. More...

	setReauthPostData (array $data)
	Record preserved POST data after a reauthentication. More...

	useTransactionalTimeLimit ()
	Call wfTransactionalTimeLimit() if this request was POSTed. More...

Protected Attributes
HTMLForm	$authForm

FakeAuthTemplate	$fakeTemplate

	$mAction

	$mEntryError = ''

	$mEntryErrorType = 'error'

	$mFromHTTP

	$mLanguage

	$mLoaded = false

	$mLoadedRequest = false

	$mPosted

	$mReturnTo

	$mReturnToQuery

	$mSecureLoginUrl

	$mStickHTTPS

	$mToken

bool	$proxyAccountCreation
	True if the user if creating an account for someone else. More...

string	$securityLevel

User	$targetUser
	FIXME another flag for passing data. More...

Protected Attributes inherited from AuthManagerSpecialPage
string	$authAction
	one of the AuthManager::ACTION_* constants. More...

AuthenticationRequest[]	$authRequests

bool	$isReturn
	True if the current request is a result of returning from a redirect flow. More...

WebRequest null	$savedRequest
	If set, will be used instead of the real request. More...

string	$subPage
	Subpage of the special page. More...

Protected Attributes inherited from SpecialPage
IContextSource	$mContext
	Current request context. More...

	$mIncludable

	$mIncluding

	$mName

	$mRestriction

Private Member Functions
	canBypassForm (&$button_name)
	Determine if the login form can be bypassed. More...

	loadRequestParameters ( $subPage)
	Load basic request parameters for this Special page. More...

	showCreateAccountLink ()
	Whether the login/create account form should display a link to the other form (in addition to whatever the skin provides). More...

Additional Inherited Members
Static Public Member Functions inherited from SpecialPage
static	getSafeTitleFor ( $name, $subpage=false)
	Get a localised Title object for a page name with a possibly unvalidated subpage. More...

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. More...

static	getTitleValueFor ( $name, $subpage=false, $fragment='')
	Get a localised TitleValue object for a specified special page name. More...

Static Protected Member Functions inherited from AuthManagerSpecialPage
static	getField (array $array, $fieldName, $default=null)
	Get an array value, or a default if it does not exist. More...

static	mapFieldInfoTypeToFormDescriptorType ( $type)
	Maps AuthenticationRequest::getFieldInfo() types to HTMLForm types. More...

static	mapSingleFieldInfo ( $singleFieldInfo, $fieldName)
	Maps an authentication field configuration for a single field (as returned by AuthenticationRequest::getFieldInfo()) to a HTMLForm field descriptor. More...

static	sortFormDescriptorFields (array &$formDescriptor)
	Sort the fields of a form descriptor by their 'weight' property. More...

Static Protected Member Functions inherited from 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). More...

Static Protected Attributes inherited from AuthManagerSpecialPage
static string[]	$allowedActions
	The list of actions this special page deals with. More...

static array	$messages = []
	Customized messages. More...

Detailed Description

Holds shared logic for login and account creation pages.

Definition at line 38 of file LoginSignupSpecialPage.php.

Constructor & Destructor Documentation

◆ __construct()

LoginSignupSpecialPage::__construct ( $name )

Definition at line 86 of file LoginSignupSpecialPage.php.

References $name, and $wgUseMediaWikiUIEverywhere.

Member Function Documentation

◆ beforeExecute()

LoginSignupSpecialPage::beforeExecute ( $subPage )

protected

Gets called before.

See also: SpecialPage::execute. Return false to prevent calling execute() (since 1.27+).

Since: 1.20

Parameters

string | null $subPage

Returns: bool|void

Reimplemented from AuthManagerSpecialPage.

Reimplemented in SpecialUserLogin.

Definition at line 207 of file LoginSignupSpecialPage.php.

References AuthManagerSpecialPage\$subPage, and loadRequestParameters().

◆ canBypassForm()

LoginSignupSpecialPage::canBypassForm ( & $button_name )

private

Determine if the login form can be bypassed.

This will be the case when no more than one button is present and no other user input fields that are not marked as 'skippable' are present. If the login form were not bypassed, the user would be presented with a superfluous page on which they must press the single button to proceed with login. Not only does this cause an additional mouse click and page load, it confuses users, especially since there are a help link and forgotten password link that are provided on the login page that do not apply to this situation.

Parameters

string | null &$button_name if the form has a single button, returns the name of the button; otherwise, returns null

Returns: bool

Definition at line 402 of file LoginSignupSpecialPage.php.

References as, and AuthManagerSpecialPage\isContinued().

Referenced by execute().

◆ execute()

LoginSignupSpecialPage::execute ( $subPage )

Parameters

string | null $subPage

Reimplemented from SpecialPage.

Definition at line 216 of file LoginSignupSpecialPage.php.

References $query, $response, AuthManagerSpecialPage\$subPage, $time, $title, $wgSecureLogin, canBypassForm(), SpecialPage\checkPermissions(), AuthManagerSpecialPage\getContinueAction(), AuthManagerSpecialPage\getDefaultAction(), SpecialPage\getFullTitle(), SpecialPage\getLanguage(), RequestContext\getMain(), SpecialPage\getOutput(), SpecialPage\getPageTitle(), getPreservedParams(), AuthManagerSpecialPage\getRequest(), AuthManagerSpecialPage\getToken(), getTokenName(), SpecialPage\getUser(), AuthManagerSpecialPage\isActionAllowed(), isSignup(), load(), AuthManagerSpecialPage\loadAuth(), logAuthResult(), mainLoginForm(), StatusValue\newFatal(), User\newFromName(), PROTO_HTTPS, SpecialPage\setHeaders(), setRequest(), setSessionUserForCurrentRequest(), successfulAction(), AuthManagerSpecialPage\trySubmit(), use, wfAppendQuery(), and wfCanIPUseHTTPS().

◆ getAuthForm()

LoginSignupSpecialPage::getAuthForm	(	array	$requests,
			$action,
			$msg = `''`,
			$msgType = `'error'`
	)

protected

Generates a form from the given request.

Parameters

AuthenticationRequest[]	$requests
string	$action	AuthManager action name
string \| Message	$msg
string	$msgType

Returns: HTMLForm

Definition at line 650 of file LoginSignupSpecialPage.php.

References $authForm, $context, $fakeTemplate, $formDescriptor, $requests, $wgSecureLogin, HTMLForm\factory(), SpecialPage\getContext(), getFakeTemplate(), SpecialPage\getPageTitle(), AuthManagerSpecialPage\getRequest(), getReturnToQueryStringFragment(), AuthManagerSpecialPage\getToken(), getTokenName(), isSignup(), and postProcessFormDescriptor().

Referenced by mainLoginForm().

◆ getBCFieldDefinitions()

LoginSignupSpecialPage::getBCFieldDefinitions	(	$fieldDefinitions,
		$template
	)

protected

Adds fields provided via the deprecated UserLoginForm / UserCreateForm hooks.

Parameters

array	$fieldDefinitions
FakeAuthTemplate	$template

Returns: array

Definition at line 1201 of file LoginSignupSpecialPage.php.

References $template.

Referenced by getFieldDefinitions().

◆ getFakeTemplate()

LoginSignupSpecialPage::getFakeTemplate	(	$msg,
		$msgType
	)

protected

Temporary B/C method to handle extensions using the UserLoginForm/UserCreateForm hooks.

Parameters

string \| Message	$msg
string	$msgType

Returns: FakeAuthTemplate

Definition at line 710 of file LoginSignupSpecialPage.php.

References $request, $template, $user, $wgAuth, $wgEmailConfirmToEdit, $wgEnableEmail, $wgEnableUserEmail, $wgHiddenPrefs, $wgPasswordResetRoutes, $wgSecureLogin, SpecialPage\getPageTitle(), AuthManagerSpecialPage\getRequest(), SpecialPage\getSkin(), AuthManagerSpecialPage\getToken(), SpecialPage\getUser(), isSignup(), object, Hooks\run(), showCreateAccountLink(), wfDeprecated(), and wfUrlencode().

Referenced by getAuthForm().

◆ getFieldDefinitions()

LoginSignupSpecialPage::getFieldDefinitions ( $template )

protected

Create a HTMLForm descriptor for the core login fields.

Parameters

FakeAuthTemplate $template B/C data (not used but needed by getBCFieldDefinitions)

Returns: array

Definition at line 900 of file LoginSignupSpecialPage.php.

References $params, $template, $value, $wgEmailConfirmToEdit, Html\element(), getBCFieldDefinitions(), SpecialPage\getConfig(), SpecialPage\getLinkRenderer(), AuthManagerSpecialPage\getRequest(), getReturnToQueryStringFragment(), SpecialPage\getTitleFor(), SpecialPage\getUser(), AuthManagerSpecialPage\isContinued(), isSignup(), Skin\makeInternalOrExternalUrl(), SpecialPage\msg(), Html\rawElement(), showCreateAccountLink(), showExtraInformation(), text, and use.

Referenced by onAuthChangeFormFields().

◆ getGroupName()

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'.

Returns: string

Since: 1.21

Reimplemented from SpecialPage.

Reimplemented in SpecialCreateAccount, and SpecialUserLogin.

Definition at line 1333 of file LoginSignupSpecialPage.php.

◆ getPageHtml()

LoginSignupSpecialPage::getPageHtml ( $formHtml )

protected

Add page elements which are outside the form.

FIXME this should probably be a template, but use a sane language (handlebars?)

Parameters

string $formHtml

Returns: string

Definition at line 586 of file LoginSignupSpecialPage.php.

References $html, $wgLoginLanguageSelector, isSignup(), makeLanguageSelector(), SpecialPage\msg(), Html\rawElement(), and showExtraInformation().

Referenced by mainLoginForm().

◆ getPreservedParams()

LoginSignupSpecialPage::getPreservedParams ( $withToken = false )

protected

Returns URL query parameters which can be used to reload the page (or leave and return) while preserving all information that is necessary for authentication to continue.

These parameters will be preserved in the action URL of the form and in the return URL for redirect flow.

Parameters

bool $withToken Include CSRF token

Returns: array

Reimplemented from AuthManagerSpecialPage.

Definition at line 193 of file LoginSignupSpecialPage.php.

References $params, $wgSecureLogin, and isSignup().

Referenced by execute().

◆ getReturnToQueryStringFragment()

LoginSignupSpecialPage::getReturnToQueryStringFragment ( )

protected

Returns a string that can be appended to the URL (without encoding) to preserve the return target.

Does not include leading '?'/'&'.

Returns: string

Definition at line 1247 of file LoginSignupSpecialPage.php.

References wfUrlencode().

Referenced by getAuthForm(), and getFieldDefinitions().

◆ getTokenName()

LoginSignupSpecialPage::getTokenName ( )

protected

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

Returns: string

Reimplemented from AuthManagerSpecialPage.

Reimplemented in SpecialCreateAccount, and SpecialUserLogin.

Definition at line 1273 of file LoginSignupSpecialPage.php.

References isSignup().

Referenced by execute(), getAuthForm(), and load().

◆ hasSessionCookie()

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 1233 of file LoginSignupSpecialPage.php.

References $wgDisableCookieCheck, $wgInitialSessionId, AuthManagerSpecialPage\getRequest(), and string.

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

◆ isSignup()

LoginSignupSpecialPage::isSignup ( )

abstractprotected

Reimplemented in SpecialCreateAccount, and SpecialUserLogin.

Referenced by execute(), getAuthForm(), getFakeTemplate(), getFieldDefinitions(), getPageHtml(), getPreservedParams(), getTokenName(), mainLoginForm(), postProcessFormDescriptor(), and showCreateAccountLink().

◆ load()

LoginSignupSpecialPage::load ( $subPage )

protected

Load data from request.

Access:\n private

Parameters

string $subPage Subpage of Special:Userlogin

Definition at line 127 of file LoginSignupSpecialPage.php.

References $request, $securityLevel, AuthManagerSpecialPage\$subPage, $wgSecureLogin, SpecialPage\getLinkRenderer(), SpecialPage\getPageTitle(), AuthManagerSpecialPage\getRequest(), getTokenName(), LoginHelper\getValidErrorMessages(), AuthManagerSpecialPage\loadAuth(), loadRequestParameters(), SpecialPage\msg(), Title\newFromText(), text, and true.

Referenced by execute().

◆ loadRequestParameters()

LoginSignupSpecialPage::loadRequestParameters ( $subPage )

private

Load basic request parameters for this Special page.

Parameters

string $subPage

Definition at line 103 of file LoginSignupSpecialPage.php.

References $request, AuthManagerSpecialPage\$subPage, and AuthManagerSpecialPage\getRequest().

Referenced by beforeExecute(), and load().

◆ logAuthResult()

LoginSignupSpecialPage::logAuthResult	(	$success,
		$status = `null`
	)

abstractprotected

Logs to the authmanager-stats channel.

Parameters

bool	$success
string \| null	$status	Error message key

Reimplemented in SpecialCreateAccount, and SpecialUserLogin.

Referenced by execute().

◆ mainLoginForm()

LoginSignupSpecialPage::mainLoginForm	(	array	$requests,
			$msg = `''`,
			$msgtype = `'error'`
	)

protected

Parameters

AuthenticationRequest[]	$requests	A list of AuthorizationRequest objects, used to generate the form fields. An empty array means a fatal error (authentication cannot continue).
string \| Message	$msg
string	$msgtype

Exceptions

ErrorPageError
Exception
FatalError
MWException
PermissionsError
ReadOnlyError

Access:\n private

Definition at line 515 of file LoginSignupSpecialPage.php.

References $out, $requests, $user, getAuthForm(), AuthManagerSpecialPage\getDefaultAction(), SpecialPage\getName(), SpecialPage\getOutput(), getPageHtml(), SpecialPage\getUser(), isSignup(), SpecialPage\msg(), and StatusValue\newGood().

Referenced by execute(), SpecialCreateAccount\successfulAction(), and SpecialUserLogin\successfulAction().

◆ makeLanguageSelector()

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 1283 of file LoginSignupSpecialPage.php.

References $lang, as, captcha-old\count, SpecialPage\getLanguage(), makeLanguageSelectorLink(), and SpecialPage\msg().

Referenced by getPageHtml().

◆ makeLanguageSelectorLink()

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	$text	Link text
string	$lang	Language code

Returns: string

Definition at line 1310 of file LoginSignupSpecialPage.php.

References $lang, $mReturnTo, $mReturnToQuery, $query, Language\factory(), SpecialPage\getLanguage(), SpecialPage\getLinkRenderer(), and SpecialPage\getPageTitle().

Referenced by makeLanguageSelector().

◆ onAuthChangeFormFields()

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().

Parameters

AuthenticationRequest[]	$requests
array	$fieldInfo	Field information array (union of all AuthenticationRequest::getFieldInfo() responses).
array	&$formDescriptor	HTMLForm descriptor. The special key 'weight' can be set to change the order of the fields.
string	$action	Authentication type (one of the AuthManager::ACTION_* constants)

Returns: bool

Reimplemented from AuthManagerSpecialPage.

Definition at line 838 of file LoginSignupSpecialPage.php.

References $formDescriptor, as, and getFieldDefinitions().

◆ postProcessFormDescriptor()

LoginSignupSpecialPage::postProcessFormDescriptor	(	&	$formDescriptor,
			$requests
	)

protected

Parameters

array	&$formDescriptor
array	$requests

Definition at line 1341 of file LoginSignupSpecialPage.php.

References $formDescriptor, $requests, $user, AuthManagerSpecialPage\addTabIndex(), AuthManagerSpecialPage\getRequest(), SpecialPage\getUser(), isSignup(), and AuthManagerSpecialPage\needsSubmitButton().

Referenced by getAuthForm().

◆ setRequest()

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.

Parameters

array	$data
bool \| null	$wasPosted

Reimplemented from AuthManagerSpecialPage.

Definition at line 94 of file LoginSignupSpecialPage.php.

Referenced by execute().

◆ setSessionUserForCurrentRequest()

LoginSignupSpecialPage::setSessionUserForCurrentRequest ( )

protected

Replace some globals to make sure the fact that the user has just been logged in is reflected in the current request.

Definition at line 483 of file LoginSignupSpecialPage.php.

References $context, $user, $wgLang, SpecialPage\getContext(), RequestContext\getMain(), and SpecialPage\setContext().

Referenced by execute().

◆ showCreateAccountLink()

LoginSignupSpecialPage::showCreateAccountLink ( )

private

Whether the login/create account form should display a link to the other form (in addition to whatever the skin provides).

Returns: bool

Definition at line 1263 of file LoginSignupSpecialPage.php.

References SpecialPage\getUser(), and isSignup().

Referenced by getFakeTemplate(), and getFieldDefinitions().

◆ showExtraInformation()

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 890 of file LoginSignupSpecialPage.php.

References $securityLevel, and AuthManagerSpecialPage\getContinueAction().

Referenced by getFieldDefinitions(), and getPageHtml().

◆ showReturnToPage()

LoginSignupSpecialPage::showReturnToPage	(	$type,
		$returnTo = `''`,
		$returnToQuery = `''`,
		$stickHTTPS = `false`
	)

Add a "return to" link or redirect to it.

Extensions can use this to reuse the "return to" logic after inject steps (such as redirection) into the login process.

Parameters

string	$type	One of the following: error: display a return to link ignoring $wgRedirectOnLogin signup: display a return to link using $wgRedirectOnLogin if needed success: display a return to link using $wgRedirectOnLogin if needed successredirect: send an HTTP redirect using $wgRedirectOnLogin if needed
string	$returnTo
array \| string	$returnToQuery
bool	$stickHTTPS	Keep redirect link on HTTPS

Since: 1.22

Definition at line 472 of file LoginSignupSpecialPage.php.

References $type, and SpecialPage\getContext().

◆ showSuccessPage()

LoginSignupSpecialPage::showSuccessPage	(	$type,
		$title,
		$msgname,
		$injected_html,
		$extraMessages
	)

protected

Show the success page.

Parameters

string	$type	Condition of return to; see `executeReturnTo`
string \| Message	$title	Page's title
string	$msgname
string	$injected_html
StatusValue \| null	$extraMessages

Definition at line 438 of file LoginSignupSpecialPage.php.

References $out, $title, $type, SpecialPage\getContext(), SpecialPage\getName(), SpecialPage\getOutput(), SpecialPage\getUser(), wfEscapeWikiText(), and Status\wrap().

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

◆ successfulAction()

LoginSignupSpecialPage::successfulAction	(	$direct = `false`,
		$extraMessages = `null`
	)

abstractprotected

Parameters

bool	$direct	True 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 SpecialUserLogin, and SpecialCreateAccount.

Referenced by execute().

Member Data Documentation

◆ $authForm

HTMLForm LoginSignupSpecialPage::$authForm

protected

Definition at line 64 of file LoginSignupSpecialPage.php.

Referenced by getAuthForm().

◆ $fakeTemplate

FakeAuthTemplate LoginSignupSpecialPage::$fakeTemplate

protected

Definition at line 67 of file LoginSignupSpecialPage.php.

Referenced by getAuthForm().

◆ $mAction

LoginSignupSpecialPage::$mAction

protected

Definition at line 41 of file LoginSignupSpecialPage.php.

◆ $mEntryError

LoginSignupSpecialPage::$mEntryError = ''

protected

Definition at line 47 of file LoginSignupSpecialPage.php.

◆ $mEntryErrorType

LoginSignupSpecialPage::$mEntryErrorType = 'error'

protected

Definition at line 48 of file LoginSignupSpecialPage.php.

◆ $mFromHTTP

LoginSignupSpecialPage::$mFromHTTP

protected

Definition at line 46 of file LoginSignupSpecialPage.php.

◆ $mLanguage

LoginSignupSpecialPage::$mLanguage

protected

Definition at line 42 of file LoginSignupSpecialPage.php.

◆ $mLoaded

LoginSignupSpecialPage::$mLoaded = false

protected

Definition at line 50 of file LoginSignupSpecialPage.php.

◆ $mLoadedRequest

LoginSignupSpecialPage::$mLoadedRequest = false

protected

Definition at line 51 of file LoginSignupSpecialPage.php.

◆ $mPosted

LoginSignupSpecialPage::$mPosted

protected

Definition at line 40 of file LoginSignupSpecialPage.php.

◆ $mReturnTo

LoginSignupSpecialPage::$mReturnTo

protected

Definition at line 39 of file LoginSignupSpecialPage.php.

Referenced by makeLanguageSelectorLink().

◆ $mReturnToQuery

LoginSignupSpecialPage::$mReturnToQuery

protected

Definition at line 43 of file LoginSignupSpecialPage.php.

Referenced by makeLanguageSelectorLink().

◆ $mSecureLoginUrl

LoginSignupSpecialPage::$mSecureLoginUrl

protected

Definition at line 52 of file LoginSignupSpecialPage.php.

◆ $mStickHTTPS

LoginSignupSpecialPage::$mStickHTTPS

protected

Definition at line 45 of file LoginSignupSpecialPage.php.

◆ $mToken

LoginSignupSpecialPage::$mToken

protected

Definition at line 44 of file LoginSignupSpecialPage.php.

◆ $proxyAccountCreation

bool 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 59 of file LoginSignupSpecialPage.php.

◆ $securityLevel

string LoginSignupSpecialPage::$securityLevel

protected

Definition at line 55 of file LoginSignupSpecialPage.php.

Referenced by load(), and showExtraInformation().

◆ $targetUser

User LoginSignupSpecialPage::$targetUser

protected

FIXME another flag for passing data.

Definition at line 61 of file LoginSignupSpecialPage.php.

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

includes/specialpage/LoginSignupSpecialPage.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ beforeExecute()

◆ canBypassForm()

◆ execute()

◆ getAuthForm()

◆ getBCFieldDefinitions()

◆ getFakeTemplate()

◆ getFieldDefinitions()

◆ getGroupName()

◆ getPageHtml()

◆ getPreservedParams()

◆ getReturnToQueryStringFragment()

◆ getTokenName()

◆ hasSessionCookie()

◆ isSignup()

◆ load()

◆ loadRequestParameters()

◆ logAuthResult()

◆ mainLoginForm()

◆ makeLanguageSelector()

◆ makeLanguageSelectorLink()

◆ onAuthChangeFormFields()

◆ postProcessFormDescriptor()

◆ setRequest()

◆ setSessionUserForCurrentRequest()

◆ showCreateAccountLink()

◆ showExtraInformation()

◆ showReturnToPage()

◆ showSuccessPage()

◆ successfulAction()

Member Data Documentation

◆ $authForm

◆ $fakeTemplate

◆ $mAction

◆ $mEntryError

◆ $mEntryErrorType

◆ $mFromHTTP

◆ $mLanguage

◆ $mLoaded

◆ $mLoadedRequest

◆ $mPosted

◆ $mReturnTo

◆ $mReturnToQuery

◆ $mSecureLoginUrl

◆ $mStickHTTPS

◆ $mToken

◆ $proxyAccountCreation

◆ $securityLevel

◆ $targetUser