MediaWiki
master
|
Form to edit user preferences. More...
Public Member Functions | ||||||||||
areOptionsEditable () | ||||||||||
filterDataForSubmit ( $data) | ||||||||||
Separate multi-option preferences into multiple preferences, since we have to store them separately. More... | ||||||||||
getBody () | ||||||||||
Get the whole body of the form. More... | ||||||||||
getButtons () | ||||||||||
getExtraSuccessRedirectParameters () | ||||||||||
Get extra parameters for the query string when redirecting after successful save. More... | ||||||||||
getLegend ( $key) | ||||||||||
Get the "<legend>" for a given section key. More... | ||||||||||
getModifiedUser () | ||||||||||
getPreferenceSections () | ||||||||||
Get the keys of each top level preference section. More... | ||||||||||
isPrivateInfoEditable () | ||||||||||
setModifiedUser ( $user) | ||||||||||
setOptionsEditable ( $optionsEditable) | ||||||||||
setPrivateInfoEditable ( $editable) | ||||||||||
Whether the. More... | ||||||||||
wrapForm ( $html) | ||||||||||
![]() | ||||||||||
__construct ( $descriptor, $context=null, $messagePrefix='') | ||||||||||
Stable to call Build a new HTMLForm from an array of field attributes.Stable to call
| ||||||||||
getErrorsOrWarnings ( $elements, $elementsType) | ||||||||||
getHeaderText ( $section=null) | ||||||||||
Get header text. More... | ||||||||||
![]() | ||||||||||
addButton ( $data) | ||||||||||
Add a button to the form. More... | ||||||||||
addFields ( $descriptor) | ||||||||||
Add fields to the form. More... | ||||||||||
addFooterText ( $msg, $section=null) | ||||||||||
Add footer text, inside the form. More... | ||||||||||
addHeaderText ( $msg, $section=null) | ||||||||||
Add HTML to the header, inside the form. More... | ||||||||||
addHiddenField ( $name, $value, array $attribs=[]) | ||||||||||
Add a hidden field to the output. More... | ||||||||||
addHiddenFields (array $fields) | ||||||||||
Add an array of hidden fields to the output. More... | ||||||||||
addPostText ( $msg) | ||||||||||
Add text to the end of the display. More... | ||||||||||
addPreText ( $msg) | ||||||||||
Add HTML to introductory message. More... | ||||||||||
displayForm ( $submitResult) | ||||||||||
Display the form (sending to the context's OutputPage object), with an appropriate error message or stack of messages, and any validation errors, etc. More... | ||||||||||
displaySection ( $fields, $sectionName='', $fieldsetIDPrefix='', &$hasUserVisibleFields=false) | ||||||||||
formatErrors ( $errors) | ||||||||||
Format a stack of error messages into a single HTML string. More... | ||||||||||
getAction () | ||||||||||
Get the value for the action attribute of the form. More... | ||||||||||
getDisplayFormat () | ||||||||||
Getter for displayFormat. More... | ||||||||||
getField ( $fieldname) | ||||||||||
getFooterText ( $section=null) | ||||||||||
Get footer text. More... | ||||||||||
getHiddenFields () | ||||||||||
Get the hidden fields that should go inside the form. More... | ||||||||||
getHTML ( $submitResult) | ||||||||||
Returns the raw HTML generated by the form. More... | ||||||||||
getMethod () | ||||||||||
getPreText () | ||||||||||
Get the introductory message HTML. More... | ||||||||||
getSubmitText () | ||||||||||
Get the text for the submit button, either customised or a default. More... | ||||||||||
getTitle () | ||||||||||
hasField ( $fieldname) | ||||||||||
loadData () | ||||||||||
Construct the form fields from the Descriptor array. More... | ||||||||||
needsJSForHtml5FormValidation () | ||||||||||
Whether this form, with its current fields, requires the user agent to have JavaScript enabled for the client-side HTML5 form validation to work correctly. More... | ||||||||||
prepareForm () | ||||||||||
Prepare form for submission. More... | ||||||||||
setAction ( $action) | ||||||||||
Set the value for the action attribute of the form. More... | ||||||||||
setAutocomplete ( $autocomplete) | ||||||||||
Set the value for the autocomplete attribute of the form. More... | ||||||||||
setCancelTarget ( $target) | ||||||||||
Sets the target where the user is redirected to after clicking cancel. More... | ||||||||||
setCollapsibleOptions ( $collapsedByDefault=false) | ||||||||||
Enable collapsible mode, and set whether the form is collapsed by default. More... | ||||||||||
setDisplayFormat ( $format) | ||||||||||
Set format in which to display the form. More... | ||||||||||
setFooterText ( $msg, $section=null) | ||||||||||
Set footer text, inside the form. More... | ||||||||||
setFormIdentifier ( $ident) | ||||||||||
Set an internal identifier for this form. More... | ||||||||||
setHeaderText ( $msg, $section=null) | ||||||||||
Set header text, inside the form. More... | ||||||||||
setId ( $id) | ||||||||||
setIntro ( $msg) | ||||||||||
Set the introductory message, overwriting any existing message. More... | ||||||||||
setMessagePrefix ( $p) | ||||||||||
Set the prefix for various default messages. More... | ||||||||||
setMethod ( $method='post') | ||||||||||
Set the method used to submit the form. More... | ||||||||||
setName ( $name) | ||||||||||
setPostText ( $msg) | ||||||||||
Set text at the end of the display. More... | ||||||||||
setPreText ( $msg) | ||||||||||
Set the introductory message HTML, overwriting any existing message. More... | ||||||||||
setSubmitCallback ( $cb) | ||||||||||
Set a callback to a function to do something with the form once it's been successfully validated. More... | ||||||||||
setSubmitDestructive () | ||||||||||
Identify that the submit button in the form has a destructive action. More... | ||||||||||
setSubmitID ( $t) | ||||||||||
Set the id for the submit button. More... | ||||||||||
setSubmitName ( $name) | ||||||||||
setSubmitText ( $t) | ||||||||||
Set the text for the submit button. More... | ||||||||||
setSubmitTextMsg ( $msg) | ||||||||||
Set the text for the submit button to a message. More... | ||||||||||
setSubmitTooltip ( $name) | ||||||||||
setTableId ( $id) | ||||||||||
Set the id of the \<table\> or outermost \<div\> element. More... | ||||||||||
setTitle ( $t) | ||||||||||
Set the title for form submission. More... | ||||||||||
setTokenSalt ( $salt) | ||||||||||
Set the salt for the edit token. More... | ||||||||||
setValidationErrorMessage ( $msg) | ||||||||||
Set a message to display on a validation error. More... | ||||||||||
setWrapperAttributes ( $attributes) | ||||||||||
For internal use only. More... | ||||||||||
setWrapperLegend ( $legend) | ||||||||||
Prompt the whole form to be wrapped in a "<fieldset>", with this text as its "<legend>" element. More... | ||||||||||
setWrapperLegendMsg ( $msg) | ||||||||||
Prompt the whole form to be wrapped in a "<fieldset>", with this message as its "<legend>" element. More... | ||||||||||
show () | ||||||||||
The here's-one-I-made-earlier option: do the submission if posted, or display the form with or without funky validation errors Stable to override. More... | ||||||||||
showAlways () | ||||||||||
Same as self::show with the difference, that the form will be added to the output, no matter, if the validation was good or not. More... | ||||||||||
showCancel ( $show=true) | ||||||||||
Show a cancel button (or prevent it). More... | ||||||||||
suppressDefaultSubmit ( $suppressSubmit=true) | ||||||||||
Stop a default submit button being shown for this form. More... | ||||||||||
suppressReset ( $suppressReset=true) | ||||||||||
Stop a reset button being shown for this form. More... | ||||||||||
tryAuthorizedSubmit () | ||||||||||
Try submitting, with edit token check first. More... | ||||||||||
trySubmit () | ||||||||||
Validate all the fields, and call the submission callback function if everything is kosher. More... | ||||||||||
wasSubmitted () | ||||||||||
Test whether the form was considered to have been submitted or not, i.e. More... | ||||||||||
![]() | ||||||||||
canUseWikiPage () | ||||||||||
Check whether a WikiPage object can be get with getWikiPage(). More... | ||||||||||
exportSession () | ||||||||||
Export the resolved user IP, HTTP headers, user ID, and session ID. More... | ||||||||||
getAuthority () | ||||||||||
getConfig () | ||||||||||
getContext () | ||||||||||
Get the base IContextSource object. More... | ||||||||||
getLanguage () | ||||||||||
getOutput () | ||||||||||
getRequest () | ||||||||||
getSkin () | ||||||||||
getStats () | ||||||||||
getTiming () | ||||||||||
getUser () | ||||||||||
Stable to override. More... | ||||||||||
getWikiPage () | ||||||||||
Get the WikiPage object. More... | ||||||||||
msg ( $key,... $params) | ||||||||||
Get a Message object with context set Parameters are the same as wfMessage() More... | ||||||||||
setContext (IContextSource $context) | ||||||||||
Protected Member Functions | |||||||||||||
wrapFieldSetSection ( $legend, $section, $attributes, $isRoot) | |||||||||||||
Wraps the given $section into an user-visible fieldset.Stable to override
| |||||||||||||
![]() | |||||||||||||
formatFormHeader () | |||||||||||||
formatSection (array $fieldsHtml, $sectionName, $anyFieldHasLabel) | |||||||||||||
Put a form section together from the individual fields' HTML, merging it and wrapping. More... | |||||||||||||
![]() | |||||||||||||
getFormAttributes () | |||||||||||||
Get HTML attributes for the <form> tag. More... | |||||||||||||
getMessage ( $value) | |||||||||||||
Turns a *-message parameter (which could be a MessageSpecifier, or a message name, or a name + parameters array) into a Message. More... | |||||||||||||
Protected Attributes | |
bool | $mSubSectionBeforeFields = false |
Override default value from HTMLForm. More... | |
![]() | |
string | $displayFormat = 'ooui' |
Symbolic display format name. More... | |
![]() | |
array | $availableDisplayFormats |
Available formats in which to display the form. More... | |
array | $availableSubclassDisplayFormats |
Available formats in which to display the form. More... | |
string | $displayFormat = 'table' |
Format in which to display form. More... | |
bool string | $mAction = false |
Form action URL. More... | |
string null | $mAutocomplete = null |
Form attribute autocomplete. More... | |
array[] | $mButtons = [] |
-var array<array{name:string,value:string,label-message?:string|string[]|MessageSpecifier,label?:string,label-raw?:string,id?:string,attribs?:array,flags?:string|string[],framed?:bool}> More... | |
$mCancelTarget | |
bool | $mCollapsed = false |
Whether the form is collapsed by default. More... | |
bool | $mCollapsible = false |
Whether the form can be collapsed. More... | |
$mFieldTree = [] | |
HTMLFormField[] | $mFlatFields = [] |
$mFooter = '' | |
$mFormIdentifier | |
$mHeader = '' | |
array[] | $mHiddenFields = [] |
-var array<int,array{0:string,1:array}> More... | |
$mId | |
$mMessagePrefix | |
$mMethod = 'post' | |
$mName | |
$mPost = '' | |
$mPre = '' | |
$mSectionFooters = [] | |
$mSectionHeaders = [] | |
$mShowCancel = false | |
$mShowReset = false | |
$mShowSubmit = true | |
$mSubmitCallback | |
string[] | $mSubmitFlags = [ 'primary', 'progressive' ] |
$mSubmitID | |
$mSubmitName | |
$mSubmitText | |
$mSubmitTooltip | |
bool | $mSubSectionBeforeFields = true |
If true, sections that contain both fields and subsections will render their subsections before their fields. More... | |
$mTableId = '' | |
$mTitle | |
string array | $mTokenSalt = '' |
Salt for the edit token. More... | |
$mUseMultipart = false | |
$mValidationErrorMessage | |
$mWasSubmitted = false | |
$mWrapperAttributes = [] | |
$mWrapperLegend = false | |
Private Attributes | |
User null | $modifiedUser |
bool | $optionsEditable = true |
bool | $privateInfoEditable = true |
Additional Inherited Members | |
![]() | |
static | loadInputFromParameters ( $fieldname, $descriptor, HTMLForm $parent=null) |
Initialise a new Object for the field Stable to override. More... | |
![]() | |
static | factory ( $displayFormat,... $arguments) |
Construct a HTMLForm object for given display type. More... | |
static | getClassFromDescriptor ( $fieldname, &$descriptor) |
Get the HTMLFormField subclass for this descriptor. More... | |
![]() | |
$mFieldData | |
![]() | |
static string[] | $typeMappings |
A mapping of 'type' inputs onto standard HTMLFormField subclasses. More... | |
PreferencesFormOOUI::areOptionsEditable | ( | ) |
Definition at line 75 of file PreferencesFormOOUI.php.
References $optionsEditable.
Referenced by getButtons().
PreferencesFormOOUI::filterDataForSubmit | ( | $data | ) |
Separate multi-option preferences into multiple preferences, since we have to store them separately.
array | $data |
Reimplemented from HTMLForm.
Definition at line 140 of file PreferencesFormOOUI.php.
PreferencesFormOOUI::getBody | ( | ) |
Get the whole body of the form.
Reimplemented from OOUIHTMLForm.
Definition at line 170 of file PreferencesFormOOUI.php.
References $content, $header, HTMLForm\displaySection(), OOUIHTMLForm\formatFormHeader(), HTMLForm\getFooterText(), OOUIHTMLForm\getHeaderText(), getLegend(), and wfDebug().
PreferencesFormOOUI::getButtons | ( | ) |
Reimplemented from OOUIHTMLForm.
Definition at line 109 of file PreferencesFormOOUI.php.
References $t, areOptionsEditable(), HTMLForm\getTitle(), isPrivateInfoEditable(), ContextSource\msg(), and Xml\tags().
PreferencesFormOOUI::getExtraSuccessRedirectParameters | ( | ) |
Get extra parameters for the query string when redirecting after successful save.
Definition at line 92 of file PreferencesFormOOUI.php.
Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\submitForm().
PreferencesFormOOUI::getLegend | ( | $key | ) |
Get the "<legend>" for a given section key.
Normally this is the prefs-$key message but we'll allow extensions to override it.
string | $key |
Reimplemented from HTMLForm.
Definition at line 230 of file PreferencesFormOOUI.php.
Referenced by getBody().
PreferencesFormOOUI::getModifiedUser | ( | ) |
Definition at line 49 of file PreferencesFormOOUI.php.
References $modifiedUser, and ContextSource\getUser().
Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\saveFormData().
PreferencesFormOOUI::getPreferenceSections | ( | ) |
Get the keys of each top level preference section.
Definition at line 240 of file PreferencesFormOOUI.php.
PreferencesFormOOUI::isPrivateInfoEditable | ( | ) |
Definition at line 60 of file PreferencesFormOOUI.php.
References $privateInfoEditable.
Referenced by getButtons().
PreferencesFormOOUI::setModifiedUser | ( | $user | ) |
User | $user |
Definition at line 42 of file PreferencesFormOOUI.php.
PreferencesFormOOUI::setOptionsEditable | ( | $optionsEditable | ) |
bool | $optionsEditable |
Definition at line 82 of file PreferencesFormOOUI.php.
References $optionsEditable.
PreferencesFormOOUI::setPrivateInfoEditable | ( | $editable | ) |
|
protected |
Wraps the given $section into an user-visible fieldset.Stable to override
string | $legend | Legend text for the fieldset |
string | $section | The section content in plain Html |
array | $attributes | Additional attributes for the fieldset |
bool | $isRoot | Section is at the root of the tree |
Reimplemented from OOUIHTMLForm.
Definition at line 157 of file PreferencesFormOOUI.php.
PreferencesFormOOUI::wrapForm | ( | $html | ) |
string | $html |
Reimplemented from OOUIHTMLForm.
Definition at line 100 of file PreferencesFormOOUI.php.
References Xml\tags().
|
private |
Definition at line 31 of file PreferencesFormOOUI.php.
Referenced by getModifiedUser().
|
protected |
Override default value from HTMLForm.
Definition at line 28 of file PreferencesFormOOUI.php.
|
private |
Definition at line 37 of file PreferencesFormOOUI.php.
Referenced by areOptionsEditable(), and setOptionsEditable().
|
private |
Definition at line 34 of file PreferencesFormOOUI.php.
Referenced by isPrivateInfoEditable().