false, self::SHOW_DONATE => true, /** * Whether the main menu should include a link to * Special:Preferences of Special:MobileOptions */ self::MOBILE_OPTIONS => false, /** Whether a categories button should appear at the bottom of the skin. */ self::CATEGORIES => false, /** requires a wiki using Template:Ambox */ self::PAGE_ISSUES => false, /** no extension requirements */ self::TALK_AT_TOP => true, /** no extension requirements */ self::HISTORY_IN_PAGE_ACTIONS => true, /** no extension requirements */ self::TOOLBAR_SUBMENU => true, /** Whether to show tabs on special pages */ self::TABS_ON_SPECIALS => true, /** whether to show a personal menu */ self::PERSONAL_MENU => true, /** whether to show a main menu with additional items */ self::MAIN_MENU_EXPANDED => true, /** whether Echo should be replaced with a single button */ self::SINGLE_ECHO_BUTTON => false, /** whether night mode is available to the user */ self::NIGHT_MODE => false, ]; private HookContainer $hookContainer; private UserFactory $userFactory; private UserNameUtils $userNameUtils; public function __construct( HookContainer $hookContainer, UserFactory $userFactory, UserNameUtils $userNameUtils ) { $this->hookContainer = $hookContainer; $this->userFactory = $userFactory; $this->userNameUtils = $userNameUtils; } /** * override an existing option or options with new values * @param array $options */ public function setMultiple( array $options ) { foreach ( $options as $option => $value ) { if ( !array_key_exists( $option, $this->skinOptions ) ) { throw new \OutOfBoundsException( "SkinOption $option is not defined" ); } } $this->skinOptions = array_merge( $this->skinOptions, $options ); } /** * Return whether a skin option is truthy. Should be one of self:* constants * @param string $key * @return bool */ public function get( $key ) { if ( !array_key_exists( $key, $this->skinOptions ) ) { throw new \OutOfBoundsException( "SkinOption $key doesn't exist" ); } return $this->skinOptions[$key]; } /** * Get all skin options * @return array */ public function getAll() { return $this->skinOptions; } /** * Return whether any of the skin options have been set * @return bool */ public function hasSkinOptions() { foreach ( $this->skinOptions as $key => $val ) { if ( $val ) { return true; } } return false; } /** * Set the skin options for Minerva * * @param MobileContext $mobileContext * @param Skin $skin */ public function setMinervaSkinOptions( MobileContext $mobileContext, Skin $skin ) { // setSkinOptions is not available if ( $skin instanceof SkinMinerva ) { $services = MediaWikiServices::getInstance(); $featureManager = $services ->getService( 'MobileFrontend.FeaturesManager' ); $title = $skin->getTitle(); // T245162 - this should only apply if the context relates to a page view. // Examples: // - parsing wikitext during an REST response // - a ResourceLoader response if ( $title !== null ) { // T232653: TALK_AT_TOP, HISTORY_IN_PAGE_ACTIONS, TOOLBAR_SUBMENU should // be true on user pages and user talk pages for all users // // For some reason using $services->getService( 'SkinUserPageHelper' ) // here results in a circular dependency error which is why // SkinUserPageHelper is being instantiated instead. $relevantUserPageHelper = new SkinUserPageHelper( $this->userNameUtils, $this->userFactory, $title->inNamespace( NS_USER_TALK ) ? $title->getSubjectPage() : $title, $mobileContext ); $isUserPage = $relevantUserPageHelper->isUserPage(); $isUserPageAccessible = $relevantUserPageHelper->isUserPageAccessibleToCurrentUser(); $isUserPageOrUserTalkPage = $isUserPage && $isUserPageAccessible; } else { // If no title this must be false $isUserPageOrUserTalkPage = false; } $isBeta = $mobileContext->isBetaGroupMember(); $this->setMultiple( [ self::SHOW_DONATE => $featureManager->isFeatureAvailableForCurrentUser( 'MinervaDonateLink' ), self::TALK_AT_TOP => $isUserPageOrUserTalkPage ? true : $featureManager->isFeatureAvailableForCurrentUser( 'MinervaTalkAtTop' ), self::BETA_MODE => $isBeta, self::CATEGORIES => $featureManager->isFeatureAvailableForCurrentUser( 'MinervaShowCategories' ), self::PAGE_ISSUES => $featureManager->isFeatureAvailableForCurrentUser( 'MinervaPageIssuesNewTreatment' ), self::MOBILE_OPTIONS => true, self::PERSONAL_MENU => $featureManager->isFeatureAvailableForCurrentUser( 'MinervaPersonalMenu' ), self::MAIN_MENU_EXPANDED => $featureManager->isFeatureAvailableForCurrentUser( 'MinervaAdvancedMainMenu' ), // In mobile, always resort to single icon. self::SINGLE_ECHO_BUTTON => true, self::HISTORY_IN_PAGE_ACTIONS => $isUserPageOrUserTalkPage ? true : $featureManager->isFeatureAvailableForCurrentUser( 'MinervaHistoryInPageActions' ), self::TOOLBAR_SUBMENU => $isUserPageOrUserTalkPage ? true : $featureManager->isFeatureAvailableForCurrentUser( Hooks::FEATURE_OVERFLOW_PAGE_ACTIONS ), self::TABS_ON_SPECIALS => true, self::NIGHT_MODE => $featureManager->isFeatureAvailableForCurrentUser( 'MinervaNightMode' ), ] ); ( new HookRunner( $this->hookContainer ) )->onSkinMinervaOptionsInit( $skin, $this ); } } }