Dokumentace k pluginu 'Kalendář akcí'
(serendipity_event_cal)

Dokumentaci k tomuto pluginu přeložil do češtiny Vladimír Ajgl (vlada [zavinac] ajgl [tecka] cz) a naposledy ji aktualizoval dne 4.2.2012. Od té doby mohl být plugin pozměněn nebo mohly být rozšířené jeho funkce. Zkontrolujte pro jistotu i aktuální anglické "readme" a .ChangeLog

serendipity_event_cal.php, README file 2010-02-23 ian
Pokud máte zajímavé vylepšení nebo potřebujete pomoc, zanechte prosím zprávu na diskuzním fóru.
Užijte si to. .... Ian (Timbalu)
POZOR:
Plugin je postaven plně na šablonách - viz soubory
plugin_eventcal_cal.tpl (hlavní obrazovka a měsíční přehledy),
plugin_eventcal_add.tpl (formulář "přidat"),
plugin_eventcal_app.tpl (tabulka "potvrdit"),
plugin_eventcal_calweek.tpl (tabulka týdeního přehledu),
plugin_eventcal_entry.tpl (jednotlivá akce),
plugin_eventcal_ical.tpl (experimentální).
V chybových zprávách plugin_eventcal_error se stále vyskytují špatné html tagy.
Soubor s jazykovými zprávami může být dále upravován.
Čtěte DALŠÍ POZNÁMKY, Rychlé JakNaTo, Nastavení a ChangeLog (Historie verzí).
DALŠÍ POZNÁMKY
RYCHLÉ "JAK NA TO"
NASTAVENÍ
Permalink - /HTTP-Root/.../serendipity/pages/eventcal.html
Nadpis stránky a Url - Krátký nadpis, který je použitý též v index.php?serendipity[subpage]=jmeno
Formátovat jako článek - výchozí hodnota je "ano"
Nadpis stránky - nepovinné
Úvodní slovo - nepovinné; Pokud je WYSIWYG editor zapnutý, jako html pole.
Použít kryptogramy - výchozí hodnota "ne"
Exportovat iCal feed? - výchozí hodnota "ne"
Exportovat iCal URL? - výchozí hodnota "ne"; Vyberte jednu hodnotu mezi "stažení|webcal|email|uživatel rozhodne sám"
Logovat iCal exporty? - výchozí hodnota "ne"; Pokud ano, email s daty uživatele [IP, email, url] budou posílány na zadaný email, viz následující nastavení.
Vaše emailová adresa - Email, na který posílat oznámení, pokud je logování nastaveno na "ano".

Tento plugin je postaven na původním kódu "event calender" na php.net někdy v roce 2005 až 2006. Neostýchejte se ho dále vylepšovat.

Ian, 31 října 2009

CHANGE_LOG (HISTORIE VERZÍ)

Verze 1.66 (23.2.2011)

23.2.2011ZMĚNAošetřené drobné věci okolo fontů v CSS souboru kalendáře
23.2.2011NOVÁ FUNKCEdvojitá kontrola verze databáze a odstranění cleanup() je volána pokaždé
22.2.2011CHYBA (ošetřená, uzavřená)špatně umístěné volání funkce smarty_object_init() vně třídy porušilo formulář komentářů u příspěvků

Verze 1.65 (17.2.2011)

17.2.2011NOVINKAdopředná kompatibilita se Smarty3

Verze 1.64 (15.2.2011)

15.2.2011NOVÁ FUNKCEomezení adinistrační funkce v backendu a postranním sloupci pouze na přihlášeného administrátora
5.2.2011ZMĚNA a NOVÁ FUNKCEjazykové konstanty. Jazykové soubory <en>, <de>, <de-utf8>, <cs>, <cs-utf8>, <cz> a <cz-utf8> jsou nyní aktuální.
5.2.2011ZMĚNAmetoda smarty->fetch je nyní méně přísná, aby podporoval změnu pořádí parametrů mezi verzemi smarty2 a samrty3 - odstraněn parametr 4
29.1.2011NOVÁ FUNKCEvolba řazení podle času sestupně pro schválené přípsěvky (včetně drobné opravy v backend.css)
29.1.2011NOVÁ FUNKCEspráva databáze eventcal, umožňuje zálohovat, stahovat a mazat sql soubory
28.1.2011ZMĚNAbackend - kontroly, že mysql tabulka existuje, jsou nyní přísnější v případě čerstvé instalace

Verze 1.63 (19.1.2011)

9.1.2011NOVÁ FUNKCEcompatibilita se smarty3
9.1.2011ZMĚNAplugin_eventcal_cal.tpl - odstraněno start=1 z loop kvůli kompatibilitě se smarty3
8.1.2011CHYBA (ošetřená, uzavřená)update databáze nefungoval podle očekávání
22.7.2010ZMĚNAinterní sestavování URL adresy je přátelštější k nastavení mod_rewrite pomocí permalinku nebo podstrany (rewrite, žádné, errordocs definuje použití podstránky)
15.7.2010CHYBA (ošetřená, uzavřená)v případě chyby formuláře POST kalendář neukazoval na odkazovaný měsíc/rok, ale přepnul se na leden/rok
15.7.2010ZMĚNAstyle_event_backend.css, plugin_eventcal_add.tpl a plugin_eventcal_cal.tpl je přísnější co se týče css pravidel
15.7.2010ZMĚNAdrobné opravy a vyčištění kódu

