Om ingevulde formulieren van uw website terug te krijgen geeft IAF u de beschikking over een standaard CGI-script. Dit script vangt de door de bezoeker van uw site ingevulde informatie op en stuurt deze per e-mail naar vooraf ingestelde e-mailadressen.

Dit script is gebaseerd op versie 1.9s van het bekende FormMail.pl script. Deze versie is volledig ingericht om misbruik door spammers te voorkomen. De aanpassingen die door IAF zijn aangebracht, biedt de klant de mogelijkheid om, zonder tussenkomst van de webmaster, zelf e-mail adressen op te geven.

Wilt u hiervan gebruik maken, maak dan een bestand met de naam adres.txt en plaats dat in de directory waarin u komt als u met ftp een verbinding heeft gemaakt met de server waar uw website staat. Dit bestand bevat de e-mail adressen (1 per regel) waaruit u in uw formulieren wenst te kunnen kiezen. Als u erg veel emailadressen binnen hetzelfde domein heeft, kunt u ook volstaan door alleen het domein te noemen (dus zonder een @ teken erin!).

Benodigde parameters in FORM's

De locatie van ons FormMail script is in alle gevallen (of u nu een eigen domeinnaam heeft, of een website onder www.iaf.nl) gelijk, namelijk /cgi-bin/FormMail.pl. (Denk aan de hoofd- en kleine letters!)

In het formulier kunt u kiezen voor één van de opgegeven adressen door het gewenste adres in het formulier te verwerken met behulp van het onzichtbare veld recipient. (Let wel op hoofd- en kleine letters in het adres. We raden aan om voor alle adressen kleine letters te gebruiken.)

Het CGI script is benaderbaar met 'method="post"'.

Een voorbeeld. Stel het gewenste adres waar de reactie terecht moet komen is info@klantx.nl en het adres van de pagina die uw bezoekers na invullen van het formulier te zien dienen te krijgen is http://www.klantx.nl/bedankt.html, dan begint u uw formulier als volgt:

waarna de rest van uw formulier volgt, afgesloten met </form>.

Opties

Het FormMail programma kent vele opties, welke door middel van zichtbare en onzichtbare velden aan het programma doorgegeven kunnen worden. Hieronder vindt u de mogelijkheden op een rijtje:

subject

Dit veld maakt het mogelijk om het onderwerp te bepalen van het e-mailtje wat naar u wordt verzonden. Als dit veld niet wordt gegeven wordt standaard het onderwerp 'WWW Form Submission' gebruikt.

email (zichtbaar)

Dit veld maakt het de gebruiker mogelijk een antwoord e-mail adres achter te laten. Als u in staat wilt zijn het e-mailtje te beantwoorden, raden we sterk aan dit veld in uw formulier op te nemen. Dit veld wordt gebruikt voor de From: in het e-mailtje. Als dit veld verplicht moet worden, neem het dan op in het required veld.

realname (zichtbaar)

Dit veld geeft de gebruiker de gelegenheid zijn naam in te vullen. Het veld wordt alleen gebruikt voor identificatie doeleinden en wordt ook gebruikt in de From: header van het e-mailtje.

redirect

Als u een eigen resultaatpagina wilt tonen, kunt u in dit veld de URL van deze pagina opnemen.

missing_fields_redirect

Indien niet alle verplichte velden zijn ingevuld wordt de hier opgegeven pagina getoond. Indien dit veld niet wordt gegeven, wordt er een standaard (engelstalige!) foutpagina getoond.

required

U kunt hier aangeven welke velden minimaal ingevuld dienen te zijn. Plaats hiervoor simpelweg van alle verplichte velden de namen, gescheiden door comma's, in dit veld. Als een verplicht veld niet wordt ingevuld, krijgt de gebruiker een pagina te zien die hem hierop wijst. Zie missing_fields_redirect. Deze pagina bevat tevens een link terug naar het formulier.

sort

Dit veld maakt het mogelijk de volgorde waarin de velden worden opgenomen in het resultaat te bepalen. Idien dit veld niet wordt opgenomen, wordt de volgorde gebruikt waarin de browser de velden aanlevert. Meestal is dit de volgorde waarin ze in het formulier staan.
U kunt de alfabetisch laten sorteren door als waarde 'alphabetic' op te nemen.
U kunt ook een specifieke volgorde aangeven door alle veldennamen, gescheiden door comma's, in de gewenste volgorde op te nemen, voorafgegaan door 'order:'.

print_config

In dit veld kunt u opgeven welke optievelden in het e-mailtje aan u moeten worden opgenomen. Standaard worden optievelden niet mee gestuurd. Dit is omdat de belangrijke velden, zoals email, subject, enz., al in de kop van het bericht staan. Plaats hiervoor simpelweg van alle gewenste optie-velden de namen, gescheiden door comma's, in dit veld.

print_blank_fields

Dit veld zorgt ervoor dat alle (ook de lege!) velden worden vermeld in het resultaat. Standaard is dit veld niet actief, zodat lege velden niet worden getoond.

Resultaatpagina opties

De volgende velden zijn alleen van toepassing indien er geen redirect veld is toegepast. In dat geval maakt dit script een eigen (engelstalige!) resultaatpagina waarop de volgende velden van toepassing zijn:

title

Dit veld bepaalt de titel van de pagina.

return_link_url

In dit veld kunt u een URL opgeven, die klikbaar op de pagina wordt getoond. Zonder dit veld kan de gebruiker niet verder klikken.

return_link_title

Dit veld bevat de tekst waarop geklikt kan worden. De 2 velden samen worden als volgt getoond:
    return_link_title

background

Dit veld bevat de URL van een achtergrondplaatje.

bgcolor

Dit veld bepaalt de achtergrondkleur.

text_color

Dit veld bepaalt de kleur van de tekst.

link_color

Dit veld bepaalt de kleur van de links.

vlink_color

Dit veld bepaalt de kleur van de reeds bezochte links.

alink_color

Dit veld bepaalt de kleur van actieve links.

Iedere ander form-veld dat in het script wordt gebruikt, wordt gemaild en getoond op de resultaatpagina als er geen redirect veld is gegeven. Er is geen limiet aan het aantal form-velden dat door het programma verwerkt kan worden, behalve die van de webserver en de browser.

Tip!

Kijk voor een toepassing van dit script eens naar de bronkode van /helpdesk/askit.html.