Obsługiwane środowisko

LENA 1.0 wymaga:

  • Joomla 5.x albo 6.x;
  • PHP 8.1 lub nowszego, z uwzględnieniem wymagań używanej wersji Joomla;
  • MySQL albo MariaDB w wersji obsługiwanej przez Joomla;
  • rozszerzeń PHP fileinfo, gd i mbstring.

Serwer musi pozwalać PHP na zapisywanie plików w katalogu images instalacji Joomla oraz na odczyt oryginałów podczas generowania miniaturek.

Do odczytu daty wykonania i automatycznej korekty orientacji zdjęć JPEG potrzebna jest także funkcja PHP exif_read_data z rozszerzenia exif. Jej brak nie blokuje przesyłania, ale LENA nie odczyta tych informacji z pliku.

Przetwarzanie obrazów

Rozszerzenie PHP GD jest wymagane przy każdym przesyłaniu zdjęcia. LENA zapisuje oryginał i tworzy trzy warianty obrazu przeznaczone do list, galerii i powiększonego podglądu. Jeżeli GD nie działa albo nie obsługuje formatu przesyłanego pliku, zdjęcie nie zostanie dodane.

Obsługiwane formaty wejściowe to:

  • JPEG (.jpg, .jpeg),
  • PNG (.png),
  • GIF (.gif),
  • WebP (.webp),
  • AVIF (.avif).

Sama obecność rozszerzenia GD nie gwarantuje obsługi WebP lub AVIF. Zależy to od sposobu skompilowania PHP na danym serwerze. W razie wątpliwości należy wykonać próbę na pojedynczym pliku.

Limity przesyłania

LENA domyślnie stosuje limit rozmiaru pojedynczego pliku ustawiony w opcjach Mediów Joomla. Administrator może zamiast niego ustawić osobny limit LENA albo wpisać 0, aby wyłączyć limit aplikacyjny. Niezależnie nadal obowiązują ograniczenia PHP i serwera, przede wszystkim upload_max_filesize, post_max_size, dostępna pamięć oraz maksymalny czas wykonywania żądania.

LENA nie definiuje własnego limitu szerokości, wysokości ani łącznej liczby pikseli. W opcjach komponentu znajduje się diagnostyczna tabela pokazująca ograniczenia wykryte w środowisku; nie zmienia ona konfiguracji serwera.

Duże pliki lub bardzo wysokie rozdzielczości mogą wymagać znacznej ilości pamięci podczas tworzenia wariantów, nawet gdy rozmiar samego pliku mieści się w limicie wysyłania.

Przeglądarka

Do pełnej obsługi zaplecza i galerii potrzebna jest współczesna przeglądarka z włączonym JavaScriptem. Przeciąganie zdjęć, okna podglądu, operacje zbiorcze i automatyczny zapis kolejności wymagają JavaScriptu.

Lista kontrolna przed instalacją

Przed rozpoczęciem sprawdź:

  1. wersję Joomla i PHP;
  2. dostępność rozszerzeń fileinfo, gd i mbstring;
  3. możliwość zapisu w katalogu images;
  4. limity przesyłania i pamięci PHP;
  5. aktualną kopię zapasową plików i bazy danych Joomla.