moduł EYIA GALLERY: responsywna prezentacja galerii ilustracji

moduł EYIA GALLERY: responsywna prezentacja galerii ilustracji

 

Instrukcja dla redakcji miesięcznika społeczno-kulturalnego KREATYWNI

Narzędzie: EYIA Gallery 1.1.0 — Joomla 5

 

Nasz moduł EYIA gallery: responsywna prezentacja galerii ilustracji. 

 

1. Do czego służy EYIA Gallery?

Fotografia i sztuki plastyczne zajmują ważne miejsce w miesięczniku KREATYWNI. Publikujemy reportaże fotograficzne, relacje z wydarzeń kulturalnych, dokumentację wystaw, a także prezentacje twórczości fotografików, malarzy i innych artystów.

Często chcemy pokazać czytelnikom nie jedną fotografię, lecz cały zbiór zdjęć lub reprodukcji prac plastycznych.

Właśnie dlatego przygotowaliśmy specjalne narzędzie redakcyjne o nazwie EYIA Gallery.

Pozwala ono tworzyć estetyczne galerie zdjęć, które można wygodnie przeglądać na komputerach, tabletach i smartfonach.

Najważniejsza zaleta: nie trzeba pojedynczo wstawiać wszystkich fotografii do artykułu.

Wystarczy przygotować folder ze zdjęciami i wskazać go w ustawieniach modułu. EYIA Gallery automatycznie przygotuje miniatury i ułoży fotografie w galerię.

Nie trzeba znać HTML ani umieć programować stron internetowych.

2. Dlaczego stworzyliśmy EYIA Gallery?

Przygotowywanie tradycyjnej galerii może być pracochłonne. Każde zdjęcie trzeba odpowiednio zmniejszyć, umieścić w artykule i zadbać o jego wygląd.

EYIA Gallery wykonuje większość tych czynności automatycznie.

Oszczędza czas. Redaktorka przygotowuje folder zdjęć, zamiast ręcznie wstawiać kilkadziesiąt ilustracji.

Dba o estetykę. Fotografie tworzą uporządkowaną kompozycję. Mogą mieć różne proporcje — poziome, pionowe lub kwadratowe.

Dostosowuje się do ekranu. Galeria wygląda odpowiednio na komputerach i urządzeniach mobilnych.

Przyspiesza ładowanie artykułu. System automatycznie przygotowuje miniatury zdjęć w nowoczesnych formatach WEBP i, jeśli serwer na to pozwala, AVIF.

Pozwala oglądać zdjęcia w powiększeniu. Kliknięcie miniatury otwiera oryginalną fotografię w specjalnej przeglądarce.

Pomaga zachować porządek. Każda galeria korzysta z określonego folderu, dzięki czemu fotografie różnych autorów i wydarzeń nie mieszają się ze sobą.

3. Jak wygląda gotowa galeria?

Galeria może składać się z trzech części.

Nagłówek galerii

Na górze może pojawić się tytuł galerii, nazwisko autora oraz krótki opis.

Przykładowo:

Światło i cień / Anna Kowalska

Cykl fotografii przedstawiających architekturę Gdańska o różnych porach dnia. Autorka poszukuje w codziennych przestrzeniach nieoczywistych kompozycji światła i cienia.

Nagłówek jest opcjonalny. Można przygotować galerię bez niego.

Zdjęcia

Pod nagłówkiem wyświetlana jest siatka miniatur.

Na dużym ekranie może mieć cztery kolumny, na tablecie dwie, a na smartfonie jedną.

Kliknięcie miniatury otwiera zdjęcie w powiększeniu.

Przycisk powrotu

Pod galerią może pojawić się przycisk „← Cofnij”, umożliwiający powrót do poprzedniej strony w historii przeglądarki.

Jego wyświetlanie można włączyć lub wyłączyć w ustawieniach modułu.

4. Dwa sposoby przygotowania galerii

EYIA Gallery pozwala przygotować galerię w dwóch wariantach.

Wariant A. Galeria podstawowa

To najprostszy sposób.

