PABlog-1.7 README

PABlog 1.7 Documentation.
Matt Yarbrough
matt_pablog@punitiveart.com
http://www.punitiveart.com/Projects/PABlog
12.Dec.2003

Welcome to the documentation, such as it is. 

Plone version is broken, and will remain so until I have time to install plone 
and learn how to make "edit" work with plone's built in form manager.  Anyone 
who is familiar with this and wants to look into it, I would welcome your help 
most heartily.
  
Tested on: 
Zope 2.6.2/CMF 1.4.2
Zope 2.6.1/CMF 1.4.2
Zope 2.6.1/CMF 1.3.1 

Known problems:
When using CMF 1.3.1, the blogindex_html_utils needs to be edited to remove the
'.css' on the stylesheet.  Also in CMF 1.3.1, when editing comments you must hit the
"Change and View" button rather than the "Change button".



New in 1.7:
 - HtmlArea support.  This is very useful. 
 - edit/delete comments
 - list last 10 comments (alpha version, point your browser at [blog url]/last10)

To Do:
 - make last10 show the content of the comment
 - plone support
 - get comments to order chronologically

Preconditions:

1. - You have CMFCalendar installed. This is highly recommended, as the
archiving function derives from this. It comes with CMF 1.3+, so you don't even
have to download anything.  To install CMFCalendar, create an external
method in your CMF root with the module name CMFCalendar.Install and the
function name is install, run the test, and the move on. 
2 - You have HtmlArea 3 installed.  Get it here: 
http://zope.org/Members/to_be/htmlarea3

Installation:

1 - run the installer (create an external method where the Module Name
is PABlog.Install and the Function Name is install
2 - In the ZMI, go to portal_skins/PABlog, and click on
discussion_reply. You will see a readonly version of the file and a
dropdown and button. Make sure that "custom" is selected, and hit the
button. Click the Proxy tab at the top and select Manager, and hit save.
3 - copy blog.zexp to your Zope import folder (e.g. /var/Zope/import).
4 - Back in the ZMI, select your CMF Site (in our case 'site') and
import blog.zexp into the site.
5 - (optional, recommended) go to [site root]/portal_calendar and select
Configure, select PABlog as one of the types you want to show in the
calendar, and click Submit. 

Usage:
Simple blog tool. Create/edit posts in the folder for the current month. You
can put images/documents/files/etc in the same folder (it's just a regular
Portal Folder) and access them easily.