CreditsAction.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;

class CreditsAction extends FormlessAction {

    public function getName() {
        return 'credits';
    }

    protected function getDescription() {
        return $this->msg( 'creditspage' )->escaped();
    }

    public function onView() {
        if ( $this->page->getID() == 0 ) {
            $s = $this->msg( 'nocredits' )->parse();
        } else {
            $s = $this->getCredits( -1 );
        }

        return Html::rawElement( 'div', [ 'id' => 'mw-credits' ], $s );
    }

    public function getCredits( $cnt, $showIfMax = true ) {
        $s = '';

        if ( $cnt != 0 ) {
            $s = $this->getAuthor( $this->page );
            if ( $cnt > 1 || $cnt < 0 ) {
                $s .= ' ' . $this->getContributors( $cnt - 1, $showIfMax );
            }
        }

        return $s;
    }

    protected function getAuthor( Page $page ) {
        $user = User::newFromName( $page->getUserText(), false );

        $timestamp = $page->getTimestamp();
        if ( $timestamp ) {
            $lang = $this->getLanguage();
            $d = $lang->date( $page->getTimestamp(), true );
            $t = $lang->time( $page->getTimestamp(), true );
        } else {
            $d = '';
            $t = '';
        }

        return $this->msg( 'lastmodifiedatby', $d, $t )->rawParams(
            $this->userLink( $user ) )->params( $user->getName() )->escaped();
    }

    protected function canShowRealUserName() {
        $hiddenPrefs = $this->context->getConfig()->get( 'HiddenPrefs' );
        return !in_array( 'realname', $hiddenPrefs );
    }

    protected function getContributors( $cnt, $showIfMax ) {
        $contributors = $this->page->getContributors();

        $others_link = false;

        # Hmm... too many to fit!
        if ( $cnt > 0 && $contributors->count() > $cnt ) {
            $others_link = $this->othersLink();
            if ( !$showIfMax ) {
                return $this->msg( 'othercontribs' )->rawParams(
                    $others_link )->params( $contributors->count() )->escaped();
            }
        }

        $real_names = [];
        $user_names = [];
        $anon_ips = [];

        # Sift for real versus user names

        foreach ( $contributors as $user ) {
            $cnt--;
            if ( $user->isLoggedIn() ) {
                $link = $this->link( $user );
                if ( $this->canShowRealUserName() && $user->getRealName() ) {
                    $real_names[] = $link;
                } else {
                    $user_names[] = $link;
                }
            } else {
                $anon_ips[] = $this->link( $user );
            }

            if ( $cnt == 0 ) {
                break;
            }
        }

        $lang = $this->getLanguage();

        if ( count( $real_names ) ) {
            $real = $lang->listToText( $real_names );
        } else {
            $real = false;
        }

        # "ThisSite user(s) A, B and C"
        if ( count( $user_names ) ) {
            $user = $this->msg( 'siteusers' )->rawParams( $lang->listToText( $user_names ) )->params(
                count( $user_names ) )->escaped();
        } else {
            $user = false;
        }

        if ( count( $anon_ips ) ) {
            $anon = $this->msg( 'anonusers' )->rawParams( $lang->listToText( $anon_ips ) )->params(
                count( $anon_ips ) )->escaped();
        } else {
            $anon = false;
        }

        # This is the big list, all mooshed together. We sift for blank strings
        $fulllist = [];
        foreach ( [ $real, $user, $anon, $others_link ] as $s ) {
            if ( $s !== false ) {
                array_push( $fulllist, $s );
            }
        }

        $count = count( $fulllist );

        # "Based on work by ..."
        return $count
            ? $this->msg( 'othercontribs' )->rawParams(
                $lang->listToText( $fulllist ) )->params( $count )->escaped()
            : '';
    }

    protected function link( User $user ) {
        if ( $this->canShowRealUserName() && !$user->isAnon() ) {
            $real = $user->getRealName();
            if ( $real === '' ) {
                $real = $user->getName();
            }
        } else {
            $real = $user->getName();
        }

        $page = $user->isAnon()
            ? SpecialPage::getTitleFor( 'Contributions', $user->getName() )
            : $user->getUserPage();

        return MediaWikiServices::getInstance()
            ->getLinkRenderer()->makeLink( $page, $real );
    }

    protected function userLink( User $user ) {
        $link = $this->link( $user );
        if ( $user->isAnon() ) {
            return $this->msg( 'anonuser' )->rawParams( $link )->parse();
        } elseif ( $this->canShowRealUserName() && $user->getRealName() ) {
            return $link;
        } else {
            return $this->msg( 'siteuser' )->rawParams( $link )->params( $user->getName() )->escaped();
        }
    }

    protected function othersLink() {
        return MediaWikiServices::getInstance()->getLinkRenderer()->makeKnownLink(
            $this->getTitle(),
            $this->msg( 'others' )->text(),
            [],
            [ 'action' => 'credits' ]
        );
    }
}