Original post has now been updated with files for pkBlog 1.2. I’ve beefed up the instructions, and incorporated the key documents, parameters and TV definitions into the installation document. Some new parameters make the snippet more flexible, a few bugs have been fixed, and the code has been tidied here and there.
I’ve submitted this version to the Extras repository (my first submission - how nerve-wracking).
Updated parameters
&tagFormat - class for SPAN around set of tag options (was previously hard coded).
&cacheItem (default 1), set to zero for non-cacheable page. Mainly to cope with PHx - Ditto clash. Variable that used to determine this has been abolished.
$postid (where to go after publishing) can be single doc ID as before, or array of tag=>ID pairs. This allows for sites that use tags to categorize, e.g. news subsections, so tags can relate to different pages.
Bugs, corrections
- default &postid to newly created document (not &folder)
- Publish command from preview now clears preview flag (or sets published flag - whichever was wrong)
- Publish now sets published field conditional on pub_date, pkDateTo
Simplifications
- abolished config.bloglist.php - params are now set directly in Manage Posts document’s snippet call
- bloglist.manage.tpl and blog.preview.tpl chunks now use alias rather than doc id to set Add/Edit Post page as form action attributes, making it /admin/post-edit (on my site). Easier to maintain than keeping track of doc IDs.
- removed some redundant styles from forms.css, added ".clearer" class used in blog post template sample.
Outstanding issues
- need to review rich text / plain text options for the Intro and Content. I don’t think it’s possible at the moment to make the Intro a rich-text field, because it does HTML entities on saving.
- need to start thinking about how to internationalize the snippet.
pkEvents is coming along nicely, I must soon choose whether to put it out as a standalone snippet, or merge with pkBlog and make it the first version of PubKit. Decisions, decisions!

KP