Installing paab in a already working Plone

Purpose

This document will show you how to get install paab in a already working Plone instance.

Prerequisities

• A Plone 3.0.5 or Plone 3.0.6 instance working. To write this document i used a  Plone 3 with the Unified Installer instance and it should work if you Set up Plone and Zope from source or if you're using a Python/Zope/Plone server on Fedora Core 5 or Plone on Debian (Etch), although the last two cases could be slightly different (step 1) and these had not been tested, if you have any problem please write me.
  
• Paab's last version.

Warning

If you're using paab 0.2 or less, be careful because paab renames Folder and News Item content type. Until paab 0.2, the product is thought to use the entire Plone portal as a Blog and all changes are applied globally. Paab 0.3 will support local blog sections in order to be used in Plone Portals that are not exclusively Blogs.
 

Step by step

1. In your Zope instance download paab.policy product using easy_install
   

   $ cd $INSTANCE
   $ ./Python-2.4.4/bin/easy_install --prefix $INSTANCE/Plone-3.0.6/Python-2.4.4 paab.policy

   Because i'm using Plone 3 with the Unified Installer instance, i install paab in the instance local python. 
   
2. Now we need to add the slugs, first we go to the place we're going to save them
   

   $ cd $INSTANCE/zinstance/etc/package-includes

3. Using your favorite editor create a file called 001-paab.policy-configure.zcml with this content

   <include package="paab.policy" file="configure.zcml" />

4. Start your instance
   

   $ $INSTANCE/zinstance/bin/zopectl start

5. In your browser, go to your Plone Site, then Site Setup -> Add-on Products and install paab.
   

Further information

If you want to learn more about buildout i recomend these great documents:

• The Quick Guide to Python Eggs
  If you are using a linux distribution package you'll need to figure out where you should install the package.

• Using Add-on Products
  There are many third-party add-on Products for Plone that can give you additional functionality, often at the click of a button. However, not all Products are created equal. Knowing how to install, test, evaluate and extend them is important. Read on. The Part 3 describes in general the instructions of this how to.
   

Troubleshooting