Verze 1.62 (30.4.2011)

28.4.2011CHYBA (ošetřená, uzavřená)v případě změny neschválených akcí v administrační sekci formulář nezobrazoval správný typ akce
28.4.2011ZMĚNAics chování url pomocí external_plugin pro kontrolu, jestli je používáno přepisování URL (URLRewrite)
22.3.2011ZMĚNAexternal_plugin je přenější v ics_exportu akcí kalendáře

Verze 1.61 (11.3.2011)

9.3.2011NOVÁ FUNKCEvytvoření chybějícího adresáře eventcal v templates_c

Verze 1.6 (22.2.2010)

SOUHRNNĚ: V backendu (v adminstrační sekci) je nyní v postranním sloupci odkaz, pod kterým je schováno rozhraní k zobrazování, povolování, vkládání a úpravám událostí. Panel pro administraci databáze se přesunul také tam. Nicméně hlavní administrativní operace, jako povolování, změny nebo mazání zůstávají přístupné z frontendu (uživatelského rozhraní). Po celou dobu jsem PŘIDÁVAL nové funkce a MĚNIL staré funkce, *.tpl šablony a anglické a německé jazykové soubory, aby plugin správně fungoval.
23.2.2010ZMĚNAcesta pro log soubor do serendipity/templates_c/eventcal a ics soubor do serendipity/uploads - viz 11.2.2010
20.2.2010ZMĚNAčištění před releasem
19.2.2010ZMĚNAplugin_eventcal_ical.tpl pro unparsování RRULE části multi-událostí. Jsem si jistý, že už jsem to dělal dříve někde jinde..., protože multi-události mají den ukončení.
18.2.2010ZMĚNAněkteré proměnné jsou testované pomocí (isset(proměnná), abychom se vyhnuli množství PHP varování v případě nastavení chybových hlášek na error_reporting(E_ALL)
16.2.2010ZMĚNAfunkce send_ical_log_email, logování do mailu, pro vytvoření entryURI jako odkaz href s plnými parametry
14.2.2010ZMĚNAfunkce sendIcalEmail - zbavil jsem se dvojtých hlaviček Content-Type, které produkovaly X-Amavis-Alert
14.2.2010ZMĚNAfunkce send_ical_log_email - hází chybu v případě, že selhal zápis do souboru
13.2.2010ZMĚNAmail ical, aby byl přesnější vzhledem k zadanému mailu v nastavení pluginu nebo v osobním nastavení serendipity a jazykových souborech
11.2.2010ZMĚNAfunkce write_file icalendar.ics používá nyní funkci backend_file_write a zapisuje soubor do nového veřejného adresáře pod cestou k pluginu, aby byl následně poslán jako soubor v případě mailu nebo webcalu. Toto nastavení je jiné oproti verzi pluginu 1.5, který ukládal do adresáře S9y/uploads!
10.2.2010NOVÁ FUNKCEstripsalshes (odstranění lomítek) při přípravě povolené události do formuláře, který je užita podle platformy (windows) nebo php verze.... (?) Stará verze bez této funkce neměla na mém serveru běžícím na debian lenny žádný problém.
10.2.2010ZMĚNAfunkce str_replace_icalarray na funkci str_replace_recursive, podporuje NOVĚ parametr 4 pro vyhledávání pouze ve specifickém klíči pole
9.2.2010ZMĚNAfunkce send_ical_log_email, aby generovala správné entryURI, logování iCal požadavků
8.2.2010ZMĚNACW týden v šabloně plugin_eventcal_calweek.tpl je stejný v měsíčním kalendáří a v denním přehledu, v css je nastavený jako xx-small
8.2.2010ZMĚNAvlastnosti css fontu, aby byl zacílen pouze na výstup eventcal, vrací kontrolu nad blogem do rukou šablony a jejího nastavení
7.2.2010ZMĚNAchování logu iCal požadavků. Nyní možné logovat pomocí emailu a/nebo souboru v backend/ical.log
7.2.2010NOVÁ FUNKCEv šabloně plugin_eventcal_ical.tpl část ORGANIZER, direktiva RSVP=FALSE:MAILTO:"", znamenající "répondez, s'il vous plaît" nastavená na NE
6.2.2010ZMĚNAhook_event 'external_plugin' a ical funkce podporují všechny povolené události, administrátorský download pomocí mailu nebo downloadu
4.2.2010NOVÁ FUNKCEzměněná chybová konstanta v jazykovém souboru, aby zobrazovala předpokládané počáteční datum u opakujících se událostí
4.2.2010CHYBA (ošetřená, uzavřená)ve funkci calculate_recur_validday - kontrola u opakujících se událostí, pokud se počáteční den neshoduje s vybraným dnem v týdnu. Nyní souhlasí přepředposlední a třetí den v týdnu od konce, které nebyly počítány správně a vracely chybu v případě kontroly po přidání nebo opětovné editaci.
4.2.2010NOVÁ FUNKCEstrtolower(re) - opakující se měsíční událost, konstanta jména v případě 'Každý "re" jméno v týdnu'
3.2.2010CHYBA (ošetřená, uzavřená)funkce draw_add - opravený formulář na přidání - přestavěno pole pro rok v případě opakované úpravy události, aby zobrazovalo původní počáteční rok
3.2.2010ZMĚNAplugin_eventcal_entry.tpl & style_eventcal_backend.css - změněné css styly, aby lépe zobrazovaly jediný příspěvek
3.2.2010CHYBA (ošetřená, uzavřená)v 'case css' - nastaveno správné pořadí stristr, aby zjistilo, jestli soubor style.css má už css styly definované pluginem
3.2.2010ZMĚNAstyle_eventcal_backend.css - zpřesněné chování serendipityPrettyButton, aby se vyloučil konflikt v administrátorské sekci, backendu
2.2.2010CHYBA (ošetřená, uzavřená)funkce view_app_events pomocí load_unapproved_events nyní vrací false, pokud není zadána žádná hodnota
2.2.2010NOVÁ FUNKCEv šabloně plugin_eventcal_app.tpl - přidána chybějící konstanta 'jednou za čtrnáct dní'
1.2.2010NOVÁ FUNKCEpřidána administrační sekce v backendu blogu - pro schvalování, upravování a mazání událostí, včetně manipulací s databází. To zahrnuje změny v anglickém a německém jazykovém souboru, některých *.tpl šablonách a css stylopisech.

Verze 1.5 (1.2.2010)

V krátkosti, pokusím se to releasnout právě teď... je to vícemnéně hlavní release ;-).
V krátkosti, v nastavení můžete nyní povolit iCal export jako stažení souboru, poslání pomocí protokolu webcal nebo pomocí mailu. Případně můžete způsob stažení nechat na uživateli.
V krátkosti, v nastavení můžete povolit explicitní iCal export. Pokud je nastaven, v kalendáři budou zpřístupněna tlačítka, která umožňují požadavek na měsíční přehled nebo stáhnutí jednotlivé akce.
Obecně vzato jsem přidal nové a pozměnil staré funce, nastavovací proměnné, šablony, jazykové konstanty a obrázky, aby plugin podporoval korektní export ve formátu iCal.
28.1.2010ZMĚNA - znovu vylepšen sql dotaz SELECT-ARRAY, aby byl jak přesný to jde k všem tipo-akcím
26.1.2010ZMĚNA - Vylepšené a přidané některé jazykové konstanty a interní funkce, tpl šablony, přidána nápověda k přidávacímu formuláři, re-edit počáteční rok je nyní ukládán v databázi
24.1.2010NOVÁ FUNKCE - přidány opakované události - roční a čtrnáctidenní - do souborů pluginu, tpl šablon a jazykových souborů
21.1.2010CHYBA (opravená, uzavřená) - Vylepšeno pole 'case tipo 3 recurring monthly events' v měsíčním přehledu, které se nezobrazovalo vždy korektně.
17.1.2010ZMĚNA - nastavení kontroly akcí opakovaných měsíčně a týdně, aby byly přesnější, co se týče data prvního výskytu ve vybraném dnu, které je potřeba pro iCal export. Upravte staré akce, aby splňovaly nové požadavky!
6.1.2010 NOVÁ FUNKCE - Do databáze byly přidány TIMESTAMP pole 'tstamp' jako hodnota vytvoření a poslední úpravy. Toto si také vyžádalo změnu tpl šablony! Bylo to potřeba pro iCal export.
20.12.2009ZMĚNA - vylepšen a změněn databázový SELECT akcí, aby byl přesnější co se týče vícedenních a opakovaných akcí ve funkci load_monthly_events() v iCal exportu.
20.12.2009ZMĚNA - Vylepšeno pole měsíčního pohledu ve funkci load_monthly_events(), které nyní vybírá a zobrazuje všechny možné výskyty.
19.12.2009ZMĚNA - vylepšeny a přidány některé jazykové konstanty
5.12.2009ZMĚNA - změněna některá nastavení. Nastavte je prosím znovu.
2.12.2009ZMĚNA - Některá menší vylepšení v šablonách *.tpl a stylech *.css
1.12.2009ZMĚNA - Vylepšeno interní 'get back to form' v případě chyb.
26.11.2009CHYBA (opravená, uzavřená) - Zlepšeno pole týdeního přehledu 'case tipo 4 to every weekday' v měsíčním přehledu, které se ne vždy zobrazovalo korektně.

Verze 1.4