Introduction
============

This product add a new Plone view (@@plone2fss), available everywhere in the site.

From ths view you can do two tasks described below.

Export site contents to filesystem
----------------------------------

You can export the data of the Plone site to the filesystem in a format compatible
with the FileSystemStorage (recently iw.fss) product.

The export procedure didn't look at the current content's storage, so this may help to change the
storage strategy used with FileSystemStorage, but you can also export (for example) files that are
stored in the ZODB, and images already stored using FileSystemStorage with flat strategy to the
filesystem in a format compatible with the directory strategy.

This procedure DON'T touch the current storage of exported objects, so it's safe!

All compatible data found in the subtree from the path where you called the view are exported.
To export the whoe site, just call the view from the portal root.

You can also choose what content type store, but at the current developing state you can only
limit the default ones (so you can decide to not export File because they already use FSS).

For ImageField fields (for Image and News Item contents) you can also add some other non-standard
image format. Plone2FSS is stupid, so it try to export to all format listed, also if the format
is available (for example) for Image content type but not for News Item.

This isn't commonly a problem, but will generate empty directory with site1 strategy. 

Change storage used
-------------------

You can also migrate existing contents from AttributeStorage or AnnotationStorage to
FileSystemStorage.

Again you can do this task only for a portion of the site, and limiting the portal type to act on.
This will change your ZODB, so please please please... backup your data before!

To do this, change the configuration of Plone for use FSS on basic content type
(you can use the `redturtle.fss`__ product to obtain this easily).

__ http://pypi.python.org/pypi/redturtle.fss

Storage strategy 'site2'
------------------------

Storage strategy site2 isn't supported because at current time (iw.fss 2.7.6) it's dangerous due
to a bug.

Flat format is also bad, but we need it so we have implemented it.

Plone 2.5
---------

To use Plone2FSS with Plone 2.5, download the source and copy the Plone2FSS directory inside the
egg structure (Plone2FSS/Products/Plone2FSS) to the Products directory.

TODO
====

 * Support also the site2 strategy (previous a forced enabling).

 * Support for file and images fields that are not called 'image' and 'file'.

 * Need automated test, for Plone 2.5 and 3.

