3 * This program is free software; you can redistribute it and/or modify
4 * it under the terms of the GNU General Public License as published by
5 * the Free Software Foundation; either version 2 of the License, or
6 * (at your option) any later version.
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
13 * You should have received a copy of the GNU General Public License along
14 * with this program; if not, write to the Free Software Foundation, Inc.,
15 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
16 * http://www.gnu.org/copyleft/gpl.html
21 namespace MediaWiki\Preferences
;
23 use MediaWiki\MediaWikiServices
;
24 use MediaWiki\Permissions\Authority
;
25 use MediaWiki\User\CentralId\CentralIdLookup
;
27 class MultiUsernameFilter
implements Filter
{
29 * @var CentralIdLookup|null
32 /** @var Authority|int User querying central usernames or one of the audience constants */
33 private $authorityOrAudience;
36 * @param CentralIdLookup|null $lookup
37 * @param Authority|int $authorityOrAudience
39 public function __construct(
40 CentralIdLookup
$lookup = null,
41 $authorityOrAudience = CentralIdLookup
::AUDIENCE_PUBLIC
43 $this->lookup
= $lookup;
44 $this->authorityOrAudience
= $authorityOrAudience;
50 public function filterFromForm( $names ) {
51 $names = trim( $names );
52 if ( $names !== '' ) {
53 $names = preg_split( '/\n/', $names, -1, PREG_SPLIT_NO_EMPTY
);
54 $ids = $this->getLookup()->centralIdsFromNames( $names, $this->authorityOrAudience
);
56 return implode( "\n", $ids );
59 // If the user list is empty, it should be null (don't save) rather than an empty string
66 public function filterForForm( $value ) {
67 $ids = self
::splitIds( $value );
68 $names = $ids ?
$this->getLookup()->namesFromCentralIds( $ids, $this->authorityOrAudience
) : [];
69 return implode( "\n", $names );
73 * Splits a newline separated list of user ids into an array.
78 public static function splitIds( $str ) {
79 return array_map( 'intval', preg_split( '/\n/', $str, -1, PREG_SPLIT_NO_EMPTY
) );
83 * @return CentralIdLookup
85 private function getLookup() {
86 $this->lookup ??
= MediaWikiServices
::getInstance()->getCentralIdLookup();