1556
Comment:
|
3169
|
Deletions are marked like this. | Additions are marked like this. |
Line 24: | Line 24: |
== 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>> || Meno: || <<FormText(Meno,maxlength=20)>> || || Priezvisko: || <<FormText(Priezvisko,maxlength=30)>> || || Komentár: || <<FormTextarea(Komentar,rows=10,cols=20)>> || <<FormSubmit(Zaslať)>> <<FormFooter()>> |
|
Line 41: | Line 52: |
==== FormHeader ==== |
|
Line 42: | Line 55: |
==== Akcia submitemail ==== |
|
Line 47: | Line 62: |
==== 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 [[InterneStranky|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. |
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
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>>
Meno: |
|
Priezvisko: |
|
Komentár: |
|
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.
- Aké dáta chceme zbierať.
- Č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).
- Poslať ich v e-maile na nejakú adresu.
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.