README

Welcome to the documentation, such as it is. There are some notable changes in 1.6.5

• -main_template.pt is gone. You no longer have to jump through hoops retweaking your main_template to get PABlog to play nice with your site
• -Subjects have been added through metadata and the edit_form.pt has a dropdown for it (you can change the list of allowable subject by editing the Extensions/Install.py file and then running it. It looks funky if you include "here/Subject" as text in a page template, so I didn't. You can now at least do searches/sorts/displays by subject.

    
      ex: 
              <div tal:define="Politics python: here.portal_catalog(portal_type=['PABlog'], 
                              Subject='Politics', sort_on='Date', sort_order='reverse', 
                              review_state='published');
  			Batch python:modules['ZTUtils'].Batch;
  			global batch python:Batch(Politics, 1, 0, orphan=1)">
                  <div tal:condition="Politics" tal:repeat="Politics batch">
                      <div tal:define="DateTime modules/DateTime" tal:content= 
  "python:DateTime.DateTime(improv.Date).strftime('%B %d, %H:%M')">July 7, 08:11
                      </div>
                  </div>
  
              </div>
  

  I'll be fleshing out this feature with the next release.

• -turn replies off on specific posts. This is a cheesy hack, and doesn't actually turn replies off if users can figure out the URL, but it will prevent them from showing up for the post that has replies turned off. Also note, that any time you edit an entry, you will need to uncheck the "Replyable" box again to keep replies off.
• -much nicer CSS
• -plone 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.
• -File structure change. Many people didn't like that when the calendar rolled over to a new month, all previous entries disappeared from the front page to the archives. I have changes this, all entries now live in the root folder of the blog, with id's based on the timestamp. If you have an existing site, you do not HAVE to migrate, but it wouldn't be a terrible idea.

Works on: Zope 2.6+/CMF 1.3.1+

Preconditions:
1. - You have a CMF Site (PABlog assumes it is called "site". If this is not the case, you'll want to edit index_html in the blog folder once you've imported the zexp file).
2. - You have CMFCalendar installed. This is highly recommended, as the archiving function derives from this. If you don't have it, comment out the relevant section of main_template. 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.

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. - You can now go to your site (e.g. http://localhost:8080/site/blog)
6. - (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.