serendipity_event_guestbook/documentation_cs.html, poslední změna 29. června 2011
Dokumentace k pluginu 'Návštěvní kniha' (Guestbook)
MĚJTE NA PAMĚTI!
Dokumentaci k tomuto pluginu přeložil do češtiny Vladimír Ajgl (vlada [zavinac] ajgl [tecka] cz) dne 29.6.2011. Od té doby mohl být plugin pozměněn nebo mohly být rozšířené jeho funkce. Zkontrolujte pro jistotu i
aktuální anglickou dokumentaci.
Tento Serendipity plugin "Návštěvní kniha" je založen na ŠABLONÁCH vzhledu, nastavitelný vlastním stylopisem, má FRONTEND (to, co se zobrazuje návštěvníkům blogu) a BACKEND (stránky v administrační sekci sloužící k nastavení pluginu).
Přečtěte si prosím pečlivě části
Nastavení,
Administrace,
Vzhled a nejnověji měněné položky v části
Changelog.
S9Y :: NÁVŠTĚVNÍ KNIHA :: NASTAVENÍ
- Volba 'Permalink' určuje stálý odkaz (= permalink). Potřebuje absolutní HTTP cestu a musí končit na .htm nebo .html!
Výchozí hodnota je "/blogname/pages/guestbook.html", nebo, v případě že nepoužíváte mod_rewrite, "/blogname/index.php?/pages/guestbook.html".
- 'Titulek & URL adresa statické stránky' nastavení určuje titulek stránky (tj. to, co se zobrazuje v pruhu okna prohlížeče úplně nahoře.)
Pozor: toto nastavení zároveň ovlivňuje URL adresu stránky (index.php?serendipity[subpage]=titulek). Zadávejte tedy krátký jednoslovný titulek bez mezer (výchozí: guestbook).
- 'Nadpis' určuje nadpis stránky uvnitř blogu v designu nadpisů blogu (nepovinné).
- 'Úvod' nastavuje přídavný úvodní text na stránce s návštěvní knihou (nepovinné).
- 'Umístění formuláře návštěvní knihy' určuje, na kterém místě stránky bude zobrazen formulář pro vložení nových příspěvků do návštěvní knihy, jestli nad nebo pod příspěky (výchozí: nahoře).
- 'Příspěvků na stránku' nastavuje, kolik příspěvků bude zobrazeno na jedné stránce (výchozí: 10).
- 'Znaků na řádku (zalomení)' nastavuje, po kolika znacích bude automaticky zalomen text příspěvků (nová řádka) (výchozí: 120).
- 'Formátovat jako článek' určuje, jestli mají být příspěvky návštěvní knihy formátovány stejně (co se týče barev, okrajů, apod.), jako příspěvky/články na blogu (výchozí: ano).
- 'Poslat e-mail administrátorovi' nastavuje , že každý nový příspěvek bude emailem oznámen na adresu administrátora blogu. V následujícím kroku nastavte emailovou adresu administrátora (výchozí: ne).
- 'Email uživatele' nastavuje, zda-li bude zobrazeno políčko pro zadání emailu uživatele (toho, kdo chce vložit příspěvek do návštěvní knihy) (výchozí: ano).
- 'WWW stránka uživatele' nastavuje, zda-li bude zobrazeno políčko pro zadání www stránky uživatele (výchozí: ne).
- 'Zobrazovat kryptogramy' určuje, jestli bude zadání příspěvku chráněno nutností správně přepsat kryptogram jako ochrana proti spamu. (vyžaduje nainstalovaný a aktivní plugin Spamblock) (výchozí: ano).
- 'Schvalovat příspěvky' nastavuje, jestli budou příspěvky v návštěvní knize zobrazeny až poté, co je schválí administrátor blogu (výchozí: ne).
- 'Automatické schvalování' nastavuje podobné chování pro jednotlivé vzkazy. Pokud je aktivní slovní filtr pluginu "spamblock", pokud je nastaven na "schvalovat", pokud je nastavena tato volba a pokud je nalezeno nevhodné slovo, vzkaz je označen ke schválení a není zobrazen. (výchozí: ne) Hodnocení obsahu návštěvní knihy přesto nadále vyžaduje potvrzení pomocí kryptogramu, pokud je zde přípěvek vyhodnocen jako spam. Tím se liší chování návštěvní knihy od běžného spamblocku!
- 'Kontroly vzkazů' nastavuje aktivní individuální slovní filtr (výchozí: předvyplněno). Regulární výrazy jsou povolené, jednotlivé se oddělují středníkem (;). Musíte escapovat speciální znaky pomocí "\". Pokud necháte pole prázdné, nebudou se provádě žádné speciální kontroly.
- 'Formát data' umožňuje nastavit libovolný formát pro zobrazení data příspěvku pomocí funkce php strftime() (výchozí: %a, %d.%m.%Y %H:%M).
S9Y :: GUESTBOOK :: ADMINISTRACE
- Po přihlášení do blogu je možné spravovat plugin jak z administártorské sekce (z backendu), tak přímo ze stránky návštěvní knihy (z frontendu). Z frontendu je možné pouze mazat příspěvky. Před smazáním budete požádáni o potvrzení smazání.
Administrace z frontendu byla odstraněna ve verzi 3.24.
- Postranní sloupec v backendu blogu má čtyři položky pro správu návštěvní knihy:
1. zobrazení schválených příspěvků,
2. zobrazení neschválených příspěvků,
3. úprava starého nebo vložení nového příspěvku (pokud je 'Schvalovat příspěvky' nastaveno na 'ano'),
4. databázová část.
- První dvě položky umožňují potvrzení, smazání (okamžité bez potvrzení!) nebo znovu zadání jednotlivého příspěvku.
- Databázová část umožňuje: zálohovat a stáhnout databázovou tabulku návštěvní knihy, nebo okamžité smazání databázové tabulky. Při práci zde opatrně! (Akce zde jsou mocné a zpravidla nevratné.)
- Odkaz na vložení SQL je zobrazen, ale v současnosti není aktivní, neboť se v současnosti nejedná o jednoduchou operaci.
S9Y :: GUESTBOOK :: VZHLED
- Všechny šablony smarty (soubory *.tpl), obrázky a hlavní css stylopis pluginu jsou umístěny v adresáři pluginu a musí zde zůstat.
- Pokud to umíte a chcete upravit vzhled návštěvní knihy podle sebe, zkopírujte tyto soubory do adresáře se stylem/šablonou vzhledu, kterou používáte.
( plugin_guestbook_entries.tpl, plugin_guestbook_form.tpl, style_guestbook_backend.css ).
- V případě, že chcete změnit pouze barvu pozadí příspěvků, zkopírujte tyto neutrální direktivy css s bílou barvou:
/* návštevní kniha - neutrální barvy */
/* nadpis příspěvku */ .guestbook_entrytop { background:none repeat scroll 0 0 #FFF; }
/* pozadí příspěvku */ .guestbook_entrybottom { background:none repeat scroll 0 0 #FFF; }
/* administrátorský komentář */ span.guestbook_admin_comment { background:none repeat scroll 0 0 #FFF; }
/* spodní šedá/stínová řádka */ #guestbook_entrybundle { -moz-border-radius: 0 0; background:none repeat scroll 0 0 #FFF; }
na konec souboru user.css, pokud takový máte (doporučený postup!).
Pokud vaše šablona vzhledu neumožňuje uživatelské css stylopisy, zkopírujte soubor style_guestbook_backend.css do adresáře stylu/šablony vzhledu,
zkopírujte výše zmíněné css direktivy na konec a změňte hodnotu #FFF na požadovanou barvu (#FFF je neutrální bílá).
- Pokud chcete také zrušit okraje okolo příspěvků, přidejte ke každé direktivě: border: 0 none;.
- Pokud chcete změnit všechny barvy textu, přidejte:
#guestbook_entrybundle table,
#guestbook_entrybundle table a,
#guestbook_entrybundle .guestbook_entrytop,
#guestbook_entrybundle .guestbook_entrybottom,
#guestbook_entrybundle .guestbook_admin_comment p,
#guestbook_entrybundle .guestbook_admin_comment blockquote,
#guestbook_entrybundle .guestbook_admin_comment blockquote p,
#guestbook_entrybundle .guestbook_admin_comment blockquote p q { color: #000; }
pro nastavení černé barvy (#000).
- Nechcete žádné mezery mezi bloky s jednotlivými příspěvky? Přidejte: .guestbook_splitentries { display: none; visibility: hidden; }
- Úvodní text, pokud je zadán v nastavení pluginu, může být upraven pomocí: #guestbook_wrapper .guestbook_intro { padding: 0 none; text-align: left; border: 0 none; background:none repeat scroll 0 0 #FFF; }
- Krásný seznam dostupných barev naleznete například tady. Krásné obarvování!
S9Y :: NÁVŠTĚVNÍ KNIHA :: CHANGELOG
POZOR: Nejnovější verze pluginu vyžaduje, abyste zkontrolovali a zadali/znovu potvrdili nastavení návštěvní knihy!
****************************************************************
* plugin serendipty_event_guestbook, ChangeLog
* Pokud máte zajímavé vylepšení nebo chcete pomoc,
* zanechte prosím zprávu na diskuzním fóru.
* Užijte si to. .... Ian
****************************************************************
Verze 3.27 [ 27.6.2011 ]
- změna šablon backendu/frontendu včetně změn souboru se styly backend.css z tabulkového layoutu na seznam a jejich aktualizace
- změněna interního značkování nastavení, aby nastavilo výchozí hodnotu {$plugin_guestbook_articleformat} na (ano) v šabloně plugin_guestbook_entries.tpl.
- změněno zalamování řádků v postranním pluginu
- opravená sql procedura "alter update" a "remove"
- změněno zobrazení backendu pro celou administrátorskou skupinu, ne pouze pro administrátora
Verze 3.26 [ 8.3.2011 ]
- Oprava časového razítka ve volání funkce spamblock na -8 dní do minulosti, zatímco captchas_ttl považuje krytpogramy jako platní do 7 dní.
- Oprava administrační sekce; V některých chybových případech se ztatily proměnné POST.
- Změněna jazyková konstanta ERROR_DATANOTAGS v jazycích <en>, <de>, <de-utf8>, <cs>, <cs-utf8>, <cz> a <cz-utf8>, aby podporovala novou funkci slovního filtru.
- Přidána nová předvyplněná volba do nastavení, která umožňuje vypnout slovní filtr pluginu pro tělo vzkazu, která byla dříve vypínána interně.
- Přidány interní proměnné do funkce pro správnou podporu nekompletních chybových zpráv.
- Změna jazykových konstant v jazycích <en>, <de>, <de-utf8>, <cs>, <cs-utf8>, <cz> a <cz-utf8>, aby lépe vysvětlily rozdíly mezi jednotlivými způsoby schvalování vzkazů a kontrol proti spamu.
- Změněna dokumentace documentation_en.html (kterou obsahuje i současná verze české documentation_cs.html), aby lépe vysvětlila rozdíl mezi kontrolou pomocí kryptogramů proti automatickému schvalování a nové volbě 'kontrola příspěvků'.
Verze 3.25 [ 6.3.2011 ]
- Přesun interních proměnných na lepší místo.
- Změna šablony plugin_guestbook_backend_entries.tpl, aby podporovala skrytou proměnnou pro schvalování.
- Vymazána volba schvalování v postranním pluginu, která byla zavedena ve verzi 3.21, protože postranní sloupec je nyní rozšířen o nastavení pluginu události.
- Přestavěný postranní sloupec <serendipity_plugin_guestbook>, aby podporoval změny v nastavení 'automatické schvalování' a 'schvalování administrátorem'.
- Přidány jazykové konstanty v jazycích <en>, <de>, <de-utf8>, <cs>, <cs-utf8>, <cz> a <cz-utf8>.
- Přidáno nové nastavení, které umožňuje nastavit automatické schvalování pomocí pluginu spamblock, pokud je jeho slovní filtr aktivní a nastavený na 'schvalovat'.
- Opravy pravopisu v německých jazykových souborech.
- Upraveny drobnosti v CSS souboru návštěvní knihy.
- Přidána návratová hodnota spamblocku 'schvalování komentářů', podpora vkládání vzkazů jako neschválených; rozšiřuje nastavení návštěvní knihy.
Verze 3.24 [ 23.2.2011 ]
- Přidány kontroly tagů a odkazů jako prevence před tím, aby spamboti četli kryptogramy.
- Upraveny drobnosti v CSS souboru návštěvní knihy.
- Změna jazykových konstant PAGINATOR_* a přidání nových konstant ERROR_DATANOTAGS v jazycích <en>, <de>, <de-utf8>, <cs>, <cs-utf8>, <cz> a <cz-utf8>.
- Starý stránkovač nahrazen novým.
- Změna šablony plugin_guestbook_entries.tpl, aby podporovala odstraněnou administraci.
- Oodstraněny administrátorské funkce z frontendu, protože se lépe dělají v backendu.
Verze 3.23 [ 17.2.2011 ]
- Nejnovější: dopředná kompatibilita se smarty 3
Verze 3.22 [ 15.2.2011 ]
- Změněno volání metody smarty->fetch, aby podporovalo pořadí parametrů jak podle smarty 2, tak podle smarty 3 - odstraněn parametr 4.
- Přidáno omezení funkcí administračního rozhraní a administrace z postranního sloupce pouze na přihlášeného administrátora.
Verze 3.21 [ 24.1.2011 ]
- Opraveno odesílání vzkazu na email, které nezobrazovalo správně tělo vzkazu.
- Znovuzavedení falešného volání spamblocku a dalších pluginů komentářů, které bylo odstraněno v 3.20, aby bránilo spambotům v odchytávání kryptogramů.
- Oprava serendipity_plugin_guestbook.php, aby správně zobrazeovalo pouze schválené vzkazy, pokud je to zadáno v nastavení.
- Opravení překlepů v jazykovém souboru lang_en.* a upravení dokumentace tak, aby byla validní s W3C XHTML.
Verze 3.20 [ 17.7.2010 ]
- Tato verze přináší administrační stránky v administrační sekci blogu a nově umožňuje schvalování příspěvků.
- Proto přidává nový sloupec 'approve' do databázové tabulky a novou proměnnou 'showapp', nastavenou buď na ano nebo ne (výchozí je ne).
- Tyto změny se u starých příspěvků projeví tak, že budou všechny nastaveny jako schválené.
- Aktualizován postranní blok návštěvní knihy, aby zobrazoval pouze schválené příspěvky. Nová verze postranního bloku je 1.12.
- Změněny a přidány jazykové konstanty. Jazyky <en>, <de>, <de-utf8>, <cs> a <cz> jsou nyní aktuální.
- Pár drobných vylepšení jak v šablonách frontendu, tak v css stylopisech.
- Několik drobných vylepšení v algoritmu počítání stránek ve frontendu a v budování URL adresy stránky, aby byly kompatibilnější s nastavením mod_rewrite pomocí nastavení permalink nebo podstránka.
- Tato vylepšní mohou ovlivnit individuální nastavení vzhledu. Zkontrolujte prosím vlastní šablony *.tpl a css stylopisy!
Verze 3.0 až 3.11 [ 2007-2009 ]
- několik úprav od Garvina
- 3.11: - Chybějící předpona http://, díky WMK
- 3.08: - Použití nadpisu pro vložení do titulku blogu, podobně jak to dělají statické stránky.
- 3.07: - Pouze skrytí emailových adres nepřihlášeným uživatelům
- 3.06: - Oprava chybného užití proměnných, které mělo za následek, že v některých případech nešly smazat příspěvky z návštěvní knihy
- 3.05: - Opraveno správné nezobrazování emailových adres, pokud bylo nastaveno.
- Přidán status:200 pro lepší kompatibilitu s apache cgi
- 3.04: - Přidána chybějící jazyková konstanta
- 3.03: - Skok do sekce "potvrdit"
- 3.02: - Vyčištění proměnných
- 3.01: - Větší změny v rozložení knihy, odstraněna možnost vyskakovacích oken (která nefungovala správně) apod.
Verze 2.8 až 3.0 [ 24.7.2007 ]
- Pokus o vložení vyskakovacích oken a dynamického vyplňování políček formuláře, které ovšem nefungoval tak, jak bylo plánováno. (nakonec odstraněno ve verzi 3.01) ;-)
Verze 2.7 [23.7.2007]
- Změněné jazykové soubory. Jazyky <en>, <de> a <de-utf8> jsou nyní aktualizovány.
- Pokud budete měnit nějaké jiné jazykové soubory, změňte prosím první řádek na
- $Id: serendipity_event_guestbook.php, langfile(kratke_vase_jmeno) vX.X 20XX/XX/XX vase_jmeno
- Nové obrázky, přesun obrázků, vyčištění starých souborů.
- Smazaný prehistorický soubor 'plugin_guestbook.tpl', který mate nováčky. Udělejte prosím to samé!
- 'button_background.png' a 'shorttime.gif' nyní patří do podadresáře pluginu 'img'. Vymažte je prosím ze základního adresáře pluginu, aby nikoho nemátly.
- Do adresáře 'img' přidány 'blank.gif' a 'info.gif', což je vlastně pomocný obrázek do nastavení.
- Změna šablony plugin_guestbook_form.tpl
- použití nových proměnných smarty
- pokud jsou nastaveny: vyskakovací okno pro zobrazení zpráv
- Nyní může uživatel používající vyskakovací okno vidět svůj příspěvěk po vložení do databáze.
- V šabloně 'plugin_guestbook_form.tpl' byla změněna 'action="{$plugin_guestbook_action}#entry"' na 'action="{$commentform_action}?frontpage#feedback"'. To je nezbytné, pokud používáte statickou stránku jako startovní stránku blogu. Ujistěte se, že je plugin "statické stránky" před pluginy "kontaktní formulář" a "návštěvní kniha". Vlastně '?frontpage' bude zadána v 'serendipity_event_guestbook.php'
- Přidáno administrační rozhraní
- Změněno několik css tříd
- Změna šablony plugin_guestbook_entries.tpl
- použití nových proměnných smarty
- pokud je nastaveno, zarovnání formuláře nahoře nebo dole a možnost odkazovat na formulář
- změněno pár věcí okolo toho
- přidáno pár věcí do adinistračního rozhraní a tag <td></td>, který se ukázal nezbytným
- Změněno několik css tříd
- Změněn, vyčištěn a pozměněn soubor style_guestbook_backend.css
- Do Vašeho adresáře se šablonou si můžete vložit vlastní verzi jak tpl šablon, tak css stylopisů.
- Přidáno dynamické pole navíc (dyn).
- Nemyslím, že je nutné používat mgroeningerovu výbornou dynamickou funkci z kontaktního formuláře.
- Aby byl plugin lépe a více nastavitelný, následující proměnné byly přidány nebo pozměněny (viz též jazykové soubory):
- 'headline' nadpis statické stránky, přidal Garvin (v. 2.7).
- 'intro' použito pro volitelný úvodní text na začátku stránky.
- 'pageurl' nyní nazávaný permalink, zatímco pagetitle je použit jako původní (1.x) URL adresa pro
staticpage_pagetitle, viz níže. (Vím, zní to zmateně, ale ve výsledku je to přímější!)
- 'pagetitle' je použit ve statických stránkách a dalších šablonách a určuje URL adresu stránky
'index.php?serendipity[subpage]=name'.
- 'formorder' určuje místo zobrazení formuláře pro zadání nových příspěvků, výchozí hodnota je pod příspěvky.
- 'formpopup' určuje, jestli se má formulář zobrazit ve vyskakovacím okně, výchozí hodnota (ano) znamená žádná vyskakovací okna.
- 'showdynfield' je základní dynamické pole definované v databázi jako mysql varchar(100).
Použijte spolu se vstupním polem v šabloně plugin_guestbook_form.tpl
a jako textový výstup v šabloně plugin_guestbook_entries.tpl.
Zkoušel jsem to i s polem typu tinyblob, ale zjistil jsem, že není moc dobrý nápad
ukládat binární data v databázi, a proto jsem se vrátil k tomuto malému textovému poli.
Pokud chcete změnit označení tohoto pole, nastavte na stránce s nastavením nové jméno v příslušném políčku (dynfield) a potvrďte změny.
- Opravena malá chyba ve funkci stránkování.
- Generální úklid kódu ho vyčistil a posunul výš. Více zdokumentovaného kódu.
- Nyní se jedná už o opravdu plně šablonovanou verzi (99.9% ;-)).
- Zbývající bloky (div) a administrační věci byly přesunuty do *.tpl šablon.
- Sorry, ve funkcích je stále potřeba zpracovávat zalomení řádků a url adresy ve funkci stránkování.
- Dobré zprávy! Kód pro statické stránky na konci této stránky je už překonaný.
- Zachováme kompatibilitu s verzí 1.x až do příštího releasu 3.x. No, vlastně, ... ta verze se bude jmenovat 3.0.....
Verze 2.5 až 2.7 [ 2007 ]
Verze 2.0 až 2.4 [ 21.8.2006 až 9.10.2006 ]
- Několik změn ve vytváření ve funkci pro vytávření odkazů generate_EntriesPage(), aby pracovalo s i bez modulu mode_rewrite
- SQL dotazy pro zobrazení příspěvků se nyní vykonávají pouze pokud je uživatel v módu 'zobrazení příspěvků' nebo 'příspěvek hotov'
- Guestbookform tpl action url je nyní: $serendipity['baseURL'] . $serendipity['indexFile'] . '#entry'
- Změněn postranní sloupec serendipity_event_staticpage.php, aby byl kompatibilní také s verzí návštěvní knihy 2.0 (code1).
V případě, že už jste tento plugin používali k zobrazení odkazu do návštěvní knihy v postranním sloupci, jděte prosím do administrační sekce,
do nastavení statických stránek, a znovu zadejte zobrazování návštěvní knihy mezi odkazy. Touto akcí dojde k potřebným změnám.
- Postranní sloupec serendipity_plugin_guestbook nyní funguje pouze s verzí 2.0
- Email administrátora by měl být nyní kompatibilní s verzí návštěvní knihy 1.38 - použití pouze jednoho emailu
- Nastavení značkování nyní způsobuje, že políčka návštěvní knihy jsou nyní při zobrazování prohnána skrz standardní fonukce serendipity pro formátování textu a převod smajlíků do obrázkové podoby
- Změna starších databázových tabulek nyní funguje (pouze?) v mysql
- Více funkcí pro vyčištění/přejmenování a nastavitelné zalamování textu ve verzi 2.0
- Nyní by měla návštěvní kniha spolupracovat s kryptogramy - to si vyžádalo novou proměnnou v nastavení, tedy prosím zkontrolujte nastavení kryptogramů v pluginech spamblock a návštěvní kniha
- Vyčištění a optimalizace jazykových konstant
- Teď už je plugin serendipity_event_guestbook skoro celý postavený na šablonách (viz plugin_guestbook_entries.tpl a plugin_guestbook_form.tpl)
- Odteď naleznete obrázky shorttime.gif, button_background.png a delete.png v adresáři $adresar_pluginu/img.
- Změna css (style_guestbook_backend.css) a souborů šablon podle vašich požadavků
- Zkontrolujte prosím ostatní jazykové soubory. Nyní jsou aktuální a správně pracující pouze <en>, <de> a <de-utf8>!
- Permalink ("pageurl") je úplná cesta z htto kořenového adresářenapř. "/serendipity/pages/guestbook.html" nebo "/serendipity/index.php?/pages/guestbook.html" (viz mod_rewrite)
- Prosím pozor: Tato verze používá funkce pluginu spamblock, konkrétně kryptogramy (vypnuto pro administrátory),
- Prosím pozor: proměnné timelock a sessionlock už nejsou nadále používány - jsou odstraněny při aktualizaci databázové tabulky
Verze 1.0 až 1.38 [ 11.2.2005 až 21.8.2006 ]
- první verze vyvinul Philipp Schneider aka boelkstoff