ChangesListBooleanFilter.php

Go to the documentation of this file.

<?php
use MediaWiki\Html\FormOptions;
use MediaWiki\SpecialPage\ChangesListSpecialPage;
use Wikimedia\Rdbms\IReadableDatabase;
 
class ChangesListBooleanFilter extends ChangesListFilter {
    protected $showHide;
 
    protected $isReplacedInStructuredUi;
 
    protected $defaultValue;
 
    protected $queryCallable;
 
    protected $activeValue;
 
    public function __construct( $filterDefinition ) {
        parent::__construct( $filterDefinition );
 
        if ( isset( $filterDefinition['showHide'] ) ) {
            $this->showHide = $filterDefinition['showHide'];
        }
 
        $this->isReplacedInStructuredUi = $filterDefinition['isReplacedInStructuredUi'] ?? false;
 
        if ( isset( $filterDefinition['default'] ) ) {
            $this->setDefault( $filterDefinition['default'] );
        } else {
            throw new InvalidArgumentException( 'You must set a default' );
        }
 
        if ( isset( $filterDefinition['queryCallable'] ) ) {
            $this->queryCallable = $filterDefinition['queryCallable'];
        }
 
        $this->activeValue = $filterDefinition['activeValue'] ?? true;
    }
 
    public function getDefault( $structuredUI = false ) {
        return $this->isReplacedInStructuredUi && $structuredUI ?
            !$this->activeValue :
            $this->defaultValue;
    }
 
    public function setDefault( $defaultValue ) {
        $this->defaultValue = (bool)$defaultValue;
    }
 
    public function getShowHide() {
        return $this->showHide;
    }
 
    public function displaysOnUnstructuredUi() {
        return (bool)$this->showHide;
    }
 
    public function isFeatureAvailableOnStructuredUi() {
        return $this->isReplacedInStructuredUi ||
            parent::isFeatureAvailableOnStructuredUi();
    }
 
    public function modifyQuery( IReadableDatabase $dbr, ChangesListSpecialPage $specialPage,
        &$tables, &$fields, &$conds, &$query_options, &$join_conds
    ) {
        if ( $this->queryCallable === null ) {
            return;
        }
 
        ( $this->queryCallable )(
            get_class( $specialPage ),
            $specialPage->getContext(),
            $dbr,
            $tables,
            $fields,
            $conds,
            $query_options,
            $join_conds
        );
    }
 
    public function getJsData() {
        $output = parent::getJsData();
 
        $output['default'] = $this->defaultValue;
 
        return $output;
    }
 
    public function isSelected( FormOptions $opts ) {
        return !$opts[ $this->getName() ] &&
            array_filter(
                $this->getSiblings(),
                static function ( ChangesListBooleanFilter $sibling ) use ( $opts ) {
                    return $opts[ $sibling->getName() ];
                }
            );
    }
 
    public function isActive( FormOptions $opts, $isStructuredUI ) {
        if ( $this->isReplacedInStructuredUi && $isStructuredUI ) {
            return false;
        }
 
        return $opts[ $this->getName() ] === $this->activeValue;
    }
}