Configuration

From Tweeki
Jump to: navigation, search

Configuration Options (and their defaults)

These options can be set in LocalSettings.php (after the inclusion of tweeki.php):

$wgTweekiSkinUseAwesome = true;
Whether or not to include Font Awesome to allow the use of icons like this one: (<span class="fa fa-bus"></span>)

Special Navigational Elements

$wgTweekiSkinNavigationalElements = array();
Add to this array to create customized buttons, the array's key is the keyword for the navigational element to be used in navbars, subnav, sidebar, or footer, the value is the name of a callback function. This function will be called with the skin object as argument and should return either an array of buttons or a string that can be parsed as buttons.
$wgTweekiSkinSpecialElements = array( 
  'FIRSTHEADING' => 'self::renderFirstHeading', 
  'TOC' => 'self::renderTOC', 
  'SEARCH' => 'self::renderSearch', 
  'LOGO' => 'self::renderLogo', 
  'LOGIN-EXT' => 'self::renderLoginExt' 
  );
Use this array to add completely arbitrary code into navbars, subnav, sidebar, or footer. The value again is a callback function you need to create. It will be called with two arguments, the skin object and the context as a string (navbar-left, navbar-right, subnav, sidebar, footer). The function should directly print the html you want to have.

Hiding Page Elements

$wgTweekiSkinHideAll = array();
This variable can be used to hide elements from everybody. The {{#tweekihide}} parser function will add to this array. Attention: Only hiding of elements that are also listed in $wgTweekiSkinHideable will actually be put into effect.
$wgTweekiSkinHideable = array( 'firstHeading' );
In order to prevent abuse, only elements listed in this array are allowed to be hidden by the {{#tweekihide}} parser function.
$wgTweekiSkinHideAnon = array();
Elements in this array will be hidden for users who are not logged in.
$wgTweekiSkinHideNonPoweruser = array( 'TOOLBOX', 'EDIT-EXT-special' );
Elements in this array will only be shown to users who have chosen in their preferences to be "powerusers".

Footer

$wgTweekiSkinFooterIcons = true;
If set to false, the icons in the footer will be replaced by text aquivalents.

Messages (and their defaults)

Navbar

Mediawiki:Tweeki-navbar-brand: Tweeki

Content of the "brand" link.

Mediawiki:Tweeki-navbar-left: empty

Content of the left side of the navbar.

Mediawiki:Tweeki-navbar-right: SEARCH,TOOLBOX,PERSONAL

Content of the right side of the navbar.

Mediawiki:Tweeki-navbar-class: navbar navbar-default navbar-fixed-top

Classes to use for the navbar. For further possibilities see http://getbootstrap.com/components/#navbar

Subnavigation

Mediawiki:Tweeki-subnav: SIDEBAR

Content of the sub navigation. Set to "-" to not show a sub navigation.

Sidebar

Mediawiki:Tweeki-sidebar: EDIT-EXT,TOC

Content of the sidebar.

Footer

Mediawiki:Tweeki-footer:

Additional content for the footer - will be placed between the standard text footers and the icon footers. Name to use for the hiding mechanisms provided by Tweeki: footer-custom.

Edit Section Button

You can customize the appearance of the edit section button with system messages. You can also use customized CSS to change aligning etc. Tweeki's default button should look like this: <button wrapper="" class="btn btn-default btn-xs"> Edit Section|</button>

Mediawiki:Tweeki-editsection-text: Edit section

Text for the Edit Section Button

Mediawiki:Tweeki-editsection-class: btn btn-default btn-xs

Classes to use for the Edit Section Button

Mediawiki:Tweeki-editsection-icon:

Icon to insert into the Edit Section Button

Link Customization

Mediawiki:Tweeki-login: Log in / Create account

Text used for the login link.

Mediawiki:Tweeki-toolbox: empty

Custom link content for toolbox dropdown. (e.g. <i class="icon icon-cog"></i>)

Mediawiki:Tweeki-edit-ext: Edit $1

Text for the EDIT-EXT button

Tweekihide parser function

Usage: {{#tweekihide:element1|element2|...}}

This parser function can be used to hide elements from a specific page (e.g. the main page).

You can use all page sections and navigational elements (also custom ones).