MoveTranslatableBundleSpecialPage.php

<?php
declare( strict_types = 1 );
 
namespace MediaWiki\Extension\Translate\PageTranslation;
 
use ErrorPageError;
use HTMLForm;
use InvalidArgumentException;
use MediaWiki\CommentStore\CommentStore;
use MediaWiki\Extension\Translate\MessageBundleTranslation\MessageBundle;
use MediaWiki\Extension\Translate\MessageGroupProcessing\TranslatableBundle;
use MediaWiki\Extension\Translate\MessageGroupProcessing\TranslatableBundleFactory;
use MediaWiki\Html\Html;
use MediaWiki\Language\FormatterFactory;
use MediaWiki\Permissions\PermissionManager;
use MediaWiki\Permissions\PermissionStatus;
use MediaWiki\SpecialPage\UnlistedSpecialPage;
use MediaWiki\Title\Title;
use Message;
use OutputPage;
use PermissionsError;
use ReadOnlyError;
use SplObjectStorage;
use ThrottledError;
use Wikimedia\ObjectFactory\ObjectFactory;
 
class MoveTranslatableBundleSpecialPage extends UnlistedSpecialPage {
    // Form parameters both as text and as titles
    private string $oldText;
    private string $reason;
    private bool $moveTalkpages = true;
    private bool $moveSubpages = true;
    private bool $leaveRedirect = true;
    private ObjectFactory $objectFactory;
    private TranslatableBundleMover $bundleMover;
    private PermissionManager $permissionManager;
    private TranslatableBundleFactory $bundleFactory;
    private FormatterFactory $formatterFactory;
    private $movePageSpec;
    // Other
    private ?Title $oldTitle;
 
    public function __construct(
        ObjectFactory $objectFactory,
        PermissionManager $permissionManager,
        TranslatableBundleMover $bundleMover,
        TranslatableBundleFactory $bundleFactory,
        FormatterFactory $formatterFactory,
        $movePageSpec
    ) {
        parent::__construct( 'Movepage' );
        $this->objectFactory = $objectFactory;
        $this->permissionManager = $permissionManager;
        $this->bundleMover = $bundleMover;
        $this->bundleFactory = $bundleFactory;
        $this->formatterFactory = $formatterFactory;
        $this->movePageSpec = $movePageSpec;
    }
 
    public function doesWrites(): bool {
        return true;
    }
 
    protected function getGroupName(): string {
        return 'pagetools';
    }
 
    public function execute( $par ) {
        $request = $this->getRequest();
        $user = $this->getUser();
        $this->addHelpLink( 'Help:Extension:Translate/Move_translatable_page' );
        $out = $this->getOutput();
        $out->addModuleStyles( 'ext.translate.special.movetranslatablebundles.styles' );
 
        $this->oldText = $request->getText(
            'wpOldTitle',
            $request->getText( 'target', $par ?? '' )
        );
        $newText = $request->getText( 'wpNewTitle' );
 
        $this->oldTitle = Title::newFromText( $this->oldText );
        $newTitle = Title::newFromText( $newText );
        // Normalize input
        if ( $this->oldTitle ) {
            $this->oldText = $this->oldTitle->getPrefixedText();
        }
 
        $this->reason = $request->getText( 'reason' );
 
        // This will throw exceptions if there is an error.
        $this->doBasicChecks();
 
        // Real stuff starts here
        $bundle = $this->bundleFactory->getBundle( $this->oldTitle );
        if ( $bundle && $bundle->isMoveable() ) {
            $this->getOutput()->setPageTitleMsg( $this->getSpecialPageTitle( $bundle ) );
 
            if ( !$user->isAllowed( 'pagetranslation' ) ) {
                throw new PermissionsError( 'pagetranslation' );
            }
 
            $subaction = $this->getSubactionFromRequest( $request->getText( 'subaction' ) );
 
            $isValidPostRequest = $this->checkToken() && $request->wasPosted();
            if ( $isValidPostRequest && $subaction === 'check' ) {
                try {
                    $pageCollection = $this->bundleMover->getPageMoveCollection(
                        $this->oldTitle,
                        $newTitle,
                        $user,
                        $this->reason,
                        $this->moveSubpages,
                        $this->moveTalkpages,
                        $this->leaveRedirect
                    );
                } catch ( ImpossiblePageMove $e ) {
                    $this->showErrors( $e->getBlockers() );
                    $this->showForm( $bundle );
                    return;
                }
 
                $this->showConfirmation( $pageCollection, $bundle );
            } elseif ( $isValidPostRequest && $subaction === 'perform' ) {
                $this->moveSubpages = $request->getBool( 'subpages' );
                $this->moveTalkpages = $request->getBool( 'talkpages' );
                $this->leaveRedirect = $request->getBool( 'redirect' );
 
                // This will throw exceptions if there is an error.
                $this->authorizeMove();
 
                $this->bundleMover->moveAsynchronously(
                    $this->oldTitle,
                    $newTitle,
                    $this->moveSubpages,
                    $this->getUser(),
                    $this->reason,
                    $this->moveTalkpages,
                    $this->leaveRedirect
                );
                $this->getOutput()->addWikiMsg(
                    'pt-movepage-started',
                    $this->getLogPageWikiLink( $this->bundleFactory->getValidBundle( $this->oldTitle ) )
                );
            } else {
                $this->showForm( $bundle );
            }
        } else {
            // Delegate... don't want to reimplement this
            $sp = $this->objectFactory->createObject( $this->movePageSpec );
            $sp->execute( $par );
        }
    }
 
