ContentModelChangeConstraint.php

Go to the documentation of this file.

<?php
namespace MediaWiki\EditPage\Constraint;
 
use MediaWiki\PageEdit\PageEditStatus;
use MediaWiki\Permissions\Authority;
use MediaWiki\Permissions\PermissionStatus;
use MediaWiki\Title\Title;
 
class ContentModelChangeConstraint extends EditConstraint {
 
    public function __construct(
        private readonly Authority $performer,
        private readonly Title $title,
        private readonly string $newContentModel,
    ) {
    }
 
    public function checkConstraint(): PageEditStatus {
        if ( $this->newContentModel === $this->title->getContentModel() ) {
            return PageEditStatus::newGood();
        }
 
        $status = PermissionStatus::newEmpty();
        $perm = $this->title->exists() ? 'editcontentmodel' : 'createwithcontentmodel';
 
        if ( !$this->performer->authorizeWrite( $perm, $this->title, $status ) ) {
            return $this->castPermissionStatus( $status );
        }
 
        // Make sure the user can edit the page under the new content model too.
        // We rely on caching in UserAuthority to avoid bumping the rate limit counter twice.
        $titleWithNewContentModel = clone $this->title;
        $titleWithNewContentModel->setContentModel( $this->newContentModel );
        if (
            !$this->performer->authorizeWrite( $perm, $titleWithNewContentModel, $status )
            || !$this->performer->authorizeWrite( 'edit', $titleWithNewContentModel, $status )
        ) {
            return $this->castPermissionStatus( $status );
        }
 
        return PageEditStatus::newGood();
    }
 
    private function castPermissionStatus( PermissionStatus $status ): PageEditStatus {
        $statusValue = PageEditStatus::newGood();
 
        if ( !$status->isGood() ) {
            if ( $status->isRateLimitExceeded() ) {
                $statusValue->merge( $status );
                $statusValue->setResult( false, self::AS_RATE_LIMITED );
            } else {
                $statusValue
                    ->setResult( false, self::AS_NO_CHANGE_CONTENT_MODEL )
                    ->setErrorFunction( $status->throwErrorPageError( ... ) );
            }
        }
 
        return $statusValue;
    }
 
}