CologneBlue.php

Go to the documentation of this file.

<?php
if ( !defined( 'MEDIAWIKI' ) ) {
    die( -1 );
}

class SkinCologneBlue extends SkinTemplate {
    var $skinname = 'cologneblue', $stylename = 'cologneblue',
        $template = 'CologneBlueTemplate';
    var $useHeadElement = true;

    function setupSkinUserCss( OutputPage $out ) {
        parent::setupSkinUserCss( $out );
        $out->addModuleStyles( 'mediawiki.legacy.oldshared' );
        $out->addModuleStyles( 'skins.cologneblue' );
    }

    function formatLanguageName( $name ) {
        return $name;
    }
}

class CologneBlueTemplate extends BaseTemplate {
    function execute() {
        // Suppress warnings to prevent notices about missing indexes in $this->data
        wfSuppressWarnings();
        $this->html( 'headelement' );
        echo $this->beforeContent();
        $this->html( 'bodytext' );
        echo "\n";
        echo $this->afterContent();
        $this->html( 'dataAfterContent' );
        $this->printTrail();
        echo "\n</body></html>";
        wfRestoreWarnings();
    }

    function variantLinks() {
        $s = array();

        $variants = $this->data['content_navigation']['variants'];

        foreach ( $variants as $key => $link ) {
            $s[] = $this->makeListItem( $key, $link, array( 'tag' => 'span' ) );
        }

        return $this->getSkin()->getLanguage()->pipeList( $s );
    }

    function otherLanguages() {
        global $wgHideInterlanguageLinks;
        if ( $wgHideInterlanguageLinks ) {
            return "";
        }

        // We override SkinTemplate->formatLanguageName() in SkinCologneBlue
        // not to capitalize the language names.
        $language_urls = $this->data['language_urls'];
        if ( empty( $language_urls ) ) {
            return "";
        }

        $s = array();
        foreach ( $language_urls as $key => $data ) {
            $s[] = $this->makeListItem( $key, $data, array( 'tag' => 'span' ) );
        }

        return wfMessage( 'otherlanguages' )->text()
            . wfMessage( 'colon-separator' )->text()
            . $this->getSkin()->getLanguage()->pipeList( $s );
    }

    function pageTitleLinks() {
        $s = array();
        $footlinks = $this->getFooterLinks();

        foreach ( $footlinks['places'] as $item ) {
            $s[] = $this->data[$item];
        }

        return $this->getSkin()->getLanguage()->pipeList( $s );
    }

    function processBottomLink( $key, $navlink, $message = null ) {
        if ( !$navlink ) {
            // Empty navlinks might be passed.
            return null;
        }

        if ( $message ) {
            $navlink['text'] = wfMessage( $message )->escaped();
        }

        return $this->makeListItem( $key, $this->processNavlinkForDocument( $navlink ), array( 'tag' => 'span' ) );
    }

    function bottomLinks() {
        $toolbox = $this->getToolbox();
        $content_nav = $this->data['content_navigation'];

        $lines = array();

        if ( $this->getSkin()->getOutput()->isArticleRelated() ) {
            // First row. Regular actions.
            $element = array();

            $editLinkMessage = $this->getSkin()->getTitle()->exists() ? 'editthispage' : 'create-this-page';
            $element[] = $this->processBottomLink( 'edit', $content_nav['views']['edit'], $editLinkMessage );
            $element[] = $this->processBottomLink( 'viewsource', $content_nav['views']['viewsource'], 'viewsource' );

            $element[] = $this->processBottomLink( 'watch', $content_nav['actions']['watch'], 'watchthispage' );
            $element[] = $this->processBottomLink( 'unwatch', $content_nav['actions']['unwatch'], 'unwatchthispage' );

            $element[] = $this->talkLink();

            $element[] = $this->processBottomLink( 'history', $content_nav['views']['history'], 'history' );
            $element[] = $this->processBottomLink( 'info', $toolbox['info'] );
            $element[] = $this->processBottomLink( 'whatlinkshere', $toolbox['whatlinkshere'] );
            $element[] = $this->processBottomLink( 'recentchangeslinked', $toolbox['recentchangeslinked'] );

            $element[] = $this->processBottomLink( 'contributions', $toolbox['contributions'] );
            $element[] = $this->processBottomLink( 'emailuser', $toolbox['emailuser'] );

            $lines[] = $this->getSkin()->getLanguage()->pipeList( array_filter( $element ) );


            // Second row. Privileged actions.
            $element = array();

            $element[] = $this->processBottomLink( 'delete', $content_nav['actions']['delete'], 'deletethispage' );
            $element[] = $this->processBottomLink( 'undelete', $content_nav['actions']['undelete'], 'undeletethispage' );

            $element[] = $this->processBottomLink( 'protect', $content_nav['actions']['protect'], 'protectthispage' );
            $element[] = $this->processBottomLink( 'unprotect', $content_nav['actions']['unprotect'], 'unprotectthispage' );

            $element[] = $this->processBottomLink( 'move', $content_nav['actions']['move'], 'movethispage' );

            $lines[] = $this->getSkin()->getLanguage()->pipeList( array_filter( $element ) );


            // Third row. Language links.
            $lines[] = $this->otherLanguages();
        }

        return implode( array_filter( $lines ), "<br />\n" ) . "<br />\n";
    }

