mediawiki-skins-Citizen/includes/Partials/Header.php

<?php
/**
 * Citizen - A responsive skin developed for the Star Citizen Wiki
 *
 * This file is part of Citizen.
 *
 * Citizen is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Citizen is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with Citizen.  If not, see <https://www.gnu.org/licenses/>.
 *
 * @file
 * @ingroup Skins
 */

declare( strict_types=1 );

namespace Citizen\Partials;

use Citizen\GetConfigTrait;
use Linker;
use MediaWiki\MediaWikiServices;
use MWException;
use OutputPage;
use Skin;
use SkinCitizen;
use SpecialPage;
use Title;

/**
 * Header partial of Skin Citizen
 * Generates the following partials:
 * - Personal Menu
 * - Extra Tools
 * - Search
 * - Theme Toggle
 */
class Header {

	use GetConfigTrait;

	/**
	 * @var Skin
	 */
	private $skin;

	/**
	 * Needed for trait
	 *
	 * @var OutputPage
	 */
	private $out;

	/**
	 * Header constructor.
	 * @param SkinCitizen $skin
	 */
	public function __construct( SkinCitizen $skin ) {
		$this->skin = $skin;
		$this->out = $skin->getOutput();
	}

	/**
	 * Build Personal Tools menu
	 *
	 * @return array
	 */
	public function buildPersonalMenu(): array {
		$personalTools = $this->skin->getPersonalToolsForMakeListItem(
			$this->skin->buildPersonalUrls()
		);

		// Move the Echo badges and ULS out of default list
		if ( isset( $personalTools['notifications-alert'] ) ) {
			unset( $personalTools['notifications-alert'] );
		}
		if ( isset( $personalTools['notifications-notice'] ) ) {
			unset( $personalTools['notifications-notice'] );
		}
		if ( isset( $personalTools['uls'] ) ) {
			unset( $personalTools['uls'] );
		}

		if ( $this->skin->getUser()->isLoggedIn() ) {
			$personalTools = $this->addUserGroupsToMenu( $personalTools );
		}

		$personalMenu = $this->skin->getMenuData( 'personal', $personalTools );
		// Hide label for personal tools
		$personalMenu[ 'label-class' ] .= 'screen-reader-text';

		return [
			'msg-citizen-personalmenu-toggle' => $this->skin->msg( 'citizen-personalmenu-toggle' )->text(),
			'data-personal-menu-list' => $personalMenu,
		];
	}

	/**
	 * Echo notification badges and ULS button
	 *
	 * @return array
	 */
	public function getExtratools(): array {
		$personalTools = $this->skin->getPersonalToolsForMakeListItem(
			$this->skin->buildPersonalUrls()
		);

		// Create the Echo badges and ULS
		$extraTools = [];
		if ( isset( $personalTools['notifications-alert'] ) ) {
			$extraTools['notifications-alert'] = $personalTools['notifications-alert'];
		}
		if ( isset( $personalTools['notifications-notice'] ) ) {
			$extraTools['notifications-notice'] = $personalTools['notifications-notice'];
		}
		if ( isset( $personalTools['uls'] ) ) {
			$extraTools['uls'] = $personalTools['uls'];
		}

		$html = $this->skin->getMenuData( 'personal-extra', $extraTools );

		// Hide label for extra tools
		$html[ 'label-class' ] .= 'screen-reader-text';

		return $html;
	}

	/**
	 * Render the search box
	 *
	 * @return array
	 * @throws MWException
	 */
	public function buildSearchProps() : array {
		$toggleMsg = $this->skin->msg( 'citizen-search-toggle' )->text();
		$accessKey = Linker::accesskey( 'search' );

		return [
			'msg-citizen-search-toggle' => $toggleMsg,
			'msg-citizen-search-toggle-shortcut' => $toggleMsg . ' [alt-shift-' . $accessKey . ']',
			'form-action' => $this->getConfigValue( 'Script' ),
			'html-input' => $this->skin->makeSearchInput( [ 'id' => 'searchInput' ] ),
			'msg-search' => $this->skin->msg( 'search' ),
			'page-title' => SpecialPage::getTitleFor( 'Search' )->getPrefixedDBkey(),
			'html-random-href' => Skin::makeSpecialUrl( 'Randompage' ),
			'msg-random' => $this->skin->msg( 'Randompage' )->text(),
		];
	}

	/**
	 * Render the theme toggle
	 *
	 * @return array
	 */
	public function buildThemeToggleProps() : array {
		$toggleMsg = $this->skin->msg( 'citizen-theme-toggle' )->text();

		return [
			'msg-citizen-theme-toggle-shortcut' => $toggleMsg,
		];
	}

	/**
	 * This adds all explicit user groups as links to the personal menu
	 * Links are added right below the user page link
	 * Wrapped in an <li> element with id 'pt-usergroups'
	 *
	 * @param array $originalUrls The original personal tools urls
	 *
	 * @return array
	 */
	private function addUserGroupsToMenu( $originalUrls ) {
		$personalTools = [];

		// This does not return implicit groups
		$groups = MediaWikiServices::getInstance()->getUserGroupManager()->getUserGroups( $this->skin->getUser() );

		// If the user has only implicit groups return early
		if ( empty( $groups ) ) {
			return $originalUrls;
		}

		$userPage = array_shift( $originalUrls );
		$groupLinks = [];
		$msgName = 'group-%s';

		foreach ( $groups as $group ) {
			$groupPage = Title::newFromText(
				$this->skin->msg( sprintf( $msgName, $group ) )->text(),
				NS_PROJECT
			);

			$groupLinks[$group] = [
				'msg' => sprintf( $msgName, $group ),
				// Nullpointer should not happen
				'href' => $groupPage->getLinkURL(),
				'tooltiponly' => true,
				'id' => sprintf( $msgName, $group ),
				// 'exists' => $groupPage->exists() - This will add an additional DB call
			];
		}

		$userGroups = [
			'id' => 'pt-usergroups',
			'links' => $groupLinks
		];

		// The following defines the order of links added
		$personalTools['userpage'] = $userPage;
		$personalTools['usergroups'] = $userGroups;

		foreach ( $originalUrls as $key => $url ) {
			$personalTools[$key] = $url;
		}

		return $personalTools;
	}
}