editvote

3. Muokattavat elementit

Yksinkertainen äänestys

Systeemi tukee simppeleitä äänestyksiä, joissa käyttäjä
valitsee halutuista vaihtoehdoista ja sitten näkee äänestyksen
tulokset samalla sivulla samassa kohdassa painettuaan nappulaa.

<%editvote(nappulan_teksti, valintojen_lukumäärä, sähköpostiosoite, sähköpostikentän_otsikko, muita_kenttiä_lomakkeelle, kiitosteksti)%>

Äänestyssysteemi toimii niin, että sivulle laitetaan kutsu esim.
<%editvote('Äänestä')%>
jonka kohdalle tulee normaalisti lista vaihtoehdoista ja nappula jossa
on annettu teksti (pikku formina), jos äänestää niin samalle kohdalle
tulee äänestyksen tulokset (niiden muotoa voi vielä hieman viilata).

Jos ollaan logattu sisään, näkyy katseltaessa aina tulokset ja
editoitaessa sitten tulee näkyviin editoitava lista kohteiden nimistä
sekä "reset votes" valinta joka tyhjentää äänilaskurit.

Jos kaikki editoitavat nimet ovat tyhjiä, ei äänestys näy ollenkaan
www-sivulla, eli äänestyksen saa pois tyhjäämällä kaikki nimikentät
editoitaessa.

Kutsulle voi myös antaa max. lukumäärän äänestyksen kohteista
(oletuksena 9), eli kutsuun voi lisätä toisen argumentin:
<%editvote('Äänestä', 20)%>
jos haluttuja kohteita on enemmän.

Äänestyksessä voi olla myös sähköpostitoiminto, jolloin käyttäjältä
kysytään sähköpostiosoitetta ja se (sekä muut lomakkeella mahdollisesti olevat mail -alkuisilla nimillä nimetyt lomakkeen kentät) lähetetään tiedoksi haluttuun paikkaan
äänestyksen yhteydessä, esim. arvontaa tms. varten. Tällöin kutsun muoto on

<%editvote(

'Äänestä',     // Nappulan teksti

9,      // Montako mahdollisuutta max

"aanestys@example.com",      // Sähköosoite minne tiedot lähetetään

"Sähköposti:",     // Sähköpostikentän otsikko lomakkeella

'Nimesi: <input type=text name=mailnimi>',     // lisäyksiä lomakkeen sisältöön html:nä

'Kiitos, tietosi lähetetty'     // Kiitosteksti

)%>

eli editvote(nappulan teksti, montako vaihtoehtoa max, osoite minne
äänestäneiden osoitteet lähetetään, osoitekentän otsikkoteksti).

Sähköpostikenttä tulee joka tapauksessa näkyviin, sen jälkeisissä parametreissa voi olla muita form-kenttiä käyttäjän tarpeiden mukaan. Kun ääni lähetetään, näytetään kiitosteksti ja sähköpostiviestiin kerätään kaikki mailjotain (eli mail-alkuiset) kentät lomakkeelta.

Sähköposteista näkyy milloin on äänestetty, millä sivulla ja mikä
annettu sähköpostiosoite oli. Jos sähköpostit ovat Unixissa, on aika helppo grepillä etsiä sieltä annetut äänet jatkokäsittelyä varten, esim. grep '^foo.com/aanestys.html' $MAIL | ...

Yhdellä www-sivulla voi olla vain yksi äänestys. Äänestyksissä ei ole
mitään rajoitusyrityksiä moninkertaiselle äänestämiselle tms.

Note Tämä toiminto tulee muuttumaan joskus selkeämmäksi.