Plone4ArtistsCalendar
=====================

Overview
--------

Plone4ArtistsCalendar is a Plone product built to expose the 
``p4a.plonecalendar`` framework in a Plone setting.  In a nutshell it provides
the following features:

Calendar support
  Any folder or smart folder can be *calendar activated* which turns it into 
  a calendar which knows how to display an overview for all contained events.

Monthly view
  Any calendar activated (smart) folder can has several default views
  including a monthly view.

Chronological event view
  The events gathered together by the activated calendar can be displayed
  using a chronological event listing.

iCal support
  Importing and exporting events in iCal format.

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

- Zope 2.9.4 or higher (Zope 2.8 and 2.10 are not supported at this time)
- Plone 2.5.1 or higher (Plone 2.1 and 3.0 are not supported at this time)

- Five 1.4 or higher
- CMFonFive 1.3.2
- Calendaring SVN trunk r31258 or higher
- Marshal SVN trunk r7066 or higher

Installation
------------

If you're installing from the *Plone4ArtistsCalendar* bundle release you 
simply need to install all of the included Zope2 products into your 
``$INSTANCE_HOME/Products`` directory.

If you're installing just the *Plone4ArtistsCalendar* Zope 2 product, 
you'll need the other dependencies installed manually as well.  Please 
see their install files for proper installation instructions.

Testing
-------

To run the Plone4ArtistsCalendar tests you must use the standard Zope 
testrunner::

    $INSTANCE_HOME/bin/zopectl test -m Products.Plone4ArtistsCalendar.tests
    
Running the tests any other way (such as with the -s option) will result
in the testrunner finding unrunnable tests due to *PYTHONPATH* mangling.