wiki:FullBlogPlugin

Version 8 (modified by osimons, 7 years ago) (diff)

Updated status based on changes in [2779] - primarily attachments and fine-grained permission support.

Self-contained Blog plugin

Description

This plugin provides a project Blog, but unlike TracBlogPlugin and SimpleBlogPlugin it does not use Wiki pages to store the content. It has no dependencies on other plugins.

This is a preview release, only available for an up-to-date 0.11dev. The implemented features should work as expected, but some features are not yet completed.

Basic features are:

  • Create, edit and view blog posts under a new 'Blog' menu.
  • Browse post by month, category and author + and Archive page for all posts.
  • Attachments on blog posts.
  • Comments for blog posts.
  • Search for blog posts and comments.
  • Admin page for basic settings.
  • Permissions for BLOG_VIEW, BLOG_COMMENT, BLOG_MODIFY_OWN, BLOG_MODIFY_ALL, BLOG_ADMIN.
  • Support for Trac fine-grained permissions security checks (based on resource / realm).
  • Special handling of a post named 'about'.
  • Area in sidebar for information text, blogroll, links and similar.
  • Link provider, like [blog:this_is_my_post] and [blog:category/trac] and [blog:2007/10].

Some features will not be completed before ongoing Trac context refactoring and timeline API changes are nearing completion:

  • Posts and comments in timeline.
  • Diff between version of the post.
  • Delete post version, delete post and delete comment.
  • XmlRpcPlugin support.
  • Some sort of news-listing macro thing that will look nice on a project front page, or as summary for categories and author tags. Not sure yet about the details and what it should look like. Input welcome :-)

That means:

  • Use in production at your own risk as it is still a 'preview'.
  • Don't file tickets for tasks that are missing as in 'not implemented' (see list above).
  • Feedback is most welcome - see osimons to get in touch with me by mail or on the #trac channel.

Screenshots

The plugin in action:

Bugs/Feature Requests

Existing bugs and feature requests for FullBlogPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

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

Example

Get started:

  1. Install the plugin in your preferred manner.
  2. Enable the plugin:
    [components]
    tracfullblog.* = enabled
    
  3. Include the core of the plugin as permission policy (necessary for attachments). Example of new default line if no other policies are used:
    [trac]
    permission_policies = DefaultPermissionPolicy, LegacyAttachmentPolicy, FullBlogCore
    
  4. Run trac-admin /path/to/env upgrade.
  5. Restart server and as TRAC-ADMIN you should now see 'Blog' in menu.
  6. Add one or more permissions to let users view, create, comment and modify posts (see list above).

The link to 'Blog' in menu will appear last. To move it, edit your trac.ini config file to add blog into the ordered list:

[trac]
mainnav = wiki,blog,timeline,....

Recent Changes

[13462] by osimons on 2013-12-09 12:03:49
FullBlogPlugin: Conform to latest version of Tags API. Closes #11435.
[12111] by osimons on 2012-10-04 09:10:57
FullBlogPlugin: Add a BLOG_DELETE permission used for deleting posts and comments. Closes #8652.
[12110] by osimons on 2012-10-04 09:05:03
FullBlogPlugin: Added a unit test for getting blog posts by category.

Author/Contributors

Author: osimons
Contributors:

Attachments (2)

Download all attachments as: .zip