[Wwedit-development] pt_extform Release Candidate 1

[Thomas R. <th...@by...>]

Hi Leute,

Gestern abend habe ich das erste Release Candidate 1 des neusten pagetypes fertig gestellt. es handelt sich, wie in meiner gestrigen email beschrieben um eine moeglichkeit auf einer website nahezu beliebige formulare zu verwenden, und die eingegebenen daten per email zu verschicken.

Eine kurze Funktionsbeschreibung:

1. Ein formular wird ueber die templates.ini an ein template gebunden. Dabei wird als pagetype pt_extform benutzt. um nun ein bestimmtes formular auf dieser seite zu benutzten, muss das feld definition auf eine formular definition gesetzt werden.

2. forularedefinitionen werden in der datei forms.ini eingetragen. ein beipiel liegt unter http://wwedit.sourceforge.net/screenshoots/01_forms.ini.jpg.

als sektionsname dient der wert im defintionfeld des templates in der template.ini.

folgende merkmale koennen zu einem formular definiert werden:

  - Name des Formulars (wird im Backend angezeigt, kann im Frontend angezeigt werden)
  - Eine optionale BCC Adresse, an die IMMER eine Kopie der Daten geschickt werden soll.
  - Eine absenderadresse fuer die emails, die an den redakteur gehen
  - ein betreff fuer die emails
  - einen contenttype (zbsp.: text/plain oder text/html, je nachdem, ob html mails oder text mals versand werden sollen)
  - ein smarty template file, welches sich im ordner ./templates/ befinden muss. dieses template wird benutzt, um die email zu texten und zu gestalten.
  - liste an formularfeldern und texten 

3. die einzelnen formularfelder werden in der fields.ini definiert. als sektionname wird der name aus der feldliste in der forms.ini benutzt. ein feld besteht aus mehreren feldern:

  - einen namen (der der auch als name fuer das formular im frontend benutzt werden muss)
  - ein Label (fuer das backend)
  - einen typ (selectone, selectmore, input, text, label)
    text und label ermoeglichen es dem redakteur im backend texte zu definieren. der unterschied liegt in der darstellung als textarea oder input box.
  - verfuegbare values (fuer selectone, selectmore), welche fuer eine auswahl zur verfuegung stehen (selectboxen, radiobuttons, checkboxen)
  - einen default wert
  - und validierungsregeln

4. validierung von formularen.

- validierung wir dmit hilfe der PEAR Klasse Validate realisiert - man muss ja das rad nicht neu erfinden.
- conditions ist eine kommagetrennte liste von bedingungen:

   + min_length:anzahl   definiert eine min. laenge der eingabe
   + max_length:anzahl   definiert eine max. laenge der eingabe
   + min_count:anzahl    definiert fuer selectmore eine min. anzahl ausgewaehlter elemente
   + max_count:anzahl    definiert fuer selectmore eine max. anzahl ausgewaehlter elemente
   + email               es muss sich um eine email-adresse handeln
   + url                 es muss sich um eine url handeln
   + number              es muss sich um eine ganze zahl handeln
   + min                 mindest wert einer zahl
   + max                 maximal wert einer zahl


so. ich hoffe der funktionsumfangst so einigermassen bewusst geworden. wem auffaellt, dass was fehlt (zum beispiel validierung fuer kommazahlen oder liste von email-adressen) , dann doch bitte bescheid geben.


gruss

thomas