BlockErrorFormatter.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Block;
 
use CommentStoreComment;
use Language;
use Message;
use User;
 
class BlockErrorFormatter {
    public function getMessage(
        AbstractBlock $block,
        User $user,
        Language $language,
        $ip
    ) {
        $key = $this->getBlockErrorMessageKey( $block );
        $params = $this->getBlockErrorMessageParams( $block, $user, $language, $ip );
        return new Message( $key, $params );
    }
 
    private function getBlockErrorInfo( AbstractBlock $block ) {
        return [
            'identifier' => $block->getIdentifier(),
            'targetName' => (string)$block->getTarget(),
            'blockerName' => $block->getByName(),
            'blockerId' => $block->getBy(),
            'reason' => $block->getReasonComment(),
            'expiry' => $block->getExpiry(),
            'timestamp' => $block->getTimestamp(),
        ];
    }
 
    private function getFormattedBlockErrorInfo(
        AbstractBlock $block,
        User $user,
        Language $language
    ) {
        $info = $this->getBlockErrorInfo( $block );
 
        $info['expiry'] = $language->formatExpiry( $info['expiry'] );
        $info['timestamp'] = $language->userTimeAndDate( $info['timestamp'], $user );
        $info['blockerName'] = $language->embedBidi( $info['blockerName'] );
        $info['targetName'] = $language->embedBidi( $info['targetName'] );
 
        $info['reason'] = $this->formatBlockReason( $info['reason'], $language );
 
        return $info;
    }
 
    private function formatBlockReason( CommentStoreComment $reason, Language $language ) {
        if ( $reason->text === '' ) {
            $message = new Message( 'blockednoreason', [], $language );
            return $message->text();
        }
        return $reason->message->inLanguage( $language )->plain();
    }
 
    private function formatBlockerLink( $blockerName, $blockerId, Language $language ) {
        if ( $blockerId === 0 ) {
            // Foreign user
            return $blockerName;
        }
 
        $blocker = User::newFromId( $blockerId );
        $blockerUserpage = $blocker->getUserPage();
        $blockerText = $language->embedBidi( $blockerUserpage->getText() );
        return "[[{$blockerUserpage->getPrefixedText()}|{$blockerText}]]";
    }
 
    private function getBlockErrorMessageKey( AbstractBlock $block ) {
        $key = 'blockedtext';
        if ( $block instanceof DatabaseBlock ) {
            if ( $block->getType() === AbstractBlock::TYPE_AUTO ) {
                $key = 'autoblockedtext';
            } elseif ( !$block->isSitewide() ) {
                $key = 'blockedtext-partial';
            }
        } elseif ( $block instanceof SystemBlock ) {
            $key = 'systemblockedtext';
        } elseif ( $block instanceof CompositeBlock ) {
            $key = 'blockedtext-composite';
        }
        return $key;
    }
 
    private function getBlockErrorMessageParams(
        AbstractBlock $block,
        User $user,
        Language $language,
        $ip
    ) {
        $info = $this->getFormattedBlockErrorInfo( $block, $user, $language );
 
        // Add params that are specific to the standard block errors
        $info['ip'] = $ip;
        $info['blockerLink'] = $this->formatBlockerLink(
            $info['blockerName'],
            $info['blockerId'],
            $language
        );
 
        // Display the CompositeBlock identifier as a message containing relevant block IDs
        if ( $block instanceof CompositeBlock ) {
            $ids = $language->commaList( array_map(
                function ( $id ) {
                    return '#' . $id;
                },
                array_filter( $info['identifier'], 'is_int' )
            ) );
            if ( $ids === '' ) {
                $idsMsg = new Message( 'blockedtext-composite-no-ids', [], $language );
            } else {
                $idsMsg = new Message( 'blockedtext-composite-ids', [ $ids ], $language );
            }
            $info['identifier'] = $idsMsg->plain();
        }
 
        // Messages expect the params in this order
        $order = [
            'blockerLink',
            'reason',
            'ip',
            'blockerName',
            'identifier',
            'expiry',
            'targetName',
            'timestamp',
        ];
 
        $params = [];
        foreach ( $order as $item ) {
            $params[] = $info[$item];
        }
 
        return $params;
    }
}