HELP - $section

Dołączanie Artykułów Po prawidłowym zainstalowaniu CuteNews możesz zacząć publikować swoje artykuły. Aby je wyświetlić musisz dołączyć plik show_news.php (znajdujący się w głównym folderze cutnews). Aby dołączyć show_news.php do swojej strony musisz użyć kodu takiego jak ten::

<?PHP
include("path/to/show_news.php");
?>

Musisz zastąpić path/to/show_news.php prawdziwą ścieżką do pliku show_news.php, A NIE adresem URL !!!
Przykłady:
PRAWIDŁOWO : include("CuteNews/show_news.php");
NIEPRAWIDŁOWO: include("http://site.com/CuteNews/show_news.php");

Pamiętaj, że aby prawidłowo korzystać z kodu php, rozszerzenie pliku do którego dołączasz kod musi być .php
Jeśli chcesz dołączyć kod do strony .html, zmień rozszerzenie pliku z .html na .php i wszystko będzie działać prawidłowo.

Dodatkowe Parametry Oto lista wszystkich dodatkowych parametrów, których można używać przy dołączaniu artykułów i artykułów archiwalnych:

\$category = 'X';

Parametr używany do pokazywania artykułów z konkretnej kategorii. "X" określa Id kategorii (numer kategorii).
Można używać kilka równocześnie za pomocą następującego formatu:
\$category = '1,3,5';

Domyślnie: CuteNews pokazuje wszystkie artykuły.

\$template = 'X';

Parametr używany do pokazywania artykułów przy użyciu konkretnego schematu. Schematy można dodawać/edytować w sekcji "Edycja Schematów" w panelu Opcje. "X" określa nazwę schematu. UWAGA: rozróżniana jest wielkość liter nazwy!

Domyślnie: artykuły będą wyświetlane wg schematu "Default", którego nie można usunąć.

\$number = X;

Liczba wyświetlanych artykułów. "X" należy zastąpić liczbą. CuteNews automatycznie użyje określonej liczby artykułów zarchiwizowanych, jeśli liczba aktywnych artykułów będzie mniejsza niż określona w parametrze \$number.

Domyślnie: Cutnews wyświetli wszystkie aktywne artykuły, ale nie pokaże żadnych artykułów z archiwizowanych.

\$only_active = true;

Jeśli \$number został ustawiony na liczbę większą niż liczba aktywnych artykułów, a ten parametr zostanie użyty, CuteNews nie będzie wyświetlał artykułów zarchiwizowanych by uzupełnić brakujących artykułów.

Domyślnie: nie ustawiony, CuteNews wyświetla artykuły zarchiwizowane jeśli liczna w \$number jest większa niż liczba artykułów aktywnych.

\$start_from = X;

Zaczyna wyświetlanie artykułów od podanej liczby. Aby poprawnie działało, należy zawsze używać równocześnie parametru \$number. Zastępując "X" liczbą "5" i ustawiając \$number na przykład na "5", zostaną wyświetlone artykuły od 6 do 10. UWAGA: przyciski poprzednie/następne nie działają podczas używania tego parametru.

Domyślnie: CuteNews wyświetli wszystkie artykuły od pierwszego.

\$static = true;

Dzięki temu parametrowi nie będą wyświetlane komentarze oraz Pełna Treść. Użyteczne dla Nagłówków, kiedy chcesz pokazać Pełną Treść w innym miejscu na tej samej stronie, ale chcesz pokazać listę aktywnych artykułów.

Domyślnie: nie statyczne - pokazywane są strony z pełną treścią i komentarzami.

\$PHP_SELF = 'X.php';

Parametr używany aby przekierować wszystkie odnośniki do innej strony. Użyteczny kiedy chcesz pokazać Pełną Treść na innej stronie. Na drugiej stronie należy dodać kod wstawiający artykuły w miejscu gdzie chcesz, aby były one wyświetlane. Nie należy dodawać żadnych dodatkowych parametrów (?zmienna=wartosc itp.) na końcu odnośnika - zamiast tego należy użyć parametru \$QUERY_STRING. Odnośniki poprzednie/następne również będą kierować na wskazaną stronę.

Domyślnie: artykuły są wyświetlane na stronie, na której znajduje się kod wyświetlania artykułów.

\$QUERY_STRING = 'X';