    function talkLink() {
        $title = $this->getSkin()->getTitle();

        if ( $title->getNamespace() == NS_SPECIAL ) {
            // No discussion links for special pages
            return "";
        }

        $companionTitle = $title->isTalkPage() ? $title->getSubjectPage() : $title->getTalkPage();
        $companionNamespace = $companionTitle->getNamespace();

        // TODO these messages are only be used by CologneBlue,
        // kill and replace with something more sensibly named?
        $nsToMessage = array(
            NS_MAIN => 'articlepage',
            NS_USER => 'userpage',
            NS_PROJECT => 'projectpage',
            NS_FILE => 'imagepage',
            NS_MEDIAWIKI => 'mediawikipage',
            NS_TEMPLATE => 'templatepage',
            NS_HELP => 'viewhelppage',
            NS_CATEGORY => 'categorypage',
            NS_FILE => 'imagepage',
        );

        // Find out the message to use for link text. Use either the array above or,
        // for non-talk pages, a generic "discuss this" message.
        // Default is the same as for main namespace.
        if ( isset( $nsToMessage[$companionNamespace] ) ) {
            $message = $nsToMessage[$companionNamespace];
        } else {
            $message = $companionTitle->isTalkPage() ? 'talkpage' : 'articlepage';
        }

        // Obviously this can't be reasonable and just return the key for talk namespace, only for content ones.
        // Thus we have to mangle it in exactly the same way SkinTemplate does. (bug 40805)
        $key = $companionTitle->getNamespaceKey( '' );
        if ( $companionTitle->isTalkPage() ) {
            $key = ( $key == 'main' ? 'talk' : $key . "_talk" );
        }

        // Use the regular navigational link, but replace its text. Everything else stays unmodified.
        $namespacesLinks = $this->data['content_navigation']['namespaces'];
        return $this->processBottomLink( $message, $namespacesLinks[$key], $message );
    }

    function processNavlinkForDocument( $navlink, $idPrefix = 'cb-' ) {
        if ( $navlink['id'] ) {
            $navlink['single-id'] = $navlink['id']; // to allow for tooltip generation
            $navlink['tooltiponly'] = true; // but no accesskeys

            // mangle or remove the id
            if ( $idPrefix === false ) {
                unset( $navlink['id'] );
            } else {
                $navlink['id'] = $idPrefix . $navlink['id'];
            }
        }

        return $navlink;
    }

    function beforeContent() {
        ob_start();
?>
<div id="content">
    <div id="topbar">
        <p id="sitetitle" role="banner">
            <a href="<?php echo htmlspecialchars( $this->data['nav_urls']['mainpage']['href'] ) ?>">
                <?php echo wfMessage( 'sitetitle' )->escaped() ?>
            </a>
        </p>
        <p id="sitesub"><?php echo wfMessage( 'sitesubtitle' )->escaped() ?></p>
        <div id="linkcollection" role="navigation">
            <div id="langlinks"><?php echo str_replace( '<br />', '', $this->otherLanguages() ) ?></div>
            <?php echo $this->getSkin()->getCategories() ?>
            <div id="titlelinks"><?php echo $this->pageTitleLinks() ?></div>
            <?php if ( $this->data['newtalk'] ) { ?>
            <div class="usermessage"><strong><?php echo $this->data['newtalk'] ?></strong></div>
            <?php } ?>
        </div>
    </div>
    <div id="article" role="main">
        <?php if ( $this->getSkin()->getSiteNotice() ) { ?>
        <div id="siteNotice"><?php echo $this->getSkin()->getSiteNotice() ?></div>
        <?php } ?>
        <h1 id="firstHeading" lang="<?php
            $this->data['pageLanguage'] = $this->getSkin()->getTitle()->getPageViewLanguage()->getHtmlCode();
            $this->text( 'pageLanguage' );
        ?>"><span dir="auto"><?php echo $this->data['title'] ?></span></h1>
        <?php if ( $this->translator->translate( 'tagline' ) ) { ?>
        <p class="tagline"><?php echo htmlspecialchars( $this->translator->translate( 'tagline' ) ) ?></p>
        <?php } ?>
        <?php if ( $this->getSkin()->getOutput()->getSubtitle() ) { ?>
        <p class="subtitle"><?php echo $this->getSkin()->getOutput()->getSubtitle() ?></p>
        <?php } ?>
        <?php if ( $this->getSkin()->subPageSubtitle() ) { ?>
        <p class="subpages"><?php echo $this->getSkin()->subPageSubtitle() ?></p>
        <?php } ?>
<?php
        $s = ob_get_contents();
        ob_end_clean();

        return $s;
    }

