Extension:Header Tabs

This extension transforms top-level MediaWiki headers into tabs using Yahoo! YUI library.

It was originally developed for Ardorado.com and maintained by Semantic Communities LLC.

Usage
To enable tabs on a page after you installed the extension, you need to add tag into the page in place where the last tab should end (everything below this tag will be shown under the tab view. Most of the times though, you'll want to put it at the bottom of the page.

In addition to that, page should have top level headers defined in it like this: = Header title =

Linking to tabs
To allow users to switch to specific tab by just clicking a link on the page (in another tab or outside tab view), you can call the  parser function like this:

This will create a link to the tab with the name "Tab Name", and the text of the link will read "Link Text". If you want the link to a point to a tab on some page other than the current one, you can optionally add the third parameter, "Page Name".

Semantic MediaWiki factbox
In addition to user-defined tabs, Header Tabs converts Semantic MediaWiki factbox into a tab and adds it as a last tab in tab view.

Example
Some text above the tab view

= First section header = This will be displayed on first tab

= Second section header = This will be displayed on second tab

= Third section header = This will be always displayed under the tab view because it's below  tag.

Header titles get automatically converted into tab titles.

Installing from SVN
To get code from Subversion, just type svn checkout http://mediawiki-header-tabs.googlecode.com/svn/trunk/ HeaderTabs

Installation
Download the code into  folder. Note: $IP stands for the root directory of your MediaWiki installation, the same directory that holds LocalSettings.php.

Add the following to LocalSettings.php:

Skin modification
If you want to override YUI skin, feel free to modify your skin and assign skin class (e.g. ) to   tag. See YUI skinning documentation for more details.

Configuration parameters
The following parameters can be changed in the LocalSettings.php file below the :

$htYUIBase
variable defines path to the YUI installation. By default it uses [http://developer.yahoo.com/yui/articles/hosting/ YUI hosted on Yahoo! servers], but you can download it to  on your site and point to it like this: Keep in mind that Yahoo! hosts YUI at their fast CDN (with another domain which might speed up downloads), does a very good job at enforcing the cache of these files and so on, plus they might be cached in users browser (because many people visit http://www.yahoo.com) already by the time he hits your servers. Don't think it's necessarily better for you to host it yourself.

$htUseHistory
variable defines if tab navigation should be tracked within the URL updating the hash value, by default history is used.

Known issues

 * Table of contents doesn't make much sense when tabs are used. Right now you can disable it with . Later versions might force this.

Helpful hints
If the extension HeaderTabs does not work in your installation, check the following
 * make sure you have a file ; you might have inadvertedly changed the name to
 * compatibilities between HeaderTabs and yui:
 * HeaderTabs 0.6.5: yui 2.5.1 ok, yui 2.5.2 ok, yui 2.6.0 incompatible, yui 2.7.0b incompatible

Support
The best way to seek help with this extension is to send your questions to our development google group

http://groups.google.com/group/semacomm-dev

extension maintainer and active users and contributors are on this list and will be able to help you.

Sites using this extension

 * vraywiki.com
 * Ardorado.com
 * All sites on Referata.com hosting
 * BioVenturist.com
 * Cause Caller Wiki
 * LexWiki
 * The Music Snob
 * The Seventh Sun Wiki
 * Venicewiki.org
 * The Old Cookery Book
 * PinataIsland.info - Viva Pinata Wiki

Links

 * The Yahoo! User Interface Library (YUI)