English

Polish

Russian

Donate

Forum

yvComment

v.1.23.0, (0.1Mb) ostatnia zmiana: 2009-07-12. Co nowego? (in English) Pobierz yvComment: JoomlaCode, local file (rozpakuj przed instalacją).

Spis treści:

Opis skrócony

yvComment jest pierwszym dedykowanym dla Joomla! 1.5 Rozbudowanym rozwiązaniem do komentarzy , które jest darmowe.
Do prawidłowego działania wymaga się instalacji dwóch 'części' (rozszerzeń): komponentu + dodatku, - oraz kilku rozszerzeń opcjonalnych, takich jak modułu yvComment czy 29 wersji językowych yvComment, więc wynik Twoich działań może być bardzo prosty lub wręcz przeciwnie - stosownie do Twoich wymagań.
yvComment wykorzystuje następujące rozszerzenia: CAPTCHA (ukryte słowa), uśmieszki, kody BB (ang. BBcodes), awatary / grawatary, edytor WYSIWYG oraz inne dodatki i narzędzia przystosowane do pracy z artykułami środowiska Joomla! (por. GeSHi). yvComment pozwala użytkownikom na dodawanie komentarzy do artykułów (jak również komentowanie kometarzy). Komentarze mogą być przechowywane w tej samej tablicy, co inne treści (i traktowane jak specjalny rodzaj artykułu) lub w osobnej tablicy przeznaczonej tylko do tego celu.

yvComment został napisany od podstaw z myślą o środowisku Joomla! 1.5 i nie jest zgodny z wcześniejszymi wersjami Joomla!/Mambo. Jest zintegrowany z jądrem Joomla!; służy do poszerzenia jego możliwości a nie do jego powielania.

 Warunki stosowania: Copyright (C) 2007-2008 Yuri Volkov, Moskwa, Rosja.
To oprogramowanie jest wolne (od wolności); możesz je rozpowszechniać i/lub zmieniać pod warunkiem, że spełnisz wymagania ogólnej publicznej licencji GNU, wersja 2, wg wydania Free Software Foundation. To oprogramowanie jest rozpowszechniane z nadzieją, że okaże się przydatne, ale BEZ JAKIEJKOLWIEK GWARANCJI; bez implied warranty of MERCHANTABILITY lub stosowalności do konkretnego celu. Szzegóły znajdziesz w Ogólnej Publicznej Licencji GNU.

Strony demo: Znalazłem kilka stron, które wykorzystują yvComment (niektóre odnośniki mogą nie działać...): fenster.joomlaportal.ch; JoomlaCMS.dk; www.tricountyweb.com. Dalsze przykłady możesz znaleźć posługując się wyszukiwarką, np. Wyszukaj w Google yvComment v.1.19. 

Recenzje: Możesz być zainteresowany recenzjami yvComment wystawionymi przez innnych użytkowników. By przeczytać recenzje zajrzyj naJoomla! Extensions Directory.

 Potrzebujemy Twojego wsparcia!

• Wesprzyj projekt dokonując drobnej wpłaty.
• Napisz rozszerzenie do subskrypcji zawartości strony Joomla! (lub znajdź już istniejące...)
  Istnieje potrzeba uzupełnienia funkcjonalności; każdy użytkownik powinien mieć możliwość wyboru artykułów. Jeżeli do tych (wybranych) artykułów zostaną dodane nowe komentarze, to użytkownik zostanie o tym automatycznie powiadomiony.
  Myślę, że ta funkcjonalność nie powinna stać się częścią "yvComment", ale że raczej powinno powstać nowe rozszerzenie do subskrypcji treści (lub powinno zostać zaadoptowane już istniejące...), które pozwoliłoby użytkownikowi subskrypcję wybranych artykułów (oraz ich aktualizacji...) według: Sekcji, Kategorii, związków z wybranym artykułem (np. 'subskrypcja komentarzy do wybranego artykułu') itp. W tej chwili nie jest mi znane takie roszerzenie.
• Stworzenie piaskownicy (strony demo...) dla yvComment.
  Ludzie proszą o przygotowanie strony Joomla! specjalnie dla yvComment, gdzie mogliby sprawdzić na żywo jak działa wprowadzanie komentarzy oraz gdzie istniałaby specjalna wydzielona część dla osób chcących sprawdzić w działaniu nowe wydania...
  Nie mam czasu by nadzorować taką stronę (musi ona być często i automatycznie resetowana...), więc potrzebujemy ochotników, którzy przygotowaliby taką piaskownicę dla yvComment.
• Napisanie rozszerzenia blokującego spamerów, które analizuje (loguje, przeprowadza audyty...) adresy IP użytkowników, adresy email, ksywy itp.
  Otrzymałem kilka próśb podobnej treści, by rozszerzyć o tę funkcjonalność yvComment, por. np. here. Jestem przekonany, że te funkcje powinny dotyczyć całej strony (logowanie i audytowanie wszystkich / wybranych odwiedzin / zmian treści...) a nie tylko zawartości yvComment. Przy okazji pewna uwaga: komentarze mogą być edytowane nie tylko za pomocą yvComment, ale mogą być potraktowane jak każdy inny artykuł. Tak więc sprawa dotyczy bezpieczeństwa całej strony.
  Znalazłem roszerzenie o nazwie" Fly06 Spammer Blocker", które robi coś podobnego, ale niestety działa poprawnie tylko z Joomla! 1.0. Możesz rozpocząć pracę od zapoznania się z nim, skontaktowania się z autorem, lub stworzyć coś nowego...
• Napisanie rozszerzenia " Złe słowa".
  Funkcjonalność "złe słowa" jest wykorzystywana do powstrzymywania wypowiedzi ludzi, którzy używają przekleństw itp.... "Złe słowa" powinny być osobnym rozszerzeniem, obejmującym całą stronę, które mogłoby być wykorzystane do "iltrowania" każdego spamu... Jeżeliby głębięj się nad tym zastanowić, takie rozszerzenie powinno być BARDZO inteligentne ORAZ świadome języka, w jakim tworzony jest komentarz...
  Podsumowując, zadanie polega na stworzeniu rozszerzenia "złe słowa". Integracja z yvComment byłaby już prosta.
  Istnieje prosty dodatek " JBehave - Content filtering", który zastępuje wcześniej określone słowa maską ('***') przed wyświetleniem strony, ale:
  - zastępuje te słowa tylko w polach 'tekstowych' (np. tylko w 'Tekście komentarza'),
  - i nie chroni twojej strony przed wysyłaniem (zapisywaniem) na niej takiej 'złej zawartości'.
• Dowiedz się, jak stworzyć własne, dopasowane do wymagań konkretnego rozszerzenia (np. yvComment) parametry nadawane konkretnemu artykułowi. Zawsze zdarzają się sytuacje, gdy użytkownik potrzebuje, by jakieś zmiany objęły dokładnie jeden artykuł (np. zechce wyłączyć dodawanie nowych komentarzy dla dokładnie jednego artykułu). Niestety Joomla! pozwala na dokładnie jeden zestaw parametrów dla dodatku w obrębie całej strony. Do tej pory nie wymyśliłem wystarczająco sprytnej metody czy miejsca, jak i gdzie dokonać takiej zmiany dla tylko JEDNEGO artykułu...
  Być może potrzebujemy dla artykułu czegoś w rodzaju "meta tagu", który by przechowywał takie parametry "dla określonego artykułu"... Sprawdź, spróbuj się dowiedzieć, jak to powinno zostać zrobione przy uwzględnieniu architektury środowiska Joomla. (Jakie są "najlepsze metody" rozwiązania tego typu problemu?). Być może nawet zechcesz zmienić jądro Joomla! by wprowadzić powyższą możliwość...
  
  Przykładowo możemy połączyć parametry yvComment z Menedżerem Artykułów / Parametry zaawansowane. Mógłbyś zmodyfikować kilka globalnych parametrów dla każdego artykułu z osobna, na przykład wyłączyć komentarze (Np. na stronie z kontaktami), wyłączyć wiadomości przesłane przez gości, lub ustawić maksymalną liczbę dozwolonych znaków. W ten sposób zmienić działanie ustawień ogólnych.
  Jednym ze sposobów na uzyskanie możliwości ustawiania dodatkowych parametrów dla pojedynczych artykułów (ale wymagającym zmian w jądrze Joomla!) został opisany tutaj.