Kiedy chcesz przekierować wyświetlanie artykułu na inną stronę, ale strona ta używa dodatkowych zmiennych typu
"strona.php?zmienna1=wartosc1&zmienna2=wartosc2",
ustaw \$PHP_SELF na "strona.php", a \$QUERRY_STRING na
"zmienna1=wartosc1&zmienna2=wartosc2".

Domyślnie: Jeśli wyświetlasz artykuły na stronie
"http://www.mojadomena.pl/index.php?strona=news"
parametr \$QUERY_STRING powinien być ustawiony na "strona=news".

\$sortby = X;

"X" jest liczbą od 0 do 6, które oznaczają kolejno:
0 = sortuje wg czasu dodania (od najstarszych)
1 = sortuje wg autorów (alfabetycznie)
2 = sortuje wg tytułów artykułów (alfabetycznie) *
3 = sortuje wg Krótkiej Treści
4 = sortuje wg Pełnej Treści
5 = sortuje wg avatara
6 = sortuje wg Kategorii

* Uwaga: sortowanie wg tytułów nie działa do końca poprawnie - najpierw pojawiają się artykuły, które zaczynają się od polskich znaków diakrycznych (ł, ż itp.)

Domyślnie: od najnowszego.

\$sortbyxfield = 'NAZWA_POLA';

Sortuje pola wg dodatkowego pola utworzonego w module Konfiguracja Xfields.
Zamiast "NAZWA_POLA" należy wstawić nazwę swojego pola Xfiled.

Domyślnie: od najnowszego.

\$reverse = true;

Wyświetla artykuły od najstarszego do najnowszego. Brak parametrów konfiguracyjnych.
Zastępuje parametr "\$sortby = 0".

Domyślnie: od najnowszego.

\$author = "Author1,Author2";

Wyświetla artykuły tylko wybranych autorów.

Domyślnie: od najnowszego.

Dodatkowe parametry są opcjonalne i nie musisz ich dodawać jeśli nie chcesz.
Dołączamy je wstawiając je przed "include("path/to/show_news.php");" w następujący sposób:

<?PHP
\$number = "X";
\$template = "NAZWA";
\$static = TRUE;
\$category = "ID";
\$start_from = "NUMER";
include("path/to/show_news.php");
?>

Teraz przypuśćmy, że chcesz dołączyć artykuły więcej niż jeden raz na pojedynczej stronie. Na przykład chcesz wyświetlić 5 nagłówków (używając schematu Headlines) a pod nimi dołączyć całą resztę artykułów. Problem w tej sytuacji stanowi to, że kiedy klikniesz nagłówek CuteNews nie zrozumie gdzie chcesz wyświetlić cały artykuł - w miejscu nagłówków, czy tam gdzie znajduje się cała reszta artykułów. Rozwiązaniem jest użycie parametru $static = TRUE; przed dołączeniem nagłówków. Kiedy użyjesz tego parametru CuteNews nie wyświetli żadnych rezultatów w miejscu gdzie użyjesz $static.
Oto prawidłowy kod dołączania powyższego przykładu z nagłówkami i artykułami:

<?PHP
Nasze 5 Najnowszych Nagłówków:
\$static = TRUE;
\$number = "5";
\$template = "Headlines";
include("path/to/show_news.php");

Artykuły
include("path/to/show_news.php");
?>

Teraz kiedy klikniesz na nagłówek, pełna treść artykułu zostanie wyświetlona w miejscu reszty artykułów, a lista pięciu nagłówków wciąż będzie wyświetlana.

Zrób sam kilka testów z \$static = TRUE; aby zrozumieć jak one działają i jak bardzo mogą być użyteczne.

Poziomy Dostępu Użytkowników Dla większego bezpieczeństwa i kontroli użytkownicy zostali podzieleni na cztery rodzaje poziomów dostępu. Każdy poziom ma limitowany dostęp do pewnych opcji i nie mogą one być zmienione.
Istnieją następujące Poziomy Dostępu Użytkowników:

Administrator - administratorzy mają dostęp do wszystkich opcji: mogą edytować cudze artykuły, komentarze, banować użytkowników, zmieniać ustawienia skryptu i wszystko inne... bądź więc ostrożny przy dodawaniu użytkowników jako administratorów !!!

