Skins

Choice

Bs-002 < Skins > Cinnamon   (talk | users | test page | RWD? | set as default | unset | validate: HTML, CSS)

Summary: Choice is a two-column theme, with a top navigation tab bar, and traditional footer.
Version: 1.1.3 (31-Mar-2016)
Prerequisites: None
Status: Active
Maintainer: DaveG
Categories: Skins, BlogIt, PHP55, PHP82
License: Dual licensed under the MIT and GPL licenses.
Users: +6 (View / Edit)
Discussion: Choice-Talk

This skin provides a beautifully simple, 2-column fluid interface, with a total of 9 variations (blue, green, orange, all in bold or muted, with white or dark background), with full support for the BlogIt blogging engine.

Click to enlarge

Feature Summary

  • Customizable: Main sections (headers and footers) of the page are stored as wiki pages, so you don't need to know HTML.
  • Adds full support for BlogIt, a blogging engine for PmWiki. This means that your elements of the blog page will seamlessly fit within the skin.
  • Color switching: Easily switch skin colors (3 basic versions in muted or bold come standard), page background (black or white), and page header backgrounds, or create your own skin colors.
  • Supports removal of header/title/right/footer elements using directives on specific pages or site wide.
  • Fully CSS driven: All files are fully commented, and the design has been made easy to modify. The CSS used for layout and coloring are in separate files allowing easy customization of colors, without having to wander throughout the layout styles.

Download and Installation

  • Download the skin package (ZIP or TAR) and unzip it into your skins directory (usually pmwiki/pub/skins).
  • For PHP 7.2 or newer please get choice-php82.zipΔ instead.
  • Add the following to your local configuration file: $Skin = 'choice';
  • If you use a page logo, add this to config.php:
$PageLogoUrl="URL_TO_IMAGE";
  • Optionally set the logo height and width. The skin will calculate this for you, but if you know the dimensions you should specify them, including the units of measure (ie, 'px'):
$PageLogoUrlWidth='154px';
$PageLogoUrlHeight='24px';
  • If you do not use a page logo, or want to override the default logo, add this to config.php:
$PageLogoUrl="";
  • If you use BlogIt, add this to config.php, before including BlogIt:
    $bi_SkinClasses=array('approved-comment-count'=>'.comment-count a');

Optional

Change the color (green_muted is the default) and theme (light or dark background). Refer to colors for more color options.

$SkinColor = 'orange_bold';
$SkinTheme = 'dark';

Color Switching

You can switch the color theme site wide by updating your config.php with:

$SkinColor = 'blue';

Or simply pass a parameter:

?color=red

You can try out the color schemes using the color selector menu. The included color schemes are:

  • blue_bold, blue_muted
  • green_bold, green_muted
  • orange_bold, orange_muted

You can set the skin theme, to either dark or light, which changed the background coloring. If you want light, you do not need to set anything.

$SkinTheme='dark';  #no need to set this if you want the light theme

BlogIt for Blogs

Choice fully supports the BlogIt blogging engine, automatically -- you don't need to do anything other than install BlogIt.

Page Layout

  • Blue: Included pages. These can be edited as normal PmWiki pages.
  • Green: PmWiki variables. Usually set in config.php.
  • Red: Disable section. Markup is for in-page use; SetTmplDisplay is for use in config.php.

Sections can be removed from the page or the site with special markup.

  • Turn off sections on a page with markup (:noXXX:).
  • Turn off sections for the whole site in config.php by setting:
SetTmplDisplay('PageXXXFmt', 0);

Header

You can set the Title and the Tag-line by setting the following in config.php:

$WikiTitle = "My site";
$WikiTag   = "Site description";

The wiki file Site.SiteHeader can be overridden with a Group level page. If you want to change the layout of the header edit either {$Group}.SiteHeader or {$SiteGroup}.SiteHeader. The default value for the header is:

! %block sitetitle%[[{$ScriptUrl} | {$WikiTitle}]]
(:div class="sitetag":){$WikiTag}
(:divend:)

Top Navigation Tabs

In order to change the links available in the navigation tabs, edit Site.SiteNav, and use a list format as below:

* [[Grp/MyPage | Page 1]]
* [[Grp/MyPage | Page 2]]
* [[Grp/MyPage | Page 3]]

Side Bar

The other likely change you'll want to make is on the Side Bar. In this case edit Site.SideBar, and use a list format below:

%sidehead% [[Header 1]]
* [[First Level]]
** [[Second level]]

Footer

The wiki file Site.SiteFooter contains the last modified date.

FAQ

Browser Compatibility

This is an incomplete listing of the browsers which have been seen working with this skin.

  • Works under Windows with: Chrome; Safari; Firefox; IE6/7/8; Opera.

Known Issues

None known.

  • 2011-02-09 pogay: Download of skinlink comes to message 502 bad gateway (Mozilla 3.6.10/Linux) probably certificate issue. workarround: download with w3m worked :-)
    • DaveG 9-Feb-2011: You mean the ZIP/TAR links for downloading the skin? They seem to work fine on various machines I've tested, so the links are okay. Possibly a temp network error?

Change Log

1.1.3 (31-Mar-2016)

  • chg: Send fullname into tags with update of blogit bi_SaveTags().

1.1.2 (25-Mar-2016)

  • chg: Compatible with BlogIt 1.9.0.

1.1.1 (25-Feb-2016)

  • chg: PHP 5.5 compatible.

1.1.0 (12-Jun-2010)

  • new: Add styling for blogit-comment-status
  • new: Add container div around single blog entry "#wikitext .blogit-post". (for ajax blog edit)
  • new: Add .blogit-post-summary container around multi-entry blogs; ensure .blogit-post-summary is added to shared same styling as .blogit-post.
  • chg: Increased contrast for h3 elements
  • chg: Increased color contrast for text in form input areas.
  • chg: Author to lowercase
  • bug: Incorrect reference to {*$LastModified}; XL translation did not work.
  • bug: ie7.css was not included in package.

1.0.3 (19-Oct-2009) (rev 572)

  • new: notitle hides page group and title.
  • new: Added date formats to XLPage.
  • new: Added "Last modified..." footer text to XLPage.
  • chg: Use BlogIt skin markup to simplify blogit template.
  • chg: Removed LinkPageCreateFmt override.
  • chg: Improved styling with blogit.
  • chg: Changed footer to point to blogit page, if blogit is being used.
  • bug: Unable to turn off search bar.
  • bug: "Last modified..." footer displayed modify date of the footer page, not base page. (Reported by SH)

1.0.2 (4-Oct-2009) (rev 525)

bug: Corrected display issue in Safari and Chrome. bug: Fixed display issue on quickref, when <br /> tag is present. chg: Added styling for BlogIt page navigation block.

1.0.1 (3-Oct-2009) (rev 523)

  • bug: When $PageLogoUrl is undefined (like PmWiki.com) heading is offset too high.

1.0.0 (3-Oct-2009) (rev 522)

  • First release.

Credit

  • The main layout and the CSS is based on the Choice theme, created by Demus Design.

Comments

Show your support and leave a comment, or help out and let me know if you have a suggestion or a problem. Love it or hate it, I'd like to know!

User notes +6: If you use, used or reviewed "Choice", you can add your name. These statistics appear in the Skins listings and will help newcomers browsing through the wiki.