The Blogging RPC Plugin implements the Blogger 1.0 API and the MetaWeblog API for Confluence to let you post Confluence news pages from any client that implements these APIs
Version 1.2.1 of this plugin is currently bundled with Confluence
Configuration
Once you have installed the plugin point your blog client at the confluence rpc url:
http://yourhost:port/rpc/xmlrpc
Select either the Blogger API or the MetaWeblog option as the blogging tool. (You may need to select a custom configuration for clients that already have the address for popular sites such as Blogger configured.)
Once you have setup your client and authenticated you should see every space you have permission to edit news items on as a list of blogs for the confluence site
Once you have your blog client configured, you can edit your blog posts as though you were using the wiki-markup mode on the website. If you write your post in standard wiki-markup, it will all be translated normally when posted, including macros. Note, however, that your blog client will not be able to interpret the markup and will present it as plain text.
Also, be careful that your client does not any html tags to your content before you save it. There is currently no conversion of html so be sure to configure your client to send only plain text (wiki markup).
Blog Post Titles You cannot repeat the same blog post title on the same day in Confluence.
The following sections detail how the specific API methods relate to confluence functionality:
MetaWeblog Method Functionality
Method
Description
newPost
Creates a new blog page in Confluence. Any categories set on the blog post will be converted to confluence labels.
editPost
Edits a post. The categories specified on the updated blog post will replace any labels that currently exist on the page in Confluence.
getPost
Returns a blog post specified by a given Id. The labels attached to the page in Confluence are returned as MetaWeblog categories.
getRecentPosts
Returns a list of recent blog posts for the specified space
getCategories
Returns all of the labels from the specified space as well as the 20 most popular global labels (if not already included) as metaweblog categories.
newMediaObject
This method is not currently implemented. You will need to use the confluence web interface to add attachments to blog pages.
Blogger Method Functionality
Method
Description
getUserBlogs
Returns a list of spaces in which the specified user can create or edit blog pages.
newPost
Creates a new blog page in Confluence.
editPost
Edits a post.
getRecentPosts
Returns a list of recent posts for a specified space. The client can specify how many posts are returned.
deletePost
Puts the specified post in the trash. A space administrator needs to purge the trash to remove the post permanantly
getPost
Returns a struct containing information about a single news page
getUserInfo
Returns a struct containing information about the authenticated user.
getTemplate
This method is not supported. You need to use the normal confluence admin screens to view/change templates.
setTemplate
This method is not supported. You need to use the normal confluence admin screens to view/change templates.
For all methods the publish flag must be set to true. You can not save a draft of your changes for publication later.
For the Blogger API the title tag must be specified in the content like <title>My Title<title>. Some blog clients do this automatically, but others (like MarsEdit) require you to put this in the body of the post. Don't worry, it will appear correctly in confluence after you post.
This release fixes a bug with the 1.1 release that allows users to view other users private labels on a blog post.
This is a highly recommended upgrade for all users
This is the initial version of the Blogging RPC Plugin containing an
implementation of the Blogger 1.0 API. This version of the plugin cannot
be installed via the web interface or the plugin repository. Please visit
the documentation page
for instructions on manual download and installation in the confluence
WEB_INF/lib directory.
Woah! Very cool!
I would like to be able to post to ordinary pages as well as n...
Woah! Very cool!
I would like to be able to post to ordinary pages as well as news pages via a blogging API - though I appreciate that thinking this through is a bit tricky - how do you represent the hierarchy of pages in a space in a blog-like manner? I thought the best way might be to use something similar to Blojsom meta-data so you could add things like "meta-confluence-parent=home", "meta-confluence-tags=cool, blogging, amazing". Or should these be represented as wiki markup for consistency's sake?
The reason I'm keen to see all of Confluence exposed through a blogging API is that it's quite attractive to leverage the organisational and offline composition features of a desktop blogging client. At present, I write wiki pages in BBEdit, then paste them in to the web form on Confluence.
Miles - the first step here is just to get it working for the blogs within Confl...
Miles - the first step here is just to get it working for the blogs within Confluence, then we can look at pages once that's done. There are quite a few challenges (like tags for example) already without bringing pages into the equation
1.2.4
(#105)
Comments (36)
Nov 05, 2006
Miles Metcalfe says:
Woah! Very cool! I would like to be able to post to ordinary pages as well as n...Woah! Very cool!
I would like to be able to post to ordinary pages as well as news pages via a blogging API - though I appreciate that thinking this through is a bit tricky - how do you represent the hierarchy of pages in a space in a blog-like manner? I thought the best way might be to use something similar to Blojsom meta-data so you could add things like "meta-confluence-parent=home", "meta-confluence-tags=cool, blogging, amazing". Or should these be represented as wiki markup for consistency's sake?
The reason I'm keen to see all of Confluence exposed through a blogging API is that it's quite attractive to leverage the organisational and offline composition features of a desktop blogging client. At present, I write wiki pages in BBEdit, then paste them in to the web form on Confluence.
Nov 05, 2006
Mike Cannon-Brookes says:
Miles - the first step here is just to get it working for the blogs within Confl...Miles - the first step here is just to get it working for the blogs within Confluence, then we can look at pages once that's done. There are quite a few challenges (like tags for example) already without bringing pages into the equation