MediaWiki  master
HTMLTitlesMultiselectField.php
Go to the documentation of this file.
1 <?php
2 
4 
28  public function __construct( $params ) {
29  $params += [
30  // This overrides the default from HTMLTitleTextField
31  'required' => false,
32  ];
33 
34  parent::__construct( $params );
35  }
36 
37  public function loadDataFromRequest( $request ) {
38  $value = $request->getText( $this->mName, $this->getDefault() );
39 
40  $titlesArray = explode( "\n", $value );
41  // Remove empty lines
42  $titlesArray = array_values( array_filter( $titlesArray, static function ( $title ) {
43  return trim( $title ) !== '';
44  } ) );
45  // This function is expected to return a string
46  return implode( "\n", $titlesArray );
47  }
48 
49  public function validate( $value, $alldata ) {
50  if ( !$this->mParams['exists'] ) {
51  return true;
52  }
53 
54  if ( $value === null ) {
55  return false;
56  }
57 
58  // $value is a string, because HTMLForm fields store their values as strings
59  $titlesArray = explode( "\n", $value );
60 
61  if ( isset( $this->mParams['max'] ) && ( count( $titlesArray ) > $this->mParams['max'] ) ) {
62  return $this->msg( 'htmlform-multiselect-toomany', $this->mParams['max'] );
63  }
64 
65  foreach ( $titlesArray as $title ) {
66  $result = parent::validate( $title, $alldata );
67  if ( $result !== true ) {
68  return $result;
69  }
70  }
71 
72  return true;
73  }
74 
75  public function getInputHTML( $value ) {
76  $this->mParent->getOutput()->enableOOUI();
77  return $this->getInputOOUI( $value );
78  }
79 
80  public function getInputOOUI( $value ) {
81  $params = [
82  'id' => $this->mID,
83  'name' => $this->mName,
84  'dir' => $this->mDir,
85  ];
86 
87  if ( isset( $this->mParams['disabled'] ) ) {
88  $params['disabled'] = $this->mParams['disabled'];
89  }
90 
91  if ( isset( $this->mParams['default'] ) ) {
92  $params['default'] = $this->mParams['default'];
93  }
94 
95  if ( isset( $this->mParams['placeholder'] ) ) {
96  $params['placeholder'] = $this->mParams['placeholder'];
97  } else {
98  $params['placeholder'] = $this->msg( 'mw-widgets-titlesmultiselect-placeholder' )->plain();
99  }
100 
101  if ( isset( $this->mParams['max'] ) ) {
102  $params['tagLimit'] = $this->mParams['max'];
103  }
104 
105  if ( isset( $this->mParams['showMissing'] ) ) {
106  $params['showMissing'] = $this->mParams['showMissing'];
107  }
108  if ( isset( $this->mParams['excludeDynamicNamespaces'] ) ) {
109  $params['excludeDynamicNamespaces'] = $this->mParams['excludeDynamicNamespaces'];
110  }
111 
112  if ( isset( $this->mParams['input'] ) ) {
113  $params['input'] = $this->mParams['input'];
114  }
115 
116  if ( $value !== null ) {
117  // $value is a string, but the widget expects an array
118  $params['default'] = $value === '' ? [] : explode( "\n", $value );
119  }
120 
121  // Make the field auto-infusable when it's used inside a legacy HTMLForm rather than OOUIHTMLForm
122  $params['infusable'] = true;
123  $params['classes'] = [ 'mw-htmlform-autoinfuse' ];
124  $widget = new TitlesMultiselectWidget( $params );
125  $widget->setAttributes( [ 'data-mw-modules' => implode( ',', $this->getOOUIModules() ) ] );
126 
127  return $widget;
128  }
129 
130  protected function shouldInfuseOOUI() {
131  return true;
132  }
133 
134  protected function getOOUIModules() {
135  return [ 'mediawiki.widgets.TitlesMultiselectWidget' ];
136  }
137 
138 }
HTMLTitlesMultiselectField\getInputOOUI
getInputOOUI( $value)
Same as getInputHTML, but returns an OOUI object.Defaults to false, which getOOUI will interpret as "...
Definition: HTMLTitlesMultiselectField.php:80
HTMLTitlesMultiselectField\getInputHTML
getInputHTML( $value)
This function must be implemented to return the HTML to generate the input object itself....
Definition: HTMLTitlesMultiselectField.php:75
HTMLTitleTextField
Implements a text input field for page titles.
Definition: HTMLTitleTextField.php:21
HTMLTitlesMultiselectField\getOOUIModules
getOOUIModules()
Get the list of extra ResourceLoader modules which must be loaded client-side before it's possible to...
Definition: HTMLTitlesMultiselectField.php:134
HTMLTitlesMultiselectField\loadDataFromRequest
loadDataFromRequest( $request)
Get the value that this input has been set to from a posted form, or the input's default value if it ...
Definition: HTMLTitlesMultiselectField.php:37
HTMLFormField\$mDir
$mDir
Definition: HTMLFormField.php:16
HTMLFormField\$mName
$mName
Definition: HTMLFormField.php:15
MediaWiki\Widget\TitlesMultiselectWidget
Widget to select multiple titles.
Definition: TitlesMultiselectWidget.php:11
$title
$title
Definition: testCompression.php:38
HTMLFormField\$mID
$mID
Definition: HTMLFormField.php:18
HTMLTitlesMultiselectField\__construct
__construct( $params)
Definition: HTMLTitlesMultiselectField.php:28
HTMLFormField\getDefault
getDefault()
Definition: HTMLFormField.php:998
HTMLTitlesMultiselectField
Implements a tag multiselect input field for titles.
Definition: HTMLTitlesMultiselectField.php:23
HTMLTitlesMultiselectField\validate
validate( $value, $alldata)
Override this function to add specific validation checks on the field input.
Definition: HTMLTitlesMultiselectField.php:49
HTMLFormField\msg
msg( $key,... $params)
Get a translated interface message.
Definition: HTMLFormField.php:87
HTMLTitlesMultiselectField\shouldInfuseOOUI
shouldInfuseOOUI()
Whether the field should be automatically infused.
Definition: HTMLTitlesMultiselectField.php:130