Web formulier scripts actief bij Antenna

Er zijn 3 standaard FORM-scripts actief bij Antenna:

SCRIPT	SCRIPT-TAAL	FORM NAME	METHOD	ACTION
A. MAIL A FORM	Perl	vrij in te vullen	POST	http://www.antenna.nl/cgi-bin/mail-a-form.cgi
B. FORM 2 CSV	PHP	vrij in te vullen	POST	http://www.antenna.nl/diensten/form2csv.phtml
C. FORM 2 CSV+MAIL	PHP	vrij in te vullen	POST	http://www.antenna.nl/diensten/form2csvmail.phtml

A. MAIL A FORM

Gebruikers kunnen het aanroepen vanuit hun eigen directory vanuit elke HTML-pagina.
Het script herkent of de website bij Antenna is geregistreerd.
Het werkt dus alleen als URL website bekend is gemaakt aan support@antenna.nl!

Er moeten een aantal FORM-elementen opgenomen worden:

ELEMENT	TYPE	NAME	VALUE
input	hidden	to	eigenadres@antenna.nl (1)
input	hidden	from	afzender@email.nl (2)
input	hidden	subject	zelf invullen (3)
input	hidden	nextpage	http://www.naam.nl/bedankt.html (3)
input	text	veld1	optioneel (4)
input	text	veld2	optioneel (4)
input	text	veld3	optioneel (4)
input	submit		Opslaan

Noten:

Dit element moet aanwezig zijn: er wordt een bericht verzonden met alle ingevulde velden van het desbetreffedende formulier!
Dit element moet aanwezig zijn als afzender van het desbetreffedende formulier!
Dit element moet aanwezig zijn: Subject van het bericht dat wordt verzonden.
Een vrij aantal velden van elk soort: textarea, text, checkbox, radiobutton kan worden opgenomen.
Een uitleg met voorbeeld is hier te lezen.

Een voorbeeld

<FORM NAME="Formulier bij Antenna" METHOD="POST" 
ACTION="http://www.antenna.nl/cgi-bin/mail-a-form.cgi">
<INPUT TYPE="hidden" NAME="to" VALUE="mijnadres@antenna.nl">
<INPUT TYPE="hidden" NAME="from" VALUE="Mijn formulier bij Antenna">
<INPUT TYPE="hidden" NAME="subject" VALUE="Een ingevuld formulier">
Geef je naam <INPUT TYPE="text" NAME="naam" SIZE="45">
<INPUT TYPE="hidden" NAME="nextpage" 
VALUE="http://www.antenna.nl/~mijnhomedirectory/verstuurd.html">
<INPUT TYPE="submit" VALUE="Verzenden">
</FORM>

De constanten

De METHOD is altijd "POST".
De ACTION is altijd de locatie van het script: "http://www.antenna.nl/cgi-bin/mail-a-form.cgi"

B. FORM 2 CSV

Wat doet form2csv.phtml

Gebruikers kunnen het aanroepen vanuit hun eigen directory vanuit elke HTML-pagina.
Het script herkent of de website bij Antenna is geregistreerd.
De inhoud van vrij op te nemen velden worden in een CSV-bestand opgeslagen.
Dit bestand heeft het formaat van "Command Separated Values" en wordt moeiteloos door Open Office,
Excel, Word en Access ingelezen (veld namen zijn niet relevant).
Met een 'csv_name' veld kun je aangeven hoe het CSV-bestand moet heten.
Met een 'list_fields' veld lijst met velden aangeven in welke volgorde de fields weggeschreven moeten worden.
De veldnamen worden op eerste regel van CSV geplaatst zodat Excel meteen de betekenis toont.
Elke keer als iemand script aanroept wordt inhoud op nieuwe regel aan file toegevoegd.
Als de file niet bestaat wordt die meteen aangemaakt.

Installatie

Er moet in de eigen directory 'public_html' een nieuwe subdirectory gemaakt worden met de naam 'uploads'.
Dit kan hetzij door support hetzij door door de gebruiker zelf (met een FTP-programma) worden gedaan.
En de rechten moeten zijn: 'R/W' voor iedereen (Chmod 777)

Er moeten een aantal FORM-elementen opgenomen worden:

ELEMENT	TYPE	NAME	VALUE
input	hidden	csv_name	bestandsnaam.csv (1)
input	hidden	list_fields	veld_1,veld_2,veld_3 (2)
input	hidden	next_page	http://www.naam.nl/bedankt.html (3)
input	text	veld_1	optioneel (4)
input	text	veld_2	optioneel (4)
input	text	veld_3	optioneel (4)
input	submit		Opslaan

Noten:

De filenaam die je verzint wordt in je 'public_html' directory in de subdirectory '/uploads/' geplaatst.
De veldnamen zijn vrij bv. een reeks zoals 'titel,auteur,abstract,isbn,uitgever'.
De waarde van de 'next_page' is URL van de pagina na het indienen van het formulier.
Vergeet niet dat elk van de velden wel een eigen form-element moet krijgen.

Gebruik in COBRA pagina's

Je kunt nu in COBRA vensters of:

onderaan klikken in evt. aanwezige WYSYWYG-editor op HTML en dan de FORM-code plaatsen
of in andere textareas tussen [HTML] en [/HTML] plaatsen.

Een voorbeeld

<FORM NAME="Formulier bij Antenna" METHOD="POST" 
ACTION="http://www.antenna.nl/diensten/form2csv.phtml">
<INPUT TYPE="hidden" NAME="csv_name" VALUE="bestandsnaam.csv">
<INPUT TYPE="hidden" NAME="list_fields" VALUE="naam,adres,postcode,plaats,email">
<BR />Geef je naam <INPUT TYPE="hidden" NAME="naam" SIZE="45">
<BR />Huisadres <INPUT TYPE="text" NAME="adres" SIZE="45">
<BR />Postcode <INPUT TYPE="text" NAME="postcode" SIZE="45">
<BR />Woonplaats <INPUT TYPE="text" NAME="plaats" SIZE="45">
<BR />E-mail <INPUT TYPE="text" NAME="email" SIZE="45">
<INPUT TYPE="hidden" NAME="next_page" 
VALUE="http://www.antenna.nl/~mijnhomedirectory/verstuurd.html">
<INPUT TYPE="submit" VALUE="Verzenden">
</FORM>

De constanten

De METHOD is altijd "POST".
De ACTION is altijd de locatie van het script: "http://www.antenna.nl/diensten/form2csv.phtml"

C. FORM 2 CSV+MAIL

Zie alle punten van FORM 2 CSV
De scriptnaam waarnaar verwezen wordt, wijkt af: http://www.antenna.nl/diensten/form2csvmail.phtml
Er moet een extra FORM-element opgenomen worden:

ELEMENT TYPE NAME VALUE

input hidden to eigenadres@antenna.nl (1)

Dus in het formulier komt er bij: <INPUT TYPE="hidden" NAME="to" VALUE="mijnadres@antenna.nl">

Noot:

Indien dit element aanwezig is wordt een melding verzonden dat een bijdrage
is ontvangen via het desbetreffedende formulier in het opgegeven bestand!