Configure Bonny skin (version 0.06).
This is a fully CSS-driven skin, with variations in layout and appearance.
Style Options
There are two style options: layout and theme.
The layout options determine the layout variations. The theme options determine
what colour and font "theme" is shown.
Try on this page:
Set in cookie:
Three-column layout
If one selects the 'trio' or 'roomy_trio' layout, this gives a three-column layout. The third column gets its content from
the page given by {$RightBar} (if it is defined), otherwise from
{$Group}.RightBar (if it exists), otherwise from Site.RightBar.
If one wishes to disable the rightbar in a page, give the (:noright:) directive in that page.
Layout content
- Edit BreadCrumb
- The "Breadcrumb trail" at the top of the header.
- Edit MenuBar
- The (optional) MenuBar in the header. Only displayed if $BonnyMenuBar is true (see Config Variables below).
- Edit RightBar
- The right-hand column in three-column layouts.
- Edit PageActionsCMS
- The PageActionsCMS page will be used (if it exists) rather than the PageActions page; but it includes the PageActions page inside it, so you can use your usual PageActions -- the PageActionsCMS page simply takes into account whether BonnyCMS is enabled, and whether the user has logged in.
Config variables
These can be set in your local/config.php file.
- $BonnyTheme
- which theme to use
$BonnyTheme = 'silver';
Options:
- gblue (Grey-Blue)
- iron (Greys)
- matrix (computer green)
- silver (Silver-Grey)
- team (Red, Black, White)
- tricolore (Blue, White, Red)
- turk (Turquoise and blue)
- vioblue (Violet-Blue)
- $BonnyLayout
- which layout variation to use
$BonnyLayout = 'roomy';
Options:
- roomy (margins around elements showing a contrasting background)
- snug (no margins around elements)
- roomy_right (sidebar on right)
- snug_right (sidebar on right)
- trio (three columns: SideBar and RightBar)
- roomy_trio (as with trio, but with margins around elements and contrasting background)
- $BonnyStyleSet
- disable/enable style options to be set via cookie. (Enabled by default)
$BonnyStyleSet = 1;
Currently enabled.
- $ThemeCookieExpires
- this is normally set to be one year from now; if you want it to expire at the end of the session, set it to 0.
$ThemeCookieExpires = 0;
- $LayoutCookieExpires
- this is normally set to be one year from now; if you want it to expire at the end of the session, set it to 0.
$LayoutCookieExpires = 0;
- $BonnyCMS
- enable CMS-like behaviour to hide page actions from non-logged in users, and make the login link hard to see until you hover your mouse over it.
$BonnyCMS = 1;
Currently enabled.
- $BonnyCMSHover
- if $BonnyCMS is also true, then use CSS :hover settings to hide the login link even more deeply (the only thing showing will be a '.' until you hover your mouse over it, which then displays the Login link); but this doesn't work with an IE browser, so it is disabled by default.
$BonnyCMSHover = 1;
Currently disabled.
- enable the MenuBar.
$BonnyMenuBar = 1;
The default MenuBar displays all the groups in the wiki; since this may be horribly large on some wikis, and manageably small on others, it is disabled by default. If you want to display the menubar, then set this to 1. If you want your menubar to have other content, then edit your own version of it, and set $BonnyMenuBar to 1. Currently disabled.
- $BonnyIncludeSearch
- disable/enable inclusion of the searchbox in the sidebar and the search link in the footer. (Enabled by default).
#BonnyIncludeSearch = 0;
When would one wish to disable it? When one is using one's own search, and doesn't want to use PmWiki's search; other templates require one to remove the search links by editing the template; with this skin you only have to set a config variable. Also note, however, that you can change the format of the searchbox by setting the $SearchBoxFmt variable. Currently disabled.
- $BonnyLogoLink
- set this to the URL you want to be used in the logo link. If it isn't set, it will use
$ScriptUrl as per usual. This is useful for CMS-flavoured sites where you have the wiki as part of the site, and you want the logo URL to link to the top of the site rather than the wiki part of the site.
$BonnyLogoLink = 'http://www.example.com/';
Note: if this doesn't work, try adding global $BonnyLogoLink; when you set it.