Edytor - użytkownicy na tym poziomie mogą dodawać własne artykuły, edytować artykuły własne i innych użytkownków. Mogą również aktywować artykuły dodane przez 'Dziennikarza'.

Dziennikarz - użytkownicy na tym poziomie mogą dodawać oraz edytować TYLKO własne artykuły! Kiedy Dziennikarz doda artykuł nie będzie on wyświetlany i będzie oznaczony jako 'Nieaktywny'. Aby mógł on być wyświetlany musi zostać aktywowany przez Administratora lub Edytora.

Komentator - kiedy użytkownicy z tego poziomu się zalogują, mogą jedynie zmienić swoje hasło. Nie mogą dodawać i edytować artykułów, ani nie mogą wykonywać żadnych innych operacji.
Jest to użyteczne kiedy użytkownik chce aby jego nazwa użytkownika była chroniona hasłem podczas dodawania komentarzy, tak by nikt inny nie mógł używać ich nazwy. Można także zabronić pisania komentarzy niezarejestrowanym użytkownikom.

Redaktor - użytkownicy na tym poziomie mogą dodawać i edytować TYLKO własne artykuły! Kiedy Redaktor doda artykuł będzie on wyświetlany i oznaczony jako 'Aktywny'. Praktycznie identyczny z Dziennikarzem, ale bez potrzeby aktywacji przez Edytora lub Administratora.

Kategorie Kiedy dodasz nową kategorię, pojawi się ona w sekcji "Dodaj Artykuł". Dzięki temu podczas dodawania artykułu będziesz mógł przypisać go do konkretnej kategorii (wybór kategorii jest opcjonalny) i dzięki temu lepiej zarządzać artykułami. Dodając kategorię musisz podać jej nazwę (i opcjonalnie URL do jej ikony). Zostanie jej automatycznie przypisany numer ID, który należy dodać do kodu strony jeśli chcesz wyświetlić artykuły TYLKO z danej kategorii.

Przykładowy kod

<?PHP
\$category = "2";
include("path/to/show_news.php");
?>

Powyższy kod PHP wyświetli wszystkie artykuły z kategorii o ID 2.

Jeśli na przykład masz 5 kategorii i chcesz na stronie wyświetlić artykuły tylko z 3 kategorii, możesz użyć następującego kodu:

<?PHP
\$category = "2,3,5";
include("path/to/show_news.php");
?>

Powyższy kod wyświetli wszystkie artykuły z kategorii o ID 2, 3 i 5.

Jeśli nie użyjesz parametru \$category = "<ID>"; CuteNews wyświetli artykuły ze wszystkich kategorii.

Ikona kategorii może być wyświetlana wraz z twoimi artykułami. Aby to zrobić musisz wstawić {category-icon} do swojego schematu wyświetlania strony.

Schematy Wyświetlania Schematy wykorzystuje się do łatwego ustawienia wyglądu wyświetlanego artykułu. Możesz przejrzeć części schematu, używane do wyświetlania różnych fragmentów swojego artykułów. Na przykład część "Aktywne Artykuły" schematu domyślnego (Default) jest wykorzystywana do modyfikowania wyglądu aktywnych artykułów, "Pełna Treść" do określania wyglądu wyświetlania pełnej treści artykułu, "Komentarze" do określenia wyglądu wyświetlanych komentarzy itd.

Podczas edycji schematu możesz używać znaczników HTML do budowy struktury wyglądu. Musisz jedynie dodać specjalne znaczniki do schematu by określić w którym miejscu ma być wyświetlany tytuł artykułu, autor, data itd.... Dostępne znaczniki są wyszczególnione nad każdym polem schematu.
Weźmy na przykład część "Artykuły Aktywne": kiedy rozwiniesz tę część, pojawi się lista dostępnych znaczników, a pod nimi pole tekstowe. Jednym z głównych znaczników jest {title}, ilekroć wstawisz go w swoim schemacie zostanie on zastąpiony przez prawdziwy tytuł artykułu.

Możesz używać więcej niż jednego schematu wyświetlania. Jest to przydatne jeśli chcesz wyświetlać artykuły na różnych stronach o różnym wyglądzie.
Po utworzeniu własnego schematu musisz użyć specjalnego parametru przy dołączaniu kodu strony by określić z jakiego schematu chcesz korzystać przy wyświetlaniu artykułów.
przykładowy kod:

