===============
Installing epoz
===============

Requirements
------------

- Python 2.1 or higher

- if using Zope2: Zope 2.5 or higher

- if using CMF: CMF 1.4

- if using Plone: Plone 2.1

- if using Zope3: Zope3 CVS Head, Python 2.2 or 2.3

Migrating
---------

If you are migrating from Epoz 0.X, please also read MIGRATING.txt

Zope2 without CMF or Plone
-------------------------

1. Requirements

You need the FileSystemSite product, version 1.3 or higher. You can
download it from http://zope.org/Members/philikon/FileSystemSite.

2. Installation

Drop the 'epoz' directory into your instance home's Products directory
and restart the Zope instance.

3. Using the epoz editor macro

Typically you want to use the editor macro in your own Page
Template. First, create an 'epoz editor' object at the top of your
folder hierarchy and give it an id, e.g. 'epoz'. Then, create a page
template and make use of the macros and slots documented in API.txt
using 'here/epoz/epozmacros/macros' as TALES path prefix (if you have
named the editor object 'epoz').

Zope2 with CMF/Plone
--------------------

Drop the 'epoz' directory into your instance home's Products directory
and restart the Zope instance.

The commended way to install epoz into your CMF or Plone site is using
CMFQuickInstaller which can be downloaded from the Collective project
page at sourceforge: http://sf.net/projects/collective. Alternatively,
execute the external method Install.py in the Extensions directory
manually from your CMF/Plone site.

Zope3
-----

Simply drop the 'epoz' directory into Zope3's zopeproducts directory
and edit your products.zcml file to include::

  <include package="zopeproducts.epoz" />
