#####################################
## ZMS KForms 1.3 (zms special object)
## Niels Dettenbach <nd@syndicat.com>
## http://syndicat.com
## distributed under GPL
## (c) 2004
## tested under Zope 2.8 and ZMS 2.8
#####################################

ZMS KForms is a zms special object wich 
allow to interoperate between ZMS and the 
ZOPE Formulator-Product.

Data from successfully filled forms is send 
as emails (dtml sendmail tag).

With this special object it should be simple
to any zms user to create new instances
of forms and to iuntegrate their own forms 
within zms sites.

The basis setup delivers a typically ready
to use contact form and some other instances,
but the forms and methods can be modified 
for doing other things very easily. In
this new version you can add simply more
new types of different forms.

Feel free to understand this project as
a proof of concept.


INSTALL
#######


step 1.) download KForm stuff

If you dont have the Formulator product yet
download the ZOPE Formulator from
http://www.zope.org/Members/faassen/Formulator
and install it into your zope product folder
like any product.

step 2.) extracting the stuff

  extract kforms with
  tar -xzf kforms_xx.tgz


step 3.) import the special object

import kforms-xx.xml as new special object
in ZMS.


step 4.) import the forms

  Import Kontakt.zexp
into the ZMS root folder.

(optional:
  Import Buchung.zexp
...
into the ZMS root folder as a second
instance of a predefined Formulator Form)

step 5.) create instances

Create one or more test instance(s) of 
your new special object "Formular".

- now it should work - if not see TROUBLESHOOTING 
here:


TROUBLESHOOTING
###############

step 6.) mailserver settings / SMTP

If your KForms didnt send emails from filled
forms as configured you have to change the
default SMTP-server in the KForm special object.

Open the KForm special object in the ZMS editor 
and open the following two methodes:

In the first line you will find the

  <dtml sendmail smtphost="localhost"> 

and change it to your working SMTP-host like

  <dtml sendmail smtphost="mail.YourHost.com">

Alternatively you can use your predefined
"MailHost" ZOPE-object too.

UPGRADING HINTS
###############

On some upgrades ZMs and Zope platforms updating
only per over installing the kform special object
may result in trouble, because of old code fragments
from older versions - you can find them under the
ZMS root and / or the "content" folder (with the 
"Z-view" button or zshell - marked as "DO NOT MODIFIY...").

Do delete all the files from kform and reimport the kform
object into the zms config and you got a plain fresh 
install of kform. Old instances (>=v1.x) within ZMS should work
most times without required touching but, to use all the
new options or features - you have to reopen and close 
the instances. Its best to take al look in one of the 
instances to see if it works for you...

---

6.) own forms
You can easily edit or redefine the forms
inside the zms root.

Generate more forms simply by copying the
"Kontakt" Folder with the form object inside
and edit it to your needs. Add the Folder 
names of this new Forms to the data-field
"formtype" in the zms configuration menu
to get the forms selectable for the users.


POST CONFIG:
############

The feedback message can be customized
in dtml methods.

Wich of your own methods should be called
can you give in the feedback method. 

Usability and accessibility of vars:

You can set a
"send_button_name" anywhere, wich will
set the label of the send button 
(i.e. "send").

Pls. didnt remove my name or url from
the code (GPL).

After sucsessful installation pls
send us your url for our records.

Thank You!


TODO at next
############
- give a choice between different
form layouts
- XHTML strict and CSS
- give choice to send data as XML record in mail
- different excport functions and operations
on that forms like "online fill in" of PDF-printed
forms
- interfaces to digital signatures on 
forms and form data
- zms integrated online form editor
...

If someone likes to contribute in kforms pls
feel free to contact me @ nd@syndicat.com
ot take some looks at our project site
http://www.syndicat.com/open_source/
and
http://rimi.de


CONTACT/CREDITS:
#################

For any questions, bugs and inspirations
in any way pls feel free to contact me.

Good luck!

Niels Dettenbach

Syndicat IT&Internet
Lange Str. 51
37359 Effelder
phone:	+49 36075 57225
fax:	+49 36075 57226
email:	nd@syndicat.com
Web:	http://syndicat.com


ToDo
####
- zms multilingual version
- more config stuff
- automatic selection of new form folders
- bring the forms into a sub of the special object