    function afterContent() {
        ob_start();
?>
    </div>
    <div id="footer">
        <div id="footer-navigation" role="navigation">
<?php
        // Page-related links
        echo $this->bottomLinks();
        echo "\n<br />";

        // Footer and second searchbox
        echo $this->getSkin()->getLanguage()->pipeList( array(
            $this->getSkin()->mainPageLink(),
            $this->getSkin()->aboutLink(),
            $this->searchForm( 'footer' )
        ) );
?>
        </div>
        <div id="footer-info" role="contentinfo">
<?php
        // Standard footer info
        $footlinks = $this->getFooterLinks();
        if ( $footlinks['info'] ) {
            foreach ( $footlinks['info'] as $item ) {
                echo $this->data[$item] . ' ';
            }
        }
?>
        </div>
    </div>
</div>
<div id="mw-navigation">
    <h2><?php echo wfMessage( 'navigation-heading' )->escaped() ?></h2>
    <div id="toplinks" role="navigation">
        <p id="syslinks"><?php echo $this->sysLinks() ?></p>
        <p id="variantlinks"><?php echo $this->variantLinks() ?></p>
    </div>
    <?php echo $this->quickBar() ?>
</div>
<?php
        $s = ob_get_contents();
        ob_end_clean();

        return $s;
    }

    function sysLinks() {
        $s = array(
            $this->getSkin()->mainPageLink(),
            Linker::linkKnown(
                Title::newFromText( wfMessage( 'aboutpage' )->inContentLanguage()->text() ),
                wfMessage( 'about' )->text()
            ),
            Linker::makeExternalLink(
                Skin::makeInternalOrExternalUrl( wfMessage( 'helppage' )->inContentLanguage()->text() ),
                wfMessage( 'help' )->text(),
                false
            ),
            Linker::linkKnown(
                Title::newFromText( wfMessage( 'faqpage' )->inContentLanguage()->text() ),
                wfMessage( 'faq' )->text()
            ),
        );

        $personalUrls = $this->getPersonalTools();
        foreach ( array( 'logout', 'createaccount', 'login', 'anonlogin' ) as $key ) {
            if ( $personalUrls[$key] ) {
                $s[] = $this->makeListItem( $key, $personalUrls[$key], array( 'tag' => 'span' ) );
            }
        }

        return $this->getSkin()->getLanguage()->pipeList( $s );
    }

    function sidebarAdditions( $bar ) {
        // "This page" and "Edit" menus
        // We need to do some massaging here... we reuse all of the items, except for $...['views']['view'],
        // as $...['namespaces']['main'] and $...['namespaces']['talk'] together serve the same purpose.
        // We also don't use $...['variants'], these are displayed in the top menu.
        $content_navigation = $this->data['content_navigation'];
        $qbpageoptions = array_merge(
            $content_navigation['namespaces'],
            array(
                'history' => $content_navigation['views']['history'],
                'watch' => $content_navigation['actions']['watch'],
                'unwatch' => $content_navigation['actions']['unwatch'],
            )
        );
        $content_navigation['actions']['watch'] = null;
        $content_navigation['actions']['unwatch'] = null;
        $qbedit = array_merge(
            array(
                'edit' => $content_navigation['views']['edit'],
                'addsection' => $content_navigation['views']['addsection'],
            ),
            $content_navigation['actions']
        );

        // Personal tools ("My pages")
        $qbmyoptions = $this->getPersonalTools();
        foreach ( array( 'logout', 'createaccount', 'login', 'anonlogin' ) as $key ) {
            $qbmyoptions[$key] = null;
        }

        // Use the closest reasonable name
        $bar['cactions'] = $qbedit;
        $bar['pageoptions'] = $qbpageoptions; // this is a non-standard portlet name, but nothing fits
        $bar['personal'] = $qbmyoptions;

        return $bar;
    }