Wystarczy:

  1. Przygotować fotografie.

  2. Umieścić je w osobnym folderze Joomla.

  3. Utworzyć moduł EYIA Gallery.

  4. Wskazać folder zdjęć oraz artykuł, w którym galeria ma się pojawić.

Moduł sam przygotuje miniatury i wyświetli zdjęcia.

Ten wariant polecamy do zwykłych galerii ilustrujących artykuły, reportaże i relacje z wydarzeń.

Wariant B. Galeria z nagłówkiem i opisem

Ten wariant pozwala dodatkowo umieścić nad zdjęciami:

  • Tytuł galerii.

  • Imię i nazwisko autora.

  • Opis prezentowanych prac.

  • Wybraną kolorystykę nagłówka i tła galerii.

Wymaga przygotowania dodatkowego, niewielkiego pliku XML.

Ten wariant polecamy szczególnie do samodzielnych prezentacji twórczości fotograficznej i plastycznej.

Nie jest on obowiązkowy.

5. Przygotowanie zdjęć — krok po kroku

Krok 1. Wybierz fotografie

Zgromadź zdjęcia przeznaczone do publikacji.

Sprawdź ich jakość, kompletność i zgodność z tematyką artykułu.

Upewnij się również, że mamy prawo je opublikować.

Krok 2. Uporządkuj nazwy plików

EYIA Gallery obsługuje formaty JPG, JPEG, PNG i WEBP.

Najczęściej wystarczy korzystać z formatu JPG.

Dobrą praktyką jest nadawanie zdjęciom uporządkowanych nazw, np.:

wystawa_001.jpg

wystawa_002.jpg

wystawa_003.jpg

Warto stosować cyfry z zerami na początku, ponieważ ułatwia to porządkowanie plików.

Krok 3. Przygotuj folder

W panelu Joomla przejdź do:

Treści → Media

Utwórz folder przeznaczony dla galerii.

Przykładowo:

images/galerie/wystawa_malarska_2026

Prześlij do niego wszystkie fotografie.

Ważne: każda galeria powinna mieć osobny folder. Nie umieszczaj zdjęć różnych galerii w jednym katalogu.

6. Jak utworzyć galerię w Joomla?

Krok 1. Przygotuj artykuł

Utwórz lub otwórz artykuł, w którym chcesz umieścić galerię.

Zapisz go i sprawdź jego numer ID.

Każdy artykuł Joomla ma własny, niepowtarzalny numer.

Krok 2. Otwórz moduły witryny

W panelu administracyjnym Joomla wybierz:

Treści → Moduły witryny

Następnie utwórz nowy moduł typu mod_eyia_gallery.

Krok 3. Wpisz ID artykułu

W polu ID artykułu wpisz numer artykułu, dla którego przygotowujesz galerię.

Przykładowo:

1250

To bardzo ważne ustawienie.

EYIA Gallery wyświetla się wyłącznie w pełnym widoku wskazanego artykułu.

Dzięki temu galeria nie pojawi się przypadkowo w innych publikacjach.

Krok 4. Wskaż folder zdjęć

W polu Folder zdjęć wpisz ścieżkę do katalogu, w którym znajdują się fotografie.

Przykładowo:

images/galerie/wystawa_malarska_2026

Nie trzeba wpisywać pełnego adresu strony internetowej.

Krok 5. Zdecyduj, czy potrzebny jest nagłówek

Jeżeli przygotowujesz zwykłą galerię zdjęć, pole Nazwa pliku XML pozostaw puste.

Jeśli galeria ma mieć własny tytuł, nazwisko autora i opis, skorzystaj z instrukcji w następnym rozdziale.

Krok 6. Zapisz moduł

Zapisz ustawienia i upewnij się, że moduł jest opublikowany oraz przypisany do pozycji wykorzystywanej przez redakcję.

Otwórz odpowiedni artykuł na stronie miesięcznika.

Gotowe! Galeria powinna być już widoczna.

7. Jak przygotować galerię z tytułem, autorem i opisem?

To dodatkowa funkcja EYIA Gallery, szczególnie przydatna przy prezentowaniu twórczości artystycznej.

