mirror of
https://gerrit.wikimedia.org/r/mediawiki/skins/MinervaNeue
synced 2024-11-16 10:50:52 +00:00
305 lines
9 KiB
PHP
305 lines
9 KiB
PHP
<?php
|
|
/**
|
|
* MinervaTemplate.php
|
|
*/
|
|
|
|
/**
|
|
* Extended Template class of BaseTemplate for mobile devices
|
|
*/
|
|
class MinervaTemplate extends BaseTemplate {
|
|
/** @var bool Specify whether the page is a special page */
|
|
protected $isSpecialPage;
|
|
|
|
/** @var bool Whether or not the user is on the Special:MobileMenu page */
|
|
protected $isSpecialMobileMenuPage;
|
|
|
|
/** @var bool Specify whether the page is main page */
|
|
protected $isMainPage;
|
|
|
|
/**
|
|
* Start render the page in template
|
|
*/
|
|
public function execute() {
|
|
$title = $this->getSkin()->getTitle();
|
|
$this->isSpecialPage = $title->isSpecialPage();
|
|
$this->isSpecialMobileMenuPage = $this->isSpecialPage &&
|
|
$title->equals( SpecialPage::getTitleFor( 'MobileMenu' ) );
|
|
$this->isMainPage = $title->isMainPage();
|
|
Hooks::run( 'MinervaPreRender', [ $this ] );
|
|
$this->render( $this->data );
|
|
}
|
|
|
|
/**
|
|
* Returns available page actions
|
|
* @return array
|
|
*/
|
|
public function getPageActions() {
|
|
return $this->isFallbackEditor() ? [] : $this->data['page_actions'];
|
|
}
|
|
|
|
/**
|
|
* Returns template data for footer
|
|
*
|
|
* @param array $data Data used to build the page
|
|
* @return array
|
|
*/
|
|
protected function getFooterTemplateData( $data ) {
|
|
$groups = [];
|
|
|
|
foreach ( $data['footerlinks'] as $category => $links ) {
|
|
$items = [];
|
|
foreach ( $links as $link ) {
|
|
if ( isset( $this->data[$link] ) && $data[$link] !== '' && $data[$link] !== false ) {
|
|
$items[] = [
|
|
'category' => $category,
|
|
'name' => $link,
|
|
'linkhtml' => $data[$link],
|
|
];
|
|
}
|
|
}
|
|
$groups[] = [
|
|
'name' => $category,
|
|
'items' => $items,
|
|
];
|
|
}
|
|
|
|
// This turns off the footer id and allows us to distinguish the old footer with the new design
|
|
return [
|
|
'lastmodified' => $this->getHistoryLinkHtml( $data ),
|
|
'headinghtml' => $data['footer-site-heading-html'],
|
|
// Note mobile-license is only available on the mobile skin. It is outputted as part of
|
|
// footer-info on desktop hence the conditional check.
|
|
'licensehtml' => isset( $data['mobile-license'] ) ? $data['mobile-license'] : '',
|
|
'lists' => $groups,
|
|
];
|
|
}
|
|
|
|
/**
|
|
* Get the HTML for rendering the available page actions
|
|
* @param array $data Data used to build page actions
|
|
* @return string
|
|
*/
|
|
protected function getPageActionsHtml( $data ) {
|
|
$actions = $this->getPageActions();
|
|
$html = '';
|
|
$isJSOnly = true;
|
|
if ( $actions ) {
|
|
foreach ( $actions as $key => $val ) {
|
|
if ( isset( $val['is_js_only'] ) ) {
|
|
if ( !$val['is_js_only'] ) {
|
|
$isJSOnly = false;
|
|
}
|
|
unset( $val['is_js_only'] ); // no need to output this attribute
|
|
}
|
|
$html .= $this->makeListItem( $key, $val );
|
|
}
|
|
$additionalClasses = $isJSOnly ? 'jsonly' : '';
|
|
$html = '<ul id="page-actions" class="hlist ' . $additionalClasses . '">' . $html . '</ul>';
|
|
}
|
|
return $html;
|
|
}
|
|
|
|
/**
|
|
* Returns the 'Last edited' message, e.g. 'Last edited on...'
|
|
* @param array $data Data used to build the page
|
|
* @return string
|
|
*/
|
|
protected function getHistoryLinkHtml( $data ) {
|
|
$action = Action::getActionName( RequestContext::getMain() );
|
|
if ( isset( $data['historyLink'] ) && $action === 'view' ) {
|
|
$historyLink = $data['historyLink'];
|
|
$args = [
|
|
'clockIconClass' => MinervaUI::iconClass( 'clock-gray', 'before' ),
|
|
'arrowIconClass' => MinervaUI::iconClass(
|
|
'arrow-gray', 'element', 'mw-ui-icon-small mf-mw-ui-icon-rotate-anti-clockwise indicator' ),
|
|
'isMainPage' => $this->getSkin()->getTitle()->isMainPage(),
|
|
'link' => $historyLink['href'],
|
|
'text' => $historyLink['text'],
|
|
'username' => $historyLink['data-user-name'],
|
|
'userGender' => $historyLink['data-user-gender'],
|
|
'timestamp' => $historyLink['data-timestamp']
|
|
];
|
|
$templateParser = new TemplateParser( __DIR__ );
|
|
return $templateParser->processTemplate( 'history', $args );
|
|
} else {
|
|
return '';
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
protected function isFallbackEditor() {
|
|
$action = $this->getSkin()->getRequest()->getVal( 'action' );
|
|
return $action === 'edit';
|
|
}
|
|
|
|
/**
|
|
* Get page secondary actions
|
|
* @return string[]
|
|
*/
|
|
protected function getSecondaryActions() {
|
|
if ( $this->isFallbackEditor() ) {
|
|
return [];
|
|
}
|
|
|
|
return $this->data['secondary_actions'];
|
|
}
|
|
|
|
/**
|
|
* Get HTML representing secondary page actions like language selector
|
|
* @return string
|
|
*/
|
|
protected function getSecondaryActionsHtml() {
|
|
$baseClass = MinervaUI::buttonClass( '', 'button' );
|
|
$html = Html::openElement( 'div', [
|
|
'class' => 'post-content',
|
|
'id' => 'page-secondary-actions'
|
|
] );
|
|
/** @var $skin SkinMinerva $skin */
|
|
$skin = $this->getSkin();
|
|
// no secondary actions on the user page
|
|
if ( $skin instanceof SkinMinerva && !$skin->getUserPageHelper()->isUserPage() ) {
|
|
foreach ( $this->getSecondaryActions() as $el ) {
|
|
if ( isset( $el['attributes']['class'] ) ) {
|
|
$el['attributes']['class'] .= ' ' . $baseClass;
|
|
} else {
|
|
$el['attributes']['class'] = $baseClass;
|
|
}
|
|
$html .= Html::element( 'a', $el['attributes'], $el['label'] );
|
|
}
|
|
}
|
|
|
|
return $html . Html::closeElement( 'div' );
|
|
}
|
|
|
|
/**
|
|
* Get the HTML for the content of a page
|
|
* @param array $data Data used to build the page
|
|
* @return string representing HTML of content
|
|
*/
|
|
protected function getContentHtml( $data ) {
|
|
if ( !$data[ 'unstyledContent' ] ) {
|
|
$content = Html::openElement( 'div', [
|
|
'id' => 'bodyContent',
|
|
'class' => 'content',
|
|
] );
|
|
$content .= $data[ 'bodytext' ];
|
|
if ( isset( $data['subject-page'] ) ) {
|
|
$content .= $data['subject-page'];
|
|
}
|
|
return $content . Html::closeElement( 'div' );
|
|
} else {
|
|
return $data[ 'bodytext' ];
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the HTML for rendering pre-content (e.g. heading)
|
|
* @param array $data Data used to build the page
|
|
* @return string HTML
|
|
*/
|
|
protected function getPreContentHtml( $data ) {
|
|
$internalBanner = $data[ 'internalBanner' ];
|
|
$preBodyHtml = isset( $data['prebodyhtml'] ) ? $data['prebodyhtml'] : '';
|
|
$headingHtml = isset( $data['headinghtml'] ) ? $data['headinghtml'] : '';
|
|
$postHeadingHtml = isset( $data['postheadinghtml'] ) ? $data['postheadinghtml'] : '';
|
|
|
|
$html = '';
|
|
if ( $internalBanner || $preBodyHtml || isset( $data['page_actions'] ) ) {
|
|
$html .= $preBodyHtml
|
|
. Html::openElement( 'div', [ 'class' => 'pre-content heading-holder' ] );
|
|
|
|
if ( !$this->isSpecialPage ) {
|
|
$html .= $this->getPageActionsHtml( $data );
|
|
}
|
|
|
|
$html .= $headingHtml;
|
|
$html .= $postHeadingHtml;
|
|
$html .= $data['subtitle'];
|
|
$html .= $internalBanner;
|
|
$html .= '</div>';
|
|
}
|
|
return $html;
|
|
}
|
|
|
|
/**
|
|
* Gets HTML that needs to come after the main content and before the secondary actions.
|
|
*
|
|
* @param array $data The data used to build the page
|
|
* @return string
|
|
*/
|
|
protected function getPostContentHtml( $data ) {
|
|
return $this->getSecondaryActionsHtml();
|
|
}
|
|
|
|
/**
|
|
* Get the HTML for rendering the wrapper for loading content
|
|
* @param array $data Data used to build the page
|
|
* @return string HTML
|
|
*/
|
|
protected function getContentWrapperHtml( $data ) {
|
|
return $this->getPreContentHtml( $data ) .
|
|
$this->getContentHtml( $data ) .
|
|
$this->getPostContentHtml( $data );
|
|
}
|
|
|
|
/**
|
|
* Gets the main menu only on Special:MobileMenu.
|
|
* On other pages the menu is rendered via JS.
|
|
* @param array $data Data used to build the page
|
|
* @return string
|
|
*/
|
|
protected function getMainMenuHtml( $data ) {
|
|
if ( $this->isSpecialMobileMenuPage ) {
|
|
$templateParser = new TemplateParser(
|
|
__DIR__ . '/../../resources/skins.minerva.mainMenu/' );
|
|
|
|
return $templateParser->processTemplate( 'menu', $data['menu_data'] );
|
|
} else {
|
|
return '';
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Render the entire page
|
|
* @param array $data Data used to build the page
|
|
* @todo replace with template engines
|
|
*/
|
|
protected function render( $data ) {
|
|
$templateParser = new TemplateParser( __DIR__ );
|
|
|
|
// prepare template data
|
|
$templateData = [
|
|
'banners' => $data['banners'],
|
|
'wgScript' => $data['wgScript'],
|
|
'isAnon' => $data['username'] === null,
|
|
'search' => $data['search'],
|
|
'placeholder' => wfMessage( 'mobile-frontend-placeholder' ),
|
|
'headelement' => $data[ 'headelement' ],
|
|
'menuButton' => $data['menuButton'],
|
|
'headinghtml' => $data['footer-site-heading-html'],
|
|
// A button when clicked will submit the form
|
|
// This is used so that on tablet devices with JS disabled the search button
|
|
// passes the value of input to the search
|
|
// We avoid using input[type=submit] as these cannot be easily styled as mediawiki ui icons
|
|
// which is problematic in Opera Mini (see T140490)
|
|
'searchButton' => Html::rawElement( 'button', [
|
|
'id' => 'searchIcon',
|
|
'class' => MinervaUI::iconClass( 'magnifying-glass', 'element' ),
|
|
], wfMessage( 'searchbutton' ) ),
|
|
'secondaryButtonData' => $data['secondaryButtonData'],
|
|
'mainmenuhtml' => $this->getMainMenuHtml( $data ),
|
|
'contenthtml' => $this->getContentWrapperHtml( $data ),
|
|
'footer' => $this->getFooterTemplateData( $data ),
|
|
];
|
|
// begin rendering
|
|
echo $templateParser->processTemplate( 'minerva', $templateData );
|
|
$this->printTrail();
|
|
?>
|
|
</body>
|
|
</html>
|
|
<?php
|
|
}
|
|
}
|