Pluginy a jejich pouziti
O rozsirujicich modulech (pluginech) obecne
K cemu jsou rozsirujici moduly (pluginy) uzitecne?
Blogovaci system Serendipity je navrzen tak, aby mohl uzivatel snadno vytvaret a spravovat sve prispevky. Rozsirujici moduly mu dovoluji rozsirit, zvetsit moznosti blogu a predlozit ctenari vice a kvaltinejsich informaci. V Serendipity existuji dva typy plugin - pluginy postranniho sloupce a pluginy udalosti.
Pluginy postranniho sloupce
Jsou videt v blogu v postrannim sloupci (levem nebo pravem). Postranni pluginy jsou vhodne predevsim k zobrazovani drobnosti jako je kalendar, seznam nejnovejsich kometnaru, ale i jakykoliv obecny HTML blok (HTML nugget). Postranni pluginy byvaji jednoduche, casto obsahuji odkazy, ale mohou byt i slozitejsi jako napriklad plugin Shout Box?.
Pluginy udalosti
Pluginy udalosti manipuluji s daty, ktere Serendipity pouziva. To z nich dela mocny nastroj, ktery zvysuje vykon Serendipity. Kod Serendipity je napsan tak, ze pro udalosti, ktera se v Serendipity muze vyskytnout (jako je zobrazeni prispevku, ulozeni prispevku, upravovani prispevku), lze priradit libovolnou funkci, ktera dokaze pozmenit data, ktera do udalosti vstupuji. Jako priklad mohou poslouzit znackovaci pluginy, ktere dovoluji pouzit v telu prispevku znackovaci jazyk. Na vysvetlenou jednoduchy priklad, pokud chcete napsat text tucne bez znackovaciho jazyku, musite pouzit HTML jazyk weboych stranek. Kod vypada takto: <b>*tucny text*</b>. S pouzitim znackovaciho jazyka staci napsat jednodussi zapis \*tucny text\* a znackovaci plugin se postara o prevod znackovaciho jazyka do HTML za Vas. Priklady ruznych znackovacich jazyku jsou: s9yMakrup, Wiki, BBCode, Textile.
Volani funkci je uskutecnovano pomoci hooku. Jejich seznam je k dispozici v Technicke dokumentaci (anglicky). Pridanim jedine radky do kodu Serendipity muzeme pridat hook na jakekoliv misto Serendipity, takze pokud nenajdete hook, ktery by se vam hodil, staci rict. :-)
Instalace a nastaveni rozsirujicich modulu
Pluginy mohou byt instalovany a nastavovany vyhradne z administratorskeho rozhrani. Kliknete na odkaz "Konfigurace pluginu" v levem sloupci. Zobrazi se seznam vsech instalovanych postrannich pluginu a pluginu udalosti. Serendipity je predastavena s jiz nainstalovanymi nekterymi zakladnimi pluginy. Dalsi najdete v adresari plugins.
Urcite se vsimnete mnozstvi voleb u kazdeho pluginu - zaskrtavaci policko k odinstalaci, ikona k nastaveni pluginu, policko s vyberem opravneni, soustava sipek, pomoci kterych muzete upravit poradi pluginu, u postrannich pluginu pak i polohu (vlevo, vpravo), pripadne ho skryt.
Ve verzi 1.0 byla pridana snadnejsi manipulace s pluginy pomoci javascriptu. Pokud ho Vas prohlizec podporuje, muzete s pluginy posouvat systemem "drag and drop" = kliknutim a tazenim.
Pluginy udalosti nejsou zobrazeny v postrannim sloupci. Jejich posloupnost ve sloupci urcuje poradi, v jakem jsou vykonany. Nektere pluginy musi byt vykonany pred jinymi, maji-li dohromady sprane fungovat.
Nainstalovat novy rozsirujici modul neni nic jednodussiho, nez kliknout na odkazy v zahlavi kazde ze sekci - "Kliknete a instalujte novy postranni plugin" nebo "Kliknete a instalujte novy plugin udalosti". Ted pred sebou vidite uplny list vsech dostupnych pluginu. Kliknutim na ikonu vpravo od popisu pluginu ho nainstalujete. To je vse :-)
Jakmile Serendipity nainstaluje novy plugin, zobrazi konfiguracni obrazovku pluginu. Tady muzete zmenit vlastnosti pluginu, jak funguje. Mnozstvi nastavitelnych parametru zavisi na slozitosti pluginu. Nekdy neni treba nastavovat nic, jindy jsou nastaveni cele dve stranky.
Pro nastaveni drive nainstalovane pluginy jednoduse kliknete na jeho jmeno. Nektere pluginy jsou tak jednoduche, ze zadne nastaveni nemaji. Jejich jmene pak neni klikatelne.
Instalovani externich pluginu
Projekt Serendipity ma k dispozici pekne velky zasobnik externich rozsirujicich modulu. Podivejte se na jejich seznam Plugins/Add-Ons? (anglicky).
Je nekolik zpusobu, jak tyto pluginy nainstalovat:
Pomoci modulu SPARTACUS
Od verze Serendipity 0.8 je jeji soucasti plugin udalosti, ktery se jmenuje "SPARTACUS". Ten umoznuje pripojeni k internetovemu serveru a automaticke nahrani pluginy na Vas server. Nainstalujte tento plugin. V konfiguraci pluginu se pak objevi nove ikonky s odkazy - "Vyhledat nove pluginy pro postranni sloupec." a "Vyhledat nove pluginy udalosti."
Kdyz na nektery z odkazu kliknete, Serendipity se pripoji do on-line uloziste pluginu a stahne aktualni seznam dostupnych pluginu, ktery zobrazi. Pak satci kliknout na ikonku vedle popisu pluginu a ten se automaticky stahne a nainstaluje.
K tomuto specialnimu modulu mame tri poznamky:
1. Spartacus potrebuje k cinnosti odchozi spojeni k serveru Source Forge?.Net. To znamena, ze by vas webovy server nemel blokovat http pozadavky.
2. Source Forge?.net ViewCVS server je ponekud nespolehlivy. Muze se stat, ze doobdrzite chybovou hlasku "Soubor nenalezen", pripadne ani seznam plugin neni mozno stahnout. V takovem pripade budte prosim trpelivi a zkuste to znovu za chvili.
3. Spartacus potrebuje mit prava k zapisu do adresare "/plugins" a do vsech jeho podadresaru, aby mohl nahrat vsechny potrebne soubory. Tedy budete muset zmenit pristupova prava techto souboru na 777 nebo neco podobneho v zavislosti na Vasem webovem serveru. Pokud to neudelate, dostanete hlasku: "Soubor nebylo mozno vytvorit..."
Instalace pomoci CVS
Muzete kontrolovat nase uloziste "pridavnych pluginu" pomoci verzovaciho systemu CVS. Pak vytvorite symbolicky odkaz v adresari serendipity/plugins/ do adresare, ve kterem synchronizujete pridavne pluginy pmoci CVS. Serendipity pak zjisti pritomnost techto novych vnorenych pluginu a nabidne jejich seznam k nainstalovani (v administratorskem rozhrani).
Tahle moznost vyzaduje trochu znalosti Linuxu/Windows-Shellu a znalosti, jak pouzivat CVS.
Stazeni pluginu
Pluginy muzete stahnout bud pomoci ViewCVS prohlizece nebo stazenim vsech pluginu v jednom archivu z mirroru Netmirror.org.
Plugin je vzdy tvoren jedinym adresarem pojmenovanym ve stylu "serendipity_event_trackback" s alespon jednim souborem uvntir. Pokud pouzivate prohlizec ViewCVS, klikate na jednotlive soubory a pak na tlacitko "Download". Nejdrive vytvorte v adresari /plugins podadresar stejneho jmena jako je nazev pluginy ("serendipity_event_trackback") a do nej pak ulozte soubor(y) "serendipity_event_trackback.php".
Po stazeni a nahrani vsech souboru se prihlaste do administratorskeho rozhrani Serendipity a ve spravci pluginu uvidite na seznamu pluginu Vas prave stazeny modul. :-)
Podobny postup je pri stahovani archivu z Netmirroru. Archiv rozbalte a obsah zkopirujte do adresare /plugins.
