Szczegóły

mslonik

Opublikowano: 11 grudzień 2010

Odsłony: 31060

Spis treści:

Wstęp

Rozszerzenia

Funkcjonalność

Instalacja

Sprawdzenie poprawności instalacji

Jak to działa

Deinstalacja

Konfiguracja dodatku YASIG

Składnia galerii YASIG

Konfiguracja dodatku yasiguncle

FAQ (Często zadawane pytania)

Wsparcie, pomoc

Automatyczne przerabianie zdjęć po stronie klienta

Zespół

Apel

 

---

Wstęp

Jak każdy inny rodzaj treści, także galeria zdjęć służy do wymiany informacji pomiędzy:

• Autorem - twórcą strony internetowej, a
• Użytkownikiem - osobom odwiedzającą stronę Autora.

Rolą Autora jest wybór zestawu zdjęć, które zamierza zaprezentować w Internecie Użytkownikom. Ten zestaw, albo inaczej zbiór zdjęć nazwany został galerią. Działania związane z przygotowaniem galerii zdjęć Autor prowadzi na tzw. zapleczu strony, czyli po zalogowaniu się do zaplecza. Przygotowanie zdjęć jest w znacznym stopniu zautomatyzowane, co pozwala na przyspieszenie publikacji.

Z puntku widzenia Użytkownika zdjęcia prezentowane są najczęściej w postaci pomniejszonych wersji zdjęć, czyli tzw. miniatur. Po kliknięciu na którąś z miniatur wyświetlane jest zdjęcie w pełnym rozmiarze. Za pomocą klawiatury lub myszy możliwe jest obejrzenie innych zdjęć tworzących galerię.

Podsumowując, YASIG to rozwiązanie, które przy pomocy kilku rozszerzeń pozwala na:

• przygotowanie zdjęć, z których autor tworzy galerię,
• prezentację zdjęć osobom odwiedzającym naszą witrynę.

Przetwarzanie zdjęć (np. zmiana rozmiaru, dodanie ramki wokół zdjęć itp.) następuje po stronie serwera, czyli po przesłaniu zdjęć na serwer. Takie rozwiązanie może być wygodne dla osób prowadzących np. portale społecznościowe. Wszystko, czego wymaga się od użytkowników, to przesłanie zdjęć do konkretnego katalogu umieszczonego na serwerze.

Zespół rozszerzeń YASIG został przygotowany z myślą o środowisku Joomla! w wersji 2.5.x. Do działania inteligentnie wykorzystuje bibliotekę Javacript JQuery.

Obsługiwane typy plików graficznych: .JPG oraz .PNG

Do wyświetlania efektów graficznych wykorzystywany jest efekt Lightbox, a w zasadzie jego 'odchudzony brat', czyli Slimbox.

Do przetwarzania zdjęć (zmniejszenie, dodanie obramowania itp.) wykorzystano bibliotekę GD.

Powrót do Spisu treści.

 

---

Rozszerzenia

Rozszerzenia, które składają się na YASIG zostały przedstawione w poniższej tabeli:

Lp.	Typ rozszerzenia	Nazwa rozszerzenia	Kategoria rozszerzenia	Funkcja
1.	dodatek (ang. plugin)	plg_yasig	treść (ang. content)	Galeria zdjęć.
2.	komponent (ang. component)	com_yasiguncle	treść (ang. content)	Silnik przetwarzający zdjęcia.
3.	dodatek (ang. plugin)	plg_yasiguncle	rozszerzenie edytora (ang. editors-xtd)	Rozszerzenie edytora.
4.	paczka (ang. package)	pkg_yasiguncle	-	Instalator / deinstalator pozostałych rozszerzeń.

 

