UserLinkRenderer.php

Go to the documentation of this file.

<?php
declare( strict_types=1 );
 
namespace MediaWiki\Linker;
 
use MediaWiki\Context\IContextSource;
use MediaWiki\Html\Html;
use MediaWiki\SpecialPage\SpecialPageFactory;
use MediaWiki\Title\TitleValue;
use MediaWiki\User\ExternalUserNames;
use MediaWiki\User\TempUser\TempUserConfig;
use MediaWiki\User\TempUser\TempUserDetailsLookup;
use MediaWiki\User\UserIdentity;
use MessageLocalizer;
use Wikimedia\HtmlArmor\HtmlArmor;
use Wikimedia\IPUtils;
use Wikimedia\MapCacheLRU\MapCacheLRU;
 
class UserLinkRenderer {
    private TempUserConfig $tempUserConfig;
    private SpecialPageFactory $specialPageFactory;
    private LinkRenderer $linkRenderer;
    private TempUserDetailsLookup $tempUserDetailsLookup;
 
    private MapCacheLRU $userLinkCache;
 
    public function __construct(
        TempUserConfig $tempUserConfig,
        SpecialPageFactory $specialPageFactory,
        LinkRenderer $linkRenderer,
        TempUserDetailsLookup $tempUserDetailsLookup
    ) {
        $this->tempUserConfig = $tempUserConfig;
        $this->specialPageFactory = $specialPageFactory;
        $this->linkRenderer = $linkRenderer;
        $this->tempUserDetailsLookup = $tempUserDetailsLookup;
 
        // Set a large enough cache size to accommodate long pagers,
        // such as Special:RecentChanges with a high limit.
        $this->userLinkCache = new MapCacheLRU( 1_000 );
    }
 
    public function userLink(
        UserIdentity $targetUser,
        IContextSource $context,
        ?string $altUserName = null,
        array $attributes = []
    ): string {
        $outputPage = $context->getOutput();
        $outputPage->addModuleStyles( [
            'mediawiki.interface.helpers.styles',
            'mediawiki.interface.helpers.linker.styles'
        ] );
 
        return $this->userLinkCache->getWithSetCallback(
            $this->userLinkCache->makeKey(
                $targetUser->getName(),
                $altUserName ?? '',
                implode( ' ', $attributes )
            ),
            fn () => $this->renderUserLink( $targetUser, $context, $altUserName, $attributes )
        );
    }
 
    private function renderUserLink(
        UserIdentity $targetUser,
        MessageLocalizer $messageLocalizer,
        ?string $altUserName = null,
        array $attributes = []
    ): string {
        $userName = $targetUser->getName();
 
        $classes = [ 'mw-userlink' ];
 
        $postfix = '';
 
        if ( $this->tempUserConfig->isTempName( $userName ) ) {
            $classes[] = 'mw-tempuserlink';
            $attributes['data-mw-target'] = $userName;
 
            // Adjust the styling of expired temporary account links (T358469).
            if ( $this->tempUserDetailsLookup->isExpired( $targetUser ) ) {
                $classes[] = 'mw-tempuserlink-expired';
 
                $description = $messageLocalizer->msg( 'tempuser-expired-link-tooltip' )->text();
 
                $postfix = Html::element(
                    'span',
                    [
                        'role' => 'presentation',
                        'class' => 'cdx-tooltip mw-tempuserlink-expired--tooltip',
                    ],
                    $description
                );
 
                $attributes['aria-description'] = $description;
 
                // Hide default link title when rendering expired temporary account links
                // to avoid conflicting with the tooltip.
                $attributes['title'] = null;
            }
 
            $pageName = $this->specialPageFactory->getLocalNameFor( 'Contributions', $userName );
            $page = new TitleValue( NS_SPECIAL, $pageName );
        } elseif ( !$targetUser->isRegistered() ) {
            $page = ExternalUserNames::getUserLinkTitle( $userName );
 
            if ( ExternalUserNames::isExternal( $userName ) ) {
                $classes[] = 'mw-extuserlink';
            } elseif ( $altUserName === null ) {
                $altUserName = IPUtils::prettifyIP( $userName );
            }
            $classes[] = 'mw-anonuserlink'; // Separate link class for anons (T45179)
        } else {
            $page = TitleValue::tryNew( NS_USER, strtr( $userName, ' ', '_' ) );
        }
 
        // Wrap the output with <bdi> tags for directionality isolation
        $linkText =
            '<bdi>' . htmlspecialchars( $altUserName ?? $userName ) . '</bdi>'
             . $postfix;
 
        if ( isset( $attributes['class'] ) ) {
            $classes[] = $attributes['class'];
        }
 
        $attributes['class'] = $classes;
 
        if ( $page !== null ) {
            return $this->linkRenderer->makeLink( $page, new HtmlArmor( $linkText ), $attributes );
        }
 
        return Html::rawElement( 'span', $attributes, $linkText );
    }
}