• Jeżeli chciałbyś pomóc rozwijać kod rozszerzenia yvComment, jest to mile widziane. Zawsze znajdzie się coś do zrobienia: możesz rozpocząć od lektury listy DO ZROBIENIA, którą znajdziesz poniżej lub od przedstawienia swoich propozycji... W każdym razie proszę napisz do mnie!

 Rozwiązywanie problemów oraz 'Zanim rozpoczniesz'

• Jeżeli napotkałeś na jakiś problem proszę przeczytaj tę stronę od samego początku do samego końca - służy ona właśnie do tego celu: by zaoszczędzić twój czas, by odpowiedzieć na twoje pytania i rozwiązać twoje problemy.
• Jeżeli w trakcie instalacji yvComment wyświetlony zostanie następujący komunikat: 'Error! Could not find an XML setup file in the package.' - oznacza to, że nie przeczytałeś zamieszczonych poniżej instrukcji (w takim wypadku, rozdział "1. Instalacja Joomla! oraz rozszerzeń"): yvComment.zip NIE jest plikiem instalacyjnym.
• By zminimalizować możliwość wystąpienia problemów zalecam wykorzystanie PHP5 oraz MySQL5. I nie wykorzystujcie "trybu zgodności wstecznej" (ang. legacy mode) Joomla! o ile nie jest to absolutnie niezbędne. 
• Zaznaczam, że nie testowałem jak działa najnowsza wersja yvComment pod PHP4 i w "trybie zgodności wstecznej"...
  Wydaje się, że yvComment nie jest kompatybilne z MySQL v.4, ponieważ wykorzystuje słowo kluczowe 'LIKE <table>'. Z tego powodu wymaga się MySQL v.5! Jednakże w dokumentacji MySQL można znaleźć następujący zapis:
  "W MySQL 4.1 także można wykorzystywać LIKE do tworzenia pustych tablic opartych na budowie innych tablic, pod warunkiem że któryś z atrybutów kolumn i indeksów oryginalnej tablicy ma: CREATE TABLE nowa_tablica LIKE oryginalna_tablica;".
  Istnieją doniesienia, że to rozwiązanie działa. Tak więc, być może, MySQL v.4 ci zadziała.
• Aktualna wersja yvComment wymaga Joomla! w wersji 1.5.6 lub nowszej (wyższy numer wersji). yvComment   został pozytywnie przetestowany w "Joomla! 1.5.7". Co więcej, na pewno nie działa na starszych wersjach Joomla! 1.5.
  Tak więc jeżeli napotkasz na jakieś problemy, zacznij od aktualizacji (na swojej stronie testowej, nie na stronie docelowej!) do najnowszej stabilnej wersji Joomla!.
• Jeżeli zainstalowałeś paczkę językową yvComment, ale interfejs nie jest wyświetlany w twoim języku, proszę upewnij się, że zainstalowałeś 'pełną' paczkę językową Joomla! dla zaplecza administracyjnego PRZED instalacją paczki językowej yvComment.
  
• Jeżeli napotkałeś na problem z jednym z rozszerzeń Joomla!, które współpracuje z yvComment, proszę przeczytaj wiadomości oraz wyślij swoje pytania na odpowiednim wątku forum, np.: yvBBCodeyvSmiley, Bigo Captcha.
• Jeżeli wciąż masz jakiś problem związany z yvComment, proszę przeczytaj wiadomości w wątku yvComment na forum Joomla! lub możesz nawet przeszukać tylko ten dział forum. Jest tam już ponad 750 wiadomości, więc jest spora szansa, że na twoje pytanie już ktoś wcześniej odpowiedział (kilkakrotnie ). Forum posiada funkcję "Szukaj w dziale"(dostępne po zalogowaniu się na forum!), więc bardzo łatwo jest znaleźć to, czego szukasz.
• Jeżeli jesteś przekonany, że znalazłeś błąd w yvComment i chcesz poprawić yvComment, proszę szczegółowo opisz problem, załączając następujące informacje:
  • dokładną wersję środowiska Joomla!,
  • dokładną wersję yvComment,
  • scenariusz (kroki), który pozwoli na powtórzenie wystąpienia problemu.
  - i prześlij swój raport na JoomlaCode Tracker: możemy tam przedyskutować twój problem z zachowaniem pewności, że nie zostanie zapomniany.
• Jeżeli masz jakiś inny problem i potrzebujesz pomocy (wsparcia), proszę opisz go ze szczegółami... i prześlij swój raport na wyżej wspomniane forum: to forum jest najwłaściwszym miejscem. Tu masz szansę na otrzymanie odpowiedzi na swoje pytanie (od całej społeczności Joomla!).

Uwaga! Powinieneś postępować zgodnie z poniższą instrukcją
zachowując przedstawioną kolejność czynności.

Powodzenia i zaczynajmy!

Aktualizacja yvComment

Jedynym pewnym sposobem na aktualizację yvComment jest odinstalowanie (odinstalowanie zarówno komponentu jak i dodatku) a następnie instalacja nowej wersji (w sposób opisany poniżej). By zaktualizować paczkę językową musisz ją odinstalować a nasępnie zainstalować nowszą.

Proszę zauważ, że yvComment w wyniku odinstalowania nie usuwa żadnych komentarzy, więc nie stracisz żadnych komentarzy. Podobnie yvComment oczywście nie usunie żadnych plików z ustawieniami (dodanych przez użytkowników), np. twojego własnego szablonu (por. zmiana szablonu).

Podczas aktualizacji nie zostaną zapisane parametry "dodatku yvComment", więc po instalacji musisz ponownie je ustawić. Aby przyspieszyć procec konfiguracji parametrów (oraz aby mieć pewność, że czegoś nie przeoczysz...) zalecam przed odinstalowaniem otwarcie okna z parametrami dodatku yvComment w nowej zakładce przeglądarki internetowej i pozostawienie jej otwartej; wykorzystasz informacje z tego okna jako wzór, który pomoże ci ustawić parametry po zainstalowaniu nowej wersji. Po odinstalowaniu starej wersji, instalacji i konfiguracji nowej, proszę zamknij "zakładkę wzorcową". Nie naciskaj żadnego z jej przycsków!

Instalacja i konfiguracja

1. Instalacja środowiska Joomla! oraz rozszerzeń

1. W przypadku napotkania problemów w trakcie instalacji, proszę zapoznaj się z powyższym rozdziałem Rozwiązywanie problemów.
2. Zaleca się środowisko Joomla! 1.5.7 lub nowsze, ponieważ yvComment nie był testowany na wcześniejszych wersjach Joomla!   (w każdym razie MUSISZ mieć co najmniej wersję Joomla! 1.5.6. Jeżeli tak nie jest, nie trać czasu na próby instalacji yvComment ).
3. By mieć możliwość wstawiania uśmieszków (ang. smileys) w yvComment, proszę zainstaluj (skonfiguruj i włącz! - dla tego i wszystkich innych rozszerzeń wspomnianych w tej instrukcji) rozszerzenie yvSmiley.
4. By mieć możliwość wykorzystania w yvComment kodów BB (ang. BBCodes), proszę zainstaluj rozszerzenie yvBBCode.
5. By mieć możliwość wyświetlenia Awatarów (i Grawatarów) autorów komentarzy (w tym awatarów gości...), proszę zainstaluj rozszerzenie Awatar/Grawatar.
6. By mieć możliwość wstawiania w yvComment urytych obrazków (mechanizm Captcha), proszę zainstaluj jedno z niżej wymienionych rozszerzeń:
   • rozszerzenie Bigo Captcha;
   • rozszerzenie OSTWigits - Captcha.
   Proszę zauważ, że yvComment wykorzystuje rozszerzenie Captcha do publikacji komentarzy tylko przez niezarejestrowanych użytkowników (np. gości).