<?PHP
\$template = "moj_testowy_schemat";
include("path/to/show_news.php");
?>

Z powyższym kodem, wszystkie artykuły będą wyświetlane przy użyciu schematu "moj_testowy_schemat" który sam stworzyłeś. Jeśli nie określisz z jakiego schematu chcesz korzystać, zostanie wykorzystany schemat domyślny. Schematu domyślnego (Default) nie można usunąć.

Archiwizacja Kiedy przenosisz artykułu do archiwum, CuteNews automatycznie tworzy nowy plik archiwum w katalogu ./archives/ folder z rozszerzeniem .arch . Następnie wszystkie artykuły, które zaznaczyłeś do przeniesienia do archiwum są przenoszone z pliku news.txt (gdzie znajdują się tylko aktywne artykuły) do nowo stworzonego pliku w archives/. Od tej pory artykuły w archiwum nie będą widziane przez show_news.php ale tylko przez show_archives.php gdzie wszystkie archiwa są wylistowane.

Kiedy artykuły zostaną przeniesione do archiwum nie ma możliwości automatycznego przeniesienia ich z powrotem do artykułów aktywnych. Jedynym sposobem jest ręczne otwarcie pliku archiwum i skopiowanie go do pliku news.txt.

Kiedy przeniesiesz wszystkie aktywne artykuły do archiwum nie zostanie żaden aktywny artykuł do wyświetlania, ale jeśli użyjesz parametru \$number = X; w kodzie dołączania strony, CuteNews automatycznie wyświetli X najnowszych artykułów z archiwum.

Przenoszenie artykułów do archiwum jest opcjonalne i możesz go nigdy nie używać, ale jest użyteczne jeśli masz dużo artykułów i chcesz je przeorganizować. Używanie archiwizacji jest zalecane, jeśli masz więcej niż 3000 aktywnych artykułów.

Opcje Publikowania

Podczas dodawania artykułu, masz kilka opcji które możesz wybrać do konkretnego artykułu.

Aktywny - jeśli dodajesz artykuł jako aktywny, zostanie on opublikowany natychmiast
Nieaktywny - ta opcja umożliwia dodanie artykułu, ale nie będzie on wyświetlany do chwili gdy go aktywujesz
Odroczony - jeśli chcesz aby artykuł był wyświetlany od późniejszego terminu, musisz wybrać datę określającą kiedy ma być opublikowany. Kiedy określona data nadejdzie, zostanie on automatycznie wyświetlony na stronie.

Menadżer Obrazków

Okienko pop-up w artykułach

Jeśli wybierzesz TAK - wyświetla klikalne miniaturki z artykułu w oknie pop-up, zamiast w nowym oknie.

Aby korzystać z tej opcji:

1. MUSISZ wstawić w dokumencie do którego dołączasz artykuły w sekcji head następujący kod:

2. Przekopiować do folderu w którym masz stronę wyświetlającą artykuły plik "popup.js", który znajduje się w folderze "_addons".

Okienko pop-up w oknie dodawania obrazków

Jeśli wybierzesz TAK - wyświetla podgląd obrazka w oknie pop-up, przy dodawaniu obrazka do artykułu.

Ilość obrazków na stronie

Określa ilość obrazków wyświetlanych na stronie w Menadżerze Obrazków i oknie dodawania obrazków do artykułu.

Szerokość miniaturek

Jest do domyślna szerokość tworzonych miniaturek. Można ją każdorazowo zmienić przy dodawaniu obrazka na serwer.

Format miniaturek

Proporcjonalne - obrazki wgrywane na serwer i ich miniatury zachowają swoje oryginalne rozmiary.
Kwadratowe - obrazki wgrywane na serwer i ich miniatury zostaną przycięte do formatu 1:1 (kwadrat)

Znak Wodny

Aby korzystać z opcji "znaku wodnego" należy do folderu CuteNews/data/watermark wgrać czcionkę i/lub obrazek, który będzie użyty jako "znak wodny".

UWAGA: funkcja Znak Wodny działa TYLKO w Menedżerze Obrazków dostępnego w menu OPCJE.

Xfields - Jak to działa?