Informacje o galerii przechowywane są w pliku XML.

XML to zwykły plik tekstowy zawierający dane zapisane według określonego schematu.

Nie trzeba znać języka XML. Wystarczy skorzystać z gotowego wzoru i zmienić odpowiednie informacje.

Przykładowy plik XML

<?xml version="1.0" encoding="UTF-8"?>
<gallery>
    <title>Światło i cień</title>
    <author>Anna Kowalska</author>
    <body>
        Cykl fotografii przedstawiających
        architekturę Gdańska.
    </body>
    <bg_footer>#222222</bg_footer>
    <color_footer>#ffffff</color_footer>
    <bg_gallery>#f5f5f5</bg_gallery>
</gallery>

Co oznaczają poszczególne elementy?

Element Znaczenie
title Tytuł galerii
author Imię i nazwisko autora
body Krótki opis galerii
bg_footer Kolor tła nagłówka
color_footer Kolor tekstu nagłówka
bg_gallery Kolor tła pod zdjęciami

Kolory zapisane są za pomocą specjalnych kodów, np.:

  • #ffffff — biały.

  • #000000 — czarny.

  • #222222 — ciemnoszary.

  • #f5f5f5 — bardzo jasnoszary.

Jak zapisać plik?

  1. Otwórz prosty edytor tekstu, np. Notatnik.

  2. Skopiuj powyższy wzór.

  3. Zmień tytuł, nazwisko autora i opis.

  4. Zapisz plik w kodowaniu UTF-8, np. jako galeria.xml.

  5. Umieść go w tym samym folderze co fotografie.

W ustawieniach EYIA Gallery znajdź pole Nazwa pliku XML.

Wpisz:

galeria

Uwaga: wpisujemy nazwę bez rozszerzenia .xml.

Moduł sam odszuka plik galeria.xml w folderze zdjęć.

Po zapisaniu modułu nad fotografiami pojawi się przygotowany nagłówek.

Czy wszystkie informacje w XML są obowiązkowe?

Nie. W podstawowej wersji opisowej najważniejsze są tytuł, autor i ewentualny opis.

Jeśli nie chcesz korzystać z pliku XML, po prostu pozostaw odpowiednie pole w module puste.

W razie problemów z przygotowaniem pliku XML poproś o pomoc redaktora technicznego.

8. Jak ustawić wygląd galerii?

W module dostępne są ustawienia pozwalające dostosować sposób wyświetlania fotografii.

Ustawienie Zalecana wartość
Szerokość miniatur 400
Jakość WEBP 80
Jakość AVIF 60
Kolumny desktop 4
Kolumny tablet 2
Kolumny mobile 1
Pokaż przycisk cofania Tak
Zezwalaj na zewnętrzne referery Nie

W większości przypadków nie trzeba zmieniać wartości domyślnych.

Co oznaczają kolumny?

Liczba kolumn określa, ile zdjęć może znajdować się obok siebie.

Na komputerze galeria może mieć cztery kolumny, na tablecie dwie, a na smartfonie jedną.

Nie trzeba przygotowywać oddzielnych wersji galerii dla różnych urządzeń.

Co oznacza szerokość miniatur?

Miniatura to pomniejszona wersja fotografii wyświetlana w galerii.

Ustawienie 400 oznacza, że moduł przygotowuje miniaturę o szerokości 400 pikseli, zachowując proporcje zdjęcia.

Oryginalny plik pozostaje dostępny do oglądania w powiększeniu.

9. Jak czytelnik przegląda galerię?

Galeria została przygotowana z myślą o wygodnym oglądaniu fotografii.

Czytelnik widzi najpierw uporządkowany zestaw miniatur.

Po kliknięciu wybranej fotografii otwiera się ona w powiększeniu.

Do prezentowania zdjęć wykorzystujemy mechanizm PhotoSwipe.

Na komputerze można korzystać z myszy i klawiatury, a na urządzeniach dotykowych — z gestów obsługiwanych przez przeglądarkę zdjęć.

Czytelnik może zamknąć powiększenie i wrócić do widoku miniatur.

