ApiSetPageLanguage.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;
 
class ApiSetPageLanguage extends ApiBase {
    // Check if change language feature is enabled
    protected function getExtendedDescription() {
        if ( !$this->getConfig()->get( 'PageLanguageUseDB' ) ) {
            return 'apihelp-setpagelanguage-extended-description-disabled';
        }
        return parent::getExtendedDescription();
    }
 
    public function execute() {
        // Check if change language feature is enabled
        if ( !$this->getConfig()->get( 'PageLanguageUseDB' ) ) {
            $this->dieWithError( 'apierror-pagelang-disabled' );
        }
 
        // Check if the user has permissions
        $this->checkUserRightsAny( 'pagelang' );
 
        $this->useTransactionalTimeLimit();
 
        $params = $this->extractRequestParams();
 
        $pageObj = $this->getTitleOrPageId( $params, 'fromdbmaster' );
        if ( !$pageObj->exists() ) {
            $this->dieWithError( 'apierror-missingtitle' );
        }
 
        $titleObj = $pageObj->getTitle();
        $user = $this->getUser();
 
        // Check that the user is allowed to edit the page
        $this->checkTitleUserPermissions( $titleObj, 'edit' );
 
        // If change tagging was requested, check that the user is allowed to tag,
        // and the tags are valid
        if ( $params['tags'] ) {
            $tagStatus = ChangeTags::canAddTagsAccompanyingChange( $params['tags'], $user );
            if ( !$tagStatus->isOK() ) {
                $this->dieStatus( $tagStatus );
            }
        }
 
        $status = SpecialPageLanguage::changePageLanguage(
            $this,
            $titleObj,
            $params['lang'],
            $params['reason'] ?? '',
            $params['tags'] ?: []
        );
 
        if ( !$status->isOK() ) {
            $this->dieStatus( $status );
        }
 
        $r = [
            'title' => $titleObj->getPrefixedText(),
            'oldlanguage' => $status->value->oldLanguage,
            'newlanguage' => $status->value->newLanguage,
            'logid' => $status->value->logId
        ];
        $this->getResult()->addValue( null, $this->getModuleName(), $r );
    }
 
    public function mustBePosted() {
        return true;
    }
 
    public function isWriteMode() {
        return true;
    }
 
    public function getAllowedParams() {
        return [
            'title' => null,
            'pageid' => [
                ApiBase::PARAM_TYPE => 'integer'
            ],
            'lang' => [
                ApiBase::PARAM_TYPE => array_merge(
                    [ 'default' ],
                    array_keys( MediaWikiServices::getInstance()
                        ->getLanguageNameUtils()
                        ->getLanguageNames( null, 'mwfile' ) )
                ),
                ApiBase::PARAM_REQUIRED => true,
            ],
            'reason' => null,
            'tags' => [
                ApiBase::PARAM_TYPE => 'tags',
                ApiBase::PARAM_ISMULTI => true,
            ],
        ];
    }
 
    public function needsToken() {
        return 'csrf';
    }
 
    protected function getExamplesMessages() {
        return [
            'action=setpagelanguage&title=Main%20Page&lang=eu&token=123ABC'
                => 'apihelp-setpagelanguage-example-language',
            'action=setpagelanguage&pageid=123&lang=default&token=123ABC'
                => 'apihelp-setpagelanguage-example-default',
        ];
    }
 
    public function getHelpUrls() {
        return 'https://www.mediawiki.org/wiki/Special:MyLanguage/API:SetPageLanguage';
    }
}