Dzięki Xfields możesz dodawać do CuteNews własne pola. Są to tego samego typu pola jak "Tytuł", "URL Avatara", "Krótka Treść" czy "Pełna Treść". Dlaczego więc ta wtyczka jest tak potężna? Cóż, dzięki niemu CuteNews zyskuje więcej możliwości.

Na przykład: Jeśli pisujesz recenzje wydawanych gier, potrzebujesz stałego miejsca na zrzuty ekranu, ale nie chcesz ich wstawiać za każdym razem w kodzie HTML, możesz stworzyć dla nich pole Xfields. Możesz po prostu wstawić kod zrzutów ekranu do swojego schematu i w polu Xfield wstawiać tylko nazwę obrazka. Dzięki temu będzie to dużo prostsze.

Kolejny przykład: Jeśli masz stronę w dwóch językach a chcesz używać tylko jednego postu za każdym razem w dwóch językach, możesz użyć XFields. Utwórz jeden lub dwa pola tekstowe i dodatkowe pole Tytuł. Teraz użyj ich w dwóch różnych schamtach. Na swojej stronie użyj różnych schematów i otrzymasz artykuły w odpowiednim języku.

UWAGA: Przy korzystaniu z pól Xfields nie oznaczonych "opcjonalnie" zalecane jest przełączenie sposobu wyświetlania Kategorii na stronie Dodaj Artykuł (Opcje -> Ustawienia Systemu -> Artykuły -> Pokazuj Listę Wyboru Kategorii ustawiamy na NIE).

Wtyczkę stworzył SMKiller2.

Xfields - Konfiguracja

Oto pola, które należy wypełnić edytując lub dodając nowe pole Xfields:

Nazwa: Wewnętrzna nazwa pola używana przez XFields. Powinna być unikalna dla każdego pola i nie powinna być wyświetlana.

Opis: Opis pola, który pojawi się w sekcji Dodaj Artykuł i Edytuj Artykuł.

Kategoria: Wybierz w jakiej Kategorii ma się pojawić to pole. Jeśli wybierzesz "wielokrotne" pojawi się dodatkowe pole gdzie możesz wpisać ID kilku kategorii (oddzielając je przecinkami).

Typ: Wybierz zachowanie pola. Możesz wybrać trzy rodzaje pól.

Domyślna Zawartość: To pole pojawi się tylko wtedy, gdy wybierzesz jako typ pola "Pojedyńcza Linia" lub "Pole Tekstowe". Możesz Wpisać tu domyślną zawartość tego pola.

Opcje: To pole pojawi się tylko wtedy, gdy wybierzesz jako typ pola Rozwijalna Lista". Możesz wstawić wszystkie opcje wyboru do tego pola (każde w pojedynczej lini). Nie możesz użyć dwóch jednakowych opcji.

Opcjonalne: To pole pojawi się tylko wtedy, gdy wybierzesz jako typ pola "Pojedyńcza Linia" lub "Pole Tekstowe". Możesz wybrać czy pole musi być wypełnione, czy może zostać puste.

HTML; // XFields v2.1 - addblock $help_sections["Xfields Configurating Templates"] = <<

Xfields - Schematy Wyświetlania

Aby używać swoich danych w polach Xfield w swoich schematach, użyj następujących znaczników:

[xfvalue_NAME]: To wyświetli treść pola Xfield o nazwie NAME (nazwa użyta w polu NAZWA, a nie ta użyta w polu OPIS!).

Np.

Mój obecny nastrój to: "[xfvalue_nastroj]".

wyświetli:

Mój obecny nastrój to: "szczęśliwy".

kiedy wypełnisz w artykule odpowiednie pole Xfield.
Jednak jeśli pole jest opcjonalne i nic do niego nie wpiszesz, wyświetli się:

Mój obecny nastrój to: "".

[xfgiven_NAME]...[/xfgiven_NAME]: Opcjonalne wyświetlanie treści pola Xfield. Pokaże kod pomiędzy znacznikami tylko wtedy, gdy pole Xfield będzie zawierało treść. W innym wypadku nie wyświetli się nic.

Np.

[xfgiven_mood] Mój obecny nastrój to: "[xfvalue_mood]". [/xfgiven_mood]

wyświetli:

Mój obecny nastrój to: "szczęśliwy".

