General Actions:
Blog Application
Last modified by Thomas Mortagne on 2012/02/22
 | Transforms the wiki into a bliki with the ability to add Blog posts and display them |
| Type | XAR |
| Developed by | |
| License | GNU Lesser General Public License 2.1 |
| Bundled With | XWiki Enterprise, XWiki Enterprise Manager |
| Compatibility | XWiki Enterprise >= 1.8 |
Table of contents
Description
Creating one or several Blogs
By default a recent XWiki installation will provide a blog inside the Blog space. You can use that one or create a new one inside an existing space or as the main content of a new space using the Blog's Management. For that you just need to navigate to this URL: <URL to server:port>/xwiki/bin/view/Blog/Management. A new page will show up asking you to enter:
- The name of the Space
- The title of the Blog
- Select if the blog is inside an existing space or as the main content of that space
After you have filled in the information click "Create". You now have a new blog!
RSS Feed for the Blog
In order to display the RSS Feed icon on your blog you have to add this line:
<link rel="alternate" type="application/rss+xml" title="Blog RSS Feed" href="$xwiki.getURL('Blog.BlogRss', 'view', 'xpage=plain')" />
to the Blog's Presentation HTTP Meta Information text area. You can reach that by clicking on Administration -> Administer Space: 'Blog Space Name'.
If you want to provide feeds based on the Blog's Categories then drag the Blog Categories Panel onto your blog's sidebar. You can find that by selecting Administration -> Administer Space: 'Blog Space Name' -> Panel Wizard.
If this panel does not produce the correct feeds then check out this JIRA report that has a patch for it.
Examples
The blog application is used for example on the Blog page of xwiki.org.
It is also possible to customize the Blog application for specific purposes. You will need some Velocity knowledge to do this, so please check the Developer's Guide for more information.
You can add / change blog categories on the http://<server>/xwiki/bin/view/Blog/Categories page.
A panel that lists all blog categories is also available . You can find it on the http://<server>/xwiki/bin/view/Panels/BlogCategories page of your XWiki.
Screenshots
The Blog Panel
A Blog Article
A Blog Main Page
Changing the Style
The blog application uses a Skin Extension stored as an object attached to the Blog.BlogStyle document. In order to modify the Blog's style edit this document in Object Mode and modify the style as you wish.
Prerequisites & Installation Instructions
- Log in the wiki with a user having Administration rights
- Go to the Administration page and select the Import category
- Follow the on-screen instructions to upload the downloaded XAR
- Click on the uploaded XAR and follow the instructions