WebToDate/Ankety/O produktu: Porovnání verzí
| (Není zobrazena jedna mezilehlá verze od stejného uživatele.) | |||
| Řádek 33: | Řádek 33: | ||
== Co modul umožňuje == | == Co modul umožňuje == | ||
=== Práce s anketami === | |||
Anketa nabízející hlasování se může zobrazovat na těchto typech stránek: | Anketa nabízející hlasování se může zobrazovat na těchto typech stránek: | ||
| Řádek 56: | Řádek 57: | ||
Modul umožňuje definovat více souborů grafických nastavení (tzv. ''Předpisů''), pro každou anketu zvlášť se pak volí z nabídky připravených předpisů. Díky tomu lze na jedné webové prezentaci používat více způsobů zobrazení anket a kombinovat ankety svázané se zprávou s anketami samostatnými, které se umísťují na kterékoliv stránce prezentace. | Modul umožňuje definovat více souborů grafických nastavení (tzv. ''Předpisů''), pro každou anketu zvlášť se pak volí z nabídky připravených předpisů. Díky tomu lze na jedné webové prezentaci používat více způsobů zobrazení anket a kombinovat ankety svázané se zprávou s anketami samostatnými, které se umísťují na kterékoliv stránce prezentace. | ||
=== Možnosti hodnocení článků === | |||
Ve stavu před hodnocením lze zobrazit: | |||
* Prvek pro hodnocení, kde uživatel volí známku | |||
* Počet hodnocení pro daný článek | |||
* Průměrné hodnocení článku | |||
Pro prvek pro hodnocení lze nastavit bodovou stupnici, např. 1-5, 1-10 apod. Každé známce lze přiřadit textový popisek (5=vynikající, 4=dobrý apod.). | |||
Ve stavu po hodnocení lze zobrazit: | |||
* Hodnocení uživatele graficky i jako číslo | |||
* Počet hodnocení pro daný článek | |||
* Průměrné hodnocení článku | |||
Modul samotný řeší pouze zobrazování textových informací a hodnotící prvek jako formulář typicky s radiopřepínači reprezentujícími známky. Pro grafické zobrazení a ovládání (typicky se zobrazuje jako hvězdičky či podobné ikony) se použijí v implementaci javascripty, vhodné je např. použít [http://jquery.com/ jQuery] a [http://orkans-tmp.22web.net/star_rating/ plugin Star Rating] pro [http://jqueryui.com/ jQuery UI]. Vždy je v takovém případě při implementaci nutné připravit a testovat podobu se zapnutým a vypnutým javascriptem. | |||
Rozpoznávání toho, zda uživatel již článek hodnotil, se provádí pomocí standardního cookie s identifikací uživatele, na serveru se uchovává tabulka, ve které je zapsán identifikátor uživatele a ID zprávy, která bylo hodnocena. Tabulku lze pomocí plánované úlohy promazávat tak, aby se nehromadila stará data. | |||
Globálně lze nastavit stáří zpráv, které lze hodnotit a volitelně tak omezit přidávání nových hodnocení ke zprávám starším než x dní. | |||
V administračním rozhraní lze vypisovat přehledy hodnocení článků podobně, jako pracuje funkce [[../../Referenční/Statistiky shlédnutí|Statistika]] ve WebToDate pro čtenost. Lze vypisovat přehledy nejlépe hodnocených článků, hodnocení po dnech a hodnocení zvoleného článku. | |||
Jsou podporovány instalace s více jazyky tak, aby se prvek pro hodnocení zobrazoval ve zprávách v různých jazycích s odpovídajícími texty. | |||
Je možné provozovat na jedné instalaci více typů hodnocení v tom smyslu, že část serveru používá hodnocení v určité grafice a s nějakým počtem možností (známek) a jiná část (např. jiný virt. serveru) používá jinou grafiku s možným jiným počtem známek. Naopak není podporováno: | |||
* Více typů hodnocení pro jednu zprávu (např. separátní hodnocení důvěryhodnosti, objektivity apod.) | |||
* Možnost zrušit hlas uživatele – uživatel, který použil hodnocení u dané zprávy, jej již nemůže odvolat | |||
== Co je nového == | == Co je nového == | ||
=== Verze 4.2.9.0 modulu === | |||
Do modulu je přidána podpora implementace hodnocení článků neboli známek, kterými mohou čtenáři jednotlivé zprávy hodnotit. | |||
=== Verze 4.0.1.6 modulu === | === Verze 4.0.1.6 modulu === | ||
Aktuální verze z 12. 6. 2012, 11:15
Základní vlastnosti modulu
Ankety
Tento modul je určen k vytváření a správě standardních webových hlasovacích anket, kdy se vybírá jedna odpověď z několika předdefinovaných možností. Hlasovací ankety se umísťují na veřejně přístupné stránky webové prezentace a umožňují hlasovat všem anonymním návštěvníkům. Příklady zobrazení takovýchto anket jsou na následujících otiscích obrazovky z některých implementací WebToDate.
- Příklady zobrazení formuláře s anketou
Modul samozřejmě uchovává shromážděná data – výsledky hlasování, podporuje pak např. výpisy starších anket, jak je znázorněno na následujícím otisku obrazovky.

Základní možnosti jsou následující:
- Lze vytvářet libovolné množství anket, na jednom serveru může být zároveň prezentováno více různých anket.
- Anketa je vždy tvořena otázkou a výběrem z několika připravených odpovědí, uživatel musí při hlasování zvolit právě jednu odpověď.
- Formátování (grafické zobrazení) anket je volně definovatelné, formátuje se definovaným WebToDate stylem. Lze implementovat anketu jako formulář (s radiopřepínači) nebo hlasování přímo klepnutím na odpověď.
- Je implementován aparát využívající cookies, který jednak brání stejnému uživateli hlasovat vícekrát, a dále na základě rozpoznávání toho, zda uživatel již hlasoval, může zobrazovat jiný tvar ankety (např. již bez aktivních prvků pro hlasování)
- Daná anketa může být svázána s konkrétní WebToDate zprávou, nebo může jít o obecnou anketu použitelnou kdekoliv na www prezentaci.
- Položky anket mohou mít řadu dalších údajů, např. příznak, zda je anketa aktivní (na neaktivní anketu již nelze hlasovat), mohou být opatřeny komentářem (který se např. zobrazuje ve výpisu starších anket) apod.
Hodnocení
Modul rovněž podporuje hodnocení článků v rámci veřejné části webové prezentace. Jedná se o známkování článků formou výběru jedné z několika známek, prvek pro hodnocení článku se zobrazuje v každé stránce se zprávou (detailu zprávy), jejíž předloha tento prvek obsahuje.

Uživatel hodnotí výběrem známky – čísla, čím vyšší číslo, tím lepší hodnocení. Rozeznává se stav před hodnocením (uživatel zobrazující stránku ještě danou zprávu nehodnotil) a po hodnocení (uživatel již článek hodnotil).
Co modul umožňuje
Práce s anketami
Anketa nabízející hlasování se může zobrazovat na těchto typech stránek:
- Ve stránce s celým textem zprávy (stránka zobrazovaná pomocí skriptu /scripts/detail.php)
- V samostatné hlasovací stránce (stránka /scripts/modules/vote/vote.php)
- Na kterékoliv jiné stránce generované pomocí WebToDate
První dva případy jsou specifické v tom, že se jedná o dynamické zobrazení, tj. zobrazení celé ankety se sestavuje ve chvíli požadavku na zobrazení stránky. Zde může anketa rozlišit stav – zda již uživatel na tuto anketu hlasoval nebo ještě ne. Tomu odpovídají v nastavení modulu WebToDate styly – jeden styl pro zobrazení Před hlasováním a druhý Po hlasování. Pomocí těchto dvou stylů lze tyto stavy rozlišit graficky – styl Před hlasováním by měl nabízet možnost klepnutí na odpověď, styl Po hlasování pouze prezentovat aktuální výsledky hlasování. Sledování hlasování je ovšem nezávislé na těchto grafických stylech – i když bude styl Po hlasování nabízet klepnutí na nějakou odpověď, volba se započítá jen poprvé a podruhé nelze hlasovat.
Třetí typ zobrazování anket (na stránce generované pomocí WebToDate) počítá s tím, že anketa je umístěna staticky na nějakou stránku, tj. celý její HTML kód je předgenerován, a hlasování je směrováno na samostatnou stránku /scripts/modules/vote/vote.php. Z toho vyplývá, že pokud je např. třeba umístit anketu na úvodní stránku www prezentace, která je staticky generovaná, musí anketa nabízet pro všechny uživatele stejný kód, který nerozlišuje stavy před a po hlasování a který nemůže např. zobrazovat aktuální výsledky, výběr odpovědi znamená, že se zobrazí stránka pro jednotlivé ankety /scripts/modules/vote/vote.php, kde je zobrazen aktuální výsledek hlasování stylem Po hlasování.
Nejjednodušší příklad je hlasování uvnitř zprávy svázané s danou konkrétní zprávou. Princip způsobu zpracování je naznačen na následujícím diagramu.

V předloze pro zprávy je třeba umístit jedno klíčové slovo zastupující celý hlasovací formulář. Při zobrazení zprávy se pak vyhodnocuje, zda uživatel na tuto anketu již hlasoval a podle toho se zvolí jeden ze dvou možných formátovacích stylů. Při tom, nezáleží na tom, jestli jde o aktuálně provedené hlasování, tj. uživatel zrovna provádí hlasování, nebo jestli jde o zobrazení ankety, na kterou uživatel odpovídal před týdnem – rozdíl zde je pouze v tom, že se v prvním případě aktuálně započte nový hlas, způsob zobrazení je v obou případech stejný.
Je-li modul řádně nakonfigurován, tj. nastaveny formátovací styly apod., stačí pro vytvoření takové ankety spojené se zprávou zadat v sekci Data modulu otázku a možné odpovědi a zadat ID zprávy, ke které se anketa vztahuje, vše ostatní již zafunguje v prezentační vrstvě automaticky.
Pokud chceme umístit anketu na libovolnou stránku (např. na úvodní stránku www prezentace), která je typicky staticky generovaná, postup je o něco složitější. Do stránky je třeba vložit kompletní hlasovací formulář, kde se již nemůže měnit ve chvíli žádosti o zobrazení je na stránku pevně generován. Zde se využívá funkce, která z anketního formuláře vytvoří novou zprávu WebToDate, která v těle obsahuje kompletní HTML kód formuláře. Cílová stránka tohoto formuláře pak musí být PHP skript pro zobrazení jedné ankety, který započte hlas a zobrazí výsledky hlasování. Funkce je znázorněna na následujícím diagramu.

Modul umožňuje definovat více souborů grafických nastavení (tzv. Předpisů), pro každou anketu zvlášť se pak volí z nabídky připravených předpisů. Díky tomu lze na jedné webové prezentaci používat více způsobů zobrazení anket a kombinovat ankety svázané se zprávou s anketami samostatnými, které se umísťují na kterékoliv stránce prezentace.
Možnosti hodnocení článků
Ve stavu před hodnocením lze zobrazit:
- Prvek pro hodnocení, kde uživatel volí známku
- Počet hodnocení pro daný článek
- Průměrné hodnocení článku
Pro prvek pro hodnocení lze nastavit bodovou stupnici, např. 1-5, 1-10 apod. Každé známce lze přiřadit textový popisek (5=vynikající, 4=dobrý apod.).
Ve stavu po hodnocení lze zobrazit:
- Hodnocení uživatele graficky i jako číslo
- Počet hodnocení pro daný článek
- Průměrné hodnocení článku
Modul samotný řeší pouze zobrazování textových informací a hodnotící prvek jako formulář typicky s radiopřepínači reprezentujícími známky. Pro grafické zobrazení a ovládání (typicky se zobrazuje jako hvězdičky či podobné ikony) se použijí v implementaci javascripty, vhodné je např. použít jQuery a plugin Star Rating pro jQuery UI. Vždy je v takovém případě při implementaci nutné připravit a testovat podobu se zapnutým a vypnutým javascriptem.
Rozpoznávání toho, zda uživatel již článek hodnotil, se provádí pomocí standardního cookie s identifikací uživatele, na serveru se uchovává tabulka, ve které je zapsán identifikátor uživatele a ID zprávy, která bylo hodnocena. Tabulku lze pomocí plánované úlohy promazávat tak, aby se nehromadila stará data.
Globálně lze nastavit stáří zpráv, které lze hodnotit a volitelně tak omezit přidávání nových hodnocení ke zprávám starším než x dní.
V administračním rozhraní lze vypisovat přehledy hodnocení článků podobně, jako pracuje funkce Statistika ve WebToDate pro čtenost. Lze vypisovat přehledy nejlépe hodnocených článků, hodnocení po dnech a hodnocení zvoleného článku.
Jsou podporovány instalace s více jazyky tak, aby se prvek pro hodnocení zobrazoval ve zprávách v různých jazycích s odpovídajícími texty.
Je možné provozovat na jedné instalaci více typů hodnocení v tom smyslu, že část serveru používá hodnocení v určité grafice a s nějakým počtem možností (známek) a jiná část (např. jiný virt. serveru) používá jinou grafiku s možným jiným počtem známek. Naopak není podporováno:
- Více typů hodnocení pro jednu zprávu (např. separátní hodnocení důvěryhodnosti, objektivity apod.)
- Možnost zrušit hlas uživatele – uživatel, který použil hodnocení u dané zprávy, jej již nemůže odvolat
Co je nového
Verze 4.2.9.0 modulu
Do modulu je přidána podpora implementace hodnocení článků neboli známek, kterými mohou čtenáři jednotlivé zprávy hodnotit.
Verze 4.0.1.6 modulu
Skript /scripts/modules/vote/vote.php může využívat parametr patternid, kterým se vynucuje předpis, který se použije pro zobrazení ankety. V rámci předpisu je uveden styl před / po hlasování i předloha, lze tak tedy kompletně předefinovat zobrazení dané ankety.
Verze 4.0.1.3 modulu
V modulu lze nově vytvořit jednoúrovňový seznam vlastních kategorií (nezávislý na stromu kategorií WebToDate). Každá anketa může být volitelně zařazena do jedné kategorie.
Podle kategorií lze v administračním rozhraní modulu vyhledávat, rovněž lze ale v prezentační části vypsat seznam starších anket s omezením na danou kategorii.