| 1 | = Self-contained Blog plugin = |
| 2 | |
| 3 | == Description == |
| 4 | |
| 5 | 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. |
| 6 | |
| 7 | This is a preview relase, only available for an up-to-date 0.11dev. The implemented features should work as expected, but some features are not yet completed. |
| 8 | |
| 9 | Basic features are: |
| 10 | * Create, edit and view blog posts under a new 'Blog' menu. |
| 11 | * Browse post by month, category and author + and Archive page for all posts. |
| 12 | * Comments for blog posts. |
| 13 | * Admin page for basic settings. |
| 14 | * Permissions for `BLOG_VIEW, BLOG_COMMENT, BLOG_MODIFY_OWN, BLOG_MODIFY_ALL, BLOG_ADMIN`. |
| 15 | * Special handling of a post named 'about'. |
| 16 | * Area in sidebar for information text, blogroll, links and similar. |
| 17 | |
| 18 | Some features will not be completed before ongoing Trac context refactoring and timeline API changes are nearing completion: |
| 19 | * Attachments on blog posts. |
| 20 | * Posts and comments in timeline. |
| 21 | * Diff between version of the post. |
| 22 | * Delete post version, delete post and delete comment. |
| 23 | * Fine-grained permissions - currently only 0.10 style permissions are implemented as there is no context/resource system implemented. |
| 24 | * XmlRpcPlugin support. |
| 25 | |
| 26 | '''That means:''' |
| 27 | * Use in production at your own risk as it is still a 'preview'. |
| 28 | * Don't file tickets for tasks that are missing as in 'not implemented' (see list above). |
| 29 | * Feedback is most welcome - see [wiki:osimons] to get in touch with me by mail or on the #trac channel. |
| 30 | |
| 31 | == Bugs/Feature Requests == |
| 32 | |
| 33 | Existing bugs and feature requests for FullBlogPlugin are |
| 34 | [report:9?COMPONENT=FullBlogPlugin here]. |
| 35 | |
| 36 | If you have any issues, create a |
| 37 | [http://trac-hacks.org/newticket?component=FullBlogPlugin&owner=osimons new ticket]. |
| 38 | |
| 39 | == Download == |
| 40 | |
| 41 | Download the zipped source from [download:fullblogplugin here]. |
| 42 | |
| 43 | == Source == |
| 44 | |
| 45 | You can check out FullBlogPlugin from [http://trac-hacks.org/svn/fullblogplugin here] using Subversion, or [source:fullblogplugin browse the source] with Trac. |
| 46 | |
| 47 | == Example == |
| 48 | |
| 49 | Get started: |
| 50 | 1. Install the plugin in your preferred manner. |
| 51 | 1. Enable the plugin: |
| 52 | {{{ |
| 53 | [components] |
| 54 | tracfullblog.* = enabled |
| 55 | }}} |
| 56 | 1. Run `trac-admin /path/to/env upgrade` |
| 57 | 1. Restart server and see it work. |
| 58 | |
| 59 | |
| 60 | |
| 61 | == Recent Changes == |
| 62 | |
| 63 | [[ChangeLog(fullblogplugin, 3)]] |
| 64 | |
| 65 | == Author/Contributors == |
| 66 | |
| 67 | '''Author:''' [wiki:osimons] [[BR]] |
| 68 | '''Contributors:''' |