7. Jeżeli planujesz instalację paczek językowych yvComment dla jakiś języków, proszę zainstaluj 'pełną' paczkę językową dla środowiska Joomla! przeznaczoną dla paneluAdministratora, ściągając ją np. z Joomla! uznane tłumaczenia.
8. Instalacja samego yvComment.
   

   1. Nie próbuj 'zainstalować' pliku yvComment.zip.
   2. Wymaga się instalacji "komponentu yvComment", "modułu yvComment" oraz "dodatku "yvComment". Dostępna na tej stronie pojedyncza paczka (yvCommand.zip) zawiera (ma w środku) spakowane Komponent, Moduł i Dodatek, więc najpierw wypakuj yvCommentComponentX.XX.XXX.zip, yvCommentModuleX.XX.XXX.zip oraz yvCommentPluginX.XX.XXX.zip z tej paczki, a następnie zainstaluje je, jedno po drugim.
   3. Paczka yvComment jest wyłącznie w języku angielskim. Jeżeli potrzebujesz innej wersji językowej, ściągnij paczkę językową yvCommentLanguage Packs ze strony JoomlaCode i zainstaluj (yvCommentLanguagePacks nie powinny być włączane!)

   Najlepszą metodą na uzyskiwanie powiadomień o aktualizacji yvComment jest skorzystanie z JoomlaCode: proszę zarjestruj się w JoomlaCode, zaloguj, a uzyskasz możliwość "Monitorowania paczki" (np. paczki yvComment lub paczki z twoim językiem...), por. zrzut ekranu.

Możesz teraz przejść do znajdującego się poniżej rozdziału "Przygotowania do konfiguracji".

2. Przygotowania do konfiguracji

Zanim rozpoczniesz konfigurację, powinieneś wykonać kilka czynności w panelu Administratora (na zapleczu strony):

1. By odróżnić komentarze (do artykułów) od samych artykułów (oraz od innych treści, np. wiadomości itp.), musisz stworzyć osobną sekcję oraz kategorię (w tej samej sekcji) specjalnie dla komentarzy (następnie przypiszesz je jako parametry dodatku yvComment). By uniknąć zamieszania wybrane sekcja oraz kategoria nie powinny być używane przez żaden inny rodzaj treści, np. przez (inne typy) artykułów. Artykuły (które będą komentowane) mogą należeć do KAŻDEJ sekcji i kategorii z wyjątkiem tych, które stworzysz w tym kroku. Tak więc:
   • Stwórz nową sekcję (np. "Komentarze").
   • Stwórz nową kategorię (np. "Dowolne komentarze"), przynależną do sekcji "Komentarze".
2. Jeżeli planujesz udostępnić możliwość wprowadzania komentarzy gościom (odwiedzającym, niezarejestrowanym użytkownikom...):
   • Stwórz specjalnego użytkownika 'Gość', który będzie (z punktu widzenia środowiska Joomla) autorem wszystkich komentarzy wprowadzanych przez różnych gości (goście nie są zarejestrowanymi użytkownikami Joomla!).
     Joomla! nie posiada wbudowanego 'Konta gościa' (użytkownika Gość) który uosabiałby gości, więc musisz takiego użytkownika stworzyć:
     np. (w menu zaplecza > 'Witryna'->'Użytkownicy'-> naciśnij przycisk 'Utwórz') stwórz użytkownika o 'Nazwie własnej'='Gość' oraz 'Użytkownik'=' gość'.
   • Użytkownik gość musi należeć do grupy Autorów.
   • Jeżeli chcesz, by do edycji komentarzy służył wbudowany w środowisko edytor, to konto użytkownika 'Gość' powinno być odblokowane.

Możesz teraz przejść do poniższego rozdziału "Konfiguracja krok po kroku"

3. Konfiguracja dodatku yvComment krok po kroku

1. Pole "Ustawienia dodatku" (Panel administratora -> Rozszerzenia -> Dodatki -> yvcomment) zawiera zarówno parametry, które decydują o działaniu całego rozwiązania yvComment (Komponent+Dodatek+Moduł), jak i parametry, które odpowiadają tylko za działanie Dodatku.
   Pierwszym krokiem, jaki należy wykonać, jest otwarcie strony z konfiguracją dodatku: wybierz z menu Rozszerzenia -> Dodatki -> wybierz dodatek "yvComment".
   Ekran będzie wyglądał mniej więcej tak, jak na ilustracji po prawej.
2. "Używaj artykułów do przechowywania komentarzy". Domyślnie yvComment wykorzystuje do przechowywania komentarzy ten sam kontener (tablicę bazy danych), co do przechowywania artykułów. Tak więc komentarze stają się jeszcze jednym rodzajem artykułów Joomla!
   Jeżeli chciałbyś, by komentarze były gromadzone w osobnej tablicy bazy danych, ustaw wartość parametru "Używaj artykułów do przechowywania komentarzy" na "Nie"  - nie zalecam tego wyboru: stracisz wiele potencjalnie przydatnych możliwości (o których przeczytasz poniżej...)
3. "Sekcja dla komentarzy" oraz "Kategoria dla komentarzy" - wybierz z dostępnej listy nazwy wcześniej stworzonych specjalnie na potrzeby komentarzy sekcji oraz kategorii.
4. "Lista ID sekcji artykułów , która będą (lub nie będą) zawierać komentarzy". Np. 1, 22, 15   - Pozostaw to pole puste, jeżeli zezwalasz na dodawanie komentarzy do artykułów należących do dowolnej sekcji.
5. "Lista ID kategorii artykułów, które będą (lub nie będą) zawierać komentarzy." Np. 1, 3, 25   - Pozostaw to pole puste, jeżeli zezwalasz na dodawanie komentarzy do artykułów należących do dowolnej kategorii.
6. "Lista ID artykułów, które będą (lub nie będą) zawierać komentarzy" parametr uzupełniający inne parametry określające sekcje i kategorie artykułów, do których mogą być dodawane komentarze. Dzięki temu parametrowi uzyskasz możliwie największą elastyczność przy określaniu który artykuł może, a który nie może być komentowany. Przykładowo możesz pozwolić na dodawanie komentarzy tylko do jednego artykułu.
   Zwróć uwagę, że jeżeli do jakiegoś artykułu już dodano komentarze, ale podejmiesz decyzję o wyłączeniu możliwości dodawania kolejnyh komentarzy do tego artykułu, te dodane wcześniej będą wciąż istniały i będą nadal widoczne dla użytkowników.
   Identyfikatory (ID) sekcji, kategorii oraz artykułów są logicznie łączne
   (operator logiczny 'lub').
7. "Wyklucz Sekcje i Kategorie wskazane powyżej (wartość 'Nie' - zalicza)" - domyślnie wybrana jest wartość 'Nie'.
   Możesz zechcieć włączyć ten parametr np. w następującym przypadku:
   Wybrałeś trzy sekcje artykułów, dla których nie chcesz, by były do nich dodawane komentarze I wpisałeś identyfikatory (ID) tych trzech sekcji w poprzednim polu.

   ---

