Lars Pind's Blogger Documentation

By Lars Pind


I wrote this blogger package for my own web site at For background information, please visit


The blogger now lives in the OpenACS cvs repository.

Getting started

Install the package on your system, mount a new instance somewhere on the site map, make sure you have admin permission on the instance, and then visit /admin under the URL where you mounted it. Now you can add your first blog entry.

Syndicating a blog (putting it on your front page)

If you want to include a blog as part of another page, that's pretty simple.

If you're including in an ADP, say:

<include src="/packages/lars-blogger/www/blog" url="/blog">

... for the non-cached version, and ...

<%=[lars_blog_get_as_string -url "/blog"]%>

... for the cached version. There shouldn't be any problems using the cached version, as the cache should be flushed whenever anything changes.

From a Tcl page:

set blog_html [template::adp_parse "[acs_package_root_dir "lars-blogger"]/www/blog" [list url "/blog"]]

... for the non-cached version, and ...

[lars_blog_get_as_string -url "/blog"]

... for the cached version.

All of these are shown with an argument 'url' here, but they all take a package_id argument instead, if you prefer that and know what the package_id is. If nothing's supplied, the current package is used, which is generally not what you want.

Technical Info

The package fully supports multiple instances, i.e., you can mount several instances in your site map, and they'll stay properly isolated from each other.

Contents in your blog entries are assumed to be full-blooded ADP-ified HTML, so don't give people access to post a blog unless you trust them. I guess it should be made configurable whether to allow this or not, but since I'm developing this for my own site primarily, I haven't done so. This also means that if you've added custom ADP tags, those are also available to you in your blog. update ping

There are a couple parameters governing this feature. You can turn it on or off on a per-package basis. And you can specify which URL you want to export to, in case it's not the one the package instance is mounted at. This can be useful if you're including the blog on other pages, for example your site's front page. Thanks to Jerry Asher for the code to do this.

RSS Feed

The RSS feed is version 1.0 only, and uses the rss-support package. You should be able to simply visit the admin page of your new blogger instance and click the "Setup RSS" link, and you'll have an RSS feed.

Then you'll need to set the parameters and say that your rss_file_url is at /where-your-blogger-instnace-sists/rss/rss.xml. If you leave this blank, we won't advertise your RSS feed URL anywhere.

You can also supply your own channel image through the parameters.

Road Map

Version History


Released under the GPL.