    function quickBar() {
        // Massage the sidebar. We want to:
        // * place SEARCH at the beginning
        // * add new portlets before TOOLBOX (or at the end, if it's missing)
        // * remove LANGUAGES (langlinks are displayed elsewhere)
        $orig_bar = $this->data['sidebar'];
        $bar = array();
        $hasToolbox = false;

        // Always display search first
        $bar['SEARCH'] = true;
        // Copy everything except for langlinks, inserting new items before toolbox
        foreach ( $orig_bar as $heading => $data ) {
            if ( $heading == 'TOOLBOX' ) {
                // Insert the stuff
                $bar = $this->sidebarAdditions( $bar );
                $hasToolbox = true;
            }

            if ( $heading != 'LANGUAGES' ) {
                $bar[$heading] = $data;
            }
        }
        // If toolbox is missing, add our items at the end
        if ( !$hasToolbox ) {
            $bar = $this->sidebarAdditions( $bar );
        }


        // Fill out special sidebar items with content
        $orig_bar = $bar;
        $bar = array();
        foreach ( $orig_bar as $heading => $data ) {
            if ( $heading == 'SEARCH' ) {
                $bar['search'] = $this->searchForm( 'sidebar' );
            } elseif ( $heading == 'TOOLBOX' ) {
                $bar['tb'] = $this->getToolbox();
            } else {
                $bar[$heading] = $data;
            }
        }


        // Output the sidebar
        // CologneBlue uses custom messages for some portlets, but we should keep the ids for consistency
        $idToMessage = array(
            'search' => 'qbfind',
            'navigation' => 'qbbrowse',
            'tb' => 'toolbox',
            'cactions' => 'qbedit',
            'personal' => 'qbmyoptions',
            'pageoptions' => 'qbpageoptions',
        );

        $s = "<div id='quickbar'>\n";

        foreach ( $bar as $heading => $data ) {
            $portletId = Sanitizer::escapeId( "p-$heading" );
            $headingMsg = wfMessage( $idToMessage[$heading] ? $idToMessage[$heading] : $heading );
            $headingHTML = "<h3>" . ( $headingMsg->exists() ? $headingMsg->escaped() : htmlspecialchars( $heading ) ) . "</h3>";
            $listHTML = "";

            if ( is_array( $data ) ) {
                // $data is an array of links
                foreach ( $data as $key => $link ) {
                    // Can be empty due to how the sidebar additions are done
                    if ( $link ) {
                        $listHTML .= $this->makeListItem( $key, $link );
                    }
                }
                if ( $listHTML ) {
                    $listHTML = "<ul>$listHTML</ul>";
                }
            } else {
                // $data is a HTML <ul>-list string
                $listHTML = $data;
            }

            if ( $listHTML ) {
                $role = ( $heading == 'search' ) ? 'search' : 'navigation';
                $s .= "<div class=\"portlet\" id=\"$portletId\" role=\"$role\">\n$headingHTML\n$listHTML\n</div>\n";
            }
        }

        $s .= "</div>\n";
        return $s;
    }

    function searchForm( $which ) {
        global $wgUseTwoButtonsSearchForm;

        $search = $this->getSkin()->getRequest()->getText( 'search' );
        $action = $this->data['searchaction'];
        $s = "<form id=\"searchform-" . htmlspecialchars( $which ) . "\" method=\"get\" class=\"inline\" action=\"$action\">";
        if ( $which == 'footer' ) {
            $s .= wfMessage( 'qbfind' )->text() . ": ";
        }

        $s .= $this->makeSearchInput( array( 'class' => 'mw-searchInput', 'type' => 'text', 'size' => '14' ) );
        $s .= ( $which == 'footer' ? " " : "<br />" );
        $s .= $this->makeSearchButton( 'go', array( 'class' => 'searchButton' ) );

        if ( $wgUseTwoButtonsSearchForm ) {
            $s .= $this->makeSearchButton( 'fulltext', array( 'class' => 'searchButton' ) );
        } else {
            $s .= '<div><a href="' . $action . '" rel="search">' . wfMessage( 'powersearch-legend' )->escaped() . "</a></div>\n";
        }

        $s .= '</form>';

        return $s;
    }
}