Sperrobjekt Weblog ::
The following instructions are valid only for the Microformats plugin up to version 0.4*. Beginning with the current 0.6* versions, installation and setup have been simplified, and new options have been added.
This page will contain information on my microformats plugin for the blog software Serendipity.
Installation
There are two microformats plugins in one: the event plugin and the sidebar plugin. I recommend you install the event plugin first because the sidebar plugin cannot be installed without the event plugin. It's required for everything to work correctly. The easiest way to install plugins is to use SPARTACUS, Serendipity's built-in plugin manager. If you want to display microformats in your blog entries, it is necessary that you edit your template's entries.tpl file. Find the line that says {$entry.body}. Right after this line, add two more lines containing:{microformats_show data=$entry.properties type=hReview}{microformats_show data=$entry.properties type=hCalendar}
That's it.
Setting up the event plugin
Currently, there are four setup options, two of which are very experimental (to say the least) and should not be modified for the time being: "Maximum points" and "Steps". The current draft (version 0.3) of the hReview microformat, which is still a work in progress, contains an optional rating field with optional worst and/or best values. I want to make those available in one of the next versions of my plugin. So let's put them aside for now.
The first option "Add subnode" is a concession to the older structured blogging approach that was introduced way before microformats. The future of this is very unclear, it seems, so it's probably best to leave this setting to "No". If you really need a structured blogging subnode in your source code, enable this option. But be aware that your source code may fail to validate.
Setting up the sidebar plugin
The sidebar plugin gives you the option to enter a heading for your sidebar box. You can choose if you want your events ordered by date (ascending). If you do not want to display events that are already over, just enter the number of days after that the event will not be displayed anymore; leave the field empty if all events should be displayed. All the events that you announce in your blog entries by way of the event plugin can also be read from the database and be listed in your sidebar; this might lead to double occurrences on the page, though. As a visual hint for your visitors, you can show a red CAL icon (I guess this option will be removed in one of the next updates). Make sure you select the correct timezone (of your blog) .
Now for the most important entry: the XML code that contains your events. Take a look at this example:
<events>
<event summary="Football Worldcup 2010" location="South Africa" url="http://www.fifa.com/de/worldcup/index/0,3360,WF2010,00.html?comp=WF&year=2010" dtstart="20100611T1930" dtend="20100711T2000" description="Africa's Calling" />
</events>
The list of your events must be enclosed in <events></events> tags. A single <event/> must have at least the summary dtstart attributes. The location url dtend description attributes are optional. Right now, dtend description are ignored, but this will change in future releases.
To be continued ...