Rozszerzenie plg_yasig może być wykorzystywane samodzielnie. Użytkownik może samodzielnie przetwarzać pliki graficzne (więcej na ten temat w rozdziale Automatyczne przerabianie zdjęć po stronie klienta) i samodzielnie przygotowywać wywołania galerii (więcej na ten temat w rozdziale (Składnia galerii YASIG).

Rozszerzenia com_yasiguncle i plg_yasiguncle zawsze powinny być instalowane wspólnie z rozszerzeniem plg_yasig. Instalacja tych rozszerzeń pojedynczo nie ma sensu, bo użytkownik nie uzyska w ten sposób żadnej dodatkowej funkcjonalności.

Rozszerzenie pkg_yasiguncle pozwala na łatwą i szybką instalację wszystkich potrzebnych rozszerzeń.

Powrót do Spisu treści.

 

---

Funkcjonalność

Funkcjonalność zależy od przyjętego punktu widzenia:

• Autora lub
• Użytkownika.

Z punktu widzenia Autora:

Funkcja	Opis
Galeria jest tekstem w treści artykułu.	Wstawienie galerii ze zdjęciami polega na wstawieniu do treści wybranego artykułu pewnego ciągu znaków o ustalonym porządku ograniczonego znakami nawiasu klamrowego: {...}. Silnik obsługujący stronę www (Joomla!) zadba o interpretację tego ciągu w taki sposób, by Użytkownik ujrzał galerię zdjęć. Ponieważ miejsce w artykule, w którym znajdzie się galeria składa się wyłącznie z tekstu, to praca nad edycją galerii jest prosta i szybka. Wszystkie działania polegają na edycji tekstu, a więc do obsługi tak przygotowanej galerii wystarczy jakikolwiek edytor. Podczas edycji galerii nie są ściągane zdjęcia składowe, tworzące galerię, a edycji podlega wyłącznie tekst. Znacznie przyspiesza to pracę nad edycją galerii.
Możliwość dołączenia do zdjęć komentarza.	Użytkownik zobaczy komentarz po krótkiej chwili po najechaniu kursorem na miniaturę zdjęcia oraz bezpośrednio pod zdjęciem w rozmiarze normalnym. Komentarze nie muszą być umieszczone w osobnym pliku ani nie są umieszczane w nagłówku pliku. Dzięki temu ich zmiana sprowadza się do prostej edycji tekstu.
Indeksowanie przez Google tak zdjęć jak i komentarzy pod zdjęciami.	Zarówno nazwy plików zdjęć, jak i teksty komentarzy pod zdjęciami są indeksowane przez wyszukiwarkę Google. Oznacza to, że po przygotowaniu galerii będzie możliwe wyszukanie tych łańcuchów tekstowych za pomocą wyszukiwarki Google.
Pełna kontrola nad wielkością i kolejnością zdjęć.	Mamy pełną kontrolę nad wielkością i kolejnością zdjęć. Wielkość zdjęć można wybrać na etapie przygotowania galerii. Zmiana kolejności zdjęć polega na zmianie kolejności odpowiednich sekcji tekstu, do czego wystarczy edytor.
Duża szybkość działania	Wiele galerii zdjęć działa w ten sposób, że pobierają informacje o tym, gdzie położone są zdjęcia w oryginalnym rozmiarze i dopiero w chwili, gdy użytkownik zaczyna przeglądać przygotowaną przez nas galerię, zmieniają rozmiary zdjęć, przechowując zmniejszone kopie tymczasowo w pamięci serwera. Gdy użytkownik kończy przeglądać galerię te tymczasowe kopie są usuwane. Operacje zmniejszania rozmiaru zdjęć wymagają czasu i sporych zasobów tak pamięci jak i procesora serwera. Z punktu widzenia użytkownika czas potrzebny na zmniejszenie aktualnie oglądanych zdjęć dodaje się do czasu potrzebnego do ściągnięcia zdjęć z naszej strony. Wszystko fajnie, jeżeli naszą stronę odwiedza kilku użytkowników, a każdy z nich ogląda inną galerię. Jeżeli jednak mamy więcej odwiedzin, to może się zdarzyć, że po pierwsze, serer nie da rady szybko i sprawnie przerobić większej liczby zdjęć, a po drugie znacznie wydłuży się czas oczekiwania użytkownika na efekt tych działań. YASIG wczytuje już przygotowane zdjęcia, czekające na serwerze. Odpada czas potrzebny na przerabianie zdjęć. Ponadto serwer jest w stanie obsłużyć wielu użytkowników jednocześnie. Można więc powiedzieć, że YASIG dobrze sprawdza się w przypadku dużych, popularnych galerii...
Oszczędność miejsce na serwerze	YASIG wyświetla przygotowane przez nas wcześniej zdjęcia. Pliki zdjęć po przygotowaniu galerii często zajmują o wiele mniej miejsca od plików, które zostały wybrane przez Użytkownika i przesłane na serwer. Przykładowo zdjęcie w rozmiarze 2816 x 2112 (punktów) zajmuje około 2,4 MB. To samo zdjęcie w rozmiarze 640 x 480 (punktów) zajmuje około 81,6 kB, a w rozmiarze 200 x 150 (punktów) zajmuje około 18,5 kB. W ten prosty sposób na jednym zdjęciu "oszczędzamy" około 2,3 MB.

 

Z punktu widzenia Użytkownika:

Funkcja	Opis
Duża szybkość działania	Wiele galerii zdjęć działa w ten sposób, że pobierają informacje o tym, gdzie położone są zdjęcia w oryginalnym rozmiarze i dopiero w chwili, gdy użytkownik zaczyna przeglądać przygotowaną przez nas galerię, zmieniają rozmiary zdjęć, przechowując zmniejszone kopie tymczasowo w pamięci serwera. Gdy użytkownik kończy przeglądać galerię te tymczasowe kopie są usuwane. Operacje zmniejszania rozmiaru zdjęć wymagają czasu i sporych zasobów tak pamięci jak i procesora serwera. Z punktu widzenia użytkownika czas potrzebny na zmniejszenie aktualnie oglądanych zdjęć dodaje się do czasu potrzebnego do ściągnięcia zdjęć z naszej strony. Wszystko fajnie, jeżeli naszą stronę odwiedza kilku użytkowników, a każdy z nich ogląda inną galerię. Jeżeli jednak mamy więcej odwiedzin, to może się zdarzyć, że po pierwsze, serer nie da rady szybko i sprawnie przerobić większej liczby zdjęć, a po drugie znacznie wydłuży się czas oczekiwania użytkownika na efekt tych działań. YASIG wczytuje już przygotowane zdjęcia, czekające na serwerze. Odpada czas potrzebny na przerabianie zdjęć. Ponadto serwer jest w stanie obsłużyć wielu użytkowników jednocześnie. Można więc powiedzieć, że YASIG dobrze sprawdza się w przypadku dużych, popularnych galerii...
Możliwość przewijania zdjęć za pomocą myszy	Przechodzenie pomiędzy zdjęciami składającymi się na galerię jest możliwa poprzez klikanie myszą. Wystarczy kursorem najechać na prawą lub lewą połowę aktualnie powiększonego zdjęcia. Wyświetlą się dodatkowe wskazówki ułatwiające przechodzenie pomiędzy zdjęciami tworzącymi galerię: przejście do kolejnego zdjęcia w galerii nastąpi poprzez najechanie kursorem myszy na prawą część aktualnie powiększonego zdjęcia i kliknięcie lewym przyciskiem myszy, przejście do poprzedniego zdjęcia w galerii nastąpi poprzez najechanie kursorem myszy na lewą część aktualnie powiększonego zdjęcia i kliknięcie lewym przyciskiem.
Możliwość przewijania za pomocą klawiatury (skrótów klawiszowych)	Przechodzenie pomiędzy zdjęciami składającymi się na galerię jest możliwe poprzez naciskanie klawiszy klawiatury: przejście do kolejnego zdjęcia w galerii nastąpi po naciśnięciu klawisza 'prawy kursor' (->) lub klawisza podkreślonej litery widocznej w napisie obrazka, który pojawi się po najechaniu kursorem myszy na prawą połowę zdjęcia, przejście do poprzedniego zdjęcia w galerii nastąpi po naciśnięciu klawisza 'lewy kursor' (<-) lub klawisza podkreślonej litery widocznej w napisie obrazka, który pojawi się po najechaniu kursorem myszy na lewą połowę zdjęcia, opuszczenie galerii nastąpi po naciśnięciu klawisza 'Esc'.

Powrót do Spisu treści.

 

---

Instalacja

Instalacja jest możliwa na dwa następujące sposoby:

1. Wykorzystanie paczki instalacyjnej. Jest to zalecana, domyślna metoda instalacji. Skrypty wykonywane w trakcie instalacji paczki zadbają o prawidłową instalację wszystkich rozszerzeń składających się na rozwiązanie YASIG.
2. Ręczna instalacja poszczególnych rozszerzeń.

Typowo wszystkie czynności związane z instalacją rozszerzeń wykonuje administrator witryny.

 

Wykorzystanie paczki instalacyjnej

Poniżej przedstawiono domyślną procedurę instalacji.

1. Pobierz paczkę instalacyjną:

• Katalog / repozytorium rozszerzeń Joomla!: http://extensions.joomla.org/, wybrać opcję "Download".
• Strona projektu: http://joomlacode.org/gf/project/yasig/, wybrać z lewego menu "Files".

Paczka instalacyjna ma postać pliku, który w nazwie zawiera człon "pkg" oraz ma rozszerzenie .zip, np. "pkg_yasiguncle_j.2.5.zip". Zapamiętaj położenie paczki na dysku.

 

2. Zaloguj się na zapleczu witryny

W pasku adresu przeglądarki wpisz adres swojej witryny zakończony członem "administrator", przykładowo: http://adres_naszej_witryny.rozszerzenie/administrator Po chwili ekran powinie przybrać postać jak na sąsiednim obrazku.

 

3. Instalacja pliku paczki

Przejdź do menedżera rozszerzeń: menu -> Rozszerzenia -> Instalacje.
Z menu wybierz zakładkę Instalator.
Naciśnij przycisk "Przeglądaj" i wskaż położenie pliku paczki (np. "pkg_yasiguncle_j.2.5.zip").
Wciskamy przycisk Instaluj.
Po chwili wyświetlony zostanie komunikat informujący o prawidłowym przebiegu procesu instalacji ("Pakiet zainstalowano poprawnie").

Skrypty wykonywane podczas instalacji paczki automatycznie włączają zainstalowa dodatki.

Film pokazujący instalację oraz sprawdzenie poprawności instalacji:

 

Powrót do Spisu treści.

 

---

Sprawdzenie poprawności instalacji

W celu sprawdzenia, czy instalacja przebiegła prawidłowo, przejdź do Menedżera rozszerzeń: menu -> Rozszerzenia -> Instalacje.
Wybierz zakładkę "Zarządzanie".
W okienku "Filtr" wpisz ciąg "yasig" i wciśnij znajdujący się na prawo przycisk "Znajdź". Po chwili powinieneś zobaczyć tabelę. Każdy z wierszy tej tabeli odpowiada jednemu z 4 właśnie zainstalowanych rozszerzeń: com_yasiguncle pkg_yasiguncle plg_yasig plg_yasiguncle Są to rozszerzenia tworzące rozwiązanie yasig.

Powrót do Spisu treści.

 

---

Jak to działa

Przygotowanie galerii wymaga od Autora:

1. wyboru zdjęć, z których chce stworzyć galerię,
2. wgrania zdjęć na serwer Joomla! do wybranego przez Autora katalogu - katalogu wejściowego,
3. ewentualnie stworzenie katalogu, w którym znajdą się zdjęcia po przetworzeniu, czyli katalogu wyjściowego,
4. wybrania artykułu, w którym ma zostać umieszczona galeria.

Pozostałe czynności, czyli:

1. przetworzenie zdjęć: przygotowanie ze zdjęć wybranych przez Autora zdjęć w rozmiarze normalnym oraz miniatur.
2. przygotowanie treści wywołań galerii YASIG.
3. wstawienie treści wywołań galerii YASIG do wybranego artykułu

zostaną wykonane automatycznie przez rozszerzenia yasiguncle (komponent oraz rozszerzenie edytora). Autor galerii będzie mógł jeszcze ręcznie uzupełnić opisy (komentarze) poszczególnych zdjęć. Domyślnie jako opis (komentarz) zdjęć wstawiana jest nazwa pliku graficznego.

 

Sytuacja początkowa wygląda więc mniej więcej tak:

1. Autor poprawnie zainstalował rozwiązanie YASIG (wszystkie rozszerzenia),
2. w wybranym katalogu na serwerze (np. images/stories/yasig_input) Autor galerii umieszcza np. 2 zdjęcia, jak w opisie w poniższej tabeli,

Nazwa pliku	Orientacyjna wielkość pliku	Rozmiar zdjęcia [px] x [px]
IMG_7952_KaluznicaCzarnozielona.JPG	1.6 MiB	1704 x 2272
IMG_7954_KaluznicaCzarnozielona.JPG	1.5 MiB	1704 x 2272

 

Autor wybrał artykuł, w którym zamierza umieścić galerię, otworzył ten artykuł, wybrał miejsce w treści, w którym ma znaleźć się galeria
Pod okienkiem edytora znajduje się przycisk 'yasiguncle'. Wciśnięcie tego przycisku uruchomi kreatora, który zrealizuje wymienione powyżej czynności.
Wspomniany przycisk.
Po naciśnięciu przycisku ekran zostanie przysłonięty widocznym obok okienkiem. Jest to tzw. kreator. Autor galerii powinien skonfigurować przynajmniej niektóre opcje. Przede wszystkim powiniem wskazać katalog wejściowy, czyli ten, w którym umieścił zdjęcia oraz katalog wyjściowy, czyli ten, w którym powinny znaleźć się zdjęcia powstałwe w wyniku ich przetwarzania. (Autor ma możliwość zmiany wartości opcji wyświetlanych po uruchomieniu kreatora, patrz rozdział Konfiguracja dodatku yasiguncle).
Autor ma możliwość zmiany opcji 'Katalog wejściowy' oraz 'Katalog wyjściowy' na dwa sposoby. Metodą zalecaną jest kliknięcie w drugi wiersz pod tekstem "Katalog wejściowy" oraz "Katalog wyjściowy", co spowoduje rozwinięcie okienka z listą katalogów znajdujących się na serwerze. W ten sposób, za pomocą myszy, można wybrać odpowiednie katalogi. Drugą metodą jest wpisanie ścieżki dostępu do odpowiednich katalogów w pierwszym wierszu pod tekstem "Katalog wejściowy" oraz "Katalog wyjściowy'. Na sąsiednim ekranie Autor zmienił wybrane opcje. Poprzez kliknięcie odnośnika Pokaż panel konfiguracyjny można uzyskać dostęp do większej liczby ustawień. Po upewnieniu się, że wszystkie opcje zostały ustawione zgodnie z wolą Autora powinien on kliknąć na przycisk 'Przejdź do kolejnego kroku'.
Na ekranie pojawi się niewielkie kółeczko symbolizujące przetwarzanie kolejnych zdjęć. Po chwili na ekranie pojawi się składnia galerii YASIG oraz przycisk 'Wstaw wywołanie galerii YASIG do treści artykułu'. Należy wcisnąć ten przycisk.
Po wciśnięciu przycisku w treści artykułu znajdzie się poprawne wywołanie galerii YASIG.

W poniższej tabeli umieszczono efekty przetwarzania przykładowych plików graficznych.

Pliki stworzone przez yasiguncle	Orientacyjna wielkość pliku	Rozmiar zdjęcia [px] x [px]
200_IMG_7952_KaluznicaCzarnozielona.JPG	10,8 KiB	150 x 200
640_IMG_7952_KaluznicaCzarnozielona.JPG	95,1 KiB	480 x 640
200_IMG_7954_KaluznicaCzarnozielona.JPG	11,2 KiB	150 x 200
640_IMG_7954_KaluznicaCzarnozielona.JPG	87,9 KiB	480 x 640

Gotowe! Efekty działania galerii możesz obejrzeć w Demo.

Krótki film pokazujący, jak wygląda w praktyce przygotowanie galerii zdjęć:

Krótki film pokazujący, jak działa galeria z punktu widzenia Użytkownika:

 

Powrót do Spisu treści.

 

---

Deinstalacja

Przejdź do Menedżera rozszerzeń: menu -> Rozszerzenia -> Instalacje.
Wybierz zakładkę "Zarządzanie".
W okienku "Filtr" wpisz ciąg "yasig" i wciśnij znajdujący się na prawo przycisk "Znajdź". Po chwili powinieneś zobaczyć tabelę. Każdy z wierszy tej tabeli odpowiada jednemu z 4 właśnie zainstalowanych rozszerzeń: com_yasiguncle pkg_yasiguncle plg_yasig plg_yasiguncle Są to rozszerzenia tworzące rozwiązanie yasig.
Zaznacz kwadracik po prawej stronie od rozszerzenia "pkg_yasiguncle".
Wciśnij przycisk "Odinstaluj". Po chwili na ekranie powinny pojawić się komunikaty: "Pakiet odinstalowano" oraz "Brak zainstalowanych rozszerzeń pasujących do Twojego pytania". (Ten drugi komunikat jest rezultatem wciąż widniejącego na ekranie wpisu w polu "Filtr").

Powrót do Spisu treści.

 

---

Konfiguracja dodatku YASIG

Rozszerzenie (dodatek) YASIG odpowiada za sposób wyświetlania zdjęć Użytkownikowi. Panel konfiguracyjny dodatku YASIG jest dostępny po zalogowaniu na zaplecze witryny.

Wybierz z menu: Rozszerzenia -> Dodatki.
Po chwili zostanie wyświetlona lista wszystkich zainstalowanych dodatków.
W polu "Filtr" wpisz "yasig", a następnie wciśnij znajdujący się na prawo od pola "Filtr" przycisk "Znajdź". Po chwili na ekranie zostaną wyświetlone zainstalowane rozszerzenia pasujące do kryterium filtru. Kliknij na dodatku "plg_yasig".
Zostanie wyświetlony ekran konfiguracyjny rozszerzenia. Składa się on z kilku obszarów: Szczegóły Opcje podstawowe Dalej omówiony zostanie znajdujący się po prawej stronie obszar "Opcje podstawowe".
Szczegóły przedstawiają przede wszystkim składnię galerii. Ponieważ wykorzystanie składni galerii nie jest konieczne do korzystania z niej, nie zostanie tutaj dokładniej omówione. Szczegółowe wyjaśnienie składni galerii znalazło się poniżej w sekcji Składnia galerii YASIG.
Obszar "Opcje podstawowe".

Opis opcji staje się widoczny po najechaniu kursorem na etykietę opcji.

Nazwa opcji	Opis opcji	Wartość domyślna	Komentarz
Zapętl zdjęcia	Pozwala przechodzić pomiędzy ostatnim i pierwszym zdjęciem oraz na odwrót	NIE	Wybór możliwości TAK spowoduje, że po przewinięciu zawartości galerii do ostatniego zdjęcia po naciśnięciu przycisku 'Nast.' wyświetli się ponownie pierwsze zdjęcie galerii.
Stopień przyciemnienia	Jak bardzo przyciemnione ma być tło podczas wyświetlania obrazka (0 - w ogóle, 1 - całkowicie).	0.8	Po kliknięciu na dowolną miniaturę tło strony zostaje przysłonięte (przyciemnione), a na pierwszym planie zostaje wyświetlony obrazek w tzw. pełnym rozmiarze. Parametr 'stopień przyciemnienia' decyduje o przezroczystości przysłonięcia (przyciemnienia).
Kolor tła	Kolor tła obrazka	#000000 (czarny)	Kolor tła obrazka. Do wyboru są kolory dostępne z rozwijalnej listy: czarny, czerwony, różowy, żółty, zielony, jasnoniebieski, niebieski, biały.
Górny margines	Górny margines	0	Dla widoku miniatur, możliwość wyboru (w punktach / pikselach) wielkości marginesu pomiędzy górną krawędzią miniatury, a treścią poprzedzającą.
Prawy margines	Prawy margines	10	Dla widoku miniatur, możliwość wyboru (w punktach / pikselach) wielkości marginesu pomiędzy prawą krawędzią miniatury, a treścią poprzedzającą.
Dolny margines	Dolny margines	10	Dla widoku miniatur, możliwość wyboru (w punktach / pikselach) wielkości marginesu pomiędzy dolną krawędzią miniatury, a treścią poprzedzającą.
Lewy margines	Lewy margines	0	Dla widoku miniatur, możliwość wyboru (w punktach / pikselach) wielkości marginesu pomiędzy lewą krawędzią miniatury, a treścią poprzedzającą.
Napis 'Nast'	Opis z prawej strony obrazka jako link do następnego zdjęcia	'Nast.'	Tekst wyświetlany w obszarze przycisku służącego do wyświetlenia kolejnego zdjęcia galerii.
Napis 'Poprz'	Opis z lewej strony obrazka jako link do poprzedniego zdjęcia	'Poprz.'	Tekst wyświetlany w obszarze przycisku służącego do wyświetlenia poprzedniego zdjęcia galerii.
Napis 'Zamknij'	Opis z prawej-dolnej strony obrazka jako link zamykający galerię	'Zamknij'	Tekst wyświetlany w obszarze przycisku powodującego zakończenie wyświetlania zdjęć w rozmiarze normalnym.
Napis 'Obrazek'	Część napisu z lewej-dolnej strony obrazka.	'Obrazek'	Tekst wyświetlany w obszarze bezpośrednio pod zdjęciem w rozmiarze normalnym.
Napis 'Z'	Druga część napisu z lewej-dolnej strony obrazka.	'Z'	Tekst wyświetlany w obszarze bezpośrednio pod zdjęciem w rozmiarze normalnym.
Załaduj JQuery	Załaduj JQuery razem z dodatkiem	TAK	Pozwala na wyłączenie biblioteki JQuery. Opcja jest przydatna w sytuacji, gdy witryna korzysta z innych rozszerzeń bazujących na JQuery. Pozwala na uniknięcie wielokrotnego ładowania do pamięci różnych bibliotek JQuery, co pozwala na zaoszczędzenie czasu wyświetlania strony oraz zmniejszenie błędów.
Instrukcja obsługi	Informacja dodatkowa wyświetlana pod obrazkiem	--	Pod każdym zdjęciem wyświetlanym w ramach galerii może znajdować się dodatkowy tekst. Może nim być np. instrukcja obsługi galerii.

Sens przynajmniej części opcji wymienionych w powyższej tabeli będzie bardziej jasny po obejrzeniu sąsiednich obrazków. Galeria służy do wyświetlania zdjęć:

• jako miniatur - w ten sposób wyświetlane są zdjęcia bezpośrednio na stronie www,
• jako zdjęć w rozmiarze normalnym - dostępnym po kliknięciu przez Użytkownika na jednej z miniatur.

 

Widok miniatur

Poniżej widoczna jest galeria składająca się z trzech identycznych obrazków w widoku miniatur. O odległościach pomiędzy poszczególnymi miniaturami decydują wartości opcji 'Górny margines', 'Prawy margines', 'Dolny margines' oraz 'Lewy margines'. Dzięki opcjom ustawiającym marginesy pojawiła się możliwość zmiany odległości między miniaturami. Miniatury wyglądają lepiej, szczególnie w przypadku większych galerii, po zmianie wielkości marginesów. YASIG nie pozwala na dowolne umieszczenie obrazków miniatur. Po prostu stara się wpasować obrazki w dostępną przestrzeń. Sporo zależy od szablonu (plików CSS), które zarządzają danym fragmentem strony. Może się zdarzyć, że w jednym wierszu zmieszczą się koło siebie 3 obrazki, a w kolejnym tylko 2. Warto zadbać o to, by w pojedynczej galerii były wyświetlane obrazki o orientacji poziomej, a w osobnej te o orientacji pionowej.

Jeżeli w sekcji dla któregoś obrazka został napisany komentarz, to po najechaniu kursorem na taką miniaturę po krótkiej chwili zostanie on wyświetlony 'w dymku'.

 

Widok zdjęć w rozmiarze normalnym

Gdy użytkownik kliknie na jednej z miniatur, spowoduje to uruchomienie znanego i lubianego skryptu Lightbox: aktualnie przeglądana strona zostanie przysłonięta przez półprzezroczyste tło, a na pierwszym planie zostanie wyświetlone zdjęcie w rozmiarze normalnym. Opcja 'Stopień przyciemnienia' decyduje o stopniu przyciemnienia tła, a opcja 'Kolor tła' o kolorze tła.
Jeżeli Użytkownik przesunie kursor myszy nad zdjęcie, zostaną dodatkowo wyświetlone przyciski nawigacyjne. Przykładowo, jeżeli kursor myszy znajedzie się ponad prawą połową zdjęcia, zostanie wyświetlony przycisk 'Nast.' sugerujący, że po jego kliknięciu zostanie wyświetlone kolejne zdjęcie galerii. Na sąsiednim obrazku zaznaczono sens opcji 'Napis 'Nast'' oraz pozycję przykładowego komentarza, o ile Autor zdecydował się opatrzeć dane zdjęcie komentarzem.
Na czerwono zaznaczono: na dole po lewej napis podający kolejność aktualnie wyświetlanego obrazku w galerii (opcja 'Napis 'Obrazek'' oraz opcja 'Napis 'Z''), na dole po prawej przycisk powodujący zamknięcie galerii (opcja 'Napis 'Zamknij''), u góry po lewej obrazek 'Poprz.' (opcja 'Napis 'Poprz'') sugerujący, że po kliknięciu przejdziemy do poprzedniego obrazka w galerii.
Opcja 'Instrukcja obsługi' pozwala na wyświetlenie dodatkowego napisu bezpośrednio pod zdjęciem. Może to być np. zdanie wyjaśniające Użytkownikowi jak przechodzić pomiędzy zdjęciami tworzącymi galerię.

Powrót do Spisu treści.

 

---

Składnia galerii YASIG

Galeria YASIG to ciąg znaków umieszczonych pomiędzy nawiasem klamrowym otwierającym "{" a nawiasem klamrowym zamykającym "}". Po nawiasie klamrowym otwierającym musi znaleźć się słowo "yasig". Taki najprostszy ciąg znaków tworzący galerię wygląda zatem następująco:

{yasig }

Do wyświetlenia jednego zdjęcia potrzebne jest podanie do trzech argumentów (x1, x2, x3) oddzielonych od siebie znakiem pionowej kreski "|":

{yasig
x1|
x2|
x3||
}

 

Sens poszczególnych argumentów:
x1 - ścieżka dostępu do pliku zdjęcia w rozmiarze normalnym,
x2 - ścieżka dostępu do pliku zdjęcia w rozmiarze miniaturowym,
x3 - opis / komentarz wyświetlany pod każdym ze zdjęć.

Obowiązkowe jest wykorzystanie dwóch argumentów: x1 i x2. Jeżeli nie masz przygotowanej miniaturki (argument x2), jako drugi argument po prostu powtórz nazwę obrazka w pełnym rozmiarze (x1). Argument x3 można pominąć. Jeżeli w galerii znajduje się więcej zdjęć, ciągi argumentów x1, x2, x3 muszą zostać podane osobno dla każdego ze zdjęć. Zestaw argumentów x1, x2, x3 odpowiadający pojedynczemu zdjęciu nazwany został sekcją.

Przykładowa galeria wygląda więc następująco:

{yasig	początek wywołania galerii yasig
SciezkaDostepuDoZdjeciaWrozmiarzeNormalnym/ZdjecieWrozmiarzeNormalnym_01 | SciezkaDostepuDoMiniatury/ZdjecieMiniatura_01 | Przykładowy komentarz do Zdjecie_01 ||	sekcja pierwszego zdjęcia
SciezkaDostepuDoZdjeciaWrozmiarzeNormalnym/ZdjecieWrozmiarzeNormalnym_02 | SciezkaDostepuDoMiniatury/ZdjecieMiniatura_02 | Przykładowy komentarz do Zdjecie_02 ||	sekcja drugiego zdjęcia
...
SciezkaDostepuDoZdjeciaWrozmiarzeNormalnym/ZdjecieWrozmiarzeNormalnym_n | SciezkaDostepuDoMiniatury/ZdjecieMiniatura_n | Przykładowy komentarz do Zdjecie_n ||	sekcja n-tego zdjęcia
}	koniec wywołania galerii yasig

- Ścieżki dostępu do obrazków domyślnie zawierają ścieżkę dostępu do pliku z pominięciem początkowego ukośnika ("/") i nie powinny zawierać cudzysłowów (prawidłowo: images/fik.jpg -- nieprawidłowo: "/images/fik.jpg")

- Tekst z opisem / komentarzem do obrazka - x3 może zawierać dowolny znak oprócz znaku specjalnego |.

- Jeżeli nie chcesz jakiemuś obrazkowi nadawać opisu, lub jeżeli nie chcesz nadawać opisu wszystkim obrazkom, po prostu pomiń trzeci argument - x3, ale pamiętaj, że wtedy zamiast znaku | kończącego sekcję, musisz umieścić dwa znaki: || - ciągi opisujące kolejne obrazki galerii muszą być od siebie oddzielone sekwencją znaków "||".

Przykład:

{yasig
img/stories/NaszaNowaGaleria/zdjecie1_normalne.jpg |
img/stories/NaszaNowaGaleria/zdjecie1_miniatura.jpg ||


img/stories/NaszaNowaGaleria/zdjecie2_normalne.jpg |
img/stories/NaszaNowaGaleria/zdjecie2_miniatura.jpg ||


img/stories/NaszaNowaGaleria/zdjecie3_normalne.jpg |
img/stories/NaszaNowaGaleria/zdjecie3_miniatura.jpg ||


img/stories/NaszaNowaGaleria/zdjecie4_normalne.jpg |
img/stories/NaszaNowaGaleria/zdjecie4_miniatura.jpg ||


img/stories/NaszaNowaGaleria/zdjecie5_normalne.jpg |
img/stories/NaszaNowaGaleria/zdjecie5_miniatura.jpg ||
}

 

- By skorzystać z YASIG możesz po prostu skopiować powyższy przykład do swojego artykułu.

- W jednym artykule możesz mieć kilka galerii YASIG.

- Możesz też wykorzystać YASIG do wyświetlenia tylko jednego obrazka.

- Na stronie możesz wyświetlić wszystkie miniaturki, albo tylko pierwszą. Jeżeli chcesz pokazać tylko pierwszą, dodaj słowo "single" pisane małymi literami, bezpośrednio po "{yasig".

Przykład:

{yasig single
img/stories/NaszaNowaGaleria/zdjecie1_normalne.jpg |
img/stories/NaszaNowaGaleria/zdjecie1_miniatura.jpg ||
Przykładowy komentarz do Zdjecie_01 ||

img/stories/NaszaNowaGaleria/zdjecie2_normalne.jpg |
img/stories/NaszaNowaGaleria/zdjecie2_miniatura.jpg ||
Przykładowy komentarz do Zdjecie_02 ||

img/stories/NaszaNowaGaleria/zdjecie3_normalne.jpg |
img/stories/NaszaNowaGaleria/zdjecie3_miniatura.jpg ||
Przykładowy komentarz do Zdjecie_03 ||

img/stories/NaszaNowaGaleria/zdjecie4_normalne.jpg |
img/stories/NaszaNowaGaleria/zdjecie4_miniatura.jpg ||

img/stories/NaszaNowaGaleria/zdjecie5_normalne.jpg |
img/stories/NaszaNowaGaleria/zdjecie5_miniatura.jpg ||
}

Powrót do Spisu treści.

 

---

Konfiguracja dodatku yasiguncle

Rozszerzenie (dodatek) yasiuncle stanowi rozszerzenie edytorów Joomla!. Dobrze współdziała z edytorami TinyMCE oraz JCE. Panel konfiguracyjny dodatku YASIG jest dostępny po zalogowaniu na zaplecze witryny.

Wybierz z menu: Rozszerzenia -> Dodatki.
Po chwili zostanie wyświetlona lista wszystkich zainstalowanych dodatków.
W polu "Filtr" wpisz "yasig", a następnie wciśnij znajdujący się na prawo od pola "Filtr" przycisk "Znajdź". Po chwili na ekranie zostaną wyświetlone zainstalowane rozszerzenia pasujące do kryterium filtru. Kliknij na dodatku "plg_yasiguncle".
Zostanie wyświetlony ekran konfiguracyjny rozszerzenia. Składa się on z kilku obszarów: Szczegóły Opcje podstawowe
Szczegóły zawierają przede wszystkim informacje ogólne.
Obszar "Opcje podstawowe". Szczegóły dotyczące poszczególnych parametrów zostały przedstawione w poniższej tabeli.

Opis opcji staje się widoczny po najechaniu kursorem na etykietę opcji.

Przedstawione w poniższej tabeli opcje pozwalają na zapisanie wartości kreatora yasiguncle, co teoretycznie może skrócić czas przygotowania kolejnych galerii. Niezależnie od przyjętych ustawień po każdorazowym wywołaniu kreatora yasiguncle możliwa jest ręczna zmiana każdej z tych opcji.

Nazwa opcji	Opis opcji	Wartość domyślna	Komentarz
Ścieżka dostępu do katalogu wejściowego	Ścieżka dostępu do katalogu wejściowego na Twoim serwerze Joomla! W nim powinny już znajdować się zdjęcia, które zostaną przetworzone	tmp/inputImages	Jedna ścieża dostępu - jedno zadziałanie yasiguncle.
Ścieżka dostępu do katalogu wyjściowego	Ścieżka dostępu do katalogu wyjściowego na Twoim serwerze Joomla! W nim znajdą się zdjęcia po przetworzeniu	tmp/outputImages	Katalog wyjściowy może być taki sam, jak katalog wejściowy, chociaż takie rozwiązanie nie jest polecane.
Ścieżka główna	Stąd będziesz mógł wybierać podkatalogi ze zdjęciami; pusta = katalog główny		Jeżeli użytkownik często korzysta z rozszerzenia yasiguncle, to warto podać katalog nadrzędny. Przyspieszy to wybieranie katalogu wyjściowego.
Szerokość miniaturek	Szerokość miniaturek wyrażona w pikselach [px]	200	Wielkość miniaturki powinna być wyraźnie mniejsza od rozmiaru obrazka w trybie normalnym.
Wysokość miniaturek	Wysokość miniaturek wyrażona w pikselach [px]	150	Wielkość miniaturki powinna być wyraźnie mniejsza od rozmiaru obrazka w trybie normalnym.
Szerokość pomniejszonych zdjęć	Szerokość pomniejszonych zdjęć wyrażona w pikselach [px]	640	Szerokość zdjęcia normalnego, czyli takiego, jakie zostanie wyświetlone Użytkownikowi.
Wysokość pomniejszonych zdjęć	Wysokość pomniejszonych zdjęć wyrażona w pikselach [px]	480	Wysokość zdjęcia normalnego, czyli takiego, jakie zostanie wyświetlone Użytkownikowi.
Wielkość ramki zdjęć pomniejszonych	Wielkość ramki zdjęć pomniejszonych wyrażona w pikselach [px]	0	Ramka będzie elementem obrazka.
Wielkość ramki miniaturek	Wielkość ramki miniaturek wyrażona w pikselach [px]	2	Ramka będzie elementem obrazka.
Tekst umieszczany na zdjęciach	Tekst, który zostanie nałożony na zdjęcie. Będzie widoczny w lewym dolnym rogu zdjęcia.	created by YasigUncle!
Uzywaj single mode	Używaj single mode (tylko jedno zdjęcie widoczne w galerii)	nie	W trybie pojedynczym (single mode) wyświetlana jest miniatura tylko dla pierwszego obrazka galerii. Patrz np. Demo lub Składnia galerii YASIG.
Przytnij miniaturę	Przytnij miniaturę tak, by jej rozmiar pasował do pozostałych miniatur	tak	Opcja jest przydatna w przypadku dużego zbioru obrazków, które różnią się np. orientacją. Dzięki temu ustawieniu możliwe jest precyzyjne przewidzenie rozmiaru galerii na stronie. Wadą takiego rozwiązania jest przycięcie obrazków galerii przez co w pewnych okolicznościach mogą się one stać nieczytelne.
Nie usuwaj plików	Nie usuwaj plików z katalogu wejściowego po zakończeniu przetwarzania zdjęć	nie	Opcja może być przydatna np. w przypadku eksperymentów.
Rozdziel wywołania galerii	Dzieli wywołania galerii na samodzielne galerie	nie	Załóżmy, że galeria składa się z 5 zdjęć. Po wybraniu tej opcji w treść artykułu wstawionych zostanie 5 pojedynczych galerii YASIG, po jednej dla każdego ze zdjęć z katalogu wejściowego.
W tabeli	Dzieli wywołania galerii i umieszcza je w tabeli. Uwaga! Działa tylko, gdy jest włączona opcja 'Rozdziel wywołania galerii'.	nie	Załóżmy, że galeria składa się z 5 zdjęć. Po wybraniu tej opcji w treść artykułu wstawionych zostanie 5 pojedynczych galerii YASIG, po jednej dla każdego ze zdjęć z katalogu wejściowego. Każde ze zdjęć zostanie umieszczone w tabeli o 1 wierszu i 2 kolumnach, w lewej kolumnie. Szerokość lewej kolumny zostanie dopasowana do wielkości miniatury. Opcja jest przydatna w przypadku tworzenia poradników, gdzie obok zdjęcia umieszczany jest jego opis.

Powrót do Spisu treści.

 

---

FAQ (ang. Frequently Asked Questions) = Często Zadawane Pytania

1. Jakie są minimalne wymagania dotyczące poprawnej pracy galerii?
2. Czy można włączyć otaczanie tekstem miniatur?
3. Czasami wywołania galerii YASIG nie działają - zamiast wyświetlenia efektu 'Slimbox' pojawia się zdjęcie, jak niżej. Dlaczego?
4. Czasami oprócz zdjęcia wyświetlanego za pomocą efektu 'Slimbox' pojawiają się dodatkowe fragmenty tła. Dlaczego? 

1. Jakie są minimalne wymagania dotyczące poprawnej pracy galerii?

Wymagania dla galerii YASIG w ogólności są takie same jak dla środowiska J!, czyli: PHP 5.2+ oraz MySQL 5.0.4+

 

2. Czy można włączyć otaczanie tekstem miniatur?

Nie. Efekty, takie jak otaczanie tekstem zdjęć w treści artykułu są uzależnione od możliwości edytora. Wywołanie galerii YASIG polega na wstawieniu określonej składni:

{yasig
...
}

w okienku edytora. Edytor nie traktuje powyższej składni jako zdjęcia, lecz jako tekst.

 

Istnieje jednak dosyć proste i eleganckie obejście tego problemu. Wystarczy:

1. Wstawić do tekstu edytora tabelę o 1 kolumnie i 2 wierszach o szerokości 100 %.
2. W lewej kolumnie tabeli wstawić wywołanie YASIG.
3. Ustawić szerokość lewej kolumny równą szerokości obrazka miniatury.
4. W prawej kolumnie tabeli wkleić tekst.

Przykład poniżej. Dla jasności włączono kolorowanie ramki tabeli. Otaczający tekst wpisano kursywą.

 

Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst.

{yasig ... }

Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst.

Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst.

 

Co będzie wyglądało następująco:

 

Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst.

Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst.

Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst. Otaczający tekst.

 

3. Czasami wywołania galerii YASIG nie działają - zamiast wyświetlenia efektu 'Slimbox' pojawia się zdjęcie, jak niżej. Dlaczego?

Czasami zamiast poprawnego wywołania galerii ekran przybiera następującą postać:

Powodem jest nieprawidłowe działania biblioteki JQuery 'Slimbox'. Prawdopodobnie nie została ona zainstalowana, nie została prawidłowo ściągnięta przez galerię lub wystąpił konflikt pomiędzy rozszerzeniem YASIG a jakimś innym rozszerzeniem wykorzystującym bibliotekę 'Slimbox'. Co można zrobić w tej sytuacji:

a. Sprawdzić, czy przestawienie parametru 'Załaduj JQuery' w konfiguracji rozszerzenia YASIG na przeciwne przywróci prawidłowe działanie galerii (Zaplecze, menu: Rozszerzenie -> Dodatki -> YASIG).

b. Sprawdzić, które z zainstalowanych rozszerzeń Joomla! również korzysta z bibliotek JQuery. Następnie można sprawdzić, czy tamte rozszerzenia pozwalają na wyłączenie pobierania biblioteki JQuery albo na chwilę wyłączyć to rozszerzenie i sprawdzić, czy to rozwiązało problem.

 

c. Trzeci sposób polega na sprawdzeniu, czy nie pomoże zmiana kolejności ładowania rozszerzeń. W panelu konfiguracyjnym J! można zmienić kolejność ładowania rozszerzeń. Na przykładowym zrzucie ekranów wymuszono zmianę kolejności ładowania rozszerzeń 'slimbox' oraz YASIG.

Po każdej z opisanych powyżej czynności należy sprawdzić, czy wykonana zmiana przyniosła spodziewany rezultat, czyli zapisać zmiany w konfiguracji oraz przeładować zawartość strony, która poprzednio wyświetlała się nieprawidłowo.

 

4. Czasami oprócz zdjęcia wyświetlanego za pomocą efektu 'Slimbox' pojawiają się dodatkowe fragmenty tła (przykład poniżej). Dlaczego?

Czasami ekran przybiera postać, jak poniżej:

Powodem jest nieprawidłowe działania biblioteki JQuery 'Slimbox'. Prawdopodobnie nie została ona zainstalowana, nie została prawidłowo ściągnięta przez galerię lub wystąpił konflikt pomiędzy rozszerzeniem YASIG a jakimś innym rozszerzeniem wykorzystującym bibliotekę 'Slimbox'. Co można zrobić w tej sytuacji:

a. Sprawdzić, czy przestawienie parametru 'Załaduj JQuery' w konfiguracji rozszerzenia YASIG na przeciwne przywróci prawidłowe działanie galerii (Zaplecze, menu: Rozszerzenie -> Dodatki -> YASIG).

 

b. Sprawdzić, które z zainstalowanych rozszerzeń Joomla! również korzysta z bibliotek JQuery. Następnie można sprawdzić, czy tamte rozszerzenia pozwalają na wyłączenie pobierania biblioteki JQuery albo na chwilę wyłączyć to rozszerzenie i sprawdzić, czy to rozwiązało problem.

 

c. Trzeci sposób polega na sprawdzeniu, czy nie pomoże zmiana kolejności ładowania rozszerzeń. W panelu konfiguracyjnym J! można zmienić kolejność ładowania rozszerzeń. Na przykładowym zrzucie ekranów wymuszono zmianę kolejności ładowania rozszerzeń 'slimbox' oraz YASIG.

Po każdej z opisanych powyżej czynności należy sprawdzić, czy wykonana zmiana przyniosła spodziewany rezultat, czyli zapisać zmiany w konfiguracji oraz przeładować zawartość strony, która poprzednio wyświetlała się nieprawidłowo.

Powrót do Spisu treści.

 

---

Wsparcie, pomoc

Czytelniku, jeżeli dostrzegłeś jakąś nieprawidłowość w działaniu dodatku YASIG, to podziel się tą informacją. Możesz to zrobić zostawiając komentarz pod tym artykułem. Dziękujemy za Twój czas, ZESPÓŁ.

Jeżeli chcesz, możesz też zgłosić problem bezpośrednio na stronie projektu, korzystając z narzędzia Tracker.

 

Prosimy, byś wraz z opisem problemu przekazał nam następujące przydatne informacje:

• wersja środowiska J!,
• wersja serwera PHP,
• nazwa przeglądarki internetowej,
• wersja przeglądarki internetowej.

Im precyzyjniejszy opis problemu tym lepiej. Poces rozwiązania problemu polega przede wszystkim na próbie jego powtórzenia. Podane powyżej informacje powinny zasadniczo to zadanie ułatwić.

Do dyspozycji użytkowników jest także forum w języku polskim: http://forum.joomla.pl. Prosimy o komentarze!

Powrót do Spisu treści.

 

---

Automatyczne przerabianie zdjęć po stronie klienta

Opisane w tej sekcji narzędzie spełnia zadania analogiczne do narzędzia yasiguncle, które wchodzi w skład rozwiązania YASIG. Narzędzie yasiguncle przetwarza zdjęcia na serwerze, na którym zainstalowana jest strona www, na której Autor przygotowuje galerię zdjęć. Opisane poniżej narzędzie pozwala na wykonanie tych samych operacji na zdjęciach (zmniejszenie, umieszczenie napisu w zdjęciu), ale działa lokalnie, czyli na komputerze Użytkownika, a nie na serwerze. Opisany dalej skrypt został przygotowany dla systemów operacyjnych GNU/Linux.

Od dawna marzyło mi się automatyczne przygotowanie obrazków (zdjęć) przeznaczonych na stronę internetową. Taka aplikacja powinna automatycznie zmniejszyć obrazki (zdjęcia) do dwóch wymiarów:

1. 640x (...)
2. 200x (...)

Czyli chciałbym, by zdjęcia w pełnym rozmiarze miały zawsze większy wymiar maksymalnie 640 pikseli, a miniatury miały mniejszy wymiar równy 200 pikselom.

Jak łatwo się domyślić pierwszy obrazek reprezentuje obrazek w 'pełnym' rozmiarze , a drugi to miniatura pierwszego. Dodatkowo chciałem, by w obrazek w 'pełnym' wymiarze wtapiany był w lewym dolnym rogu tekst z adresem mojej strony.

Do realizacji tego zadania posłużyła mi wspaniała biblioteka ImageMagic (na licencji GNU). Z jej pomocą szybko skonstruowałem odpowiedni skrypt 'bash', który w przyszłości może posłużyć do budowy skryptu .php. Do moich celów póki co wystarczy.

 

Skrypt kopiujemy do tego samego katalogu, co pliki zdjęć, które zamierzamy poddać wyżej opisanym zmianom. Teraz wystarczy wykonać ściągnięty skrypt, np. tak:

 :~$ sh napis_w_zdjeciu

 

Po zakończeniu działania skryptu, w katalogu, w którym zostały stworzone obrazki, warto wydać polecenie:

:~$ ls -1 --sort=time --reverse 640*.* 200*.*

czyli:

-1	<- poustawiaj po jednej nazwie pliku w wierszu,
--sort=time	<- posortuj wg czasu powstania,
--reverse	<- odwroc sortowanie,
640* 200*	<- zastosuj tylko względem plików, których nazwy zaczynają się od 640 i 200.

Polecenie wylistuje jeden pod drugim wszystkie pliki, których nazwy zaczynają się od ciągów '640' oraz '200' akurat w takiej kolejności, by łatwo dało się z nich złożyć wywołanie slimbox. Wystarczy teraz zaznaczyć listę wynikową i przekopiować do artykułu w środowisku Joomla!, całość objąć nawiasami klamrowymi, dopisać ścieżki dostępu i skorzystać z dobrodziejstwa rozszerzenia slimbox. Reszta stanie się sama...

Do pobrania skrypt na licencji GNU.

Powrót do Spisu treści.

 

---

Zespół

Zespół, który stworzył zespół rozszerzeń YASIG, to 5-7 osób. Połączył nas wspólny cel - przygotowanie funkcjonalnej, prostej w obsłudze, szybkiej galerii zdjęć dla Joomla!.

 

Kontakt do zespołu

e-mail: Ten adres pocztowy jest chroniony przed spamowaniem. Aby go zobaczyć, konieczne jest włączenie w przeglądarce obsługi JavaScript.
komunikator: WhatsApp

 

Jeżeli chcesz pomóc a:

1. jesteś programistą, to możesz dołączyć do grupy programistów;
2. jesteś użytkownikiem, to możesz dołączyć do grupy testerów;
3. chciałbyś przetłumaczyć nasze rozszerzenia, skontaktuj się w jeden z opisanych powyżej sposobów;
4. sponsorem, to możesz wpłaćić pieniądze na podane konto.

 

Uczestnicy

Damian Damaszke Ksywa: woroo   Twórca większości kodu dodatku 'yasig' oraz skryptu przetwarzającego obrazki, będącego składową komponentu 'yasig'.   Rocznik 1984. Z wykształcenia inżynier informatyk. Na co dzień programista aplikacji webowych i interfejsów użytkownika oraz .NET. Na koncie ma m.in. przygotowanie interfejsu użytkownika dla systemu informatycznego dsat, czyli SID.   Hobby: adoracja pięknych kobiet, puzzle w każdej postaci.

 

Maciej Szczepański Ksywa: kroovechkaja   Twórca (a raczej 'przetwórca' ;) ) części kodu związanego z yasigUncle (guziora editors-xtd i komponentu).   Rocznik 1983. Z wykształcenia inżynier informatyk. Na co dzień projektant baz danych oraz programista .NET i C++. Na koncie głównie projekty związane z diagnostyką szlakową taboru kolejowego, wyłącznie komercyjne.   Hobby: ASG (ang. air soft gun), hodowla gadów egzotycznych.

 