8. "Użyj pliku CSS" - możesz wybrać jeden z czterech plików ze stylami, które są dostępne wraz z rozszerzeniem yvComment, lub wcale z nich nie korzystać (i, tym samym, umieścić CSS dla yvComment w swoim własnym pliku CSS). Jeżeli chcesz, aby style twojego autorstwa zostały dołączone do tego rozszerzenia, możesz mi je przesłać.
9. "Komentarz jest łączem" (opcja aktywna pod warunkiem, że "Używaj artykułów do przechowywania komentarzy"="Tak"). Łącze będzie prowadzić do widoku, w którym komentarze zostaną wyświetlone tak samo, jak artykuły; użytkownik będzie widzieć i będzie mógł dodawać komentarze do komentarza.
10. "Autor wymieniony przez" opcja może przyjąć dwie wartości: 'Imię' (domyślnie) lub 'Nazwę użytkownika'. Teraz możesz użyć nazwy użytkownika autora komentarza (lub artykułu) jako dodatku do 'Imienia'. Zarówno imię jak i nazwa użytkownika pochodzą ze 'Szczegółów użytkownika' (por. menu "Użytkownicy" w zapleczu Joomla!).
    Proszę zwróć uwagę, że aktualne jądro Joomla! pokazuje tylko 'Imię' autora artykułu, więc możliwość wyświetlenia nazwy użytkownika wyprzedza możliwości jądra Joomla!
11. "Nazwa autora jest łączem". Jeżeli ta opcja jest aktywna nazwa autora komentarza staje się łączem do jego (lub jej) witryny www.
    • W przypadku zarejestrowanych użytkowników adres www jest pobierany z parametrów kontaktu "Adres www", "Połącz z użytkownikiem" (skojarzone z tym użytkownikiem). Standardowym sposobem realizacji tego zadania w Joomla! jest skorzystanie z menedżera kontaktów "Kontakty" z zaplecza: menu -> Komponenty -> Kontakty -> Kontakty.
    • W przypadku gości, jest to "łącze do strony" lub adresu e-mail gościa (o ile te opcje są aktywne, por. niżej).
12. "Wykonuj dodatki operujące na 'treści' (ang. content)" - uaktywnienie tej opcji pozwala na wykorzystanie (teoretycznie wszystkich) dodatków jednocześnie z treściami dodanymi przy użyciu yvComment, tak jakby to były artykuły. Domyślnie ta opcja jest nieaktywna ('Nie'), by nie dopuścić do ewentualnej niekompatybilności z innymi dodatkami. Ta opcja została pomyślnie sprawdzona dla następujących dodatków:
    • 'Avatar/Gravatar 1.05' (dodawanie awatarów autora do komentarzy).
    • dodatki wbudowane w jądro Joomla!: Content - Email Cloaking, GeSHi.
    • yvBBCode oraz yvSmiley. Proszę zwróć uwagę, że te dwa dodatki działają szybciej, jeżeli nie są wykorzystywane jako dodatki treści (ang. Content), ale jeżeli zostaną skonfigurowane do zamiany tekstu w ramach całej witryny. Tak więc zalecam przy konfiguracji yvBBCode oraz yvSmiley nie ustawiać "Włącz uśmieszki (ang. smileys) w tekście artykułów" (znaczy to tyle samo, co 'nie zachowuj się jak dodatek treści').

    ---

13. "Pozwól na komenatrze do komentarzy" opcja globalna yvComment (aktywna gdy "Używaj artykułów do przechowywania komentarzy"="Tak") może przyjąć jedną z trzech wartości:
    • "Nie" - najprostsza możliwość.
    • "Tylko odpowiedź autora" - tylko autor artykułu lub administrator mogą dodać dokładnie jeden komentarz do komentarza. Dodany komentarz do komentarza nie może być skomentowany. Ten mechanizm działa podobnie do JED - por. "Odpowiedź autora" niektórych recenzji ("recenzje" są w rzeczywistości komentarzami).
    • "Jeden poziom zagnieżdżenia" każdy komentarz artykułu może posiadać dowolną liczbę komentarzy. Komentarze do komentarzy nie mogą być dalej komentowane. Jest to więc ograniczony przypadek "Zagnieżdżonych komentarzy" (por. następną wartość).
    • "Zagnieżdżone komentarze" - każdy komentarz może posiadać dowolną liczbę komentarzy. Każdy komentarz do komentarza może być skomentowany i tak dalej, zagnieżdżenie może sięgać dowolnie głęboko. Jeżeli wybrana zostanie ta opcja, każdy komentarz, podobnie do widoku blogu posiada łącze "Komentarz" lub "Odpowiedz", który prowadzi do standardowego widoku komentarzy wyświetlanych jak 'artykuły', gdzie użytkownicy mogą przeglądać lub dodawać komentarze do komentarzy.
14. "Edytor" Parametr pozwala na wybór edytora, który będzie służyć do zmian tekstu komentarzy (dodawania lub edycji komentarzy):
    • "Podstawowy edytor" - proste pole tekstowe oraz opcjonalnie kody BB (ang. BBCodes) oraz uśmieszki (ang. Smileys) (o ile zainstalowano odpowiednie rozszerzenia).
    • "Edytor WYSIWYG" - edytor WYSIWYG środowiska Joomla! Jeżeli wybrałeś tę opcję, musisz wybrać opcję "Pozwól na stosowanie w komentarzach znaczników HTML" by pozwolić na wprowadzanie "surowych danych" (w przeciwnym razie wprowadzone formatowanie nie zostanie zapisane).
15. "Wyłącz możliwość dodawania komentarzy po upływie następującej liczby dni". Parametr wyłącza możliwość dodawania komentarzy do starych artykułów, ale nie zabrania zarejestrowanym użytkownikom poprawiania lub aktualizacji starych wpisów. Istnieje specjalny obrazek , który jest wyświetlany w widoku artykułu, w pobliżu liczby komentarzy, gdy możliwość wprowadzania komentarzy została wstrzymana. Nie mogłem się zdecydować gdzie go umieścić, chociaż czułem, że gdzieś powinienem znaleźć dla niego miejsce...
16. "Lista Użytkowników, którzy zostaną poinformowani o nowych lub uaktualnionych komentarzach". Dzięki temu parametrowi członkowie grup Administratorzy oraz Wydawcy mogą otrzymywać powiadomienia e-mailowe o nowych lub zmodyfikowanych komentarzach: 
    • Jest to oddzielona przecinkami lista nazw użytkowników (np.: admin, piotr, michał). Adresy e-mail zostaną automatycznie pobrane z listy użytkowników Joomla! Obie grupy użytkowników: Administratorzy oraz Wydawcy mają prawa do edycji komentarzy, więc nazwy użytkowników należących do tych grup mogą znajdować się na tej liście.
    • Jeżeli lista pozostanie pusta, powiadamianie e-mailem jest wyłączone.
    • Powiadomienie nie zostanie wysłane jeżeli użytkownik, który dodał lub zmienił komentarz posiada wszystkie prawa do edycji komentarzy (np. jeżeli Administrator lub Wydawca dodaje lub modyfikuje treść komentarza, nikt nie jest powiadamiany). Zrobiono tak, by uniknąć niepotrzebnych dodatkowych e-maili powiadamiających o tych samych komentarzach.

    ---

