ExistingSectionEditConstraint.php

Go to the documentation of this file.

<?php
namespace MediaWiki\EditPage\Constraint;
 
use MediaWiki\Content\Content;
use MediaWiki\EditPage\EditPageStatus;
use Wikimedia\Message\MessageValue;
 
class ExistingSectionEditConstraint extends EditConstraint {
 
    public function __construct(
        private readonly string $section,
        private readonly string $userSummary,
        private readonly string $autoSummary,
        private readonly bool $allowBlankSummary,
        private readonly Content $newContent,
        private readonly ?Content $originalContent,
        private readonly string $submitButtonLabel,
    ) {
    }
 
    public function checkConstraint(): EditPageStatus {
        if ( $this->section === 'new' ) {
            // Constraint is not applicable
            return EditPageStatus::newGood();
        }
 
        if (
            !$this->allowBlankSummary &&
            !$this->newContent->equals( $this->originalContent ) &&
            !$this->newContent->isRedirect() &&
            md5( $this->userSummary ) === $this->autoSummary
        ) {
            return EditPageStatus::newGood()
                ->setResult( false, self::AS_SUMMARY_NEEDED )
                ->warning(
                    'missingsummary',
                    MessageValue::new( $this->submitButtonLabel )
                );
        }
 
        return EditPageStatus::newGood();
    }
 
}