wiki:TracBlogPlugin

Version 10 (modified by pacopablo, 8 years ago) (diff)

--

Trac Blog Plugin

Description

A blogging system for Trac.

TracBlogPlugin allows one to harness the power of TagsPlugin to generate blogs. It provides a wiki macro so that blogs can be inserted in any wiki page. It also provides a navigation component.

Screenshots

Main blog page New Blog Post Blog admin

Bugs/Feature Requests

Existing bugs and feature requests for TracBlogPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

You can check out TracBlogPlugin from here using Subversion, or browse the source with Trac.

Installation

TracBlogPlugin has been tested with the current trunk, though should work on 0.9.x

Requirements

Install in the same manner as any other Trac plugin:

# python setup.py bdist_egg
# cp dist/*.egg /srv/trac/env/plugins

You will also probably need to enable the plugin in your environments trac.ini:

[components]
tracblog.* = enabled

Example

[[BlogShow]]
Displays a blog based on tags The list of tags to be shown can be specified as arguments to the macro. An options keyword argument of union can be secified. If specified, then the resulting blog will be a union of pages with the specified tags. If the union parameter is omitted, then an intersection of the specified tags is returned.

If no tags are specified as parameters, then the default 'blog' tag is used.

[[BlogShow()]]
[[BlogShow(blog,pacopablo)]]
[[BlogShow(blog,pacopablo,union=True)]]
[[BlogPost]]
Inserts a link to create a new blog post

Accepts keyword arguments that specify default parameters. The macro will be hidden unless the user has BLOG_POSTER permissions.

tag - Tag that populates the "Tag under" field. This key may be specified as a tuple or list to pass multiple values.
blogtitle - Default blog entry title.
text - Default entry body text.
pagename - Default wiki page name.
readonly - Default readonly page status.
link - Text to display as the link.

[[BlogPost()]]
[[BlogPost(tag=(blog,pacopablo))]]
[[BlogPost(tag=blog,blogtitle="A Simple Title",text="Body Text")]]
[[BlogPost(tag=blog,pagename=blog/newpage,readonly=1)]]    
[[BlogPost(tag=(blog,pacopablo),link="A New Blog Post")]]  

trac.ini Documentation

[blog]
date_format = %x %X              ; format string in strftime format
page_format = %Y/%m/%d/%H.%M     ; format string in strftime format
default_tag = blog               ; comma separated list of tags
post_size = 1024                 ; number of bytes to show before truncation
history_days = 30                ; number of days of blog entries to show
new_blog_link = New Blog Post    ; default value for new blog post link

Recent Changes

[3516] by pacopablo on 2008-04-15 18:14:15
Added patch from retracile to include wiki:BlogHeader? in the top of the blog page.
[3371] by pacopablo on 2008-03-15 15:12:07
More 0.11 porting
[3225] by pacopablo on 2008-02-13 08:52:05
  • Refs #1111 - First big push towards porting to 0.11
  • The blog entry window has mostly been finished.

Author/Contributors

Author: pacopablo
Contributors: