Dokumentace k pluginu 'Návštěvní kniha' (Guestbook)

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 ]

• pár vylepšení od Garvina

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