UserGroupMembership.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;
use MediaWiki\Title\Title;
use MediaWiki\User\UserIdentity;
 
class UserGroupMembership {
 
    private $userId;
 
    private $group;
 
    private $expiry;
 
    private $expired;
 
    public function __construct( int $userId = 0, ?string $group = null, ?string $expiry = null ) {
        $this->userId = $userId;
        $this->group = $group;
        $this->expiry = $expiry ?: null;
        $this->expired = $expiry ? wfTimestampNow() > $expiry : false;
    }
 
    public function getUserId() {
        return $this->userId;
    }
 
    public function getGroup() {
        return $this->group;
    }
 
    public function getExpiry() {
        return $this->expiry;
    }
 
    public function isExpired() {
        return $this->expired;
    }
 
    public static function getLink( $ugm, IContextSource $context, $format, $userName = null ) {
        if ( $format !== 'wiki' && $format !== 'html' ) {
            throw new InvalidArgumentException( 'UserGroupMembership::getLink() $format parameter should be ' .
                "'wiki' or 'html'" );
        }
 
        if ( $ugm instanceof UserGroupMembership ) {
            $expiry = $ugm->getExpiry();
            $group = $ugm->getGroup();
        } else {
            $expiry = null;
            $group = $ugm;
        }
 
        $uiLanguage = $context->getLanguage();
        if ( $userName !== null ) {
            $groupName = $uiLanguage->getGroupMemberName( $group, $userName );
        } else {
            $groupName = $uiLanguage->getGroupName( $group );
        }
 
        // link to the group description page, if it exists
        $linkTitle = self::getGroupPage( $group );
        $linkRenderer = MediaWikiServices::getInstance()->getLinkRenderer();
        if ( $format === 'wiki' ) {
            if ( $linkTitle ) {
                $linkPage = $linkTitle->getFullText();
                $groupLink = "[[$linkPage|$groupName]]";
            } else {
                $groupLink = $groupName;
            }
        } else {
            if ( $linkTitle ) {
                $groupLink = $linkRenderer->makeLink( $linkTitle, $groupName );
            } else {
                $groupLink = htmlspecialchars( $groupName );
            }
        }
 
        if ( $expiry ) {
            // format the expiry to a nice string
            $uiUser = $context->getUser();
            $expiryDT = $uiLanguage->userTimeAndDate( $expiry, $uiUser );
            $expiryD = $uiLanguage->userDate( $expiry, $uiUser );
            $expiryT = $uiLanguage->userTime( $expiry, $uiUser );
 
            if ( $format === 'wiki' ) {
                return $context->msg( 'group-membership-link-with-expiry' )
                    ->params( $groupLink, $expiryDT, $expiryD, $expiryT )->text();
            } else {
                // @phan-suppress-next-line SecurityCheck-XSS False positive, only XSS if wiki format
                $groupLink = Message::rawParam( $groupLink );
                return $context->msg( 'group-membership-link-with-expiry' )
                    ->params( $groupLink, $expiryDT, $expiryD, $expiryT )->escaped();
            }
        }
        return $groupLink;
    }
 
    public static function getGroupName( $group ) {
        return RequestContext::getMain()->getLanguage()->getGroupName( $group );
    }
 
    public static function getGroupMemberName( $group, $member ) {
        return RequestContext::getMain()->getLanguage()->getGroupMemberName( $group, $member );
    }
 
    public static function getGroupPage( $group ) {
        $msg = wfMessage( "grouppage-$group" )->inContentLanguage();
        if ( $msg->exists() ) {
            $title = Title::newFromText( $msg->text() );
            if ( is_object( $title ) ) {
                return $title;
            }
        }
        return false;
    }
 
    public function equals( UserGroupMembership $ugm ) {
        return (
            $ugm->getUserId() === $this->userId
            && $ugm->getGroup() === $this->group
        );
    }
 
}