17. "Pozwól Gościom na dodawanie komentarzy". Jeżeli chcesz, aby każdy mógł oglądać komentarze ale dodawać komentarze mogli tylko zarejestrowani użytkownicy, ustaw tę opcję na "Nie".
    
    

    Jeżeli udostępniłeś Gościom możliwość dodawania komentarzy:

    Zwróć uwagę, że w żadnym przypadku goście nie mogą edytować żadnych komentarzy (ani wprowadzonych przez siebie, ani komentarzy wprowadzonych przez innych gości).

    1. Określenie 'Nazwy użytkownika - Gościa' (np. gość), utworzonego wcześniej. Użytkownik o podanej nazwie będzie autorem wszystkich komentarzy wprowadzonych przez gości. Konfiguracja tej opcji jest wymagana ze względu na konieczność zachowania spójności z "ogólnymi zasadami" Joomla!: każdy artykuł musi posiadać autora (który musi należeć do listy zarejestrowanych użytkowników).
    2. Możesz zmienić wartość parametru "Sprawdzaj imię Gościa" (wartość domyślna 'Tak') by włączyć lub wyłączyć sprawdzenie: jeżeli alias gościa (pole "Twoje imię" z formularza "Dodaj komentarz") jest częścią któregoś z imion zarejestrowanych użytkowników.
    3. Jeżeli chcesz pozwolić gościom na możliwość wstawienia łącza do ich witryny www w tekście komentarza, ustaw parametr "Pozwól Gościom na wstawianie łączy do ich witryn www". Łącze zostanie zapisane w polu "metadanych" komentarza.
       Proszę zauważ, że ze względu na znany problem w jądrze Joomla! (por. Bug No. 8709 oraz  Topic: Extending metadata of Articles (Poor implementation of content metadata saving)) jeżeli poddasz edycji jakiś komentarz korzystając z zaplecza Joomla! ("Artykuły"), łącze zostanie usunięte. Tak więc nie edytuj komentarzy wprowadzonych przez gości za pomocą zaplecza Joomla! ("Artykuły") o ile skorzystałeś z tego parametru. Na szczęście ten problem nie występuje podczas edycji komentarzy wprowadzanych za pomocą witryny (nie z poziomu zaplecza)!
    4. Jeżeli chcesz, aby komentarze wprowadzane przez gości były widoczne dla wszystkich odwiedzających witrynę zaraz po ich dodaniu, ustaw wartość parametru 'Natychmiast publikuj komentarze Gości' na 'Tak'. W przeciwnym razie komentarze gości zostaną dodane do witryny, ale nie będą widoczne dla odwiedzających witrynę dopóki nie zostaną zatwierdzone (sprawdzone) i opublikowane przez Wydawcę lub Administratora (bardziej precyzyjnie: przez użytkownika, który posiada wszystkie prawa do edycji komentarzy).
       • Podobnie jak to się robi dla zwykłych artykułów, Wydawcy oraz Administratorzy witryny  wyszukują nieopublikowane komentarze (oczywiście po zalogowaniu do zaplecza witryny ) na tej samej liście komentarzy (jako artykułów). Mogą oni poddać edycji lub opublikować DOWOLNE komentarze, dzięki czemu będą one widoczne dla innych użytkowników witryny po 'opublikowaniu' (ustawienie parametru 'Opublikowane' na 'Tak'). Oczywiście Wydawcy oraz Administratorzy mogą usuwać komentarze.
       • W zapleczu witryny, menu "Komentarze -> yvComment -> Lista komentarzy", lista komentarzy może zostać przefiltrowana pod kątem "Statusu" komentarzy - tak jak się to robi dla innych artykułów (w tym komentarzy...) poprzez menu ->'Artykuły' -> 'Wszystkie artykuły'.
    5. Jeżeli zamierzasz wykorzystać do ochrony przed spamem mechanizm Captcha (specjalne obrazki które chronią przed wprowadzeniem niechcianej treści w polach komentarza), powinieneś:
       1. Ściągnąć i zainstalować rozszerzenie Bigo Captcha (lub OSTWigits - Captcha).
       2. Skonfigurować dodatek Captcha i nie zapomnieć go włączyć!
       3. Ustawić wartość parametru "Użyj mechanizmu Captcha" na "Tak".
       4. Możesz także wykorzystać parametr "Opóźnij wczytywanie obrazka Captcha", który opóźni wyświetlenie parametru obrazka captcha do chwili, gdy użytkownik zacznie wprowadzać tekst komentarza (lub kliknie w pole tekstowe do wprowadzania komentarzy). Parametr służy do przyspieszenia ładowania strony, co przyczynia się do zmniejszenia obciążenia serwera. Większość użytkowników odwiedzających witrynę nie wprowadza komentarzy. Nie będą musieli czekać na ściągnięcie obrazka captcha. (Dziękuję za wsparcie Jan Tångring)

---

18. Do elastycznego ustalenia pozycji komentarzy w obszarze witryny służą trzy parametry: "Pozycja komentarzy w widoku 'artykuły'", "Pozycja komentarzy na stronie początkowej twojej witryny" oraz "Pozycja komentarzy w pozostałych widokach". (Niestety Joomla! nie pozwala na różne konfiguracje dodatku dla różnych menu/artykułów, więc niedogodność tę rozwiązano w powyższy, niezbyt elegancki sposób).
    Każdy parametr może przyjąć jedną z czterech wartości. Trzy z nich są proste: "Wewnątrz tekstu artykułu", "Poniżej tekstu artykułu" (domyślnie) oraz "Ukryj".
    Czwarty " Narzucony przez szablon artykułu", jest bardziej zaawansowany.
    Parametr 'Określony przez szablon artykułu' może zostać wykorzystany przez ludzi tworzących szablony witryn dla Joomla! oraz dla tych, którzy chcą mieć pełną kontrolę nad miejscami, gdzie zostanie wstawiony wyjściowy kod HTML tworzony przez dodatek yvComment ("Wyjście z yvComment").
    Jeżeli zostanie wybrana ta wartość parametru, dodatek yvComment nie doda "wyjścia z yvComment" do przewidzianego miejsca w obszarze strony (np. nie doda na końcu artykułu). Zamiast tego, tworzy nowy atrybut dla artykułu: 'komentarze', - i to tam zapisuje "Wyjście yvComment". (Atrybut 'komentarze' nie jest zapisywany w bazie danych).
    By umieścić "wyjście z yvComment" w obszarze strony tak, jakby miało zostać dodane do szablonu artykułu (poniższy przykład dotyczy widoków 'strony startowej' oraz 'blogu'):

    <?php if (isset($this->item->comments)) : ?>
    	<?php echo $this->item->comments; ?>
    <?php endif; ?>

    Jeżeli przykładowo chcesz skonfigurować pozycję komentarzy na stronie startowej, wstaw powyższy kod do pliku 'components/com_content/views/frontpage/tmpl/default_item.php' tuż przed linią:
    <span class="article_separator">&nbsp;</span>
    
    lub (dla widoku 'artykuły'):

    <?php if (isset($this->article->comments)) : ?>
    	<?php echo $this->article->comments; ?>
    <?php endif; ?>

    Zauważ proszę, że dla wartości 'Narzucony przez szablon artykułu' powinna także zostać skonfigurowana pozycja szablonu yvComment. Np. możesz zechcieć na stronie startowej usunąć dodatkowe znaczniki DIV z otoczenia pola tekstowego 'Dodaj komentarz' by umieścić go w tej samej linii co tekst 'Czytaj dalej'. Możesz też postanowić usunąć komentarz yvComment z któregoś z widoków...
    Jest inne, bardzo interesujące zastosowanie wartości "Ukryj" parametru "Pozycja komentarzy w widoku 'artykuły'", które nie wymaga konfiguracji szablonów:
    Możesz umieścić komentarze do artykułu w module (moduł yvComment) zamiast 'w/poniżej' artykułu! Jeżeli chcesz poznać szczegóły, zajrzyj do rozdziału " Komentarze do artykułu w module".
19. "Tekst 'Komentarze(n)' jest łączem do innej strony" - możesz pozostawić tę możliwość dla "Strona artykułu z komentarzami" by mieć łącze "Dodaj komentarz" w widoku 'blogu'.
    Lub możesz wybrać wartość "Ukryj" by całkowicie ukryć tekst we wszystkich widokach poza widokiem 'artykuły'.
20. Parametr "'Proszę się zarejestrować'" (został dodany po wielu pytaniach, jak to zrobić...). Jeżeli ustawiona zostanie wartość 'tak', w widoku artykułów yvComment wyświetli komunikat 'Jeżeli chcesz dodać komentarz do tego artykułu proszę zarejestruj się lub zaloguj', o ile dla tego artykułu zezwolono na dodawanie komentarzy, ale nie ma do tego uprawnień ten użytkownik.
21. "Pozycja formularza 'Dodaj komentarz'". W tej chwili są dwie 'możliwości':
    1. 'Pod komentarzami' (domyślnie);
    2. 'Na oddzielnej stronie' - pozwala 'schować' formularz służący do wprowadzania komentarzy. Zamiast całego formularza użytkownik zobaczy tylko jeden przycisk 'Dodaj komentarz', który spowoduje otwarcie osobnej strony.
