|
Programowanie / Moduł komentarzy dla Quick.CMS'a
Moduł komentarzy dla Quick.Cmsa
Skrypty można pobrać tutaj: skrypty komentarzy.
Ogólne info:
Moduł posiada następujące funkcje:
- operuje na plikach txt,
- umożliwia selektywne wyłączanie komentarzy w wybranych artykułach (za pomocą wpisów w plikach txt),
- formularz komentowania jest chroniony antyspamem,
- moderowanie jest możliwe za pomocą plików txt.
Założenia i ograniczenia
- Moduł komentarzy pisałem do wersji Quick.cms v.2.4. Czy będzie pasował do innych? Nie wiem. Sądzę, że tak, bo nie ingeruje w bieżącą funkcjonalność ale dokłada własne funkcje. Co najwyżej kod trzeba będzie wstawić w inne miejsce w pliku, lub do innego pliku.
- Instalacja modułu zakłada, że Quick.CMSa masz zainstalowanego w głównym katalogu na swoim koncie hostingowym (w głównym katalogu ftp). Tzn. ze cms jest pod adresem: www.twojadomena.pl a nie pod adresem www.twojadomena.pl/jakiskatalog . Oczywiście w tym drugim przypadku także da się zainstalować komentarze, ale trzeba będzie zmienić ścieżki w kilku miejscach.
- Zakładam, że umiesz edytować pliki html, php, etc., lub choćby umiesz dokładnie przeczytać i zrobić to co poniżej zostało napisane.
- Nie można korzystać z funkcji dzielenia artykułu na kilka podstron! Moduł nie został przystosowany do artykułów mieszczących się na wielu stronach. Pamiętaj - jeśli chcesz używać mojego modułu musisz artykuły mieć na jednej stronie! Inaczej powstaną głupie błędy!
- System może nie zadziałać gdy Twój plik komentarzy przekroczy ilość pamięci ram przypisaną do pojedynczej sesji php na serwerze www (można to sprawdzić za pomocą php-info).
Opis działania.
Działanie jest proste:
- Wyciągam z adresu strony numer artykułu i na jego podstawie sprawdzam jaki plik komentarzy jest mu przypisany.
- Analizuje, czy dla danego artykułu komentarze nie zostały zablokowane i kończę przetwarzanie lub jeśli komentarze są dozwolone - kontynuuje.
- Jeśli pliku komentarzy nie ma - tworze go! Jeśli jest - wyświetlam plik.
- Następnie wyświetlam formularz dodawania komentarzy.
- Koniec :)
Instalacja
- Dokładnie przeczytaj wszystko co jest napisane poniżej i powyżej nt. Tego modułu. Upewnij się, że punkty zawarte w "Założeniach i ograniczeniach" nie kolidują z Twoim systemem. Jeśli trzeba - popraw to.
- Ściągnij paczkę ze skryptami i rozpakuj ją na swoim komputerze.
- Katalog "modules_p" wgraj za pomocą programu ftp na konto www - tam gdzie masz zainstalowanego quick.cmsa. Założenia były takie że jest on zainstalowany w głównym (najwyższym) katalogu Twojego konta www.
- Katalogowi "modules_p" nadaj prawa 777. Pamiętaj także o podkatalogach i plikach w nim zawartych.
- Plik komentarze.inc skopiuj do istniejącego już katalogu "core".
- W kilku następnych krokach trzeba edytować istniejące pliki Twojego cmsa - wykonaj je krok po kroku, pamiętając o każdorazowym stworzeniu kopii zapasowych:
- plik "index.php" w głównym katalogu konta www:
dodaj 3 linijki:
$izapis_form = zapis_form();
$ikomentarz = koment();
$iformularz = formularz();
Linijki te należy dodać po linijce: ob_start('changeCharset'); około linijki nr. 44
Tak to powinno wyglądać:
- plik "pages_default.tpl" w katalogu "templates" -
do linijki nr 9 zawierającej tekst: $sPages dopisujemy tekst:
$ikomentarz $iformularz $izapis_form
a wiec linijka ta będzie miała postać:
$sPages $ikomentarz $iformularz $izapis_form
Tak to powinno wyglądać:
- plik "common.php" w katalogu "core" przed ostatnią linią (przed znakami "?>")dopisujemy: include 'komentarze.inc';
Tak to powinno wyglądać:
Koniec instalacji!
Obsługa
Jak już zapewne część z Was sie zorientowała w katalogu modules_p/comments są pliki w których zawarte są (lub będą) Wasze oczekiwane komentarze.
Moderacja komentarzy odbywa się poprzez edycje tych właśnie plików (np. za pomocą klienta ftp).
Nazwa pliku tekstowego zawierającego komentarze jest ściśle powiązana z konkretnym wpisem (stroną) w CMSie. I tak np. Plik komentarzy 6.txt odpowiada adresie strony www.twojadomena.pl/?namioty,6. Natomiast plik 16.txt odpowiada stronie www.twojadomena.pl/?wysokie,16, itd.
A co z sytuacja gdy dla danej strony chcemy wyłączyć komentarze?
W konkretnym pliku tekstowym wpisujemy słowo "block". Musi być ono na samej górze w pliku, ponieważ skrypt czyta pierwsze 5 znaków. Jeśli znaki te tworzą wyraz "block" komentarze na tej stronie są wyłączone.
Domyślnie wyłączone są komentarze na stronie 1 i 7 i odpowiadają adresom:
- www.twojadomena.pl/?pl_o-firmie,1 (ponieważ jest to strona tytułowa i komentarze nie są tam moim zdaniem potrzebne),
- www.twojadomena.pl/?pl_obuwie,7 (ponieważ jest to strona spisu kategorii a spisów się z reguły nie komentuje).
Oczywiście, które strony będą umożliwiały komentarze zależy tylko od Ciebie. Zarządzaj nimi manipulując plikami tekstowymi i ich zawartością, poprzez wpisanie słowa "block" na początku.
Uwaga - jeśli do jakiejś strony nie ma jeszcze pliku tekstowego komentarzy, to skrypt sam go wygeneruje (pod warunkiem, że zrobiłeś wszystko tak jak wyżej opisałem!).
Gdyby coś nie działało, sprawdź wszystko co pisałem powyżej. Zwróć uwagę na prawa katalogów oraz poszczególnych plików komentarzy - to główna przyczyna problemów.
Licencja
Powyższe skrypty możesz bez ograniczeń używać. Byłoby miło gdybyś mnie o tym poinformował, pisząc maila.
Co dalej?
Czy będę rozwijał ten projekt? Nie sądzę, no chyba ze znajdziecie jakieś kompromitujące mnie błędy, to być może je poprawie. Być może!
|
|