kiedy wypełnisz w artykule odpowiednie pole Xfield. Jeśli nic do niego nie wpiszesz, nie wyświetli się nic.

Wtyczkę stworzył SMKiller2.

HTML; $help_sections["textile"] = <<

Textile 2

Format Textile 2 pozwala formatować pisany tekst w uproszczony sposób, który jest przy wyświetlaniu zmieniany na kod HTML. Aby go używać należy korzystać z następujących znaczników:

NAGŁÓWKI I BLOKI TEKSTU

h1. - Nagłówek <H1> ... </H1>
h2. - Nagłówek <H2> ... </H2>
h3. - Nagłówek <H3> ... </H3> itd...
p. - Paragraf <p> ... </p> (aby znacznik został zamknięty należy pod linią tekstu zostawić pustą linijkę!)
bq. - Blok tekstu <blockquote> ... </blockquote>

STYLE TEKSTU

_emphasis_ - Tekst pochylony <em> ... </em>
*strong* - Tekst pogrubiony <strong> ... </strong>
??citation?? - Cytat <cite> ... </cite>
-deleted text- - ~~Tekst usunięty~~ <del> ... </del>
+inserted text+ - Tekst dodany <ins> ... </ins>
^superscript^ - ^{Indeks górny} <sup> ... </sup>
~subscript~ - _{Indeks dolny} <sub> ... </sub>
%span% - Znacznik span: <span> ... </span>
TJA(To Jest Akronim) - Akronim: TJA (podświetlana treść po najechaniu myszką)

LISTY

Lista Numerowana:
format: # jeden # dwa # trzy	wynik: jeden dwa trzy
Lista :Wypunktowana
format: * jeden * dwa * trzy	wynik: jeden dwa trzy
Lista Wielopoziomowa:
format: # jeden ## aaaa ## bbbb ## cccc # dwa ## aaaa # trzy	wynik: jeden aaaa bbbb cccc dwa aaaa trzy
Lista Mieszana:
format: * punkt pierwszy * punkt drugi ## krok pierwszy ## krok drugi ## krok trzeci * punkt trzeci podpunkt pierwszy podpunkt drugi	wynik: punkt pierwszy punkt drugi krok pierwszy krok drugi krok trzeci punkt trzeci podpunkt pierwszy podpunkt drugi

LINK I OBRAZEK

"tekst odnośnika":url_odnośnika - odnośnik np.: "Google":http://www.google.pl
!/folder/obrazek.gif(opcjonalny tekst odnośnika)! - wstawianie obrazka

INNE ZNACZNIKI

Można również wstawiać normalne znaczniki HTML takie jak <pre>, <code>, <em> itd.

Pełną informację i przykłady użycia można znaleźć TUTAJ.
UWAGA: nie wszystkie znaczniki Textille (tabele, style, klsay, ID...) są obecnie obsługiwane w CuteNews!

HTML; $help_sections["textile2"] = <<

Kalendarz

Instalacja Kalendarza

1. Otwórz swój plik z artykułami (news.php lub blog.php lub index.php lub ...) i wstaw na początku pliku:

<?php
include('sciezka_do_CuteNews/calendar.php'); //Zamień 'sciezka_do_CuteNews' na odpowiednią ścieżkę do pliku.
?>

(Ścieżka ta jest identyczna z tą zawartą w kodzie dołączania artykułów Cutnews. Możesz ją po prostu skopiować, zamieniając 'show_news.php' na 'calendar.php').

2. Wstaw poniższy kod w miejsce, gdzie chcesz wyświetlić jednomiesięczny kalendarz:

<?php
calendar_single(\$news = true, \$archives = true, \$categories = false, \$cal_string = "x=y");
?>

Opis parametrów:

\$news = true //Pokazuje aktywne artykuły w kalendarzu.

\$news = false //Ukrywa aktywne artykuły w kalendarzu.

\$archives = true //Pokazuje zarchiwizowane artykuły w kalendarzu.

\$archives = false //Ukrywa zarchiwizowane artykuły w kalendarzu.

\$categories = false //Pokazuje artykuły ze wszystkich kategorii i artykuły nie przyporządkowane do żadnej kategorii.

\$categories = '1,3,4' //Pokazuje artykuły tylko z kategorii 1, 3 i 4.