    protected function doBasicChecks(): void {
        $this->checkReadOnly();
 
        if ( $this->oldTitle === null ) {
            throw new ErrorPageError( 'notargettitle', 'notargettext' );
        }
 
        if ( !$this->oldTitle->exists() ) {
            throw new ErrorPageError( 'nopagetitle', 'nopagetext' );
        }
 
        // Since MW 1.36, Authority should be used to check permissions
        $status = PermissionStatus::newEmpty();
        if ( !$this->getAuthority()
            ->definitelyCan( 'move', $this->oldTitle, $status )
        ) {
            throw new PermissionsError( 'move', $status );
        }
    }
 
    protected function authorizeMove(): void {
        $status = PermissionStatus::newEmpty();
        $this->getAuthority()
            ->authorizeWrite( 'move', $this->oldTitle, $status );
 
        if ( !$status->isOK() ) {
            if ( $status->isRateLimitExceeded() ) {
                throw new ThrottledError;
            } else {
                throw new PermissionsError( 'move', $status );
            }
        }
    }
 
    protected function checkToken(): bool {
        return $this->getContext()->getCsrfTokenSet()->matchTokenField( 'wpEditToken' );
    }
 
    protected function showErrors( SplObjectStorage $errors ): void {
        // If there are many errors, for performance reasons we must parse them all at once
        $s = '';
        $context = 'pt-movepage-error-placeholder';
        foreach ( $errors as $title ) {
            $titleText = $title->getPrefixedText();
            $s .= "'''$titleText'''\n\n";
            $s .= $errors[ $title ]->getWikiText( false, $context );
        }
 
        $out = $this->getOutput();
        $out->addHTML(
            Html::errorBox(
                $out->msg(
                    'pt-movepage-blockers',
                    $this->getLanguage()->formatNum( count( $errors ) )
                )->parseAsBlock() .
                $out->parseAsContent( $s )
            )
        );
    }
 
    public function showForm( TranslatableBundle $bundle ) {
        $this->getOutput()->addBacklinkSubtitle( $this->oldTitle );
        $this->getOutput()->addWikiMsg(
            'pt-movepage-intro',
            $this->getLogPageWikiLink(
                $this->bundleFactory->getBundle( Title::newFromText( $this->oldText ) )
            )
        );
 
        HTMLForm::factory( 'ooui', $this->getCommonFormFields(), $this->getContext() )
            ->setMethod( 'post' )
            ->setAction( $this->getPageTitle( $this->oldText )->getLocalURL() )
            ->setSubmitName( 'subaction' )
            ->setSubmitTextMsg( 'pt-movepage-action-check' )
            ->setWrapperLegendMsg(
                $bundle instanceof MessageBundle ? 'pt-movepage-messagebundle-legend' : 'pt-movepage-legend'
            )
            ->prepareForm()
            ->displayForm( false );
    }
 
