SpecialMyLanguage.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials;
 
use MediaWiki\Languages\LanguageNameUtils;
use MediaWiki\Page\RedirectLookup;
use MediaWiki\SpecialPage\RedirectSpecialArticle;
use MediaWiki\Title\Title;
 
class SpecialMyLanguage extends RedirectSpecialArticle {
 
    private LanguageNameUtils $languageNameUtils;
    private RedirectLookup $redirectLookup;
 
    public function __construct(
        LanguageNameUtils $languageNameUtils,
        RedirectLookup $redirectLookup
    ) {
        parent::__construct( 'MyLanguage' );
        $this->languageNameUtils = $languageNameUtils;
        $this->redirectLookup = $redirectLookup;
    }
 
    public function getRedirect( $subpage ) {
        $title = $this->findTitle( $subpage );
        // Go to the main page if given invalid title.
        if ( !$title ) {
            $title = Title::newMainPage();
        }
        return $title;
    }
 
    public function findTitle( $subpage ) {
        return $this->findTitleInternal( $subpage, false );
    }
 
    public function findTitleForTransclusion( $subpage ) {
        return $this->findTitleInternal( $subpage, true );
    }
 
    private function findTitleInternal( $subpage, $forTransclusion ) {
        // base = title without the language code suffix
        // provided = the title as it was given
        $base = $provided = null;
        if ( $subpage !== null ) {
            $provided = Title::newFromText( $subpage );
            $base = $provided;
 
            if ( $provided && str_contains( $subpage, '/' ) ) {
                $pos = strrpos( $subpage, '/' );
                $basepage = substr( $subpage, 0, $pos );
                $code = substr( $subpage, $pos + 1 );
                if ( strlen( $code ) && $this->languageNameUtils->isKnownLanguageTag( $code ) ) {
                    $base = Title::newFromText( $basepage );
                }
            }
        }
 
        if ( !$base || !$base->canExist() ) {
            // No subpage provided or base page does not exist
            return null;
        }
 
        $fragment = '';
        if ( $base->isRedirect() ) {
            $base = $this->redirectLookup->getRedirectTarget( $base );
            // Preserve the fragment from the redirect target
            $fragment = $base->getFragment();
        }
 
        $uiLang = $this->getLanguage();
        $baseLang = $base->getPageLanguage();
 
        // T309329: Always use subpages for transclusion
        if ( !$forTransclusion && $baseLang->equals( $uiLang ) ) {
            // Short circuit when the current UI language is the
            // page's content language to avoid unnecessary page lookups.
            return $base;
        }
 
        // Check for a subpage in the current UI language
        $proposed = $base->getSubpage( $uiLang->getCode() );
        if ( $proposed && $proposed->exists() ) {
            if ( $fragment !== '' ) {
                $proposed->setFragment( $fragment );
            }
            return $proposed;
        }
 
        // Explicit language code given and the page exists
        if ( $provided !== $base && $provided->exists() ) {
            // Not based on the redirect target, don't need the fragment
            return $provided;
        }
 
        // Check for fallback languages specified by the UI language
        $possibilities = $uiLang->getFallbackLanguages();
        foreach ( $possibilities as $lang ) {
            // $base already include fragments
            // T309329: Always use subpages for transclusion
            // T333187: Do not ignore base language page if matched
            if ( !$forTransclusion && $lang === $baseLang->getCode() ) {
                return $base;
            }
            // Look for subpages if is for transclusion or didn't match base page language
            $proposed = $base->getSubpage( $lang );
            if ( $proposed && $proposed->exists() ) {
                if ( $fragment !== '' ) {
                    $proposed->setFragment( $fragment );
                }
                return $proposed;
            }
        }
 
        // When all else has failed, return the base page
        return $base;
    }
 
    public function personallyIdentifiableTarget() {
        return true;
    }
}
 
class_alias( SpecialMyLanguage::class, 'SpecialMyLanguage' );