Formuláre

Čo to je

Formuláre do MoinMoin dorobil v rámci bakalárskej práce študent FEI STU Peter Bódi. Sú implementované ako sústava špeciálnych makier a akcií, ktoré umožňujú autorom wiki stránok (teda aj Vám) umiestniť na stránku formulár, ktorý slúži na zber údajov.

Na čo je to dobré

Typické aplikácie v našich podmienkach sú zrejme:

• zbieranie vypracovaných zadaní od študentov
• registrácia na konferenciu.

Pôvodný zdroj

Pôvodná dokumentácia a aj zdrojové kódy sú na týchto stránkach

• http://moinmo.in/ActionMarket/FormSubmit

• http://moinmo.in/MacroMarket/FormCreate

Príklad

Toto je formulár, ktorý umožní zbierať komentáre od návštevníkov tejto stránky.

<<FormHeader(submitcsv,targetfile=komentare.csv>>

Ako sa to používa

Dokumentácia je pomerne strohá, preto sa tu pokúsim vysvetliť, o čo ide.

Ak chceme zbierať dáta nejakým formulárom musia nám byť dopredu jasné dve veci.

1. Aké dáta chceme zbierať.
2. Čo s nimi po zaslaní robiť.

Najprv sa venujme druhému bodu.

Čo s dátami po zaslaní

Bódiho systém umožňuje urobiť s dátami dve veci (aj obe naraz).

1. Poslať ich v e-maile na nejakú adresu.

2. Uložiť ich do súboru typu CSV, ktorý je v prílohe nejakej stránky.

FormHeader

Na určenie toho, čo s dátami po zaslaní, slúži makro FormHeader.

Akcia submitemail

Ak chceme obsah formulára posielať na adresu konferencia@math.sk, uvedieme takéto parametre

<<FormHeader(submitemail,targetemail=konferencia@math.sk>>

Akcia submitcsv

Ak cheme, aby sa dáta ukladali do súboru data.csv priloženého k tej stránke, na ktorej je formulár, uvedieme takéto parametre

<<FormHeader(submitcsv,targetfile=data.csv>>

To však znamená, že obsah súboru data.csv si môžu všetci záujemci prečítať, čo nie je vždy žiadúce.

Ak chceme, aby sa dáta ukladali do súboru data.csv priloženého k stránke !SecretData,uvedieme takéto parametre.

<<FormHeader(submitcsv,targetfile=data.csv,targetpage=SecretPage>>

SecretPage potom nastavíme ako internú stránku.

Akcia submitattachment

Ak chceme od užívateľov abu nám nielen vyplnili formulár, ale aj zaslali nejaké súbory (vypracované zadania, abstrakty na konferenciu), musíme použiť akciu submitattachment.

Toto

<<FormHeader(submitcsv,targetfile=data.csv,submitattachment)>>

zabezpečí, že sa zaslané súbory uložia ako prílohy na stránku, na ktorej je formulár. Ostatné položky formulára sa uložia do prílohy data.csv.

Je možné aj v tomto prípade uviesť targetpage=SecretPage, dáta potom pôjdu tam.