Features

In the entry on theme options I mentioned the date format and referenced to the strftime section of the PHP manual. While coders and other geeks will already be very familiar with this, new users and those with no PHP experience probably will not be. So let's see what all those funny little characters actually mean.

%A, %B %e. %Y, what the hell is that supposed to mean? Well, these are variable which basically tell Serendipity how to display a date using the PHP function strftime. Every combination of % and a letter stands for a part of the possible date formats. These are the variables actually used in Bulletproof:

• %a or %A Abbreviated (%a) or full (%A) weekday name.
• %b or %B Name of the month. Again, abbreviated or full.
• %d Day of the month as a number with leading zero, i.e. ranging from 01 to 31.
• %e Same as %d above, but with a space instead of the leading zero, i.e. ranging from 1 to 31.
• %m The month as a decimal number with leading zero, i.e. ranging from 01 to 12.
• %y or %Y The year as a decimal number, either with a century indicated (%Y) or without (%y)

These can be combined with dots or hyphens to format the date display in a Serendipity blog. For example, the default date format in Bulletproof is the one mentioned above: %A, %B %e. %Y. This means the date will by default be displayed like this in a blog configured to use the English language:

Full weekday name followed by a comma, then full name of the month and decimal day of the month without a leading zero followed by a dot and the year with century indicated.

For example, for the time of writing this entry, that would result to

Tuesday, August 21. 2007

Got it? However, if this sounds too complicated, just stick with the default or play with the theme option until you get a satisfying result

A frequently asked question (or better: feature) in the s9y forums has always been adding an additional navigation to a s9y-powered blog. In the past, this required modifiying the template's files, until the theme options were added to Serendipity's features. Bulletproof provides an additional navigation bar which can be extensively customized using the theme options. Since these options are very powerful, they will be explained more in detail than the other theme options.

First of all, let's look at the theme options related to the customizable navigation bar:

• Position of the navbar: Choose one of five options for the position of the navigation bar. It can be displayed above or below the banner or in either sidebar. Of course, it can also be deactivated altogether.
• Show navigation links in the footer: The links from the navbar can also be displayed in the page footer as an additional navigation source. These links will be the same links you have in the navigation bar. They are a copy of the navbar links, placed in the footer as a site visitor convenience. When enabled, your visitors will not have to scroll back to the top of the page to use site navigation. Footer navigation links will not be displayed if the navbar is deactivated.
• Show quicksearch in the navbar: If, and only if, the navigation bar is displayed above or below the banner, the input box for s9y's search option can be displayed within the navigation bar. This does not work if the navbar is displayed in either sidebar! Also, the HTML output of the quicksearch sidebar item will be automagically suppressed, you do not have to deactivate it under "Configure Plugins".
• Title for navigation menu: If the navigation menu is displayed in either sidebar, it should have a title. Use this text box to enter the desired title. This title is only for when the navigation menu is displayed in the sidebar - the title will never be displayed if the navigation menu is displayed above or below the header.

Bulletproof's primary design goal originally was to build a layout base which would make it possible to have the "traditional" website/blog layouts so the layout would not break in any modern web browser. Along the way, we also made great use of the so-called "theme options". These are certain options for the template the user can modify in the admin backend under "Manage Styles".

We're pretty confident we have addressed almost every need a user could have and also have simplified some tweaks to a s9y-based weblog which have been frequently asked in the forums in the past. Let's walk you through the theme options available in bulletproof in their order of appearance, shall we?

Although bulletproof is meant to be used as a framework for new templates by template designers, it can also be used as a template out of the box. bulletproof ships with three individual colorsets:

Purple

Blue

Green

All colorsets can be customized to some extent using the theme options.

bulletproof comes with 6 basic layouts:

This covers the most popular layout types for websites and blogs: 3-column layouts with various sidebar combinations, both 2-column layouts possible, and an additional 1-column layout showing the sidebars below the actual blog content (the entries). All of these layout are flexible, meaning their column's widths adjust to the width of the viewer's browser window.

You'll notice some of them are marked CF (content first), meaning the actual content of the blog (the entries) is the first item in the output code generated by Serendipity. It would have been possible to make all layouts CF, but that would have required additional HTML markup which we, the developers, felt was not worth the effort.