    protected function showConfirmation( PageMoveCollection $pageCollection, TranslatableBundle $bundle ): void {
        $out = $this->getOutput();
        $out->addBacklinkSubtitle( $this->oldTitle );
        $out->addWikiMsg(
            'pt-movepage-intro',
            $this->getLogPageWikiLink(
                $this->bundleFactory->getBundle( Title::newFromText( $this->oldText ) )
            )
        );
 
        $count = 0;
        $subpagesCount = 0;
        $talkpagesCount = 0;
 
        $pagesToMove = [
            'pt-movepage-list-source' => [ $pageCollection->getTranslatablePage() ],
            'pt-movepage-list-translation' => $pageCollection->getTranslationPagesPair(),
            'pt-movepage-list-section' => $pageCollection->getUnitPagesPair()
        ];
 
        $subpages = $pageCollection->getSubpagesPair();
        if ( $subpages ) {
            $pagesToMove[ 'pt-movepage-list-other'] = $subpages;
        }
 
        $out->wrapWikiMsg( '== $1 ==', [ 'pt-movepage-list-pages' ] );
 
        foreach ( $pagesToMove as $type => $pages ) {
            $this->addSectionHeaderAndMessage( $out, $type, $pages );
 
            if ( !$pages ) {
                continue;
            }
 
            $lines = [];
 
            foreach ( $pages as $pagePairs ) {
                $count++;
 
                if ( $type === 'pt-movepage-list-other' ) {
                    $subpagesCount++;
                }
 
                $old = $pagePairs->getOldTitle();
                $new = $pagePairs->getNewTitle();
                $line = '* ' . $old->getPrefixedText() . ' → ' . $new->getPrefixedText();
                if ( $pagePairs->hasTalkpage() ) {
                    $count++;
                    $talkpagesCount++;
                    $line .= ' ' . $this->msg( 'pt-movepage-talkpage-exists' )->text();
                }
 
                $lines[] = $line;
            }
 
            $out->addWikiTextAsInterface( implode( "\n", $lines ) );
        }
 
        $nonMovableSubpages = $pageCollection->getNonMovableSubpages();
        if ( $nonMovableSubpages ) {
            $this->addSectionHeaderAndMessage( $out, 'pt-movepage-list-nonmovable', $nonMovableSubpages );
            $lines = [];
            $out->wrapWikiMsg( "'''$1'''", $this->msg( 'pt-movepage-list-nonmovable-note' ) );
            foreach ( $nonMovableSubpages as $page => $status ) {
                $invalidityReason = $this->formatterFactory
                    ->getStatusFormatter( $this->getContext() )
                    ->getWikiText( $status );
                $lines[] = '* ' . $page . ' (' . str_replace( "\n", " ", $invalidityReason ) . ')';
            }
 
            $out->addWikiTextAsInterface( implode( "\n", $lines ) );
        }
 
        $translatableSubpages = $pageCollection->getTranslatableSubpages();
        $sectionType = 'pt-movepage-list-translatable';
        $this->addSectionHeaderAndMessage( $out, $sectionType, $translatableSubpages );
        if ( $translatableSubpages ) {
            $lines = [];
            $out->wrapWikiMsg( "'''$1'''", $this->msg( 'pt-movepage-list-translatable-note' ) );
            foreach ( $translatableSubpages as $page ) {
                $lines[] = '* ' . $page->getPrefixedText();
            }
            $out->addWikiTextAsInterface( implode( "\n", $lines ) );
        }
 
        $out->addWikiTextAsInterface( "----\n" );
        $out->addWikiMsg(
            'pt-movepage-list-count',
            $this->getLanguage()->formatNum( $count ),
            $this->getLanguage()->formatNum( $subpagesCount ),
            $this->getLanguage()->formatNum( $talkpagesCount )
        );
 
        $formDescriptor = array_merge(
            $this->getCommonFormFields(),
            [
                'subpages' => [
                    'type' => 'check',
                    'name' => 'subpages',
                    'id' => 'mw-subpages',
                    'label-message' => 'pt-movepage-subpages',
                    'default' => $this->moveSubpages && !count( $nonMovableSubpages ),
                    'disabled' => count( $nonMovableSubpages )
                ],
                'redirect' => [
                    'type' => 'check',
                    'name' => 'redirect',
                    'id' => 'mw-leave-redirect',
                    'label-message' => 'pt-leave-redirect',
                    'default' => $this->leaveRedirect,
                ],
                'talkpages' => [
                    'type' => 'check',
                    'name' => 'talkpages',
                    'id' => 'mw-talkpages',
                    'label-message' => 'pt-movepage-talkpages',
                    'default' => $this->moveTalkpages
                ]
            ]
        );
 
        $htmlForm = HTMLForm::factory( 'ooui', $formDescriptor, $this->getContext() );
        $htmlForm
            ->addButton( [
                'name' => 'subaction',
                'value' => $this->msg( 'pt-movepage-action-other' )->text(),
            ] )
            ->setMethod( 'post' )
            ->setAction( $this->getPageTitle( $this->oldText )->getLocalURL() )
            ->setSubmitName( 'subaction' )
            ->setSubmitTextMsg( 'pt-movepage-action-perform' )
            ->setWrapperLegendMsg(
                $bundle instanceof MessageBundle ? 'pt-movepage-messagebundle-legend' : 'pt-movepage-legend'
            )
            ->prepareForm()
            ->displayForm( false );
    }
 
