SpecialPagesWithProp.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials;
 
use MediaWiki\Html\Html;
use MediaWiki\HTMLForm\HTMLForm;
use MediaWiki\Skin\Skin;
use MediaWiki\SpecialPage\QueryPage;
use MediaWiki\Title\Title;
use stdClass;
use Wikimedia\Rdbms\IConnectionProvider;
 
class SpecialPagesWithProp extends QueryPage {
 
    private $propName = null;
 
    private $existingPropNames = null;
 
    private $ns;
 
    private $reverse = false;
 
    private $sortByValue = false;
 
    public function __construct( IConnectionProvider $dbProvider ) {
        parent::__construct( 'PagesWithProp' );
        $this->setDatabaseProvider( $dbProvider );
    }
 
    public function isCacheable() {
        return false;
    }
 
    public function execute( $par ) {
        $this->setHeaders();
        $this->outputHeader();
        $this->getOutput()->addModuleStyles( 'mediawiki.special' );
 
        $request = $this->getRequest();
        $propname = $request->getVal( 'propname', $par );
        $this->ns = $request->getIntOrNull( 'namespace' );
        $this->reverse = $request->getBool( 'reverse' );
        $this->sortByValue = $request->getBool( 'sortbyvalue' );
 
        $propnames = $this->getExistingPropNames();
 
        $fields = [
            'propname' => [
                'type' => 'combobox',
                'name' => 'propname',
                'options' => $propnames,
                'default' => $propname,
                'label-message' => 'pageswithprop-prop',
                'required' => true,
            ],
            'namespace' => [
                'type' => 'namespaceselect',
                'name' => 'namespace',
                'label-message' => 'namespace',
                'all' => '',
                'default' => $this->ns,
            ],
            'reverse' => [
                'type' => 'check',
                'name' => 'reverse',
                'default' => $this->reverse,
                'label-message' => 'pageswithprop-reverse',
                'required' => false,
            ],
            'sortbyvalue' => [
                'type' => 'check',
                'name' => 'sortbyvalue',
                'default' => $this->sortByValue,
                'label-message' => 'pageswithprop-sortbyvalue',
                'required' => false,
            ]
        ];
 
        $form = HTMLForm::factory( 'ooui', $fields, $this->getContext() )
            ->setMethod( 'get' )
            ->setTitle( $this->getPageTitle() ) // Remove subpage
            ->setSubmitCallback( $this->onSubmit( ... ) )
            ->setWrapperLegendMsg( 'pageswithprop-legend' )
            ->addHeaderHtml( $this->msg( 'pageswithprop-text' )->parseAsBlock() )
            ->setSubmitTextMsg( 'pageswithprop-submit' )
            ->prepareForm();
        $form->displayForm( false );
        if ( $propname !== '' && $propname !== null ) {
            $form->trySubmit();
        }
    }
 
    private function onSubmit( $data, $form ) {
        $this->propName = $data['propname'];
        parent::execute( $data['propname'] );
    }
 
    public function prefixSearchSubpages( $search, $limit, $offset ) {
        $subpages = array_keys( $this->queryExistingProps( $limit, $offset ) );
        // We've already limited and offsetted, set to N and 0 respectively.
        return self::prefixSearchArray( $search, count( $subpages ), $subpages, 0 );
    }
 
    public function isSyndicated() {
        return false;
    }
 
    protected function linkParameters() {
        $params = [
            'reverse' => $this->reverse,
            'sortbyvalue' => $this->sortByValue,
        ];
        if ( $this->ns !== null ) {
            $params['namespace'] = $this->ns;
        }
        return $params;
    }
 
    public function getQueryInfo() {
        $query = [
            'tables' => [ 'page_props', 'page' ],
            'fields' => [
                'page_id' => 'pp_page',
                'page_namespace',
                'page_title',
                'page_len',
                'page_is_redirect',
                'page_latest',
                'pp_value',
            ],
            'conds' => [
                'pp_propname' => $this->propName,
            ],
            'join_conds' => [
                'page' => [ 'JOIN', 'page_id = pp_page' ]
            ],
            'options' => []
        ];
 
        if ( $this->ns !== null ) {
            $query['conds']['page_namespace'] = $this->ns;
        }
 
        return $query;
    }
 
    protected function getOrderFields() {
        $sort = [ 'page_id' ];
        if ( $this->sortByValue ) {
            array_unshift( $sort, 'pp_sortkey' );
        }
        return $sort;
    }
 
    public function sortDescending() {
        return !$this->reverse;
    }
 
    public function formatResult( $skin, $result ) {
        $title = Title::newFromRow( $result );
        $ret = $this->getLinkRenderer()->makeKnownLink( $title );
        if ( $result->pp_value !== '' ) {
            // Do not show very long or binary values on the special page
            $valueLength = strlen( $result->pp_value );
            $isBinary = str_contains( $result->pp_value, "\0" );
            $isTooLong = $valueLength > 1024;
 
            if ( $isBinary || $isTooLong ) {
                $message = $this
                    ->msg( $isBinary ? 'pageswithprop-prophidden-binary' : 'pageswithprop-prophidden-long' )
                    ->sizeParams( $valueLength );
 
                $propValue = Html::element( 'span', [ 'class' => 'prop-value-hidden' ], $message->text() );
            } else {
                $propValue = Html::element( 'span', [ 'class' => 'prop-value' ], $result->pp_value );
            }
 
            $ret .= $this->msg( 'colon-separator' )->escaped() . $propValue;
        }
 
        return $ret;
    }
 
    public function getExistingPropNames(): array {
        if ( $this->existingPropNames === null ) {
            $this->existingPropNames = $this->queryExistingProps();
        }
        return $this->existingPropNames;
    }
 
    protected function queryExistingProps( ?int $limit = null, int $offset = 0 ): array {
        $queryBuilder = $this->getDatabaseProvider()
            ->getReplicaDatabase()
            ->newSelectQueryBuilder()
            ->select( 'pp_propname' )
            ->distinct()
            ->from( 'page_props' )
            ->orderBy( 'pp_propname' );
 
        if ( $limit ) {
            $queryBuilder->limit( $limit );
        }
        if ( $offset ) {
            $queryBuilder->offset( $offset );
        }
        $res = $queryBuilder->caller( __METHOD__ )->fetchResultSet();
 
        $propnames = [];
        foreach ( $res as $row ) {
            $propnames[$row->pp_propname] = $row->pp_propname;
        }
 
        return $propnames;
    }
 
    protected function getGroupName() {
        return 'pages';
    }
}
 
class_alias( SpecialPagesWithProp::class, 'SpecialPagesWithProp' );