html( 'bottomscripts' ); /* JS call to runBodyOnloadHook */ $this->html( 'reporttime' ); if ( $this->data['debug'] ) { ?> '; $output .= '' . $topItem['title'] . ''; $output .= ''; } elseif ( $pageTitle ) { $active_class = $this->data['title'] == $topItem['title'] ? 'active' : ''; $output .= sprintf( '

%3$s

', $active_class, ! empty( $topItem['external'] ) ? $topItem['link'] : $pageTitle->getLocalURL(), $topItem['title'] ?? null ); } } return $output; } /** * Render one or more navigations elements by name, automatically reveresed * when UI is in RTL mode */ private function navSelect( $nav ) { $output = ''; foreach ( $nav as $topItem ) { $pageTitle = Title::newFromText( $topItem['link'] ?: $topItem['title'] ); $output .= ''; if ( array_key_exists( 'sublinks', $topItem ) ) { foreach ( $topItem['sublinks'] as $subLink ) { if ( 'divider' == $subLink ) { $output .= "----\n"; } elseif ( ! empty( $subLink['textonly'] ) ) { $output .= "{$subLink['title']}\n"; } else { if( ! empty( $subLink['local'] ) && $pageTitle = Title::newFromText( $subLink['link'] ) ) { $href = $pageTitle->getLocalURL(); } else { $href = $subLink['link']; }//end else $output .= "{$subLink['title']}"; }//end else }//end foreach } elseif ( $pageTitle ) { $output .= '' . $topItem['title'] . ''; }//end else $output .= ''; }//end foreach return $output; } /** * Generates the logo and (optionally) site title * @param string $id * @param bool $imageOnly Whether or not to generate the logo with only the image, * or with a text link as well * * @return string html */ protected function getLogo( $id = 'p-logo', $imageOnly = false ) { $html = Html::openElement( 'div', [ 'id' => $id, 'class' => 'mw-portlet', 'role' => 'banner' ] ); $html .= Html::element( 'a', [ 'href' => $this->data['nav_urls']['mainpage']['href'], 'class' => 'mw-wiki-logo', ] + Linker::tooltipAndAccesskeyAttribs( 'p-logo' ) ); if ( !$imageOnly ) { $language = $this->getSkin()->getLanguage(); $siteTitle = $language->convert( $this->getMsg( 'sitetitle' )->escaped() ); $html .= Html::rawElement( 'a', [ 'id' => 'p-banner', 'class' => 'mw-wiki-title', 'href' => $this->data['nav_urls']['mainpage']['href'] ] + Linker::tooltipAndAccesskeyAttribs( 'p-logo' ), $siteTitle ); } $html .= Html::closeElement( 'div' ); return $html; } /** * Generates the search form * @return string html */ protected function getSearch() { $html = Html::openElement( 'form', [ 'action' => $this->get( 'wgScript' ), 'role' => 'search', 'class' => 'mw-portlet', 'id' => 'p-search' ] ); $html .= Html::hidden( 'title', $this->get( 'searchtitle' ) ); $html .= Html::rawElement( 'h3', [], Html::label( $this->getMsg( 'search' )->text(), 'searchInput' ) ); $html .= $this->makeSearchInput( [ 'id' => 'searchInput' ] ); $html .= $this->makeSearchButton( 'go', [ 'id' => 'searchGoButton', 'class' => 'searchButton' ] ); $html .= Html::closeElement( 'form' ); return $html; } /** * Generates the sidebar * Set the elements to true to allow them to be part of the sidebar * Or get rid of this entirely, and take the specific bits to use wherever you actually want them * * Toolbox is the page/site tools that appears under the sidebar in vector * * Languages is the interlanguage links on the page via en:... es:... etc * * Default is each user-specified box as defined on MediaWiki:Sidebar; you will still need a foreach loop * to parse these. * @return string html */ protected function getSiteNavigation() { $html = ''; $sidebar = $this->getSidebar(); $sidebar['SEARCH'] = false; $sidebar['TOOLBOX'] = true; $sidebar['LANGUAGES'] = true; foreach ( $sidebar as $name => $content ) { if ( $content === false ) { continue; } // Numeric strings gets an integer when set as key, cast back - T73639 $name = (string)$name; switch ( $name ) { case 'SEARCH': $html .= $this->getSearch(); break; case 'TOOLBOX': $html .= $this->getPortlet( 'tb', $this->getToolbox(), 'toolbox' ); break; case 'LANGUAGES': $html .= $this->getLanguageLinks(); break; default: $html .= $this->getPortlet( $name, $content['content'] ); break; } } return $html; } /** * In other languages list * * @return string html */ protected function getLanguageLinks() { $html = ''; if ( $this->data['language_urls'] !== false ) { $html .= $this->getPortlet( 'lang', $this->data['language_urls'], 'otherlanguages' ); } return $html; } /** * Language variants. Displays list for converting between different scripts in the same language, * if using a language where this is applicable (such as latin vs cyric display for serbian). * * @return string html */ protected function getVariants() { $html = ''; if ( count( $this->data['content_navigation']['variants'] ) > 0 ) { $html .= $this->getPortlet( 'variants', $this->data['content_navigation']['variants'] ); } return $html; } /** * Generates page-related tools/links * You will probably want to split this up and move all of these to somewhere that makes sense for your skin. * @return string html */ protected function getPageLinks( $source ) { $title = null; $titleBar = $this->getPageRawText( $source ); $nav = []; foreach ( explode( "\n", $titleBar ) as $line ) { if ( trim( $line ) == '' ) { continue; } if ( preg_match('/^\*\*\s*divider/', $line ) ) { $nav[ count( $nav ) - 1 ]['sublinks'][] = 'divider'; continue; } $sub = false; $link = false; $external = false; $non_sub_prefix = '\*\s*'; $sub_prefix = '\*\*\s*'; $page_link = '\[\[:?(.+)\]\]'; if ( preg_match( "/^{$non_sub_prefix}([^\*]*){$page_link}/", $line, $match ) ) { $sub = false; $link = true; } elseif ( preg_match( "/^{$non_sub_prefix}([^\*\[]*)\[([^\[ ]+) (.+)\]/", $line, $match ) ) { $sub = false; $link = true; $external = true; } elseif ( preg_match( "/^{$sub_prefix}([^\*\[]*)\[([^\[ ]+) (.+)\]/", $line, $match ) ) { $sub = true; $link = true; $external = true; } elseif ( preg_match( "/{$sub_prefix}([^\*]*){$page_link}/", $line, $match ) ) { $sub = true; $link = true; } elseif ( preg_match( "/{$sub_prefix}([^\* ]*)(.+)/", $line, $match ) ) { $sub = true; $link = false; } elseif ( preg_match( "/^{$non_sub_prefix}(.+)/", $line, $match ) ) { $sub = false; $link = false; } if( isset( $match[2] ) && strpos( $match[2], '|' ) !== false ) { $item = explode( '|', $match[2] ); $item = array( 'title' => $match[1] . $item[1], 'link' => $item[0], 'local' => true, ); } else { if( $external ) { $item = $match[2]; $title = $match[1] . $match[3]; } elseif ( isset( $match[1] ) ) { $item = $match[1]; if ( ! empty( $match[2] ) ) { $item .= $match[2]; } $title = $item; } else { continue; } if( $link ) { $item = array('title'=> $title, 'link' => $item, 'local' => ! $external , 'external' => $external ); } else { $item = array('title'=> $title, 'link' => $item, 'textonly' => true, 'external' => $external ); }//end else }//end else if( $sub ) { $nav[count( $nav ) - 1]['sublinks'][] = $item; } else { $nav[] = $item; }//end else } return $nav; } public function getPageRawText($title) { $pageTitle = Title::newFromText($title); if(!$pageTitle->exists()) { return 'Create the page [[Bootstrap:TitleBar]]'; } else { $page = WikiPage::factory( $pageTitle ); $revision = $page->getRevision(); $content = $revision->getContent( Revision::RAW ); return ContentHandler::getContentText( $content ); } } /** * Generates user tools menu * @return string html */ protected function getUserLinks() { // Basic list output return $this->getPortlet( 'personal', $this->getPersonalTools(), 'personaltools' ); } /** * Generates siteNotice, if any * @return string html */ protected function getSiteNotice() { return $this->getIfExists( 'sitenotice', [ 'wrapper' => 'div', 'parameters' => [ 'id' => 'siteNotice' ] ] ); } /** * Generates new talk message banner, if any * @return string html */ protected function getNewTalk() { return $this->getIfExists( 'newtalk', [ 'wrapper' => 'div', 'parameters' => [ 'class' => 'usermessage' ] ] ); } /** * Generates subtitle stuff, if any * @return string html */ protected function getPageSubtitle() { return $this->getIfExists( 'subtitle', [ 'wrapper' => 'p' ] ); } /** * Generates category links, if any * @return string html */ protected function getCategoryLinks() { return $this->getIfExists( 'catlinks' ); } /** * Generates data after content stuff, if any * @return string html */ protected function getDataAfterContent() { return $this->getIfExists( 'dataAfterContent' ); } /** * Simple wrapper for random if-statement-wrapped $this->data things * * @param string $object name of thing * @param array $setOptions * * @return string html */ protected function getIfExists( $object, $setOptions = [] ) { $options = $setOptions + [ 'wrapper' => 'none', 'parameters' => [] ]; $html = ''; if ( $this->data[$object] ) { if ( $options['wrapper'] == 'none' ) { $html .= $this->get( $object ); } else { $html .= Html::rawElement( $options['wrapper'], $options['parameters'], $this->get( $object ) ); } } return $html; } /** * Generates a block of navigation links with a header * * @param string $name * @param array|string $content array of links for use with makeListItem, or a block of text * @param null|string|array $msg * @param array $setOptions random crap to rename/do/whatever * * @return string html */ protected function getPortlet( $name, $content, $msg = null, $setOptions = [] ) { // random stuff to override with any provided options $options = $setOptions + [ // extra classes/ids 'id' => 'p-' . $name, 'class' => 'mw-portlet', 'extra-classes' => '', // what to wrap the body list in, if anything 'body-wrapper' => 'div', 'body-id' => null, 'body-class' => 'mw-portlet-body', // makeListItem options 'list-item' => [ 'text-wrapper' => [ 'tag' => 'span' ] ], // option to stick arbitrary stuff at the beginning of the ul 'list-prepend' => '', // old toolbox hook support (use: [ 'SkinTemplateToolboxEnd' => [ &$skin, true ] ]) 'hooks' => '' ]; // Handle the different $msg possibilities if ( $msg === null ) { $msg = $name; } elseif ( is_array( $msg ) ) { $msgString = array_shift( $msg ); $msgParams = $msg; $msg = $msgString; } $msgObj = $this->getMsg( $msg ); if ( $msgObj->exists() ) { if ( isset( $msgParams ) && !empty( $msgParams ) ) { $msgString = $this->getMsg( $msg, $msgParams )->parse(); } else { $msgString = $msgObj->parse(); } } else { $msgString = htmlspecialchars( $msg ); } $labelId = Sanitizer::escapeIdForAttribute( "p-$name-label" ); if ( is_array( $content ) ) { $contentText = Html::openElement( 'ul', [ 'lang' => $this->get( 'userlang' ), 'dir' => $this->get( 'dir' ) ] ); $contentText .= $options['list-prepend']; foreach ( $content as $key => $item ) { $contentText .= $this->makeListItem( $key, $item, $options['list-item'] ); } // Compatibility with extensions still using SkinTemplateToolboxEnd or similar if ( is_array( $options['hooks'] ) ) { foreach ( $options['hooks'] as $hook ) { if ( is_string( $hook ) ) { $hookOptions = []; } else { // it should only be an array otherwise $hookOptions = array_values( $hook )[0]; $hook = array_keys( $hook )[0]; } $contentText .= $this->deprecatedHookHack( $hook, $hookOptions ); } } $contentText .= Html::closeElement( 'ul' ); } else { $contentText = $content; } // Special handling for role=search and other weird things $divOptions = [ 'role' => 'navigation', 'id' => Sanitizer::escapeIdForAttribute( $options['id'] ), 'title' => Linker::titleAttrib( $options['id'] ), 'aria-labelledby' => $labelId ]; if ( !is_array( $options['class'] ) ) { $class = [ $options['class'] ]; } if ( !is_array( $options['extra-classes'] ) ) { $extraClasses = [ $options['extra-classes'] ]; } $divOptions['class'] = array_merge( $class, $extraClasses ); $labelOptions = [ 'id' => $labelId, 'lang' => $this->get( 'userlang' ), 'dir' => $this->get( 'dir' ) ]; if ( $options['body-wrapper'] !== 'none' ) { $bodyDivOptions = [ 'class' => $options['body-class'] ]; if ( is_string( $options['body-id'] ) ) { $bodyDivOptions['id'] = $options['body-id']; } $body = Html::rawElement( $options['body-wrapper'], $bodyDivOptions, $contentText . $this->getAfterPortlet( $name ) ); } else { $body = $contentText . $this->getAfterPortlet( $name ); } $html = Html::rawElement( 'div', $divOptions, Html::rawElement( 'h3', $labelOptions, $msgString ) . $body ); return $html; } /** * Wrapper to catch output of old hooks expecting to write directly to page * We no longer do things that way. * * @param string $hook event * @param array $hookOptions args * * @return string html */ protected function deprecatedHookHack( $hook, $hookOptions = [] ) { $hookContents = ''; ob_start(); Hooks::run( $hook, $hookOptions ); $hookContents = ob_get_contents(); ob_end_clean(); if ( !trim( $hookContents ) ) { $hookContents = ''; } return $hookContents; } /** * Better renderer for getFooterIcons and getFooterLinks, based on Vector * * @param array $setOptions Miscellaneous other options * * 'id' for footer id * * 'order' to determine whether icons or links appear first: 'iconsfirst' or links, though in * practice we currently only check if it is or isn't 'iconsfirst' * * 'link-prefix' to set the prefix for all link and block ids; most skins use 'f' or 'footer', * as in id='f-whatever' vs id='footer-whatever' * * 'icon-style' to pass to getFooterIcons: "icononly", "nocopyright" * * 'link-style' to pass to getFooterLinks: "flat" to disable categorisation of links in a * nested array * * @return string html */ protected function getFooterBlock( $setOptions = [] ) { // Set options and fill in defaults $options = $setOptions + [ 'id' => 'footer', 'order' => 'iconsfirst', 'link-prefix' => 'footer', 'icon-style' => 'icononly', 'link-style' => null ]; $validFooterIcons = $this->getFooterIcons( $options['icon-style'] ); $validFooterLinks = $this->getFooterLinks( $options['link-style'] ); $html = ''; $html .= Html::openElement( 'div', [ 'id' => $options['id'], 'role' => 'contentinfo', 'lang' => $this->get( 'userlang' ), 'dir' => $this->get( 'dir' ) ] ); $iconsHTML = ''; if ( count( $validFooterIcons ) > 0 ) { $iconsHTML .= Html::openElement( 'ul', [ 'id' => "{$options['link-prefix']}-icons" ] ); foreach ( $validFooterIcons as $blockName => $footerIcons ) { $iconsHTML .= Html::openElement( 'li', [ 'id' => Sanitizer::escapeIdForAttribute( "{$options['link-prefix']}-{$blockName}ico" ), 'class' => 'footer-icons' ] ); foreach ( $footerIcons as $icon ) { $iconsHTML .= $this->getSkin()->makeFooterIcon( $icon ); } $iconsHTML .= Html::closeElement( 'li' ); } $iconsHTML .= Html::closeElement( 'ul' ); } $linksHTML = ''; if ( count( $validFooterLinks ) > 0 ) { if ( $options['link-style'] == 'flat' ) { $linksHTML .= Html::openElement( 'ul', [ 'id' => "{$options['link-prefix']}-list", 'class' => 'footer-places' ] ); foreach ( $validFooterLinks as $link ) { $linksHTML .= Html::rawElement( 'li', [ 'id' => Sanitizer::escapeIdForAttribute( $link ) ], $this->get( $link ) ); } $linksHTML .= Html::closeElement( 'ul' ); } else { $linksHTML .= Html::openElement( 'div', [ 'id' => "{$options['link-prefix']}-list" ] ); foreach ( $validFooterLinks as $category => $links ) { $linksHTML .= Html::openElement( 'ul', [ 'id' => Sanitizer::escapeIdForAttribute( "{$options['link-prefix']}-{$category}" ) ] ); foreach ( $links as $link ) { $linksHTML .= Html::rawElement( 'li', [ 'id' => Sanitizer::escapeIdForAttribute( "{$options['link-prefix']}-{$category}-{$link}" ) ], $this->get( $link ) ); } $linksHTML .= Html::closeElement( 'ul' ); } $linksHTML .= Html::closeElement( 'div' ); } } if ( $options['order'] == 'iconsfirst' ) { $html .= $iconsHTML . $linksHTML; } else { $html .= $linksHTML . $iconsHTML; } $html .= $this->getClear() . Html::closeElement( 'div' ); return $html; } private function getArrayLinks( $array, $title, $which ) { $nav = []; $nav[] = [ 'title' => $title ]; foreach ( $array as $key => $item ) { $link = [ 'id' => Sanitizer::escapeId( $key ), 'attributes' => $item['attributes'] ?? null, 'link' => $item['href'] ?? null, 'key' => $item['key'] ?? null, 'class' => htmlspecialchars( $item['class'] ?? null ), 'title' => htmlspecialchars( $item['text'] ?? null ), ]; $icon = null; if( 'page' == $which ) { switch( $link['title'] ) { case 'Page': $icon = 'file'; break; case 'Discussion': $icon = 'comment'; break; case 'Edit': $icon = 'edit'; break; case 'History': $icon = 'history'; break; case 'Delete': $icon = 'trash-alt'; break; case 'Move': $icon = 'arrows-alt'; break; case 'Protect': $icon = 'lock'; break; case 'Watch': $icon = 'eye'; break; case 'Unwatch': $icon = 'eye-slash'; break; } $link['title'] = ' ' . $link['title']; } elseif( 'user' == $which ) { switch( $link['title'] ) { case 'My talk': $icon = 'comment'; break; case 'My preferences': $icon = 'cog'; break; case 'My watchlist': $icon = 'eye-close'; break; case 'My contributions': $icon = 'list-alt'; break; case 'Log out': $icon = 'unlock'; break; default: $icon = 'user'; break; } $link['title'] = ' ' . $link['title']; } $nav[0]['sublinks'][] = $link; } return $this->nav( $nav ); } public function includePage( $title ) { $pageTitle = Title::newFromText( $title ); if ( ! $pageTitle->exists() ) { echo 'The page [[' . $title . ']] was not found.'; } else { $article = new Article( $pageTitle ); echo $article->getParserOutput()->getText(); } } }