Working with BlogAddOn

To update the instructions on this page to point to your blog web, enter the name of the blog web:

Once you have copied the topics from _BlogAddOn (temporary) web to the web you want the blog to appear:

Visit yourblogweb.BlogPost for the overview of blog posts

Visit yourblogweb.BlogPostCreator to create new blog entries

Visit yourblogweb.BlogCategories to edit the categories

Putting the blog post list in a different topic

To put the overview in a topic, write:

%INCLUDE{"yourblogweb.BlogPost"}%

This will show all posts, grouped (paginated) by 10, the most recent first.

It will also include the filter and sort options above the blog posts.

List display options

Use display="posts" to show the blog posts without filter/short dropdown controls (but with author/category/tag filters):

%INCLUDE{
"yourblogweb.BlogPost"
display="posts"
}%

Use display="list" to show only the posts, without filter/sort dropdown controls and without author/category/tag filters.

%INCLUDE{
"yourblogweb.BlogPost"
display="list"
}%

NOTE: because author/category/tag filters are not displayed, users will not be able to remove filtering. Use this display variant only in specific places.

Summary options

Use parameter outline to control the contents of the summary text. Possible values:

Value

Will show

formfield(Summary) (default)

Contents of form field Summary. If the field does not exist or is empty, summary(200) is used instead.

summary

Topic summary, just the plain text, all formatting and line breaks removed; up to 162 characters. You can use other notations for summary, such as summary(n) and summary(n, noheader) - see FormattedSearch.

Settings

To show user pictures:

In WebPreferences or SitePreferences: point preference setting BLOGADDON_AUTHOR_PICTURE_FIELD to the field name of the user topic that contains the filename of the user picture. For example, for PersonalInfoAddOn that field is named "Picture", so you would write:

1.9.0 Added setting outline to control the summary text. Added form field SummmaryImage to choose the attachment name to be displayed in the summary. Improved display of comments in list view. Added options to define image sizes.

1.2 Added optional inclusion of author pictures from Foswiki:Extensions/PersonalInfoAddOn. Important upgrade notice: this version uses WIKINAME instead of WIKIUSERNAME in the Author form field. This change is not compatible with existing blog topics. If you have existing posts, you must change all author names from Main.UserName to UserName.

26 Jan 2008

1.1 Adds the creation date to blog post topic names. Adds an Edit link to the Comments header in a blog post. Increases the height of the comment box. Bug fix: allow topic names with periods.

1.0.8 Show link to latest comment in BlogPost listing. Improved readability for comments. This version relies on CommentPlugin svn release number 13313 and PatternSkin svn release number 13320, but BlogAddOn will now play nicely with other skins as well.

06 Feb 2007

1.0.7 Added no-javascript fallback to BlogPost and BlogPostCreator (so that topic can actually be created without javascript). Fixed a javascript bug that was introduced when a Core function was renamed.