Changes between Version 45 and Version 46 of FullBlogPlugin
- Timestamp:
- Mar 7, 2015, 5:38:29 PM (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
FullBlogPlugin
v45 v46 1 1 [[PageOutline(2-5,Contents,pullout)]] 2 = Self-contained Blog plugin =3 2 4 == Description == 3 = Self-contained Blog plugin 4 5 == Description 5 6 6 7 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. … … 8 9 This is a production-ready release, '''supporting Trac 0.11 and 0.12 installations'''. The current 0.11 branch is 0.12 compatible, but does not yet support other locales than English (no l10n/i18n support). 9 10 10 Basic features are:11 * Create, edit and view blog posts under a new 'Blog' menu a.12 * Browse post by month, category and author +and Archive page for all posts.11 Basic features: 12 * Create, edit and view blog posts under a new 'Blog' menu. 13 * Browse post by month, category and author and Archive page for all posts. 13 14 * Attachments on blog posts. 14 15 * Comments for blog posts. … … 16 17 * Search for blog posts and comments. 17 18 * Admin page for basic settings and editing informational text in sidebar. 18 * Permissions for `BLOG_VIEW , BLOG_COMMENT, BLOG_MODIFY_OWN, BLOG_MODIFY_ALL, BLOG_CREATE,BLOG_ADMIN`.19 * Permissions for `BLOG_VIEW`, `BLOG_COMMENT`, `BLOG_MODIFY_OWN`, `BLOG_MODIFY_ALL`, `BLOG_CREATE`, `BLOG_ADMIN`. 19 20 * Support for Trac fine-grained permissions security checks (based on resource / realm). 20 21 * Special handling of a post named 'about'. … … 25 26 * A `[[BlogList]]` news-listing macro with various display modes for pulling blog posts into the wiki. 26 27 * Change listener and manipulator APIs for hooking on to changes. 27 * Spamfilter implementation included - thanks to athomas , ([3106] - forgot commit message...)28 * Spamfilter implementation included - thanks to athomas ([3106]). 28 29 * Sample plugin provided illustrating how to use the hooks. 29 30 * FullBlogNotificationPlugin adds email notification of changes to posts and comments. … … 37 38 Feedback is most welcome - see [wiki:osimons] to get in touch with me by mail or on the #trac channel. 38 39 39 == Macro ==40 A macro to display list of posts and extracts outside (or inside) 41 the Blog module -most commonly Wiki pages.40 == Macro 41 42 A macro to display list of posts and extracts outside (or inside) the Blog module, most commonly Wiki pages. 42 43 43 44 All arguments are optional: … … 56 57 57 58 Example showing some available named arguments: 59 58 60 {{{ 59 61 [[BlogList(recent=5, max_size=250, period=2007/12, author=osimons, format=float, heading=Some Trac Posts)]] 60 62 }}} 61 63 62 The arguments for criteria are 'AND'-based, so the above example will render 63 at most 5 posts by 'osimons' in December 2007. 64 The arguments for criteria are 'AND'-based, so the above example will render at most 5 posts by 'osimons' in December 2007. 64 65 65 66 There is no heading unless specified. 66 67 67 Without restriction on recent number of posts, it will use the number currently 68 active in the Blog module as default for 'float' and 'full' rendering, but for rendering 69 of 'inline' list it will render all found as default unless restricted. Additionally for 70 'float' and 'full' it will truncate content if it is larger than a max_size (if set). 68 Without restriction on recent number of posts, it will use the number currently active in the Blog module as default for 'float' and 'full' rendering, but for rendering of 'inline' list it will render all found as default unless restricted. Additionally for 'float' and 'full' it will truncate content if it is larger than a max_size (if set). 71 69 72 70 The `format=` keyword argument supports rendering these formats: … … 79 77 Posts are rendered sorted by newest first for all modes. 80 78 81 == Screenshots ==79 == Screenshots 82 80 83 81 The plugin in action (old-ish screenshot): … … 86 84 To see the blog in action, visit its 'home' at http://www.coderesort.com/about/blog 87 85 88 == Migration ==86 == Migration 89 87 90 88 There is a script available in the [source:fullblogplugin/0.11/contrib contrib] directory for migrating existing TracBlogPlugin users to the FullBlogPlugin. … … 103 101 migrate-tracblog.py /path/to/environment 104 102 }}} 105 * Confirm th e migration succeeded, then remove the old posts (if desired)103 * Confirm that the migration succeeded, then remove the old posts if desired: 106 104 {{{ 107 105 #!sh 108 106 migrate-tracblog.py /path/to/environment --delete-only 109 107 }}} 110 Take a look at `migrate-tracblog.py --help` for more options 108 Take a look at `migrate-tracblog.py --help` for more options. 111 109 112 == Bugs/Feature Requests ==110 == Bugs/Feature Requests 113 111 114 112 Existing bugs and feature requests for FullBlogPlugin are … … 118 116 [http://trac-hacks.org/newticket?component=FullBlogPlugin&owner=osimons new ticket]. 119 117 120 == Download and Install == 118 [[TicketQuery(component=FullBlogPlugin,group=type,format=progress)]] 119 120 == Download and Installation 121 121 122 122 Either: … … 129 129 }}} 130 130 131 ''Note: on Fedora-14, Python 2.7, Trac 0.11, trac did not see the plugin after easy_install and restart.Adding these two symbolic links in site_packages fixed it:''131 ''Note: on Fedora-14, Python 2.7, Trac 0.11, Trac did not see the plugin after easy_install and restart. Adding these two symbolic links in site_packages fixed it:'' 132 132 {{{ 133 133 #!sh … … 137 137 ''I don't know what the long-term effects of this not-by-the-books edit are with future upgrades. A better egg hacker should probably correct my advice. (dr2chase)'' 138 138 139 == Source ==139 == Source 140 140 141 141 You can check out FullBlogPlugin from [http://trac-hacks.org/svn/fullblogplugin here] using Subversion, or [source:fullblogplugin browse the source] with Trac. 142 142 143 == Get it working ==143 == Configuration 144 144 145 145 Follow these simple steps and configuration hints: … … 170 170 }}} 171 171 172 '''Upgrade''' on your Trac environment172 '''Upgrade''' your Trac environment as follows: 173 173 {{{ 174 174 #!sh 175 $trac-admin <env> upgrade175 trac-admin <env> upgrade 176 176 }}} 177 177 178 == Available Plugins ==178 == Available Plugins 179 179 180 180 [[ListTagged(fullblogplugin)]] 181 181 182 == Recent Changes ==182 == Recent Changes 183 183 184 184 [[ChangeLog(fullblogplugin, 3)]] 185 185 186 == Author/Contributors ==186 == Author/Contributors 187 187 188 188 '''Author:''' [wiki:osimons] [[BR]] 189 '''Maintainer:''' [ wiki:osimons] [[BR]]189 '''Maintainer:''' [[Maintainer]] [[BR]] 190 190 '''Contributors:'''