af Andreas Astrup, HTML.dk
Sidst opdateret 16. januar 2001
Denne artikel beskriver, hvordan du let kan sende e-mails fra dit websted med scriptet FormMail og f.eks. lave et kontaktfelt på dit websted.
FormMail er et cgi-script og skal derfor være installeret på din server, for at du kan benytte dig af de muligheder, der beskrives i denne artikel. FormMail er dog standard hos flere udbydere, og følgende af de største udbydere tilbyder brug af FormMail:
Er din udbyder ikke på listen, bør du tjekke supportsider hos din udbyder, før du læser videre.
Ved hosting af webhotel giver mange udbydere mulighed for selv at installere cgi-scripts (FormMail kan downloades på http://worldwidemart.com/scripts/). Igen bør du tjekke supportsiderne hos din udbyder for yderligere oplysninger.
For at benytte FormMail skal du først opsætte en formular i HTML:
<form method="post" action="/cgi-bin/formmail"> <input type="hidden" name="recipient" value="navn@udbyder.dk"> <input type="hidden" name="subject" value="mail fra webstedet"> <input type="text" name="besked" size=20> <input type="submit" value="Send"> </form>
Attributten action i <form> fortæller, hvor FormMail-scriptet er placeret. På din udbyders supportsider finder du den nøjagtige placering på din server. Her er placering hos de tre førnævnte udbydere:
action="/cgi-bin/formmail/FormMail.pl"action="/cgi-bin/FormMail.cgi"action="/cgi-bin/formmail"Din formular kan indeholde et ubegrænset antal felter. Disse kan enten være skjulte <input type="hidden">, hvor du selv bestemmer indholdet. Eller du kan lade den besøgende bestemme indholdet: f.eks. <input type="text">.
Attributten name angiver feltets navn. Det kan enten være en foruddefineret variabel (oplysninger om e-mailen (se listen over foruddefinerede variabler nedenfor)) eller blot et navn du selv vælger (bliver til indhold i e-mailen).
I ovenstående eksempel er de to af felterne foruddefinerede variabler: recipient og subject, der angiver henholdsvis modtageradressen og emnet for e-mailen. Det sidste felt - tekstboksen med navnet besked - vil derimod blive sendt som indhold i e-mailen.
Du kan nu sende e-mails fra dit websted, men FormMail kan meget mere end det simple eksempel vist ovenfor. Her følger en oversigt over de mange foruddefineret variabel i FormMail.
Beskrivelse:
Med dette felt kan du specificere, hvilken adresse e-mailen skal sendes til. Oftest sættes dette felt til at være skjult (hidden) og med din egen e-mail adresse som modtager. Der skal altid være et recipient-felt i din formular.
Syntaks:
<input type="hidden" name="recipient" value="navn@udbyder.dk">
Beskrivelse:
Subject-feltet gør det muligt at angive, hvad der skal stå i emne-linjen på e-mailen. Hvis du ikke indsætter et subjekt-felt vil FormMail give e-mailen et standardemne.
Syntaks:
Hvis du selv vil angive emnet:
<input type="hidden" name="subjekt" value="Post fra webstedet">
Hvis den besøgende skal angive et emne:
<input type="text" name="subject">
Beskrivelse:
Angiver adressen på e-mailen. Hvis du vil have mulighed for at besvare de e-mails, du modtager, er det nødvendigt at medtage dette felt. Sættes dette felt som required (se nedenfor) testes værdien af feltet for om det indeholder en gyldig e-mail adresse, inden FormMail sender e-mailen til dig.
Syntaks:
<input type="text" name="email">
Beskrivelse:
Giver mulighed for indtaste navnet på afsenderen. Værdien af dette felt vil blive vist I afsender-feltet på den e-mail du modtager.
Syntaks:
<input type="text" name="realname">
Beskrivelse:
Feltet bruges til at sende brugen til en ny side efter afsendelse af formularen. Hvis dette felt ikke medtages får brugeren en standardside.
Syntaks:
<input type="hidden" name="redirect" value="http://www.dinside.dk/tak.htm">
Beskrivelse:
Feltet gør det muligt, at kræve at visse felter skal udfyldes, før formularen kan 'submittes'. Hvis de angivne felter ikke er udfyldt, får brugeren en fejlmeddelelse (for specificering af fejlmeddelelsen se missing_fields_redirect)
Syntaks:
Hvis du vil kræve at felterne email og f.eks. telefon skal være udfyldt i din formular, skal dit felt se således ud:
<input type="hidden" name="required" value="email,telefon">
Beskrivelse:
Giver mulighed for at medtage forskellige oplysninger om brugeren ('Environment variables'). Her er de tre mest brugte:
REMOTE_HOST: navnet på brugerens udbyderREMOTE_ADDR: brugerens IP-adresseHTTP_USER_AGENT: brugerens browsertypeFor mere information om 'Enviroment variables' se The CGI Resource Index: Documentation: Environment Variables
Syntaks:
Hvis du f.eks. ønsker at vide brugerens IP-adresse og browsertype, skal feltet se således ud:
<input type="hidden" name="env_report" value="REMOTE_ADDR,HTTP_USER_AGENT">
Beskrivelse:
Giver mulighed for at vælge, hvilken rækkefølge felterne skal vises i e-mailen. Man kan vælge mellem at have felterne sorteret alfabetisk eller specificere rækkefølgende for hvert enkelt felt. Udlades dette felt, vil felterne normalt vises i den rækkefølge, de er indsat i formularen.
Syntaks:
For alfabetisk sortering:
<input type="hidden" name="sort" value="alphabetic">
For specificering af de enkelte felter:
<input type="hidden" name="sort" value="order:felt1,felt2,osv...">
Beskrivelse:
Med dette felt kan man vælge at få de foruddefinerede variabler skrevet ind i e-mailen. Det drejer som om felter som recipient og subject, som normalt ikke medtages i selve e-mailen.
Syntaks:
Hvis du f.eks. ønsker recipient og subject medtaget, skal feltet ses således ud:
<input type="hidden" name="print_config" value="recipient,subject">
Beskrivelse:
Når sat til værdien "1" listes alle felter på den standardside, man sendes til, efter formularen er afsendt. Normalt vises de tomme felter ikke på denne side.
Syntaks:
<input type="hidden" name="print_blank_fields" value="1">
Beskrivelse:
Bruges til at angive titlen og overskriften på den standardside, man sendes til, efter formularenen er afsendt.
Syntaks:
Hvis titlen og overskriften f.eks. skal være "De indtastede oplysninger":
<input type="hidden" name="title" value="De indtastede oplysninger">
Beskrivelse:
Giver mulighed for angive den URL, der skal bruges som return_link_title (link tilbage til f.eks. forsiden) på den standardside, der vises, når formularen er afsendt.
Syntaks:
<input type="hidden" name="return_link_url" value="http://www.dinside.dk/index.htm">
Beskrivelse:
Bruges til at angive et stykke tekst, der skal være link til den siden du angav med return_link-url.
Syntaks:
<input type="hidden" name="return_link_title" value="Tilbage til forsiden">
Beskrivelse:
Dette felt bruges til at angive en URL, brugerne ledes hen til, hvis de angivne felter i required-feltet ikke er udfyldt. På den måde kan man lave sin egen fejlside i stedet for standardsiden.
Syntaks:
<input type="hidden" name="missing_fields_redirect" value="http://www.dinside.dk/fejl.htm">
Beskrivelse:
Bruges til at angive et baggrundsbillede på den standardside, man sendes til, efter formularenen er afsendt.
Syntaks:
<input type="hidden" name="background" value="http://www.dinside.dk/billede.gif">
Beskrivelse:
Bruges til at angive en baggrundsfarve på den standardside, man sendes til, efter formularen er afsendt.
Syntaks:
<input type="hidden" name="bgcolor" value="#FFFFFF">
Beskrivelse:
Bruges til at angive en tekstfarven på den standardside, man sendes til, efter formularen er afsendt.
Syntaks:
<input type="hidden" name="text_color" value="#000000">
Beskrivelse:
Bruges til at angive farven på links på den standardside, man sendes til efter formularen er afsendt.
Syntaks:
<input type="hidden" name="link_color" value="#FF0000">
Beskrivelse:
Bruges til at angive farven på besøgte links på den standardside, man sendes til, efter formularen er afsendt.
Syntaks:
<input type="hidden" name="vlink_color" value="#0000FF">
Beskrivelse:
Bruges til at angive farven på aktive links på den standardside, man sendes til, efter formularen er afsendt.
Syntaks:
<input type="hidden" name="alink_color" value="#0000FF">
Alle andre felter end ovenstående vil blive sendt som indhold i e-mailen. Det er ingen begrænsninger på, hvor mange felter formularen kan indholde.
