MediaWiki  1.34.4
MediaWiki\Auth\ButtonAuthenticationRequest Class Reference

This is an authentication request that just implements a simple button. More...

Inheritance diagram for MediaWiki\Auth\ButtonAuthenticationRequest:
Collaboration diagram for MediaWiki\Auth\ButtonAuthenticationRequest:

Public Member Functions

 __construct ( $name, Message $label, Message $help, $required=false)
 
 getFieldInfo ()
 Fetch input field info. More...
 
 getUniqueId ()
 Supply a unique key for deduplication. More...
 
- Public Member Functions inherited from MediaWiki\Auth\AuthenticationRequest
 describeCredentials ()
 Describe the credentials represented by this request. More...
 
 getMetadata ()
 Returns metadata about this request. More...
 
 loadFromSubmission (array $data)
 Initialize form submitted form data. More...
 

Static Public Member Functions

static __set_state ( $data)
 
static getRequestByName (array $reqs, $name)
 Fetch a ButtonAuthenticationRequest or subclass by name. More...
 
- Static Public Member Functions inherited from MediaWiki\Auth\AuthenticationRequest
static getRequestByClass (array $reqs, $class, $allowSubclasses=false)
 Select a request by class name. More...
 
static getUsernameFromRequests (array $reqs)
 Get the username from the set of requests. More...
 
static loadRequestsFromSubmission (array $reqs, array $data)
 Update a set of requests with form submit data, discarding ones that fail. More...
 
static mergeFieldInfo (array $reqs)
 Merge the output of multiple AuthenticationRequest::getFieldInfo() calls. More...
 

Protected Attributes

Message $help
 
Message $label
 
string $name
 

Additional Inherited Members

- Public Attributes inherited from MediaWiki\Auth\AuthenticationRequest
string null $action = null
 The AuthManager::ACTION_* constant this request was created to be used for. More...
 
int $required = self::REQUIRED
 For login, continue, and link actions, one of self::OPTIONAL, self::REQUIRED, or self::PRIMARY_REQUIRED. More...
 
string null $returnToUrl = null
 Return-to URL, in case of redirect. More...
 
string null $username = null
 Username. More...
 
const OPTIONAL = 0
 Indicates that the request is not required for authentication to proceed. More...
 
const PRIMARY_REQUIRED = 2
 Indicates that the request is required by a primary authentication provider. More...
 
const REQUIRED = 1
 Indicates that the request is required for authentication to proceed. More...
 

Detailed Description

This is an authentication request that just implements a simple button.

Since
1.27

Definition at line 31 of file ButtonAuthenticationRequest.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Auth\ButtonAuthenticationRequest::__construct (   $name,
Message  $label,
Message  $help,
  $required = false 
)

Member Function Documentation

◆ __set_state()

static MediaWiki\Auth\ButtonAuthenticationRequest::__set_state (   $data)
static
Parameters
array$data
Returns
AuthenticationRequest|static

Reimplemented from MediaWiki\Auth\AuthenticationRequest.

Definition at line 87 of file ButtonAuthenticationRequest.php.

References Message\newFromKey().

◆ getFieldInfo()

MediaWiki\Auth\ButtonAuthenticationRequest::getFieldInfo ( )

Fetch input field info.

The field info is an associative array mapping field names to info arrays. The info arrays have the following keys:

  • type: (string) Type of input. Types and equivalent HTML widgets are:
    • string: <input type="text">
    • password: <input type="password">
    • select: <select>
    • checkbox: <input type="checkbox">
    • multiselect: More a grid of checkboxes than <select multi>
    • button: <input type="submit"> (uses 'label' as button text)
    • hidden: Not visible to the user, but needs to be preserved for the next request
    • null: No widget, just display the 'label' message.
  • options: (array) Maps option values to Messages for the 'select' and 'multiselect' types.
  • value: (string) Value (for 'null' and 'hidden') or default value (for other types).
  • label: (Message) Text suitable for a label in an HTML form
  • help: (Message) Text suitable as a description of what the field is
  • optional: (bool) If set and truthy, the field may be left empty
  • sensitive: (bool) If set and truthy, the field is considered sensitive. Code using the request should avoid exposing the value of the field.
  • skippable: (bool) If set and truthy, the client is free to hide this field from the user to streamline the workflow. If all fields are skippable (except possibly a single button), no user interaction is required at all.

All AuthenticationRequests are populated from the same data, so most of the time you'll want to prefix fields names with something unique to the extension/provider (although in some cases sharing the field with other requests is the right thing to do, e.g. for a 'password' field).

Returns
array As above -return array<string,array{type:string,options?:array,value?:string,label:Message,help:Message,optional?:bool,sensitive?:bool,skippable?:bool}>

Reimplemented from MediaWiki\Auth\AuthenticationRequest.

Definition at line 58 of file ButtonAuthenticationRequest.php.

References MediaWiki\Auth\ButtonAuthenticationRequest\$help, and MediaWiki\Auth\ButtonAuthenticationRequest\$label.

◆ getRequestByName()

static MediaWiki\Auth\ButtonAuthenticationRequest::getRequestByName ( array  $reqs,
  $name 
)
static

Fetch a ButtonAuthenticationRequest or subclass by name.

Parameters
AuthenticationRequest[]$reqsRequests to search
string$nameName to look for
Returns
ButtonAuthenticationRequest|null Returns null if there is not exactly one matching request.

Definition at line 75 of file ButtonAuthenticationRequest.php.

References MediaWiki\Auth\ButtonAuthenticationRequest\$name.

Referenced by MediaWiki\Auth\ConfirmLinkSecondaryAuthenticationProvider\continueLinkAttempt(), and MediaWiki\Auth\ResetPasswordSecondaryAuthenticationProvider\tryReset().

◆ getUniqueId()

MediaWiki\Auth\ButtonAuthenticationRequest::getUniqueId ( )

Supply a unique key for deduplication.

When the AuthenticationRequests instances returned by the providers are merged, the value returned here is used for keeping only one copy of duplicate requests.

Subclasses should override this if multiple distinct instances would make sense, i.e. the request class has internal state of some sort.

This value might be exposed to the user in web forms so it should not contain private information.

Returns
string

Reimplemented from MediaWiki\Auth\AuthenticationRequest.

Definition at line 54 of file ButtonAuthenticationRequest.php.

References MediaWiki\Auth\ButtonAuthenticationRequest\$name.

Member Data Documentation

◆ $help

Message MediaWiki\Auth\ButtonAuthenticationRequest::$help
protected

◆ $label

Message MediaWiki\Auth\ButtonAuthenticationRequest::$label
protected

◆ $name


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