    private function addSectionHeaderAndMessage( OutputPage $out, string $type, array $pages ): void {
        $leaveRedirect = TranslatableBundleMover::shouldLeaveRedirect( $type, $this->leaveRedirect );
 
        $pageCount = count( $pages );
        if ( $leaveRedirect ) {
            $headingRedirectLabel = $this->msg(
                'pt-leave-redirect-label',
                $this->msg( $type, $pageCount )->text()
            )->text();
            $out->addWikiTextAsInterface( "<h3 class=\"mw-translate-leave-redirect\">$headingRedirectLabel</h3>" );
        } else {
            $out->wrapWikiMsg( '=== $1 ===', [ $type, $pageCount ] );
        }
 
        if ( !$pageCount ) {
            $out->addWikiMsg( 'pt-movepage-list-no-pages' );
        }
    }
 
    private function getSubactionFromRequest( string $subactionText ): string {
        switch ( $subactionText ) {
            case $this->msg( 'pt-movepage-action-check' )->text():
                return 'check';
            case $this->msg( 'pt-movepage-action-perform' )->text():
                return 'perform';
            case $this->msg( 'pt-movepage-action-other' )->text():
                return 'show-form';
            default:
                return 'show-form';
        }
    }
 
    private function getCommonFormFields(): array {
        return [
            'wpOldTitle' => [
                'type' => 'text',
                'name' => 'wpOldTitle',
                'label-message' => 'pt-movepage-current',
                'default' => $this->oldText,
                'readonly' => true,
            ],
            'wpNewTitle' => [
                'type' => 'text',
                'name' => 'wpNewTitle',
                'label-message' => 'pt-movepage-new',
            ],
            'reason' => [
                'type' => 'text',
                'name' => 'reason',
                'label-message' => 'pt-movepage-reason',
                'maxlength' => CommentStore::COMMENT_CHARACTER_LIMIT,
                'default' => $this->reason,
            ],
            'redirect' => [
                    'type' => 'hidden',
                    'name' => 'redirect',
                    'id' => 'mw-leave-redirect',
                    'label-message' => 'pt-leave-redirect',
                    'default' => $this->leaveRedirect,
            ],
            'subpages' => [
                'type' => 'hidden',
                'name' => 'subpages',
                'default' => $this->moveSubpages,
            ],
            'talkpages' => [
                'type' => 'hidden',
                'name' => 'talkpages',
                'default' => $this->moveTalkpages
            ]
        ];
    }
 
    private function getSpecialPageTitle( TranslatableBundle $bundle ): Message {
        if ( $bundle instanceof TranslatablePage ) {
            return $this->msg( 'pt-movepage-title', $this->oldText );
        } elseif ( $bundle instanceof MessageBundle ) {
            return $this->msg( 'pt-movepage-messagebundle-title', $this->oldText );
        }
 
        throw new InvalidArgumentException( 'TranslatableBundle is neither a TranslatablePage or MessageBundle' );
    }
 
    private function getLogPageWikiLink( ?TranslatableBundle $bundle ): string {
        if ( $bundle instanceof MessageBundle ) {
            return 'Special:Log/messagebundle';
        }
 
        // Default to page translation log in case of errors
        return 'Special:Log/pagetranslation';
    }
}