ChangesListStringOptionsFilterGroup.php

Go to the documentation of this file.

<?php
namespace MediaWiki\RecentChanges;
 
use InvalidArgumentException;
use MediaWiki\Html\FormOptions;
use MediaWiki\SpecialPage\ChangesListSpecialPage;
use Wikimedia\Rdbms\IReadableDatabase;
 
class ChangesListStringOptionsFilterGroup extends ChangesListFilterGroup {
    public const TYPE = 'string_options';
 
    public const SEPARATOR = ';';
 
    public const ALL = 'all';
 
    public const NONE = '';
 
    protected $defaultValue;
 
    protected $queryCallable;
 
    public function __construct( array $groupDefinition ) {
        if ( !isset( $groupDefinition['isFullCoverage'] ) ) {
            throw new InvalidArgumentException( 'You must specify isFullCoverage' );
        }
 
        $groupDefinition['type'] = self::TYPE;
 
        parent::__construct( $groupDefinition );
 
        $this->queryCallable = $groupDefinition['queryCallable'] ?? null;
 
        if ( isset( $groupDefinition['default'] ) ) {
            $this->setDefault( $groupDefinition['default'] );
        } else {
            throw new InvalidArgumentException( 'You must specify a default' );
        }
    }
 
    public function setDefault( $defaultValue ) {
        if ( !is_string( $defaultValue ) ) {
            throw new InvalidArgumentException(
                "Can't set the default of filter options group \"{$this->getName()}\"" .
                ' to a value of type "' . gettype( $defaultValue ) . ': string expected' );
        }
        $this->defaultValue = $defaultValue;
    }
 
    public function getDefault() {
        return $this->defaultValue;
    }
 
    protected function createFilter( array $filterDefinition ) {
        return new ChangesListStringOptionsFilter( $filterDefinition );
    }
 
    public function registerFilter( ChangesListStringOptionsFilter $filter ) {
        $this->filters[$filter->getName()] = $filter;
    }
 
    public function modifyQuery( IReadableDatabase $dbr, ChangesListSpecialPage $specialPage,
        &$tables, &$fields, &$conds, &$query_options, &$join_conds,
        FormOptions $opts, $isStructuredFiltersEnabled
    ) {
        // STRING_OPTIONS filter groups are exclusively active on Structured UI
        if ( !$isStructuredFiltersEnabled ) {
            return;
        }
        if ( !$this->queryCallable ) {
            return;
        }
 
        $value = $opts[ $this->getName() ];
        $allowedFilterNames = [];
        foreach ( $this->filters as $filter ) {
            $allowedFilterNames[] = $filter->getName();
        }
 
        if ( $value === self::ALL ) {
            $selectedValues = $allowedFilterNames;
        } else {
            $selectedValues = explode( self::SEPARATOR, strtolower( $value ) );
 
            // remove values that are not recognized or not currently allowed
            $selectedValues = array_intersect(
                $selectedValues,
                $allowedFilterNames
            );
        }
 
        // If there are now no values, because all are disallowed or invalid (also,
        // the user may not have selected any), this is a no-op.
 
        // If everything is unchecked, the group always has no effect, regardless
        // of full-coverage.
        if ( count( $selectedValues ) === 0 ) {
            return;
        }
 
        sort( $selectedValues );
 
        ( $this->queryCallable )(
            get_class( $specialPage ),
            $specialPage->getContext(),
            $dbr,
            $tables,
            $fields,
            $conds,
            $query_options,
            $join_conds,
            $selectedValues
        );
    }
 
    public function getJsData() {
        $output = parent::getJsData();
 
        $output['separator'] = self::SEPARATOR;
        $output['default'] = $this->getDefault();
 
        return $output;
    }
 
    public function addOptions( FormOptions $opts, $allowDefaults, $isStructuredFiltersEnabled ) {
        $opts->add( $this->getName(), $allowDefaults ? $this->getDefault() : '' );
    }
}
 
class_alias( ChangesListStringOptionsFilterGroup::class, 'ChangesListStringOptionsFilterGroup' );