English | Polski | Donate | Forum |
yvSmiley |
wer. 1.3.1, (0.03Mb) ostatnia zmiana:
25 sierpień 2008. Co nowego?, Dla programistów Pobierz yvSmiley: JoomlaCode, plik lokalny (rozpakuj przed instalacją). |
yvSmiley to "uśmieszkowe" (ang. smiley) rozszerzenie, wyświetlające emotikony (obrazki uśmieszków), przeznaczone dla środowiska Joomla! 1.5. Może wyświetlać uśmieszki w treści artykułów (działając jak dodatek treści (ang. content)), w obszarze całej witryny (będziesz mógł wyświetlić uśmieszki w dowolnym miejscu) lub może być używane przez dowolne rozszerzenie Joomla! (przykładowo zostało zintegrowane z moim rozszerzeniem yvComment).
Dodatek yvSmiley jest dostarczany wraz z dwoma gotowymi do natychmiastowego użycia "zestawami uśmieszków" (pochodzącymi z TinyMCE oraz phpBB), które możesz dowolnie dostosować do swoich potrzeb; ponadto jest zgodny ze skórkami aMSN (Komunikator Alvaro), dzięki czemu możesz wybierać spośród wielu istniejących "zestawów uśmieszków", które są częścią tych skórek i wykorzystywać je bez żadnych zmian (pobierz skórki z http://www.amsn-project.net/skins.php).
Rozszerzenie yvSmiley zostało napisane od podstaw z myślą o środowisku Joomla! 1.5. Nie jest kompatybilne z wcześniejszymi wersjami Joomla!/Mambo. Dzięki temu może swobodnie korzystać nawet z najbardziej zaawansowanych możliwości środowiska Joomla! 1.5.
...Uśmieszki są sposobem na nawiązanie niewerbalnej, bezpośredniej komunikacji .
1. By zainstalować yvSmiley MUSISZ posiadać środowisku Joomla! 1.5, co najmniej w wersji 8688 (RC2 z dnia 2007-08-31), lub nowsze (porównaj wskazówkę). Rozszerzenie yvSmiley należy do kategorii "dodatków systemowych".
2. Paczka z oprogramowaniem yvSmiley zawiera wyłącznie pliki w języku angielskim. Jeżeli potrzebujesz wersji przetłumaczonej na inny język (języki), pobierz i zaninstaluj z JoomlaCode paczki językowe yvSmiley (yvSmileyLanguagePack). (Po instalacji paczki yvSmileyLanguagePack nie trzeba jej włączać!)
W przypadku napotkania problemów proszę zapoznaj się z poniższym rozdziałem pt. Rozwiązywanie problemów.
"Zestaw uśmieszków" to zbiór małych obrazków (tzw. emotikon), np. ), wraz z przypisanymi im kodami (np. ;-) ) oraz opisami (np. "mrugnięcie"). Temu samemu uśmieszkowi może być przypisany więcej niż jeden kod (np. ;-) oraz ;) ). Gdy yvSmiley wyświetla listę wszystkich uśmieszków (w postaci klikalnej tablicy uśmieszków), pokazuje tylko pierwszy z kodów przypisanych danemu uśmieszkowi.
"Zestawy uśmieszków" są przechowywane w plikach tekstowych, więc bardzo łatwo można dopasować je do swoich potrzeb lub je wymienić. Oczywiście plik z "zestawem uśmieszków" nie zawiera samych obrazków: zawiera tylko adresy URL (nazwy plików) obrazków reprezentujących uśmieszki.
yvSmiley współpracuje z dwoma formatami plików 'zestawów uśmieszków':
";)";UŚMIESZEK_MRUGNIĘCIE;/plugins/editors/tinymce/jscripts/tiny_mce?plugins/emoticons/images/smiley-wink.gif- jak widzisz pojedyncza linia zawiera 'stałą językową' (w powyższym przykładzie jest to UŚMIESZEK_MRUGNIĘCIE), więc opis znaczenia danego uśmieszku może zostać przetłumaczony (zlokalizowany).
Konfiguracja polega na zmianie "parametrów dodatku yvSmiley" (Zaplecze witryny -> Rozszerzenia -> Dodatki -> yvsmiley).
Na liście "Plik i format pliku z zestawem uśmieszków" znajdują się cztery "zestawy uśmieszków":
dwa gotowe:
oraz dwa przeznaczone na zestawy dopasowane do indywidualnych potrzeb:
Kolejne dwie pozycje wymagają uzupełnienia pola "Ścieżka dostępu do pliku z własnym 'zestawem uśmieszków'", czyli podania ścieżki dostępu: pełnej lub względnej, od głównego katalogu witryny (pierwszym znakiem powinien być '/'). Zaleca się (a dla formatu skórek aMSN wprost wymaga) podania względnej ścieżki dostępu, dzięki czemu adresy URL do obrazków zapisane w pliku 'zestawu uśmieszków' również mogą być względne.
Przykładowo możesz przetestować wybór 'Plik z własnym "zestawem uśmieszków" w formacie CSV' wpisując następującą ścieżkę:
/plugins/system/yvsmiley/phpbb/smileyset.csv
Oczywiście możesz dla swoich uśmieszków stworzyć osobny katalog, np. '/templates/smileys/' i tam umieścić swój 'zestaw uśmieszków'.
Dla przykładu:
Osobiście używam następującego zestawu uśmieszków:
yvSmiley umożliwia wyświetlanie uśmieszków w treści artykułów (spełnia funkcję dodatku treści (ang. content)). Domyślnie ta funkcja ('Włącz wyświetlanie uśmieszków w treści artykułów') jest wyłączona, lecz możesz to zmienić (wybrać 'Tak').
Możesz ograniczyć wyświetlanie uśmieszków tylko do artykułów należących do wybranych sekcji. Jeżeli właśnie tego chcesz wpisz listę ID wybranych sekcji oddzielone przecinkami (,) w polu parametru "Oddzielona przecinkami lista ID...". Pozostaw to pole puste, jeżeli kody uśmieszków mają być zastępowane obrazkami uśmieszków we wszystkich sekcjach.
Dodatkowy parametr: "Wyklucz Sekcje podane powyżej ('Nie' - włącza)" pomaga w sporządzeniu krótszej listy ID sekcji. Jeżeli nie chcesz mieć uśmieszków tylko w kilku Sekcjach, to ustaw wartość tego parametru na "Tak" (tzn. "wyłącz") i wpisz (w polu parametru "Oddzielona przecinkami lista ID...") tylko ID sekcji, które mają zostać wyłączone.
Dla przykładu porównaj, jak yvSmiley zmienia wygląd artykułu: wykorzystano skórkę aMSN MSN_Live
Jak widzisz yvSmiley zmienił wygląd tego artykułu w takim samym stopniu co wygląd komentarza w poprzednim przykładzie.
Tak więc istnieją powody, by 'Włączyć wyświetlanie uśmieszków w treści artykułów', przynajmniej dla tych sekcji, gdzie Komentarze żyją .
yvSmiley umożliwia zastępowanie uśmieszków w dowolnej części witryny (parametr "Włącz wyświetlanie uśmieszków w całym obszarze witryny"). Dziękuję za poddanie tego pomysłu louis.landry!
Domyślnie yvSmiley korzysta z prostego pliku syli CSS (/plugins/system/yvsmiley/default.css), który został pomyślany jako punkt wyjściowy dla samodzielnych przeróbek. Jeżeli jakoś zmieniłeś plik CSS w swoim szablonie, zmień wartość parametru "Korzystaj z domyślnego pliku stylów CSS" na "Nie".
Do chwili obecnej yvSmiley został przetłumaczony na następujące języki: niemiecki, angielski, francuski, rosyjski, turecki.
Powodzenia!
Pochodzące od ciebie informacje (sprzężenie zwrotne) są bardzo mile widziane!
Rozszerzenie yvSmiley zostało napisane od podstaw z myślą o środowisku Joomla! 1.5, przez co nie jest kompatybilne z wcześniejszymi wersjami Joomla!/Mambo. Dzięki temu może swobodnie korzystać nawet z najbardziej zaawansowanych możliwości oferowanych przez środowisko Joomla! 1.5.
Moją intencją jest stworzenie rozszerzenia, które w jak największym stopniu jest "naturalne" z puntku widzenia środowiska Joomla, które wykorzystuje możliwie jak najwięcej możliwości dostarczanych przez to środowisko.
By skorzystać z yvSmiley inne rozszerzenia nie muszą się do niego w żaden sposób odwoływać: po prostu wyzwalają zdarzenia, które są przechwytywane przez rozszerzenie yvSmiley (o ile zostało ono zainstalowane i włączone). Jeżeli rozszerzenie yvSmiley nie zostało zainstalowane lub jeżeli jest wyłączone, nie doprowadzi ono do wystąpienia jakichkolwiek błędów!
Rozszerzenie yvSmiley zawsze rejestruje obsługę dwóch zdarzeń:
$Form = ''; $mainframe->triggerEvent('onSmiley_RenderForm', array('document.forms.yvCommentForm.fulltext', &$Form) ); echo $Form;
$fulltext = 'Some Text To Be Rendered :-)'; $mainframe->triggerEvent('onSmiley_RenderText', array (& $fulltext) ); echo $fulltext;
Jak widać inne rozszerzenia mogą w BARDZO łatwy sposób korzystać z yvSmiley.
Możesz obejrzeć przykłady wykorzystania yvSmiley w Rozszerzeniu yvComment .
GPL. Wolne oprogramowanie (od wolności), do tego za darmo. Jeżeli podoba Ci się to rozszerzenie, proszę wspomóż mnie finansowo.
To rozszerzenie Joomla! jest rozpowszechniane "tak jak jest", bez żadnej gwarancji, tak wyraźnej jak i domniemanej.
(c) 2007-2009 Yuri Volkov, Moskwa, Rosja
This page was translated by mslonik (http://mslonik.pl).