22. Włącz dodatek (w bloku 'Szczegóły' na lewo ustaw wartość parametru 'Włączony' na 'Tak').
23. Zapisz nową konfigurację dodatku yvComment.

4. Konfiguracja modułu yvComment

Moduł yvComment daje możliwości wyświetlania tych samych widoków yvComment jako modułów. Wspaniałą cechą modułów Joomla! jest możliwość stworzenia dowolnej liczby modułów, opartych na module "yvComment" (o tym samym typie 'mod_yvcomment') przy czym każdy z nich może mieć inną konfigurację.

1. Moduł yvComment jest domyślnie wstępnie skonfigurowany jako moduł "Najnowszych komentarzy" (Widok: 'Lista komentarzy', nazwa układu graficznego: '003 (taki sam jak dla 'Nowości'), ale możesz wypróbować pozostałe dwa układy graficzne... Możesz stworzyć układy graficzne dopasowane do twoich potrzeb (ta sama cecha Joomla! 'Zastąp szablon' jak dla szablonu lub dodatku) oraz wpisać nazwy tych własnych układów graficznych wykorzystując 'Własny układ graficzny'. W takim wypadku dla parametru ('Nazwa układu graficznego' ustaw wartość 'Własny').
2. Parametr "Wiltruj listę po" pozwala na uzyskanie bardzo elastycznego modułu, który wyświetli 'Najnowsze komentarze' w bieżącym kontekście (Cała witryna, Sekcja, Kategoria, Artykuł): np. może wyświetlić na stronie startowej, powiedzmy 5 najnowszych komentarzy wprowadzonych w dowolnym miejscu witryny, a jeżeli przejdziesz do 'Sekcji blogu', ten sam moduł wyświetli 'Najnowsze komentarze' wprowadzone tylko dla artykułów należących do tej sekcji.
3. Parametr "Dynamiczny tytuł modułu" może służyć do zmiany tytułu modułu w zależności od tego, co jest 'zakresem' komentarzy na danej stronie.
4. Włącz moduł (w części na prawo od kolumny 'Nazwa modułu' ustaw dla kolumny 'Włączony' wartość 'Tak').
5. Zapisz konfigurację swojego modułu yvComment.

5. Konfiguracja innych rozszerzeń

1. Możesz wypróbować (przetestować) możliwość dodawania komentarzy na stronie początkowej witryny - dodane w ten sposób komentarze pojawią się w module "Nowości". Jeżeli nie tego oczekiwałeś:
   w panelu administracyjnym przejdź do "Rozszerzenia -> Moduł" -> wybierz moduł "Nowości" i ustaw parametr "ID" na "1" (przefiltruj listę: "1" to ID sekcji "Wiadomości"). - Tak więc komentarze nie zostaną już więcej wyświetlone na liście "Nowości" .
2. Jeżeli chciałbyś mieć moduł "Najnowsze komentarze", stwórz kolejny moduł bazujący na "typie modułowym" mod_latestnews:
   W menu "Rozszerzenia" -> Moduły" naciśnij przycisk "Nowy",
   wybierz moduł "Nowości" i naciśnij przycisk "Dalej".
   Następnie nadaj nowoutworzonemu modułowi nazwę "Najnowsze komentarze", ustaw parametr "ID" na ID Sekcji "Komentarze", ustaw pozycję modułu na stronie i Zapisz moduł.

6. Style, dopasowywanie układu graficznego do własnych potrzeb oraz lokalizacja (tłumaczenia)

Arkusze stylów

Domyślnie yvComment wykorzystuje jeden z czterech prostych plików CSS (components/com_yvcomment/assets/style001.css...), które zostały przewidziane jako punkt wyjścia dla prac prowadzących do dopasowania układu graficznego do własnych potrzeb. Jeżeli stworzyłeś swój własny css osadzony we własnym szablonie, powinieneś zmienić wartość parametru "Użyj pliku CSS" na "Nie".

Nadpisywanie szablonu

yvComment w pełni wykorzystuje mechanizm "nadpisywania szablonów" (ang. template override) dla Dodatku, Modułu oraz Komponentu, w ten sam sposób, co dla dowolnego komponentu/modułu należącego do jądra Joomla! Tak więc możesz skopiować plik 'components/com_yvcomment/views/comment/tmpl/default.php' do katalogu, w którym znajduje się twój szablon (np. 'templates/mytemplatename/html/com_yvcomment/comment/default.php') i przerobić go zgodnie ze swoimi potrzebami. Co więcej, możesz stosować różne szablony dla różnych części swojej witryny (bardziej precyzyjnie: możesz przypisać różne szablony do różnych "Pozycji menu" witryny Joomla!), więc możesz dla tych różnych cześci stoswać różne szablony yvComment.

Pyt. W pliku 'components/com_yvcomment/views/comment/tmpl/default.php' nie mogę znaleźć kodu, który służy do wyświetlania komentarzy.
Odp. Następująca linia "wyświetl komentarze":
echo $yvComment->ShowCommentsOnArticle($parmsv); }
- w zasadzie w tej linii wywoływany jest drugi szablon (zagnieżdżony szablon...): components/com_yvcomment/views/listofcomments/tmpl/default.php

Tłumaczenia

Do tej chwili yvComment został przetłumaczony na 30 języków! Proszę zwróć uwagę, że tłumaczenia mogą być trochę nieaktualne. Dla niektórych języków przetłumaczono tylko stronę początkową. Paczki Komponentu oraz Dodatku yvComment zawierają pliki tylko w werjsi angielskiej. Tłumaczenia znajdują się w yvCommentLanguagePacks, które możesz pobrać z JoomlaCode a następnie osobno zainstalować.
Oczywiście możesz dopasować yvComment do swoich potrzeb edytując te pliki językowe. Np. możesz podjąć decyzję o zmianie układu graficznego powiadomień... Musisz tylko pamiętać, by nie zapomnieć zrobić kopii bezpieczeństwa samodzielnie zmodyfikowanych plików przed aktualizacją yvComment do najnowszej wersji.

Istnieje także specjalna 'angielska paczka językowa', która jest paczką-szablonem wykorzystywanym przez tłumaczy do pisania dodatkowych paczek językowych dla rozszerzeń yvComment. Tak więc jeżeli chcesz napisać nowe tłumaczenie yvComment, ściągnij tę 'angielską paczkę językową' z JoomlaCode (szukaj paczki '3_LanguagePackTemplate') i postępuj wg instrukcji z pliku yvCommentLanguagePack_en-GB.xml. W efekcie uzyskacz paczkę yvCommentLanguagePack_xx-XX_V.VV.VVV.000.zip dla swojego języka, gdzie 'xx-XX' to kod twojego języka (porównaj z 'pełną' paczkę językową swojej Joomla!) a 'V.VV.VVV' to wersja paczki językowej (będzie taka sama jak dla paczki angielskiej, która została przetłumaczona).

Przeglądanie komentarzy

Komentarze można przeglądać na dwa sposoby. Jeżeli dla komentarzy ustawiłeś parametr "Używaj artykułów do przechowywania komentarzy" możesz wykorzystać oba z nich; jeżeli nie - tylko sposób yvComment .

Ogólny sposób przeglądania artykułów w Joomla!

Jeżeli dla komentarzy ustawiłeś parametr "Używaj artykułów do przechowywania komentarzy", komentarze z punktu widzenia środowiska Joomla! są zwykłymi artykułami (ale nawet Joomla! może odróżniać komentarze dzięki specjalnej Sekcji komentarzy). W rzeczywistości możesz traktować yvComment jako jeszcze jeden sposób (szybki i prosty w użyciu) służący do publikacji i organizacji swoich artykułów (powiedzmy w innym "wymiarze" ): yvComment pozwala na komentowanie komentarzy, tak więc na tworzenie drzewiastej struktury artykułów/komentarzy (wstępującej/zstępującej).

