Boty: Paginacja Zmieniony 24.02.2009. Bot Paginacja [MOS Paging] dzieli då uå¼sze artykuå y na czä Å ci wyå wietlane na kolejnych stronach i generuje dla artykuå ów wieloczä Å ciowych spisy treå ci. UżytecznoÅ Ä dodatku Bot Paginacja [MOS Paging] jest rozszerzeniem komponentu ArtykuÅ y [Content]. Dodatek umoå¼liwia: - podziaå då uå¼szych artykuå ów i materiaå ów statycznych na strony, - nadawanie tytuå ów kolejnym stronom i ich numerowanie, - wyå wietlanie w podzielonych na strony artykuå ach i materiaå ach menu nawigacyjnego - spisu treå ci, - umieszczanie w znaczniku title dokumentu HTML tytuå ów stron. Zadanie bota Rola bota polega na wyszukaniu w treå ci specjalnego znacznika - {mospagebreak} - i wstawieniu w jego miejscu znacznikã³w podziaå u na strony, tytuå ów i numeracji, paskã³w nawigacyjnych, generowaniu URL do poszczegã³lnych stron oraz wpisu w znaczniku title wynikowego dokumentu HTML. Typ Bot naleå¼y do grupy oddziaå ujä cych na treå Ä - content. Jego pliki - mospaging.xml i mospaging.xml - winny byä umieszczone w folderze /mambots/content. Stosowanie dodatku Aby dokonaä jedynie podziaå u då uå¼szych materiaå ów na strony, wystarczy w miejscach podziaå u wstawiä znacznik {mospagebreak}. Aby dodatkowo generowaä tytuå y stron i spis treå ci, speå niajä cy rã³wnoczeå nie funkcjä menu nawigacyjnego artykuå naleå¼y: - uzupeå niä znacznik {mospagebreak} o atrybuty, - w konfiguracji globalnej witryny ustawiä opcjä Paginacja - spisy treå ci na Pokaż. Atrybuty znacznika Atrybutami znacznika sä tytuå y - pierwszej strony i kolejnych. W miejscu, w ktã³rym chcesz rozpoczä Ä kolejnä czä Å artykuå u, wpisz jeden z poniå¼szych ciä gã³w, zmieniajä c odpowiednio treå Ä atrybutu:
- {mospagebreak} albo - {mospagebreak heading=pierwsza strona} albo - {mospagebreak title=kolejna strona} albo - {mospagebreak title=kolejna strona&heading=pierwsza strona} albo - {mospagebreak heading=pierwsza strona&title=kolejna strona} Znaczenie atrybutã³w jest nastä pujä ce: - title - pozycja spisu treå ci (Å rã³dtytuå ). Wpisz zwiä zå y tekst, ktã³ry bä dzie w tabelce ze spisem treå ci Å Ä czem do t artykuå u (tutaj przykå adowo: Kolejna strona). - heading - nagå ówek (tytuå wprowadzenia). Wpisz zwiä zå y tekst tytuå u dla pierwszej strony, ktã³ry bä dzie Å Ä czem poczä tku artykuå u (tutaj przykå adowo: Pierwsza strona). Jako tytuå u pierwszej strony najlepiej uå¼yä nazwy artykuå u lub materiaå u statycznego. Spis treå ci Generowanie spisu treå ci artykuå ów i materiaå ów wielostronicowych zaleå¼y od ustawienia parametru Paginacja - spisy treå ci [Table of Contents on multi-page items] w konfiguracji globalnej. O sposobie wyå wietlania tabelki ze spisem treå ci decydujä deklaracje klasy.contenttoc w arkuszu stylã³w CSS. Wyedytuj wiä c swã³j arkusz stylã³w CSS - i zdefiniuj odpowiednio klasä.contenttoc. Przycisk Podziel stronä Korzystanie z dodatku uå atwia inny dodatek - przycisk Podziel stronä [MOS Pagebreak] w edytorze tekstu. Możesz kliknä Ä naå, aby do tekstu artykuå u zostaå a wpisana instrukcja sterujä ca {mospagebreak}. Potem wystarczy do niej dop atrybuty. NiezbÄ dne ustawienia Aby bot speå niaå swe funkcje, musi byä opublikowany, czyli wå Ä czony. Istalator Joomla! standardowo wå Ä cza ten dodatek oraz ustawia domyå lne wartoå ci jego parametrã³w. Zwykle nie ma wiä żadnej potrzeby edycji jego wå aå ciwoå ci. JeÅ li jednak chcesz, moå¼esz dokonaä zmiany niektã³rych cech dodatku. MożliwoÅ ci opisane zostaå y w sekcji Konfiguracja bota. Konfiguracja bota Wszystkie wå aå ciwoå ci konfiguracyjne bota moå¼na edytowaä w menedå¼erze: Dodatki: Edytuj - Paginacja [MosPaging]. PrzeglÄ d
Otwarcie strony menedå¼era blokuje moå¼liwoå Ä edycji cech dodatku przez innych administratorã³w. Opuszczenie strony bez zachowania zmian lub skorzystania z przycisku Anuluj ma taki sam skutek. Dopóki nie opuå cisz okna wå aå ciwoå ci dodatku, niedostä pne sä rã³wnieå¼ opcje menu administracyjnego. Joomla! wyå Ä cza je, aby zapobiec nagå emu opuszczenu okna i zablokowaniu dodatku. Aby opuå ciä okno edycji, korzysta przyciskã³w dostä pnych w pasku narzä dzi. Nie korzystaj z przycisku Wstecz przeglä darki! Pasek narzä dzi znajduje siä w prawym gã³rnym rogu okna. Poni?ej, w obszarze roboczym znajduje siä dwuczä Å ciow formularz wå aå ciwoå ci dodatku. Po stronie lewej - wå aå ciwoå ci ogã³lnych, zwanych detalami dodatku, po prawej - parametrã³w. JeÅ li dodatek nie wymaga ustawiania parametrã³w, znajdziesz tam stosowny komunikat. Publikacja Aby bot speå niaå swe funkcje, musi byä opublikowany, czyli wå Ä czony. Instalator Joomla! standardowo wå Ä cza ten dodatek oraz ustawia domyå lne wartoå ci jego parametrã³w. Zwykle nie ma wiä c żadnej potrzeby edycji jego wå aå ciwoå ci. JeÅ li jednak chcesz, moå¼esz dokonaä zmiany niektã³rych cech dodat MożliwoÅ ci opisane zostaå y poniå¼ej. O edytorze bota Wszystkie wå aå ciwoå ci konfiguracyjne bota moå¼na modyfikowaä w edytorze: Boty: Ocenianie [Voting]. Otwarcie strony edytora blokuje moå¼liwoå Ä edycji cech bota przez innych administratorã³w. Opuszczenie edytora bez zachowania zmian lub skorzystania z przycisku Anuluj rã³wnieå¼ skutkuje blokowaniem elementu do edycji. Aby zapobiec nagå emu opuszczeniu edytora i zablokowaniu bota wyå Ä czone sä opcje menu administracyjnego. Ale inne standardowe narzä dzia panelu administracyjnego sä aktywne - Åšcieżka powrotu, moduå y poczty, moduå Wyloguj. Nie naleå¼y z nich korzystaä podczas edycji wå aå ciwoå ci bota. Z tych samych powodã³w nie naleå¼y korzystaä przycisku Wstecz przeglä darki!. Pasek narzä dzi znajduje siä w prawym gã³rnym rogu okna. Poniżej, w obszarze roboczym znajduje siä dwuczä Å cio formularz wå aå ciwoå ci dodatku. Po stronie lewej - wå aå ciwoå ci ogã³lnych, zwanych detalami, po prawej - parametrã³w. JeÅ li dodatek nie wymaga ustawiania parametrã³w, znajdziesz tam stosowny komunikat. Pasek narzä dzi W pasku narzä dzi znajdujä siä 4 przyciski. Ich funkcje sä nastä pujä ce: Zapisz [Save]: Zachowuje wprowadzone zmiany. KoÅ czy pracä w edytorze bota. Odblokowuje bota do edycji przez innych administratorã³w. Kliknij ten przycisk, aby zakoå czyä edycjä wå aå ciwoå ci bota i powrã³ciä do menedå¼era. Zastosuj [Apply]: Umożliwia zapisanie efektã³w pracy bez opuszczania edytora bota. JeÅ li edycja trwa då uå¼ej niå¼ domyå lny czas trwania sesji, chroni przed automatycznym wylogowaniem i utratä niezapisanych danych. Kliknij ten przycisk, aby zapisaä dotychczas wprowadzone zmiany. Potem moå¼esz kontynuowaä pracä lub opuå ciä edytor, wydaj polecenie Zapisz lub Anuluj. Anuluj [Cancel]: Umożliwia opuszczenie edytora bota bez zapisywania zmian wprowadzonych po ostatnim ich zachowaniu. Odblokowuje bota do edycji przez innych administratorã³w. Kliknij ten przycisk, aby zakoå czyä edycjä wå aå ciwoå ci bota i powrã³ciä do menedå¼era. Wszystkie zmiany wprowadzone po ostatnim uå¼yciu przycisku Zastosuj zostanä utracone. Pomoc [Help]: WywoÅ uje okno pomocy podrä cznej, objaå niajä cej wå aå ciwoå ci bota i znaczenie opcji dostä pnych w
edytorze. Korzystaj z tego przycisku, ilekroä potrzebujesz objaå nieå na temat wå aå ciwoå ci edytowanego elementu. SzczegóŠy dodatku Każdy bot charakteryzuje siä 7 podstawowymi wå aå ciwoå ciami. Znaczenie i sposã³b definiowania wå aå ciwoå ci omã³wiono poniå¼ej: - Nazwa [Mambot Name]: Nazwa widoczna jest tylko w panelu administracyjnym. Nie jest uå¼ywana do rozpoznawania dodatku przez Joomla!. Możesz jä dowolnie zmieniaä lub pozostawiä bez zmian. Wpisz dowolny, ale objaå niajä cy rolä dodatku tekst. - Folder [Folder]: Oznacza typ bota. Wskazuje, w ktã³rym z folderã³w katalogu /mambots umieszczone sä jego pliki. Bot Ocenianie naleå¼y do typu content. Jego pliki winny byä umieszczone w folderze /mambots/content - Plik dodatku [File]: Nazwa pliku zawierajä cego gå ówny skrypt bota (bez rozszerzenia.php). W przypadku, gdy edytujesz wå aå ciwoå ci zainstalowanego bota, nie zmieniaj tej nazwy! - KolejnoÅ Ä [Order]: KolejnoÅ Ä uaktywniania funkcji opublikowanego bota, a nie tylko w wykazie!. Możesz zmieniä jedynie uporzä dkowanie botã³w w granicach jednego typu. Aby ustaliä kolejnoå Ä, kliknij nazwä bota, przed ktã³rym chc umieå ciä dodatek aktualnie edytowany. JeÅ li boty dziaå ajä poprawnie, ich kolejnoå Ä naleå¼y pozostawiä bez zmian!. KolejnoÅ ci niektã³rych botã³w nie moå¼na zmieniä. - Uprawnienia [Acces Level]: Wybór jednej z grup ustala prawa do korzystania z funkcji bota. Dysponujesz trzema opcjami: - Public - dostä p publiczny: funkcje opublikowanego bota bä dä dostä pne dla wszystkich uå¼ytkownikã³w, - Registered - dostä p ograniczony dla zarejestrowanych: funkcje opublikowanego bota bä dä dostä pne tylko dla zalogowanych uå¼ytkownikã³w, - Special - dostä p ograniczony specjalny: funkcje opublikowanego dodatku bä dä dostä pne tylko dla zalogowanych uå¼ytkownikã³w z uprawnieniami specjalnymi - autorã³w, redaktorã³w, wydawcã³w, operatorã³w i administratorã³w. Prawa dostä pu uå¼ytkownikom w menu Witryna Użytkownicy [Site User Manager]. - Opublikowany [Published]: Tak wå Ä cza funkcje bota, Nie wyå Ä cza dziaå anie. - Opis [Description]: Opis funkcji bota i instrukcje objaå niajä ce sposã³b korzystania z dodatku. TreÅ Ä opisu pobierana jest z pliku.xml dodatku z sekcji description. Parametry W dodatku Paginacja moå¼na zmodyfikowaä jeden parametr: - TytuÅ witryny [Site Title]: Decyduje o doå Ä czeniu do tytuå u witryny w znaczniku title wynikowego dokumentu HTML tytuå
pierwszej strony lub srã³dtytuå ów. Parametr domyå lnie jest ustawiony na Tak. Można zmieniä to ustawienie. Tematy pokrewne Zapoznaj siä z artykuå ami - TreÅ ci witryny: Boty - Boty: menedå¼er - Boty: edytor - MateriaÅ y - ArtykuÅ y: edytor - Konfiguracja globalna - Przycisk: Podziel stronä, Uwagi, źródÅ a Jeżeli masz sugestie odnoå nie treå ci lub chcesz zgå osiä poprawki do tego rozdziaå u, skomentuj go albo umieå Ä wiadomoå Ä na forum: Dokumentacja - Propozycje, zmiany, poprawkidziä kujemy!stefan Wajda, ZespóŠDokumentacji PC