Difference between revisions of "Configuration"

From Tweeki
Jump to: navigation, search
Line 8: Line 8:
 
: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.  
 
: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' );
+
$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.
 
: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.
  

Revision as of 21:27, 2 October 2014

Configuration Options (and their defaults)

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

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.

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 the following elements:

  • page sections: navbar, navbar-brand, navbar-left, navbar-right, subnav, sidebar, firstHeading, footer
  • navigational elements: EDIT, EDIT-EXT, PAGE, TOOLBOX, VARIANTS, VIEW, ACTIONS, PERSONAL, LOGIN, SIDEBAR, LANGUAGES, SEARCH, LOGO, FIRSTHEADING, TOC

Special navigational elements

EDIT

an "Edit Page" button for the current page

EDIT-EXT

to be used in the sidebar: a split dropdown with "Edit Page" and the other ACTIONS in the dropdown menu