Για να χρησιμοποιήσετε το
προεγκατεστημένο πρόγραμμα Formmail για την λειτουργία των φορμών επικοινωνίας
,αρκεί να δημιουργήσετε μια φόρμα με οποιοδήποτε πρόγραμμα σχεδίασης
ιστοσελίδων .
H γραμμή εντολής της φόρμας
πρέπει να είναι :
<FORM ACTION = "/cgi-bin/FormMail.pl"
METHOD = "POST">
Το formmail.pl θα κάνει
όλη την υπόλοιπη δουλειά .
Μπορείτε να καθορίσετε την συμπεριφορά του Formmail χρησιμοποιώντας
κρυμμένα πεδία (hidden fields) στην φόρμα σας .
Υπάρχει δύο υποχρεωτικά
πεδία που πρέπει να έχετε στην φόρμα σας για να δουλεύει σωστά το
Formmail . Αυτά είναι το recipient και το from (πεδίο) .
Παρακάτω αναφέρονται τα
διάφορα πεδία ρύθμισης.
Ρύθμιση Φόρμας:
ΑΠΑΡΑΙΤΗΤΑ ΠΕΔΙΑ ΦΟΡΜΑΣ
======================
ΠΕΔΙΟ : recipient
ΠΕΡΙΓΡΑΦΗ : Αυτό το πεδίο φόρμας σας επιτρέπει να ορίσετε σε ποιόν θα
θέλατε να ταχυδρομούνται (αποστολή email)τα αποτελέσματα της φόρμας
.Ορίστε αυτή την επιλογή σαν ένα κρυμμένο ( hidden ) πεδίο φόρμας βάζοντας
την email address σας .
Συνταξη: <input type=hidden
name="recipient" value="email@your.host.com">
====================
ΠΕΔΙΟ : subject
ΠΕΡΙΓΡΑΦΗ : Αυτό το πεδίο φόρμας σας επιτρέπει να ορίσετε το θέμα που
θα θέλατε να εμφανίζεται στα email που σας στέλνουν αφού αυτή η φόρμα
έχει συμπληρωθεί . Αν δεν έχετε αυτή την επιλογή ενεργή , τότε το script
θα στείλει email με το προκαθορισμένο Τίτλο θέματος : WWW Form Submission
.
ΣΥΝΤΑΞΗ :
Αν θέλετε να επιλέξετε ποιο θα είναι το θέμα :
<input type=hidden name="subject" value="Your Subject">
Για να επιτρέψετε στον χρήστη να επιλέξει ένα θέμα :
<input type=text name="subject">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : from (email)
ΠΕΡΙΓΡΑΦΗ : Αυτό το πεδίο φόρμας καθορίζει την e-mail adress του χρήστη
που συμπληρωνει την φόρμα. Αν θέλετε να έχετε την δυνατότητα να απαντάτε
τα e-mail απο τον πελάτη σας , θα πρέπει οπωσδήποτε να συμπεριλάβετε
αυτό το πεδίο φόρμας και να τους υποχρεώνετε να το συμπληρώνουν . Πρέπει
λοιπόν να ορίσετε αυτό το πεδίο σαν required (υποχρεωτικό) με e-mail
address valid syntax.
ΣΥΝΤΑΞΗ :
<input type=text
size=60 name="from" value="">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : realname
ΠΕΡΙΓΡΑΦΗ : Το πεδίο φόρμας realname θα επιτρέψει στον χρήστη να συμπληρώσει
το δικό του πραγματικό όνομα . Αυτό το πεδίο είναι χρήσιμο για αναγνώριση
στοιχείων του χρήστη, και θα πρέπει επίσης να συμπληρωθεί μέσα στην
Φόρμα
ΣΥΝΤΑΞΗ : <input type=text name="realname">
-----------------------------------------------------------------------------
Προαιρετικά πεδία φόρμας:
ΠΕΔΙΟ : redirect
ΠΕΡΙΓΡΑΦΗ : Αν θέλετε να κάνετε προώθηση (redirect) του χρήστη σε ένα
διαφορετικό URL μετά την συμπήρωση της φόρμας, μπορείτε να χρησιμοποιήσετε
αυτό το κρυμμένο πεδίο για να τον στέλνετε σε μια προκατασκευασμένη
HTML σελίδα .
ΣΥΝΤΑΞΗ :
Για να καθορίσετε εσείς το URL που θα προωθηθεί ο χρήστης αφού συμπληρώσει
την φόρμα :
<input type=hidden name="redirect" value="http://your.address/to/file.html">
Για να επιτραπεί στον χρήστη να καθορίσει ο ίδιος redirect URL όταν
η φόρμα συμπληρώνεται :
<input type=text name="redirect">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : required
ΠΕΡΙΓΡΑΦΗ : Μπορείτε τώρα
να ζητήσετε συγκεκριμένα πεδία μέσα στην φόρμα σας να συμπληρωθούν πριν
ο χρήστης υποβάλλει επιτυχώς τη φόρμα . Απλώς τοποθετήστε όλα τα ονόματα
πεδίων που θέλετε μέσα σε αυτήν τη φόρμα . Αν τα ζητούμενα πεδία δεν
συμπληρωθούν , ο χρήστης θα ενημερωθεί για το ποια θα πρέπει να συμπληρωθούν
, και ένα link πίσω στην φόρμα την οποία μόλις συμπλήρωσε, θα εμφανιστεί
.
ΣΥΝΤΑΞΗ :
Για παράδειγμα αν θέλετε να ζητήσετε από τον χρήστη να συμπληρώσει τα
πεδία για το e-mail και το τηλέφωνο μέσα στην φόρμα σας , έτσι
ώστε να μπορείτε να τους βρείτε αφού έχετε λάβει το e-mail , χρησιμοποιήστε
σύνταξη :
<input type=hidden name="required" value="from,phone">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : env_report
ΠΕΡΙΓΡΑΦΗ : Σας επιτρέπει να συμπεριλάβετε πληροφορίες στο μήνυμα που
λαμβάνετε αφού ο χρήστης έχει συμπληρώσει την φόρμα σας . Χρήσιμο αν
θέλετε να ξέρετε τι browser χρησιμοποιούν , από ποιο domain προέρχονται
ή ότι άλλα στοιχεία σχετίζονται με μεταβαλλόμενες συνθήκες που υπάρχουν κάθε
φορά που συμπληρώνεται η φόρμα σας από κάποιο χρήστη (ip address,brownser
κ.α.).
Τα παρακάτω είναι μια μικρή λίστα με πληροφορίες που μπορεί να φανούν
χρήσιμες :
REMOTE_HOST – Στέλνει το hostname αυτού που κάνει την αίτηση .
REMOTE_ADDR - Στέλνει την IP address of the remote host αυτού που κάνει
την αίτηση .
HTTP_USER_AGENT – O browser που ο πελάτης χρησιμοποιεί για να στείλει
την αίτηση .
Υπάρχουν και άλλα, αλλά
αυτά είναι λίγα από τα πιο χρήσιμα. Για περισσότερες πληροφορίες σχετικά
, επισκευτείτε: http://www.cgi-resources.com/Documentation/Environment_Variables/
ΣΥΝΤΑΞΗ :
Για παράδειγμα αν θέλετε να μάθετε το remote host και τον browser που
στέλνει την αίτηση , θα βάλετε τα ακόλουθα μέσα στην φόρμα σας .
<input type=hidden name="env_report" value="REMOTE_HOST,HTTP_USER_AGENT">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : sort (κατάταξη)
ΠΕΡΙΓΡΑΦΗ : Το πεδίο αυτό σας επιτρέπει να επιλέξετε την σειρά με την
οποία θέλετε τα αποτελέσματα να εμφανίζονται στο e-mail που δημιουργεί
το Formmail . Μπορείτε να επιλέξετε το πεδίο να κατατάσσεται αλφαβητικά
ή να καθορίσετε εσείς την σειρά με την οποία θέλετε το πεδία να εμφανίζονται.
Αφήνοντας αυτό το πεδίο κενό , η σειρά θα είναι απλώς σύμφωνα με την
σειρά με την οποία οι browsers στέλνουν τις πληροφορίες στο script (
η οποία δεν είναι πάντα ακριβώς η ίδια σειρά με την οποία εμφανίζονται
στην φόρμα ) . Όταν κατατάσσονται με καθορισμένη σειρά , πρέπει να συμπεριλαμβάνετε
την λέξη ¨order:¨ σαν πρώτο μέρος της τιμής και μετά από αυτό ακολουθούν
τα ονόματα που θέλετε να κατατάσσονται στο μήνυμα , ξεχωρίζοντάς τα
με κόμμα .
ΣΥΝΤΑΞΗ :
Για κατάταξη αλφαβητικά : <input type=hidden name="sort"
value="alphabetic">
Για κατάταξη με set εντολών πεδίου : <input type=hidden name="sort"
value="order:name1,name2,etc...">
-----------------------------------------------------------------------------
ΠΕΔΙΟ: print_config
ΠΕΡΙΓΡΑΦΗ: Το print_config
επιτρέπει να επιλέξετε ποιο από τα config πεδίa επιθυμείτε να τυπώνονται
στο e-mail μήνυμα σας. Από το προκαθορισμένο κανένα config πεδίο δεν
τυπώνεται στο email. Kαι αυτό γιατί , κύρια πεδία όπως π.χ. email, subject,
κ.α.. εμπερικλείονται στο επάνω μέρος του μηνύματος. Ωστόσο μερικοί
χρήστες έχουν ζητήσει μιά τέτοια επιλογή ,έτσι ώστε να μπορούν
να τα έχουν τυπωμένα (εμφανισμένα) στο κύριο μέρος του μηνύματος.Τα
config πεδία που θέλετε να εμφανίζονται θα πρέπει να είναι στο value
του input χωρισμένα με κόμμα.
ΣΥΝΤΑΞΗ:
Εάν επιθυμείτε να εμφανίζονται
το Email και το Θέμα (from και subject πεδία) στο κύριο μέρος του μηνύματος,
θα βάλετε τα ακόλουθα μέσα στην φόρμα σας: <input
type=hidden name="print_config" value="from,subject">
-----------------------------------------------------------------------------
ΠΕΔΙΟ: print_blank_fields
ΠΕΡΙΓΡΑΦΗ: Το print_blank_fields
πεδίο επιτρέπει να μπορούν να τυπώνονται (εμφανίζονται) όλα τα πεδία
της φόρμας που υπάρχουν στην προηγούμενη HTML, ανεξάρτητα εάν συμπληρώθηκαν
ή όχι. Στην προκαθορισμένη ρύθμιση του FormMail αυτό είναι απενεργοποιημένο,
έτσι ώστε να μην αποστέλλονται τα μη χρησιμοποιημένα πεδία.
ΣΥΝΤΑΞΗ: Εάν θέλετε να τυπωθούν
όλα τα κενά πεδία:
<input type=hidden name="print_blank_fields"
value="1">
----------------------------------------------------------------------------
ΠΕΔΙΟ : title
ΠΕΡΙΓΡΑΦΗ : Αυτό το πεδίο φόρμας σας επιτρέπει να ορίσετε τον τίτλο
και την επικεφαλίδα που θα εμφανίζεται στην σελίδα αποτελεσμάτων αν
δεν έχετε ορίσει ένα redirect URL .
ΣΥΝΤΑΞΗ : Αν θέλατε ένα τίτλο ¨Feedback Form Results¨ :
<input type=hidden name="title" value="Feedback Form
Results">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : return_link_url
ΠΕΡΙΓΡΑΦΗ : Αυτό το πεδίο φόρμας σας επιτρέπει να ορίσετε ένα URL που
θα εμφανίζετε σαν return_link_url , στην ακόλουθη σελίδα αναφοράς .
Αυτό το πεδίο δεν θα χρησιμοποιείται αν έχετε ρυθμίσει το πεδίο redirect
,είναι χρήσιμο αν επιτρέπετε στον χρήστη να λαμβάνει την αναφορά (report)
στην ακόλουθη σελίδα αλλά θέλετε να του προσφέρετε και ένα τρόπο να
γυρίζει πίσω στην αρχική σας σελίδα.
ΣΥΝΤΑΞΗ :
<input type=hidden name="return_link_url" value="http://your.host.xxx/main.html">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : return_link_title
ΠΕΡΙΓΡΑΦΗ : Αυτός είναι ο τίτλος που θα χρησιμοποιείται για να συνδέσει
το χρήστη πίσω στην σελίδα που ορίσατε με το return_link_url . Δυο πεδία
θα φαίνονται στην σελίδα με την φόρμα αποτελεσμάτων ως : : <ul>
<li><a href="return_link_url">return_link_title</a>
</ul>
ΣΥΝΤΑΞΗ :
<input type=hidden name="return_link_title" value="Back
to Main Page">
-----------------------------------------------------------------------------
ΠΕΔΙΟ: missing_fields_redirect
ΠΕΡΙΓΡΑΦΗ: Αυτό το πεδίο
σας επιτρέπει να προσδιορίσετε ένα URL στο οποίο οι χρήστες θα στέλνονται
αυτόματα όταν δεν έχουν συμπληρώσει κάποια υποχρεωτικά πεδία που υπάρχουν
στη φόρμα σας.Αυτό σημαίνει ότι μπορείται να δημιουργήσετε μία σελίδα
(error page) που θα τους ενημερώνει για το λάθος.
Syntax:
<input type=hidden name="missing_fields_redirect"
value="http://your.host.com/error.html">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : background
ΠΕΡΙΓΡΑΦΗ : Αυτό το πεδίο σας επιτρέπει να ορίσετε μια εικόνα background
που θα εμφανίζεται αν δεν έχετε ρυθμίσει το πεδίο redirect . Αυτή η
εικόνα θα εμφανίζεται σαν background στην σελίδα με την φόρμα αποτελεσμάτων
.
ΣΥΝΤΑΞΗ :
<input type=hidden name="background" value="http://your.host.xxx/image.gif">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : bgcolor
ΠΕΡΙΓΡΑΦΗ : Αυτό το πεδίο σας επιτρέπει να ορίσετε ένα bgcolor ( χρώμα
background ) στην σελίδα με την φόρμα αποτελεσμάτων κατά τον ίδιο τρόπο
που ορίσατε την εικόνα background . Αυτό το πεδίο δεν πρέπει να ρυθμιστεί
αν το πεδίο redirect είναι ρυθμισμένο .
ΣΥΝΤΑΞΗ :
Για χρώμα background , π.χ. Λευκό : <input type=hidden name="bgcolor"
value="#FFFFFF">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : text_color
ΠΕΡΙΓΡΑΦΗ : Αυτό το πεδίο λειτουργεί με τον ίδιο τρόπο όπως το bgcolor
, εκτός του ότι θα αλλάξει το χρώμα του κειμένου σας .
ΣΥΝΤΑΞΗ :
Για χρώμα κειμένου , Μαύρο : <input type=hidden name="text_color"
value="#000000">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : link_color
ΠΕΡΙΓΡΑΦΗ : Αλλάζει το χρώμα των links στη σελίδα αποτελεσμάτων . Λειτουργεί
με τον ίδιο τρόπο όπως το text_color . Δεν πρέπει να ρυθμιστεί εαν το
πεδίο redirect είναι ρυθμισμένο.
ΣΥΝΤΑΞΗ :
Για ένα link με χρώμα Κόκκινο :<input type=hidden name="link_color"
value="#FF0000">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : vlink_color
ΠΕΡΙΓΡΑΦΗ : Αλλάζει το χρώμα των links που έχετε επισκεφθεί στην σελίδα
αποτελεσμάτων . Λειτουργεί το ίδιο ακριβώς όπως το link_color . Δεν
πρέπει να ρυθμιστεί αν το πεδίο redirect είναι ρυθμισμένο .
ΣΥΝΤΑΞΗ :
Για ένα link που έχετε επισκεφθεί με χρώμα Μπλε : <input type=hidden
name="vlink_color" value="#0000FF">
-----------------------------------------------------------------------------
ΠΕΔΙΟ : alink_color
ΠΕΡΙΓΡΑΦΗ : Αλλάζει το χρώμα των ενεργών links στην σελίδα αποτελεσμάτων
. Λειτουργεί το ίδιο ακριβώς όπως το link_color . Δεν πρέπει να ρυθμιστεί
αν το πεδίο redirect είναι ρυθμισμένο .
ΣΥΝΤΑΞΗ :
Για ένα link που έχετε επισκεφθεί με χρώμα Μπλε :<input type=hidden
name="alink_color" value="#0000FF">
-----------------------------------------------------------------------------
Oποιαδήποτε άλλα πεδία φόρμας
τα οποία υπάρχουν στη φόρμα σας θα ταχυδρομηθούν σε εσάς και θα εμφανίζονται
στην σελίδα αποτελεσμάτων, εάν δεν έχετε ρυθμίσει το κρυμμένο πεδίο
redirect . Δεν υπάρχει όριο στο πόσα πεδία μπορείτε να χρησιμοποιήσετε
στην φόρμα σας, εκτός απο κάποια όρια που μπορεί να προκύπτουν από τους
browsers και τον server σας.