mediawiki-skins-MinervaNeue/includes/Menu/Main/AdvancedMainMenuBuilder.php
Thiemo Kreuz 31659edf3d Use more narrow UserIdentity interface where possible
There is still a lot of places that need either an Authority or still
an actual User object. This patch changes the usages that can be
changed right now (almost) without any codechange.

The only additional change is the removal of an unused constructor
argument.

Change-Id: I0fbb3c2cc4cea7fba135d92b04421b0563c0f0c8
2021-12-17 18:16:49 +01:00

114 lines
3 KiB
PHP

<?php
/**
* This program 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 2 of the License, or
* (at your option) any later version.
*
* This program 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 this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
*/
namespace MediaWiki\Minerva\Menu\Main;
use FatalError;
use Hooks;
use MediaWiki\Minerva\Menu\Definitions;
use MediaWiki\Minerva\Menu\Group;
use MWException;
/**
* A menu builder that provides additional menu entries that match
* Advanced Mobile Contributions project requirements. This menu
* is used when AMC SkinOption flag is set to true.
*
* @package MediaWiki\Minerva\Menu\Main
*/
final class AdvancedMainMenuBuilder implements IMainMenuBuilder {
/**
* @var bool
*/
private $showMobileOptions;
/**
* @var bool
*/
private $showDonateLink;
/**
* @var Definitions
*/
private $definitions;
/**
* Initialize the Default Main Menu builder
*
* @param bool $showMobileOptions Show MobileOptions instead of Preferences
* @param bool $showDonateLink whether to show the donate link
* @param Definitions $definitions A menu items definitions set
*/
public function __construct( $showMobileOptions, $showDonateLink, Definitions $definitions ) {
$this->showMobileOptions = $showMobileOptions;
$this->showDonateLink = $showDonateLink;
$this->definitions = $definitions;
}
/**
* @inheritDoc
* @return Group[]
* @throws FatalError
* @throws MWException
*/
public function getGroups(): array {
$donate = $this->showDonateLink ?
BuilderUtil::getDonateGroup( $this->definitions ) : null;
$groups = [
BuilderUtil::getDiscoveryTools( $this->definitions ),
$this->getSiteTools(),
BuilderUtil::getConfigurationTools( $this->definitions, $this->showMobileOptions ),
];
if ( $donate ) {
$groups[] = $donate;
}
return $groups;
}
/**
* @inheritDoc
* @throws FatalError
* @throws MWException
*/
public function getSiteLinks(): Group {
return BuilderUtil::getSiteLinks( $this->definitions );
}
/**
* Prepares a list of links that have the purpose of discovery in the main navigation menu
* @return Group
* @throws FatalError
* @throws MWException
*/
private function getSiteTools(): Group {
$group = new Group( 'p-interaction' );
$this->definitions->insertRecentChanges( $group );
$this->definitions->insertSpecialPages( $group );
$this->definitions->insertCommunityPortal( $group );
// Allow other extensions to add or override tools
Hooks::run( 'MobileMenu', [ 'sitetools', &$group ] );
return $group;
}
}