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:
-
Przygotować fotografie.
-
Umieścić je w osobnym folderze Joomla.
-
Utworzyć moduł EYIA Gallery.
-
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?
-
Otwórz prosty edytor tekstu, np. Notatnik.
-
Skopiuj powyższy wzór.
-
Zmień tytuł, nazwisko autora i opis.
-
Zapisz plik w kodowaniu UTF-8, np. jako
galeria.xml. -
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:
-
Otwórz folder zdjęć przypisany do galerii.
-
Wprowadź potrzebne zmiany.
-
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:
-
Czy w polu ID artykułu wpisano właściwy numer?
-
Czy wskazany folder ze zdjęciami istnieje?
-
Czy folder znajduje się w katalogu
images? -
Czy zawiera zdjęcia JPG, JPEG, PNG lub WEBP?
-
Czy moduł jest opublikowany?
-
Czy otwierasz właściwy artykuł, a nie tylko jego zajawkę?
-
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