(Wyświetlając artykuły z konkretnej kategorii upewnij się, że dodałeś $calendar_category = "x"; do swojego kodu wyświetlania artykułów. Więcej w punkcie 4.)

\$cal_string = "x=y" //Dodatkowe zmienne dołączane do strony. Użycie jak w \$QUERY_STRING = 'X';

3. Wstaw poniższy kod w miejsce, gdzie chcesz wyświetlić pełen kalendarz:

<?php
calendar_list(\$month_per_line = '3', \$news = true, \$archives = true, \$categories = false, \$start_year = false);
?>

Opis parametrów:

\$month_per_line = 'x' //Liczba pojedyńczych miesięcy w jednej linii.

\$news = true //Pokazuje aktywne artykuły w kalendarzu.

\$news = false //Ukrywa aktywne artykuły w kalendarzu.

\$archives = true //Pokazuje zarchiwizowane artykuły w kalendarzu.

\$archives = false //Ukrywa zarchiwizowane artykuły w kalendarzu.

\$categories = false //Pokazuje artykuły ze wszystkich kategorii i artykuły nie przyporządkowane do żadnej kategorii.

\$categories = '1,3,4' //Pokazuje artykuły tylko z kategorii 1, 3 i 4.

\$start_year = false //Pokazuje wszystkie artykuły w kalendarzu począwszy od roku w którym zamieszczono pierwszy artykuł

\$start_year = '2005' //Pokazuje kalendarz od podanego roku nawet jeśli nie było żadnych artykułów w danym roku.

(Wyświetlając artykuły z konkretnej kategorii upewnij się, że dodałeś \$calendar_category = "x"; do swojego kodu wyświetlania artykułów. Więcej w punkcie 4.)

4. Dodaj poniższy parametr do swojego Kodu Dołączania Artykułów:

\$show_calendar = true;

Jeśli chcesz wyświetlać artykuły tylko z konkretnych kategorii (używając np. \$categories = "1, 3, 4" w punkcie 2 i punkcie 3) upewnij się, że dodałeś następujący parametr do Kodu Dołączania Artykułów:

$calendar_category = "1,3,4";

Dzięki temu upewnisz się że tylko artykuły z podanych kategorii będą pokazywane, gdyż w wybranym dniu mogą być artykuły z innych kategorii lub bez kategorii.
Rozsądnie jest podać te same kategorie w punktach 2 i 3. Jeśli w krokach 2 i 3 nie sprecyzowałeś kategorii ($categories = false) nie dodawaj parametru $calendar_category do Kodu Dołączania Artykułów.

Jeśli chcesz użyć specjalnego schematu wyświetlania rezultatów z kalendarza dodaj do Kodu Dołączania Artykułów następujący parametr:

if(\$subaction == 'showcalendar') \$template = 'nazwa_schematu_kalendarza';

5. Aby dodać style możesz użyć następujących klas w swoich plikach css.

klasy css dla pojedyńczego miesiąca:

.calendar_table{ }
.first_row{ }
.prev_link{ }
.center_column{ }
.next_link{ }
.second_row{ }
.weekday_names{ }
.weekend_names{ }
.calendar_row{ }
.empty_cell{ }
.weekday{ }
.weekend{ }
.news_day{ }

klasy css dla całego kalendarza:

.list_table{ }
.year_cell{ }
.list_row{ }
.list_cell{ }

6. Jak pokazać listę wybieralną kategorii pokazywanych w kalendarzu:

Dodaj coś takiego na stronie aby pokazać cały kalendarz i listę wybieralną nad nim:

category_dropdown().'<br />'.calendar_list(\$month_per_line = '3', \$news = true, \$archives = true, (\$_POST ? \$categories = \$_POST['drop_cat'] : \$categories = false));
Dodaj poniższą linijkę do Kodu Dołączania Artykułów:

if(\$_GET['drop_cat']) \$calendar_category = \$_GET['drop_cat'];
else \$calendar_category = false;

HTML; /* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Load the specified section in PopUp Window ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */ if(isset($section)){ if(!isset($help_sections["$section"])){ die("Can not find the specified section $section"); } echo" HELP - $section ". $help_sections["$section"] ." "; } else{ echoheader("question", "Pomoc"); echo"

"; foreach($help_sections as $help_section){ echo"$help_section
do góry

"; } echo"

"; echofooter(); } ?>