Comments Ex Official Website - UNDER CONSTRUCTION
Choose your language: Polski | English
Główna | Dokumentacja | Pobierz | Błędy | Pomoc | Autorzy

Wstęp

Poniżej przedstawiam krótką dokumentację, która przedstawia opisy wszystkich funkcji modułu. Dokumentacja z biegiem czasu będzie rozszerzana, a tymczasem opis będzie ogólny z podanymi przykładami.

Funkcje index.php

killhtml(tekst)
Funkcja zamienia tagi html na znaki. Administrator pomimo tego może używać tagów. Przykład użycia funkcji:
killhtml('<a href="http://www.google.pl">link</a>');
Można także umożliwić podpięcie wtyczek (np. bbcode, bbsmiles). Wtedy tagi używane przez wtyczki nie są filtrowane. Przykład:
pnVarPrepForDisplay(killhtml($comment));
getAvatar(nick)
Funkcja pobiera id użytkownika z jego nicku, a później avatar z uzyskanego id. Przykład użycia funkcji:
getAvatar($name);
modtwo(id, punkty, poziom)
Funkcja była używana podczas moderacji komentarzy. Obecnie została wycofana z użycia.
modthree(id, tryb, sortowanie, $thold=0)
Funkcja pokazująca przycisk "moderuj" (została wycofana z użycia tak jak funkcja powyżej). navbar(atrybuty)
Funkcja ta ma na zadanie wyświetlić nagłówek komentarzy, ich ilość, przycisk "wyślij komentarz" itp. Szablon można zmodyfikować w pliku "header.html".
DisplayKids(id, tryb, sortowanie, $thold=0, poziom, $dummy=0)
Funkcja wyświetla główne komentarze wraz z ich odpowiedziami. Szablon dla komentarza to "comment1.html", dla odpowiedzi "comment_reply.html".
DisplayBabies(id, poziom, $dummy=0)
Funkcja wyświetla komentarze drugiego poziomu wraz z ich odpowiedziami. Szablon znajduje się w pliku "comment_link.html".
DisplayTopic(info, id, id_komentarza, id_tematu, tryb, sortowanie, $thold=0, poziom, blokady)
Funkcja wyświetla temat danego komentarza.
singlecomment(info, id, id2, tryb, sortowanie, $thold)
Funkcja wyświetla pojedyńczy komentarz. Szablon znajduje się w pliku "comment3.html".
reply()
Zadaniem tej funkcji jest wyświetlić pełny formularz odpowiedzi (po naciśnięciu "wyślij komentarz" lub "odpowiedz na to"). Jej szablon znajduje się w pliku "fullreply.html". Użycie funkcji jest proste:
reply();
Powyższy kod spowoduje wyświetlenie pełnego formularza odpowiedzi. Szablon pełnej odpowiedzi można zmienić w pliku "fullreply.html".
replyPreview()
Funkcja ta pozwala na podgląd komentarza.
CreateTopic()
Funkcja ta tworzy temat podany w komentarzu.
QuickReply()
Funkcja ta wyświetla szybką odpowiedź.

Funkcje tpl.php

Plik "tpl.php" ma jedną funkcję:
zamieniajtemp(plik) Funkcja ta wczytuje treść wybranego pliku, analizuje ją i zamienia znaczniki na kod php. W wyniku wszystkie znaczniki w szablonach komentarzy zostaję zamienione, a co za tym idzie wyświetlane są komentarze.