Sławomir Rapeła   Do projektu dołączył spontanicznie jako tester oprogramowania.   Lat 30. Z wykształcenia mgr inż. informatyki w zarządzaniu. Na co dzień analityk biznesowy prowadzący własną działalność. Na koncie ma m.in. udział w projektach eUrząd, System Elektronicznego Monitorowania Pracy, a także jako kierownik projektu tworzył System Wspierający Centralną Ewidencję Naruszeń dla ITD. Hobby: książki, podróże

 

Karol Lewoniewski Ksywa: karas   Rocznik 1985. Z wykształcenia mgr inż. informatyk, fizyka stosowana, specjalność informatyka stosowana. Na co dzień programista w jednej z większych trójmieskich firm wspierających banki. Na koncie ma m.in. udział w projekcie systemu wspomagania wstępnego projektowania statków dla CTO w Gdańsku.   Hobby: podróże

 

Maciej Słojewski Ksywa: mslonik   Inicjator projektu YASIG.   Rocznik 1976. Więcej na temat mojej ścieżki zawodowej tutaj.   Prywatnie więcej o mnie tutaj.

 

Sylwia Ławrów Jest z nami od lutego 2012. Studentka na wydziale ETI, kierunek Informatyka, Politechnika Gdańska. Po godzinach wolna programistka stron www :-] Hobby: Dobre kino, podróże na rowerze.

 

Karol Domagała Ksywa: kazuar Zmodyfikował skrypt .js wyświetlający obrazki (składowa dodatku 'yasig') oraz przygotował kod ajax informujący użytkownika o zmniejszeniu kolejnych obrazków. Hobby: remonty starych samochodów, projekty open source

Powrót do Spisu treści.

 

---

Apel

Wesprzyj naszą pracę! Jeżeli uznałeś, że to rozszerzenie Ci się podoba, pomogło Ci w realizacji jakiegoś zadania, zwyczajnie jest przydatne, prosimy zamieść chociaż krótką recenzję w katalogu rozszerzeń Joomla!, czyli tutaj.

Do dyspozycji użytkowników jest także forum w języku polskim. Prosimy o komentarze!

Powrót do Spisu treści.

 

Add a comment