Dzięki temu galeria nadaje się zarówno do szybkiego przeglądania reportażu, jak i dokładniejszego oglądania fotografii artystycznych.

10. Jak uzupełnić lub poprawić istniejącą galerię?

Czasami po publikacji trzeba dodać nowe fotografie, wymienić zdjęcie albo usunąć niepotrzebny plik.

W takim przypadku:

  1. Otwórz folder zdjęć przypisany do galerii.

  2. Wprowadź potrzebne zmiany.

  3. Powiadom redaktora technicznego o aktualizacji.

Dlaczego trzeci krok jest ważny?

EYIA Gallery korzysta z pamięci podręcznej, czyli tzw. cache.

Oznacza to, że raz przygotowana lista fotografii i miniatury są przechowywane, aby nie trzeba było generować ich ponownie przy każdym otwarciu artykułu.

Po zmianie zawartości folderu galeria może nadal pokazywać poprzedni zestaw zdjęć.

W takim przypadku potrzebne jest techniczne odświeżenie galerii.

Nie usuwaj samodzielnie plików z folderów media/cache i media/thumbs.

Są to katalogi techniczne obsługiwane przez moduł.

11. Co zrobić, jeśli galeria nie działa?

Najpierw sprawdź kilka podstawowych rzeczy:

  1. Czy w polu ID artykułu wpisano właściwy numer?

  2. Czy wskazany folder ze zdjęciami istnieje?

  3. Czy folder znajduje się w katalogu images?

  4. Czy zawiera zdjęcia JPG, JPEG, PNG lub WEBP?

  5. Czy moduł jest opublikowany?

  6. Czy otwierasz właściwy artykuł, a nie tylko jego zajawkę?

  7. Jeśli korzystasz z XML — czy plik znajduje się w folderze zdjęć i ma poprawną nazwę?

Jeżeli galeria nadal się nie wyświetla, zgłoś problem redaktorowi technicznemu.

W zgłoszeniu najlepiej podać numer artykułu i ścieżkę folderu ze zdjęciami.

12. Prawa autorskie i zasady redakcyjne

W miesięczniku KREATYWNI przywiązujemy szczególną wagę do poszanowania praw autorskich.

EYIA Gallery jest narzędziem technicznym. Nie zastępuje redakcyjnej odpowiedzialności za publikowane materiały.

Dlatego przestrzegamy następujących zasad:

  • Publikujemy wyłącznie zdjęcia i reprodukcje, do których mamy odpowiednie prawa lub zgody.

  • Wskazujemy autorów fotografii i prac plastycznych.

  • Nie usuwamy informacji o autorstwie bez uzasadnionej podstawy.

  • W przypadku dokumentacji wydarzeń podajemy potrzebne informacje o miejscu, czasie i charakterze wydarzenia.

  • W razie wątpliwości konsultujemy publikację z redaktorem prowadzącym.

Warto pamiętać, że EYIA Gallery przechowuje fotografie w zasobach naszej witryny. Dlatego przed przesłaniem zdjęć na serwer należy upewnić się, że mamy prawo do ich publikacji.

13. Najważniejsze do zapamiętania

Aby przygotować galerię w miesięczniku KREATYWNI:

1. Wybierz fotografie i sprawdź możliwość ich publikacji.

2. Umieść zdjęcia w osobnym folderze Joomla.

3. Przygotuj artykuł i sprawdź jego numer ID.

4. Utwórz moduł EYIA Gallery, podając ID artykułu i ścieżkę folderu.

5. Jeśli potrzebujesz tytułu, autora i opisu galerii, przygotuj dodatkowy plik XML.

6. Zapisz moduł i sprawdź rezultat na stronie miesięcznika.

Nie trzeba ręcznie przygotowywać miniatur, programować galerii ani pojedynczo umieszczać wszystkich fotografii w artykule.

EYIA Gallery powstał po to, aby redaktorki mogły poświęcać więcej czasu na wybór i opracowanie wartościowych materiałów artystycznych, a mniej na techniczne czynności związane z ich publikowaniem.


I