wiki:qPloneBlog

Version 2 (modified by olena, 18 years ago) (diff)

--

What Is qPloneBlog ?

qPloneBlog is a a SimpleBlog enhanced with the following products:

qPloneBlog is an easy to use Plone based weblog application. It has a fancy blogger-api/backlink stuff, etc. and supports categories. Writing entries is done from inside Plone. qPloneBlog comes with three new portal types: Blog, Blog Folder and Blog Entry:

  • Blog - Folderish object that is the container for the Blog Entries and the front-page of the weblog.
  • Blog Entry - Entry object inside the weblog.
  • Blog Folder - Folder that can only exist inside the Blog container. The folder allows you to organize the Blog Entries in any way you like.

Categories

SimpleBlog can use categories to classify Blog Entries. When you edit and configure the Blog object, you can provide it with a list of categories that will present itself as a multi-selection list when you edit/create a Blog Entry. Next to that, Blog Folders can define additional categories.

In Blog Entries created inside the Blog Folder, a selection can be made out of the categories defined in the Blog *and*, additionally, out of the ones defined by the Blog Folder(s) it sits in. All the categories will add up. This feature can be useful when the Blog is maintained by several authors. You can then incorporate some policy that certain Entries must be created in specific Blog Folders because of the additional categories. Categories you can later search for but you don't want exposed to all the other authors.

Next to categories defined by the Blog object and the Blog Folders, you can also define a set of global categories. These categories are available to all the Blog Entries created in the portal. Defining these global categories can be done in ZMI in the simpleblog_tool or in the Plone setup.

Blog Entries can be searched for in the Catalog and in Topics using categories. Use the Entry Category index.

Portlets

SimpleBlog comes with 5 different portlets. The portlets behave mainly in two different ways. The portlet names ending with _local are only visible inside the Blog structure. They are hidden as soon as you are not within Blog Entry, Blog Folder or Blog. Portlets ending with _global on the other hand, are visible everywhere and will summarize among Blogs deeper in the folder structure.

There are two display modes for both the _local and _global portlets. The Full version shows the calendar, the top most recent entries and the available categories. Clicking on the entries will lead to the full Blog Entry view and clicking on the category will display a list of Blog Entries within that category. Next to the Full version there is also a Recent version. That version will not display the categories and only presents a list of the recent additions.

So, summarizing, you can use any of these values inside the left_slots or right_slots:

  1. here/portlet_simpleblog/macros/portletBlogFull_local
  2. here/portlet_simpleblog/macros/portletBlogFull_global
  3. here/portlet_simpleblog/macros/portletBlogRecent_local
  4. here/portlet_simpleblog/macros/portletBlogRecent_global

There is an additional 5th portlet: portletRecentComments_local that shows the latest comments within the blog.

Installation

  1. Install SimpleBlog, qRSS2Syndication, qPingTool as usual Plone products
  2. Install in your Plone instance with Quick Installer (Plone Control Panel ->Add/remove Products)

Requirements

  • Plone 2.1.x
  • qRSS2Syndication
  • qPingTool
  • XMLRPCMethod
  • Archetypes 1.3.5 and above