Harjoitustyössä käytettävä CGI-ohjelma

• Tarvittavat tiedostot
  • conf-tiedosto
• Erityiskentät

WWW-julkaiseminen-kurssilla käytetään vuonna 2007 valmiiksi asennettua ohjelmaa, jonka käyttöohjeet löytyvät osoitteesta:

http://appro.mit.jyu.fi/www/harkka/laheta/

Nämä ohjeet ovat vuonna 2006 aloittaneille harjoitustyön tekijöille.

Tarvitset tunnuksen ja salasanan, jotka ovat näkyvissä Korppi-järjestelmässä kurssin ITKY202 sivulla.

Seuraavassa esitellään vanhanmuotoisessa harjoitustyössä käytettävän CGI-ohjelman toimintaa.

• CGI-ohjelma on tarkoitettu lomakkeen tietojen käsittelemiseen.
• CGI-ohjelma ottaa vastaan lomakkeen tiedot ja välittää ne edelleen .conf-tiedostossa annettuun sähköpostiosoitteeseen.
• Lomakkeen tiedot voidaan myös tallentaa tiedostoon.
• Ohjelmaa ei tarvitse tehdä itse!
• Ohjelmaa ei saa käyttää muissa yhteyksissä kuin WWW-julkaiseminen-kurssin harjoitustyössä.
• Harjoitustyössä saa toki käyttää omia tai muita vapaasti hyödynnettäviä CGI-ohjelmia.

Tarvittavat tiedostot

CGI-ohjelman asentamisesta ja käyttämisestä kerrotaan tarkemmin WWW-julkaiseminen-kurssin demoissa. Tiedostot löytyvät myös yhdestä ladattavasta laheta.zip-paketista.

• laheta.txt - cgi-ohjelma, joka käsittelee ja lähettää WWW-lomakkeelta saadut tiedot sähköpostiin.
• laheta.conf - konfigurointi-tiedosto, jolla ohjataan cgi-ohjelman toimintaa.

CGI-ohjelma ja conf-tiedosto on siirrettävä samaan hakemistoon. laheta.txt:n nimi on muutettava muotoon laheta.cgi (ellei se jo ole) ja sille on annettava suoritusoikeus. laheta.cgi ja laheta.conf on sijoitettava users.jyu.fi-palvelimella oman html-hakemiston alla olevaan cgi-bin-kansioon. Jos tiedot tallennetaan myös tiedostoon niin tiedostoon on oltava kirjoitusoikeus. Lomake voi olla eri hakemistossa.

conf-tiedosto

laheta.conf-tiedostossa määritellään mihin lomakkeen tieto lähetetään ja millainen sivu näytetään lomakkeen lähettämisen jälkeen. conf-tiedoston on oltava samassa hakemistossa laheta.cgi:n kanssa.

• email-elementin sisälle tulee sähköpostiosoite, johon lomakkeen tiedot lähetetään.
• save-elementtiin määritellään tiedostonnimi mihin lomakkeen tiedot tallentuvat
• h1, title ja p-elementteihin voi kirjoittaa tekstiä, jotka tulevat kyseisinä elementteinä lomakkeen käsittelyn jälkeiseen palautesivuun. Vaihtoehtoisesti url-elementteihin sisälle voi määritellä kokonaan oman palautesivun osoitteen.
• css-elementtiin voi määritellä palautesivulla käytettävän css-tiedoston.

Erityiskentät

Seuraavat kentät otetaan ensisijaisesti laheta.conf-tiedostosta, mutta ne voidaan myös määrätä lomakkeella. Lomakekentän, jonka name-ominaisuus on

• nimi, arvo määrää mikä tulee sähköpostin lähettäjän nimeksi (engl. From)
• lahettaja, arvo tulee käsittelijän lähettämän sähköpostin e-mail-osoitteeksi.
• otsikko, arvo määrää mikä on sähköpostiviestin otsikko.