INSTALL.txt
Installing Formulator
Requirements
Formulator should work with Zope versions 2.6 or higher:
http://www.zope.org/Products/Zope
For reading in forms as XML you need to have minidom installed;
this should come with a normal python 2.1 distribution. This is
not required to use Formulator, however.
Upgrading
to 1.6.x from earlier versions
There should be no problems.
to 1.6.0 from earlier versions
There should be no problems.
to 1.4.2 from earlier versions
There should be no problems.
to 1.4.1 from earlier versions
There should be no problems.
to 1.4.0 from earlier versions
There should be no problems.
to 1.3.1 from earlier versions
There should be no problems (see note for 0.9.2 though in the
unusual case you're upgrading from that..this is the last time
I'll mention it :).
to 1.3.0 from earlier versions
There should be no problems, but see the note if you're
upgrading from 0.9.2 or below (but I'd be surprised if you
were!).
to 1.2.0 from earlier versions
There should be no problems, but see the note if you're upgrading
from version 0.9.2 or below.
to 1.1.0 from earlier versions
There should be no problems. If you're upgrading from 0.9.2 or
below however, please see the upgrading note for 0.9.3. Do note
that the Override tab is scheduled to be phased out eventually in
favor of the TALES tab. This will take a while yet, though.
to 1.0.9 from earlier versions
There should be no problems. If you're upgrading from 0.9.2 or
below however, please see the upgrading note for 0.9.3. Do note
that the Override tab is scheduled to be phased out eventually in
favor of the TALES tab. This will take a while yet, though.
to 1.0.1 from earlier versions
There should be no problems. If you're upgrading from 0.9.2 or
below, please see the upgrading note for 0.9.3.
to 1.0 from earlier versions
There should be no problems. If you're upgrading from 0.9.2 or
below, please see the upgrading note for 0.9.3.
to 0.9.5 from earlier versions
There should be no problems in upgrading from 0.9.4 or 0.9.3.
If you're upgrading from 0.9.2 or below, see the upgrading note
for 0.9.3.
to 0.9.4 from earlier versions
There should be no problems in upgrading from 0.9.3.
If you're upgrading from 0.9.2 or below, see the upgrading
note for 0.9.3.
to 0.9.3 from earlier versions
'items_method' in ListField is gone; you'll have to adjust make
your forms use 'items' in the override tab now instead. Sorry
about that, it *was* marked experimental. :)
There should be no other problems in upgrading.
to 0.9.2 from earlier versions
There should be no significant upgrade problems; your forms
should still work. RangedIntegerFields should show up as
IntegerFields, which subsume their functionality.
to 0.9.1 from earlier versions
There should be no significant upgrade problems; your forms
should still work.
Quickstart
Formulator follows the normal Zope filesystem product installation
procedure; just unpack the tarball to your products directory and
restart Zope.
Now the same at a more leisurely pace.
Unpacking
Formulator comes as a 'Formulator-x.x.tgz' file, where 'x.x'
stands for the Formulator version number. On Unix, you can use::
tar xvzf Formulator-x.x.tgz
to unpack the file. On Windows you can use your favorite archiving
software, such as WinZip.
This will create a Formulator directory.
Installing the Product
Move this directory to your Zope's Products directory. Normally
this is 'yourzope/lib/python/Products'.
Now restart your Zope.
Verifying Installation
If all went well, Formulator should now be visible in Zope in the
Products screen ('/Control_Panel/Products'). In a Zope folder, you
should now see a 'Formulator Form' in your 'Add' list. You should
be able to add a form to a folder now.
Requirements
Formulator should work with Zope versions 2.6 or higher:
http://www.zope.org/Products/Zope
For reading in forms as XML you need to have minidom installed;
this should come with a normal python 2.1 distribution. This is
not required to use Formulator, however.
Upgrading
to 1.6.x from earlier versions
There should be no problems.
to 1.6.0 from earlier versions
There should be no problems.
to 1.4.2 from earlier versions
There should be no problems.
to 1.4.1 from earlier versions
There should be no problems.
to 1.4.0 from earlier versions
There should be no problems.
to 1.3.1 from earlier versions
There should be no problems (see note for 0.9.2 though in the
unusual case you're upgrading from that..this is the last time
I'll mention it :).
to 1.3.0 from earlier versions
There should be no problems, but see the note if you're
upgrading from 0.9.2 or below (but I'd be surprised if you
were!).
to 1.2.0 from earlier versions
There should be no problems, but see the note if you're upgrading
from version 0.9.2 or below.
to 1.1.0 from earlier versions
There should be no problems. If you're upgrading from 0.9.2 or
below however, please see the upgrading note for 0.9.3. Do note
that the Override tab is scheduled to be phased out eventually in
favor of the TALES tab. This will take a while yet, though.
to 1.0.9 from earlier versions
There should be no problems. If you're upgrading from 0.9.2 or
below however, please see the upgrading note for 0.9.3. Do note
that the Override tab is scheduled to be phased out eventually in
favor of the TALES tab. This will take a while yet, though.
to 1.0.1 from earlier versions
There should be no problems. If you're upgrading from 0.9.2 or
below, please see the upgrading note for 0.9.3.
to 1.0 from earlier versions
There should be no problems. If you're upgrading from 0.9.2 or
below, please see the upgrading note for 0.9.3.
to 0.9.5 from earlier versions
There should be no problems in upgrading from 0.9.4 or 0.9.3.
If you're upgrading from 0.9.2 or below, see the upgrading note
for 0.9.3.
to 0.9.4 from earlier versions
There should be no problems in upgrading from 0.9.3.
If you're upgrading from 0.9.2 or below, see the upgrading
note for 0.9.3.
to 0.9.3 from earlier versions
'items_method' in ListField is gone; you'll have to adjust make
your forms use 'items' in the override tab now instead. Sorry
about that, it *was* marked experimental. :)
There should be no other problems in upgrading.
to 0.9.2 from earlier versions
There should be no significant upgrade problems; your forms
should still work. RangedIntegerFields should show up as
IntegerFields, which subsume their functionality.
to 0.9.1 from earlier versions
There should be no significant upgrade problems; your forms
should still work.
Quickstart
Formulator follows the normal Zope filesystem product installation
procedure; just unpack the tarball to your products directory and
restart Zope.
Now the same at a more leisurely pace.
Unpacking
Formulator comes as a 'Formulator-x.x.tgz' file, where 'x.x'
stands for the Formulator version number. On Unix, you can use::
tar xvzf Formulator-x.x.tgz
to unpack the file. On Windows you can use your favorite archiving
software, such as WinZip.
This will create a Formulator directory.
Installing the Product
Move this directory to your Zope's Products directory. Normally
this is 'yourzope/lib/python/Products'.
Now restart your Zope.
Verifying Installation
If all went well, Formulator should now be visible in Zope in the
Products screen ('/Control_Panel/Products'). In a Zope folder, you
should now see a 'Formulator Form' in your 'Add' list. You should
be able to add a form to a folder now.