Tak więc dla komentarzy możesz wykorzystać:

• Tego samego menedżera "Artykuły" z zaplecza witryny do zarządzania komentarzami (Podpowiedź: przefiltruj wg Sekcji by wyświetlić tylko komentarze).
• Wbudowaną w środowisko Joomla! funkcję wyszukiwania.
• Wszystkie widoki  ("Wszystkie pozycje menu") Artykułów, by wyświetlić artykuły.
• Dowolne rozszerzenie Joomla!, przystosowane do pracy z artykułami. Np. moduł "Nowości" typowo (bez filtrów wg Sekcji/Kategorii) wyświetli tytuły komentarzy tak, jak by to zrobił dla zwykłych artykułów. Jeżeli klikniesz na łącze, zobaczysz komentarze w widoku 'artykuły' tak, jak by to był dowolny inny artykuł. Jednakże w takim wypadku yvComment rozpozna komentarze i dla wygody wyświetli łącze do artykuły, do którego odnosi się dany komentarz ("To jest komentarz do...").
• Możesz wykorzystać moduł "Nowości" jako "Najnowsze komentarze" - po prostu skonfiguruj go tak, by pokazywał "artykuły" należące do wcześniej przez ciebie określonej sekcji lub kategorii "Komentarze".
  
  PODPOWIEDŹ: jeżeli na swojej witrynie chcesz wykorzystywać oba moduły: "Nowości" oraz "Najnowsze komentarze", możesz "dodać nowy moduł" (stworzyć kopię "typu modułu" mod_latestnews): wciśnij przycisk "Nowy" w oknie "Moduły"; wybierz moduł "Nowości" i naciśnij przycisk "Dalej"...

Sposób przeglądania komentarzy specyficzny dla yvComment

Na etapie konfiguracji możesz określić, czy komentarze będą widoczne dla niezarejestrowanych użytkowników poprzez "poziom dostępu" dodatku yvComment.

Obecnie istnieją dwa rodzaje "widoków" komentarzy yvComments (możesz je wykorzystać podczas tworzenia "stron", tj. "pozycji menu" swojej witryny):

Strona "Komentarze" (+ widok dodatku)

Jeżeli oglądasz cały artykuł (widok 'artykuły') to komentarze do artykułu są wyświetlane poniżej treści artykułu. Jeżeli taki artykuł jest w rzeczywistości komentarzem do innego artykułu, yvComment wyświetli łącze do nadrzędnego artykułu ("To jest komentarz do "..."").

Na poniższym zrzucie ekranu: komentarze do artykułu w widoku dodatku - szablon Beez (przeglądarka: Internet Explorer 7.0). Dla każdego z komentarzy wyświetlane są ikonki 'edytuj' oraz 'usuń', ponieważ aktualnym użytkownikiem jest Administrator, który może nimi zarządzać przez witrynę (nie musi tego robić poprzez zaplecze).
Formularz 'Dodaj komentarz' został ukryty.

 

Komentarze do artykułów w widoku dodatku - szablon Rhuk_milkyway (przeglądarka: Firefox 2.0)
 

Strona "Lista komentarzy"

By wyświetlać listę komentarzy możesz stworzyć osobną stronę (dostępną poprzez osobną pozycję z menu). Odpowiednim typem dla pozycji w menu jest "Lista komentarzy". Lista na takiej stronie może być filtrowana wg Sekcji i/lub Kategorii artykułu nadrzędnego. Tak więc możesz mieć np. stronę "Komentarze do wiadomości", o ile wybierzesz wartość "Wiadomości" dla parametru "Sekcja artykułów zawierających komentarze".

Dla każdego komentarza znajdującego się na tej liście yvComment wyświetli łącze do artykułu nadrzędnego.

Dla list yvComment wykorzystuje wbudowany w środowisko Joomla! mechanizm stronicowania.

Moduł "yvComment"

Ta sama "Lista komentarzy" (wraz z różnymi układami graficznymi tego widoku, w tym 3 dostępnymi od ręki) może zostać wyświetlona za pomocą modułów bazujących na module 'yvcomment'.

Na ilustracji po prawej możesz zobaczyć widok 'Listy komentarzy', dla domyślnego układu graficznego, będącego modułem.

Komentarze do artykułu w module

Komentarze do artykułu (w tym także łącza służące do dodawania artykułu oraz, być może, nawet formularz służący do wprowadzania tekstu komentarza...) możesz umieścić w module zamiast 'wewnątrz/poniżej' tekstu artykułu. Tak więc możesz w łatwy sposób dopasować do swoich wymagań wygląd komentarzy na różnych stronach (ponieważ środowisko Joomla! pozwala na stosowanie różnych modułów dla różnych pozycji menu...)

Proszę zwróć uwagę, że yvComment wyświetla listę komentarzy na stronie 'drukuj' artykułu, nawet jeżeli dla parametru "Pozycja komentarzy w widoku 'artykuły'" wybrano wartość "Ukryj". Zrobiono tak, ponieważ strona 'drukuj' artykułu nie pokazuje żadnych modułów, tak więc komentarze nie będą drukowane.

Przeglądanie komentarzy na zapleczu witryny

Możliwe jest przeglądanie komentarzy poprzez zaplecze witryny: menu Komponenty -> yvComment -> Lista komentarzy. Administrator może przeglądać, edytować oraz usuwać komentarze. Dostęp do komentarzy z poziomu zaplecza jest przydatny przede wszystkim jeżeli dla komentarzy nie został ustawiony parametr "Używaj artykułów do przechowywania komentarzy".

Lista komentarzy może zostać przefiltrowana pod kątem "Stanu" komentarzy (Wszystkie/Opublikowane/Nieopublikowane) - tak jak to się robi dla artykułów (nie wyłączając z tej grupy komentarzy...) - menu "Artykuły -> Wszystkie artykuły".

Dodawanie, edycja oraz usuwanie komentarzy

By dodać komentarz wypełnij formularz "Dodaj komentarz" dostępny na dole strony z tekstem artykułu (wtedy, gdy widzisz pełny tekst artykułu, tzn. tekst jest wyświetlany w "widoku artykułu").

yvComment pozwala na wpisywanie kodu HTML (zastosowanie tagów HTML) w polu "tekst" komentarza o ile dla parametru "Pozwól na stosowanie w komentarzach znaczników HTML" wybrałeś ustawienie "Pozwól tylko na HTML".

Domyślnie, aby mieć możliwość dodawania komentarzy, użytkownik musi być zalogowany. Zmień wartość parametru "Pozwól Gościom na dodawanie komentarzy" na "Tak" by umożliwić Gościom dodawanie komentarzy. Zauważ, że dla takie rozwiązanie jest mało bezpieczne, ponieważ yvComment jak na razie nie ma ochrony antyspamowej (z wyjątkiem parametru "Minimalny przedział czasu między kolejnymi wpisami..."), tak więc zainstaluj dodatek Captcha.

Bezpośrednio przez strony witryny użytkownik może edytować swoje komentarze klikając na tej samej ikonce   , która służy do edycji artykułów: ( - dla komentarzy nieopublikowanych). Administrator może edytować lub usuwać dowolne komentarze (pamiętaj, że jako Administrator możesz zarządzać komentarzami z poziomu menedżera artykułów).

Wykorzystanie edytora WYSIWYG do dodawania lub edycji komentarzy

Możesz skonfigurować parametr "Edytor" by wykorzystywać "edytor WYSIWYG" (ten sam edytor WYSIWYG, który wybrałeś dla swojego środowiska Joomla!) do edycji tekstu komentarzy (dodawanie lub zmiana komentarzy). Sprawdź, jak to wygląda:

Ponadto, jeżeli do przechowywania komentarzy wykorzystujesz tablicę, możesz obejrzeć komentarz tak samo, jak każdy inny artykuł (np. w module "Nowości"). W takim wypadku możesz również wyedytować komentarz za pomocą edytora WYSIWYG, a yvComment wyświetli tekst komentarza wraz z formatowaniem (i obrazkami).

