PK5 Note: This is the Finnish 'documentation' produced by the Computer Center for the "Mailaa" cgi script that 'mails' the web feedback form. It is reproduced as a PK5 reference file to enable easier student access. This file should be used together with the Sample Web Feedback Form. The Sample Form also illustrates the "checkbox" command, which is not mentioned in the Computer Center documentation.

Mailaa on cgi-ohjelma, jota voit käyttää lomakkeidesi käsittelijänä. Huom! Tässä ohjeessa oletetaan että osaat jo tehdä HTML-lomakkeita ja tunnet niissä käytettävät komennot. Huomaa myös, että tämä ohjelma on tehty Tampereen yliopiston käyttöön. Jos haluat käyttää ohjelmaa muualla, kopioi skripti ja muokkaa se omaan palvelimeesi sopivaksi!

Kirjoita lomakkeeseesi seuraavat komennot:

<form method=POST action="http://www.uta.fi/cgi-bin/mailaa?osoite">
...lomake...
</form>

Kirjoita tekstin osoite paikalle sähköpostiosoite, johon haluat lomakkeelta syötetyt tiedot lähetettäväksi. Sähköpostiosoite voi olla tavallinen sähköpostiosoite, ja niitä voi olla myös monta. Esimerkkejä:

action="http://www.uta.fi/cgi-bin/mailaa?osoite@uta.fi"
action="http://www.uta.fi/cgi-bin/mailaa?postituslista@uta.fi,ab12345@uta.fi"

Lomakkeen sisällä voit antaa käyttäjän syötettäviksi tekstikenttiä, joihin hän voi syöttää oman sähköpostiosoitteensa ja nimensä. Laita sähköpostiosoitteen sisältävän tekstikentän nimeksi (name) "X-From" ja lähettäjän nimen sisältävän tekstikentän nimeksi "X-Realname".

Esim:

Your email address: <input type=text name="X-From">
Your name: <input type=text name="X-Realname">

Näihin kenttiin annetut tiedot tulevat näkyviin sähköpostissa lähettäjän paikalla. Jos käyttäjä ei anna näitä tietoja, tai lomakkeessa ei ole niille kenttiä, lähettäjän osoitteena näkyy "nobody" ja nimenä "Anonymous WWW user" (tällaisiin viesteihin lähetetyt vastaukset menevät bittien taivaaseen, eli katoavat).

Voit myös antaa tekstilaatikon "X-Subject" johon käyttäjä voi kirjoittaa otsikon lähetettävälle sähköpostille. Se tulee näkyviin aivan kuin sähköpostin otsikot yleensä. Jos tämä jätetään tyhjäksi, otsikkona on "WWW-lomake".

Lisäksi voit asettaa "X-Noinfo":lle arvon "yes", jos haluat että sinulle tulevassa sähköpostiviestissä tulee vain itse viestit, ei mitään informaatiota esim. siitä, miltä koneelta viesti on lähetetty. Tämän voit tehdä seuraavanlaisella rivillä:

<input type=hidden name="X-Noinfo" value="yes">

Kun käyttäjä on täyttänyt lomakkeen ja painanut lähetyspainiketta, hän saa näytölleen kiitosviestin. Jos haluat tarjota tilalle oman viestisi, voit sijoittaa lomakkeeseesi piilotetun kentän jossa annat oman kiitosviestisi osoitteen. Tämä annetaan kentässä jonka nimi (name) on "X-ThanksURL". Kentän arvona (value) annetaan osoite jonka haluat tulevan käyttäjälle sen jälkeen kun hän on täyttänyt lomakkeen. Kentän tyypiksi kannattaa laittaa "hidden", jolloin lomakkeen täyttäjä ei näe osoitetta. Esimerkiksi näin:

<input type=hidden name="X-ThanksURL" value="http://www.uta.fi/~osoite/thanks.html">

Itse ohjelma on tehty perlillä ja sitä voi kopioida kunhan sen copyright-tietoja ei muuteta.

Alla esimerkki lomakkeesta, joka käyttää tätä uutta ohjelmaa. Huom: Tästä lomakkeelta lähtevä posti ei mene oikeasti minnekään.

Mitä pidit ohjeista?

Nimesi:

Sähköpostiosoitteesi:

Paina lopuksi Submit-painiketta niin viestisi lähtee eteenpäin. Painalluksen jälkeen pääset yliopiston etusivulle.

Ja tässä käytetty HTML-koodi:

  <form method=POST action="http://www.uta.fi/cgi-bin/mailaa?nobody@uta.fi">
  <p>Mitä pidit ohjeista?
  <br>
  <textarea name="Kommentit" rows=4 cols=40></textarea>
  <p><b>Nimesi: </b><br><input type=text name="X-Realname">
  <br><b>Sähköpostiosoitteesi: </b><br><input type=text name="X-From">

  <p>Paina lopuksi Submit-painiketta niin viestisi lähtee eteenpäin. Painalluksen 
  jälkeen pääset yliopiston etusivulle

  <input type=hidden name="X-Subject" value="Palautetta mailaa-dokumentista">
  <input type=hidden name="X-ThanksURL" value="http://www.uta.fi/">

  <p><input type=submit>
  </form>