Difference between revisions of "Configuration"
Line 100: | Line 100: | ||
This parser function can be used to hide elements from a specific page (e.g. the main page). | This parser function can be used to hide elements from a specific page (e.g. the main page). | ||
− | You can use | + | You can use all [[Navigation|page sections and navigational elements]] (also custom ones). |
− | |||
− |
Revision as of 11:37, 10 February 2015
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>
)
$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".
$wgTweekiSkinFooterIcons = true;
- If set to false, the icons in the footer will be replaced by text aquivalents.
Messages (and their defaults)
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
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.
- 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).