Proszę zauważ, że ze względu na znany problem w jądrze Joomla! (por. Bug No. 8709 and  Topic: Extending metadata of Articles (Poor implementation of content metadata saving)), jeżeli poddasz edycji jakiś komentarz korzystając z zaplecza Joomla! ("Artykuły - wszystkie"), łącze zostanie usunięte. Tak więc nie edytuj komentarzy wprowadzonych przez gości za pomocą zaplecza Joomla! ("Artykuły - wszystkie") o ile skorzystałeś z tego parametru. Na szczęście ten problem nie występuje podczas edycji komentarzy wprowadzanych spoza zaplecza!

Sprzężenie zwrotne

Pochodzące od ciebie informacje (sprzężenie zwrotne) są bardzo mile widziane!

• Jeżeli znalazłeś problem w kodzie yvComment, lub nawet napisałeś dla niego łatę, jeżeli napisałeś nowe tłumaczenie lub tylko je zaktualizowałeś - proszę prześlij je do autora!
• Jeżeli chcesz przedyskutować yvComment z innymi członkami społeczności Joomla!, proszę wejdź na forum Joomla! . Proszę przed wysłaniem swoich sugestii zapoznaj się z poniższym rozdziałem "DO ZROBIENIA".
• Jeżeli chcesz napisać recenzję yvComment lub przeczytać recenzje napisane przez innych użytkowników, proszę zajrzyj tutaj: Joomla! Extensions Directory. Proszę pomóż innym dokonać właściwego wyboru !

DO ZROBIENIA - Plany na przyszłość oraz przemyślenia

• Dodać nową wartość do parametru "Pozwól na komenatrze do komentarzy": "Tylko Administrator może odpowiedzieć". - Podobne do "Tylko odpowiedź autora", ale tylko Administratorzy (lub użytkownicy, którzy posiadają wszystkie prawa do edycji komentarzy) mogą dodawać komentarze do komentarzy.
• Dodać do modułu nowy widok "Najczęściej komentowane". Ten widok wyświetli listę artykułów w porządku malejącym wg liczby komentarzy przyznanych każdemu z komentarzy. Liczba komentarzy także będzie wyświetlana.
• Parametr "Usuń do kosza", który czyni 'usuwanie komentarzy' podobnym do 'usuwania' artykułów do kosza z poziomu menedżera artykułów. Jeżeli wartość tego parametru zostanie ustawiona na 'Tak', komentarze nie będą usuwane z bazy danych, dopóki administrator nie usunie ich z 'Artykułów w koszu'. Parametr będzie działał tylko dla komentarzy przechowywanych w tablicach.
• Dodać przycisk do publikacji lub kończenia publikacji komentarzy.
• Zmienić działanie parametru 'Natychmiast publikuj komentarze Gości':
  parametr ' Natychmiast publikuj komentarze Gości' ("Parametr globalnego nadzoru") pozwala na nadzór, czy chcesz by komentarze stworzone przez użytkowników były dostępne dla wszystkich użytkowników witryny od razu po ich dodaniu.
  Ustaw wartość 'Tak, dla wszystkich' by pozwolić na natychmiastową publikację komentarza, który będzie widoczny dla wszystkich,
  'Tak, dla zarejestrowanych użytkowników' - by zapewnić widoczność tylko zarejestrowanym użytkownikom.
  'Nie' - komentarze wszystkich użytkowników (z wyjątkiem użytkowników, którzy mają wszystkie prawa do edycji komentarzy) są dodawane do witryny, ale niewidoczne dla odwiedzających witrynę dopóki nie zostaną zatwierdzone (sprawdzone) i opublikowane przez Wydawcę witryny lub Administratora (bardziej precyzyjnie: przez użytkownika, który posiada wszystkie prawa do edycji komentarzy).
• Przenieść listy 'Wybierz stan' oraz 'Ekran #' na szczyt.
  Być może na szczyt zostanie także przeniesione stronicowanie...
• ? Parametr "Kategoria komentarza" w formularzu do edycji komentarza. Tak więc będę musiał dodać Kategorie komentarzy do widoków...
• ? Parametry dodatku dla pozycji z menu (sposób na konfigurację wyglądu dodatku komentarzy dla różnych pozycji z menu).
• ? "Może po prostu śnię, ale pewnego dnia chciałbym zobaczyć funkcję (mootools? js?), który ukrywałby/pokazywałby komentarze podobnie do niektórych dodatków dla wordpressa - np. ten wykorzystywany w J! developers blog )" (rufuz)".
• ? Poprawić komentarze do komentarzy:
  • Parametr pozwalający na rozwijanie/zwijanie drzewa komentarzy.

Informacje dla programistów

yvComment został napisany od podstaw specjalnie dla Joomla! 1.5 i nie jest kompatybilny z wcześniejszymi wersjami Joomla!/Mambo. Tak więc może śmiało wykorzystywać nawet najbardziej zaawansowane funkcje dostępne w Joomla! 1.5.

Moją intencją jest tworzenie rozszerzenia, które jest jak najbardziej "naturalne", natywne dla Joomla, które wykorzystuje tak wiele wbudowanych (lub istniejących) cech (i narzędzi, rozszerzeń, włączając w to produkty zewnętrzne, przygotowane dla Joomla!), jak to tylko możliwe.

yvComment wykorzystuje wzorzec architektury MVC (ang. Model-View-Controller). Myślę, że dla programisty najciekawszym faktem jest to, że yvComment wykorzystuje ten sam kod MVC dla wszystkich części: Komponentu, Modułu i Dodatku. Tak więc klasy Komponentu, Modułu i Dodatku są w rzeczywistości różnymi interfejsami do tego samego jądra yvComment.

Model danych

yvComment posiada dwie możliwości: wykorzystuje tablice 'treści' (ang. content) Joomla! lub wykorzystuje swoją własną tablicę. W obu przypadkach struktura tablicy jest taka sama: tak JAK to zostało zdefiniowane w pliku 'installation/sql/mysql/joomla.sql', por. 'Table structure for table `#__content`'.

Jeżeli chcesz zobaczyć, jakie dane znajdują się w tej tablicy, wykorzystaj jakiegoś menedżera SQL (np. phpMyAdmin) do wyświetlenia zawartości tablicy 'jos_content' (lub tablicy 'jos_yvcomment', jeżeli nie chcesz wykorzystać tablicy treści (ang. content) do przechowywania komentarzy) swojej bazy danych.

yvComment wykorzystuje tablicę 'treści' (ang. content) w taki sam sposób, w jaki wykorzystuje ją środowisko Joomla!, dzięki czemu możesz wykorzystać do wyświetlenia/edycji/administracji komentarzy dowolne rozszerzenie.
Istnieją pewne zastosowania tablic treści (ang. content). Poniżej podaję listę tych rozszerzeń:

• Każdy komentarz jest łączem do artykułu poprzez pole 'parentid'. Tak więc, dla przykładu, jeżeli masz artykuł "Przykładowy Artykuł" z id=4, wszystkie komentarze do artykułu "Przykładowy Artykuł" będą miały parentid=4. Myślę, że jest to prawidłowe użycie istniejącego pola z tablicy 'jos_content'. Takie podejście pozwala na dowolny poziom hierarchii: pojęciowo każdy komentarz może być skomentowany. Planuję dodać do yvComment możliwość 'komentowania komentarzy'...
• Proszę zwróć uwagę, że yvComment wykorzystuje pewne dodatkowe 'atrybuty' komentarzy. Wszystkie te dodatkowe atrybuty są przechowywane polu 'metadata' tablicy 'treści' (ang. content). Znowu, jest to prawidłowe użycie tego pola, a nie 'sztuczka' na jądrze Joomla!

Translated into Polish by mslonik (http://mslonik.pl) 2008-12-17.