KForm / ZMSForms - Formulare im ZMS

Formulare in ZMS mit dem Zope Formulator Object

KForm alias ZMSForms bietet die einfache und transparente Integration des Zope-Formulator Produktes in das ZMS Content Management System.

KForm bietet ZMS-Nutzern das einfache Anlegen von Formularen in einer ZMS-Website per Klick.

Eingegebene Formulardaten werden geprüft und z.B. per Email an einen beliebigen Mailempfänger weitergereicht - der Absender erhält wahlweise eine Quittung.

Der einfache Ansatz ermöglicht jedoch vielfältige weitere Formularapplikationen wie auch die Ausgabe von Formularen in anderen Medien (nicht nur HTML). Basierend auf dem Formulator Objekt können einfach mehrere / beliebige Formularvorlagen bereitgestellt werden.

Interessierte Entwickler und Anwender sind eingeladen, sich am Projekt aktiv zu beteiligen.

Derzeit aktuell ist die Version KForm-1.5 (vom 01.02.2008).

Zur Installation laden und entpacken Sie eines der Archive:

aktuelle Version - KForm

ältere Versionen

Liste der Dateien:

• Buchung.zexp
• CHANGES.txt
• FAQ
• kform-specobj.xml
• Kontakt.zexp
• README.txt
• Veranstaltung.zexp

Installation

Gehen Sie mit Administratorrechten im ZMS in die "Konfiguration" -> "spezielle Objekte" und importieren Sie die XML-Datei mit der Bezeichnung kform-specobj.xml als spezielles Objekt ins ZMS. Es erscheint ein neuer Objekttyp namens "Formular" bzw "kform" (abhängig von der ZMS-Version).

Wechseln Sie unter ZOPE in das ZMS-Root Verzeichnis (oder höher) und klicken auf "Import", wo Sie die - wie üblich zuvor im ZOPE-Import Verzeichnis (meist "./import/" in der ZOPE-Instanz bzw. dem ZOPE-Server) abgelegten ZOPE-Exportdateien (zu erkennen an der Endung .zexp) - in das ZOPE-Verzeichnis importieren können.

Als Basis benötigen Sie eigentlich lediglich die Formularvorlage "Kontakt.zexp" bzw. "Kontakt", welche bereits ein Standard-Kontakt-Formular auf deutsch enthält und beim Anlegen neuer Formularobjekte im ZMS per default angewählt ist.

Weitere Formularvorlagen können Sie entweder ebenfalls als fertige ZOPE-Imports importieren oder durch Kopieren des "Kontakt" Ordners in weitere Ordner selbst übernehmen und nach Bedarf bearbeiten. Welche Formularvorlagen Ihre Benutzer auswählen dürfen, können Sie jetzt einfach in der Liste der Variable "formtype" am KForm-Objekt bearbeiten. Für eigene Formularvorlagen geben Sie dort einfach in der Liste den genauen Ordnernamen Ihrer Vorlage ein. Lediglich das Email-Feld "kform" für die Erfassung/Eingabe der Absender-Emailadresse muss in jeder Formularvorlage weiter vorhander sein, da dieser Parameter von kform selbst für verschiedene Funktionen verwendet wird und zwingend erforderlich ist.

Hinweis!
Funktioniert bei Ihnen der Versand von Emails aus KForms nicht auf Anhieb? Dann müssen Sie vorraussichtlich den in KForm eingestellten Mailserver (SMTP) - per default "localhost" je oben in den Methoden "FormularEmailSend" und "FormularEmailSendQuittung" auf den bei Ihnen gültigen SMTP-Server ändern (z.B. das bestehende dtml-sendmail smtphost="localhost" in dtml-sendmail smtphost="mail.IhrServer.com")!

Sofern Sie auf Ihrem ZOPE-System einen eigenen ZOPE-MailHost definiert haben, können Sie auch diesen im "dtml-sendmail" Tag einsetzen.

Upgrade von einer früheren Version von KForm

Bis Version 1.0 (<=1.0)

müssen Sie ev. alle bestehenden Dateien aus KForm (z.B. im ZMS-Root sowie im Content-Folder des ZMS - ZOPE-Sicht einschalten) löschen und dann erst das aktuelle KForm im ZMS installieren. Ev. ist es auch nötig, bestehende Instanzen (Formular-Objekte) im ZMS erneut einzeln zu öffnen und wieder zu speichern/schließen. Ignorieren Sie dabei die Hinweise wie "DO NOT MODIFY OR DELETE..." - diese Dateien werden, wenn benötigt, bei der Installation wieder angelegt.

Sofern Sie an einer älteren Versionm selbst einige Code-Anpassungen vorgenommen hatten, sind diese nun ev. gar nicht mehr nötig, da Sie diese Dinge nun komfortabel als eigene Optionen angeben können. Auch die neue Version ist so gestaltet worden, das KForm-Benutzer eigene Anpassungen und spezielle Erweiterungen recht einfach einsetzen können.

höher als 1.0 (>1.0)

Hier werden Sie wahrscheinlich lediglich nur die Standard-Installation durchgehen müssen und alles sollte gleich funktionieren. Damit Sie jedoch auch in den Genuß der neueren Funktionen kommen, sollten Sie hierzu die jeweiligen Formulare in Ihrem ZMS öffnen und die Einstellungen wie gewünscht vornehmen.

das KForm special object in der Manager Ansicht (des Admin)

 

ToDo - was kommt nach dieser Version?

• Multilingual-Version - Mehrsprachigkeit
• Generierung von "Online PDF" (online ausfüllen und als fertiges PDF druckbar ausgeben)
• Ausgabe der Formulardaten wahlweise / parallel als XML-Datenstrom (per EMail oder XML-RPC)
• digitale Signaturen
• mehrere Formular-Layouts und -Designs wählbar machen
• integrierter Formular-Editor für ZMS Management
• ...

Lizenzen, Benutzung und Mitarbeit

KForm wird als Open Source Software unter der GPL-Lizenz entwickelt. Gern nehmen wir uns zugestellte Hilfen, Beiträge und Ideen in das Projekt und dessen weiterer Entwicklung auf und stellen bei Bedarf auch eine geeignete Versionierungsplattform bereit.

Die Entwicklung an KForm geht ständig weiter. Details zur Software (eine history, todos oder feature requests) finden Sie bisher jetzt noch in der beiliegenden README.txt.