. * * @file * @ingroup Skins */ declare( strict_types=1 ); namespace Citizen\Partials; use Exception; use MediaWiki\MediaWikiServices; final class PageTools extends Partial { /** * Render page-related tools * Possible visibility conditions: * * true: always visible (bool) * * false: never visible (bool) * * 'login': only visible if logged in (string) * * 'permission-*': only visible if user has permission * e.g. permission-edit = only visible if user can edit pages * * @return array html */ public function buildPageTools(): array { $condition = $this->getConfigValue( 'CitizenShowPageTools' ); $contentNavigation = $this->skin->buildContentNavigationUrlsPublic(); $portals = $this->skin->buildSidebar(); $props = []; // Login-based condition, return true if condition is met if ( $condition === 'login' ) { $condition = $this->skin->getUser()->isRegistered(); } // Permission-based condition, return true if condition is met if ( is_string( $condition ) && strpos( $condition, 'permission' ) === 0 ) { $permission = substr( $condition, 11 ); try { $condition = MediaWikiServices::getInstance()->getPermissionManager()->userCan( $permission, $this->skin->getUser(), $this->skin->getTitle() ); } catch ( Exception $e ) { $condition = false; } } if ( $condition === true ) { $viewshtml = $this->skin->getMenuData( 'views', $contentNavigation[ 'views' ] ?? [] ); $actionshtml = $this->skin->getMenuData( 'actions', $contentNavigation[ 'actions' ] ?? [] ); $namespaceshtml = $this->skin->getMenuData( 'namespaces', $contentNavigation[ 'namespaces' ] ?? [] ); $variantshtml = $this->skin->getMenuData( 'variants', $contentNavigation[ 'variants' ] ?? [] ); $toolboxhtml = $this->skin->getMenuData( 'tb', $portals['TOOLBOX'] ?? [] ); if ( $viewshtml ) { $viewshtml[ 'label-class' ] .= 'screen-reader-text'; } if ( $actionshtml ) { $actionshtml[ 'label-class' ] .= 'screen-reader-text'; } $props = [ 'data-page-views' => $viewshtml, 'data-page-actions' => $actionshtml, 'data-namespaces' => $namespaceshtml, 'data-variants' => $variantshtml, 'data-page-toolbox' => $toolboxhtml, ]; } return $props; } }