Sema Pix Gallery with Resize for Joomla

Sada rozšíření pro Joomla pro automatické zpracování obrázků (změna velikosti, formát, komprese) a správu fotogalerií.

Balíček	Verze	Joomla	PHP
pkg_semapix	1.2.2	4.x, 5.x, 6.x	8.1+ (Imagick nebo GD)

Obsah

Požadavky
Instalace
Obsah balíčku
Nastavení pluginu (presety)
Admin modul – rychlý upload
Fotogalerie – správa galerií
Nahrávání obrázků
Správa obrázků v galerii
Parametry galerie
Uložení a publikování
Menu položky
Zobrazení na webu
Modul galerie (mod_semapixgallery)
Správa existujících galerií
Odinstalace
Řešení problémů

1. Požadavky

Joomla: 4.x, 5.x nebo 6.x
PHP: 8.1 nebo novější
PHP rozšíření: Imagick (doporučeno) nebo GD
MySQL: 5.7+ / MariaDB 10.3+
Diskový prostor: dostatek pro zpracované varianty obrázků (každý originál se zpracuje na 2+ varianty)

Doporučení: Imagick poskytuje výrazně lepší kvalitu a rychlost zpracování než GD. Pokud máte možnost, nainstalujte rozšíření Imagick na serveru.

2. Instalace

Získání instalačního balíčku

Stáhněte soubor pkg_semapix.zip ze SemaHub (Semakin.cz).

Postup instalace

Přihlaste se do administrace Joomla.
Přejděte do System > Install > Extensions.
Nahrajte ZIP soubor pkg_semapix.zip.
Joomla nainstaluje všech 5 dílů najednou v tomto pořadí:
- Knihovna: lib_semapix (zpracování obrázků)
- Plugin: plg_system_semapix (form field + widget)
- Modul (admin): mod_semapix (rychlý upload na dashboardu)
- Komponenta: com_semapixgallery (správa fotogalerií)
- Modul (site): mod_semapixgallery (zobrazení galerie v pozici šablony)
Plugin se povolí automaticky. Admin modul se publikuje na pozici cpanel.

Upgrade: Stejný postup jako instalace. Joomla použije method="upgrade" a zachová existující data i nastavení.

3. Obsah balíčku

Rozšíření	Typ	Popis
lib_semapix	Knihovna	Jádro – zpracování obrázků (změna velikosti, formát, komprese). Adaptéry pro Imagick a GD.
plg_system_semapix	System plugin	Poskytuje upload widget (`type="semapix"`) pro použití v libovolné komponentě. Definice presetu a variant.
mod_semapix	Admin modul	Drag-and-drop upload přímo na dashboardu administrace. Rychlé zpracování bez nutnosti otvírat galerii.
com_semapixgallery	Komponenta	Kompletní správa fotogalerií – vytváření, editace, upload, publikování. Frontend s gridem a lightboxem.
mod_semapixgallery	Site modul	Zobrazení vybrané galerie v libovolné pozici šablony (sidebar, patička, apod.).

4. Nastavení pluginu (presety)

Presety definují, jak se obrázky zpracují – jakou geometrii, formát a kompresi dostanou.

Otevření nastavení

System > Manage > Plugins
Vyhledejte semapix nebo Semapix.
Klikněte na název pluginu.

Výchozí presety

Po instalaci je k dispozici preset gallery s variantami:

Varianta	Geometrie	Rozměr	Formát	Popis
thumb	cover	300×300	WebP	Miniatura pro náhled v gridu
large	fit	1200×900	WebP	Velká verze pro lightbox

Parametry varianty

Parametr	Popis
Název varianty	Identifikátor varianty (např. `thumb`, `large`).
Geometrie	`scale` = změna velikosti, `fit` = vejde se do rozměrů, `cover` = vyplní rozměr (s oříznutím), `pad` = doplní pozadím.
Šířka / Výška	Cílový rozměr v pixelech.
Formát	`jpg`, `png`, `webp` nebo `auto` (zachová originál).
Kvalita	1–100. Výchozí 82. Vyšší = lepší kvalita, větší soubor.
Max. velikost (kB)	Volitelně. Binárním hledáním najde nejlepší kvalitu pro cílovou velikost.
Gravitace	Pro geometrii `cover` a `pad`. Určuje, která část obrázku se zachová (center, north, south…).
Pozadí	Pro geometrii `pad`. Barva výplně okrajů (hex, např. `#ffffff`).

Tip: Presety nastavuje správce webu. Běžný uživatel (redaktor) je nepotřebuje měnit – používá je automaticky při nahrávání obrázků do galerie.

5. Admin modul – rychlý upload

Admin modul se po instalaci objeví na dashboardu administrace jako panel „Semapix“.

Použití

Na dashboardu najdete panel Semapix s tlačítky presetů.
Klikněte na tlačítko presetu (např. „gallery“).
Vyberte obrázky z počítače.
Obrázky se okamžitě zpracují podle vybraného presetu.
Výsledky se uloží do složky images/semapix/.

Poznámka: Admin modul je určen pro rychlé jednorázové zpracování obrázků bez nutnosti vytvářet galerii. Pro správu fotogalerií použijte komponentu (kapitola 6).

6. Fotogalerie – správa galerií

Ke správě galerií se dostanete přes hlavní menu administrace Joomla:

Přihlaste se do administrace vašeho webu (/administrator).
V levém menu klikněte na položku „Semapix Galerie“ (nebo „Components > Semapix Galerie“).
Zobrazí se seznam všech galerií s počtem obrázků a stavem publikování.

Pokud položku Semapix Galerie v menu nevidíte, komponenta není nainstalována. Kontaktujte správce webu.

Seznam galerií

V seznamu galerií vidíte tabulku se sloupci:

Zaškrtávací políčko – pro hromadné akce (publikovat, odpublikovat, smazat)
Stav – zelená ikonka = publikováno, červená = odpublikováno
Název – klikněte pro otevření editace galerie
Obrázky – počet nahraných obrázků
Pořadí – číslo určující řazení galerií

Vytvoření nové galerie

V seznamu galerií klikněte na tlačítko „Nová“ (nebo „New“) v horním toolbaru.
Otevře se formulář pro editaci galerie.

Pole	Popis
Název (Title)	Povinné pole. Název galerie, který se zobrazí na webu i v administraci.
Alias	Volitelně. URL-přátelský identifikátor. Pokud ponecháte prázdné, vygeneruje se automaticky z názvu.
Popis	Volitelný textový editor. Popis galerie zobrazený nad obrázky na webu.
Obrázky	Semapix upload widget – viz kapitola 7.
Stav	Publikováno / Odpublikované / V koši.
Kategorie	Volitelná kategorie pro organizaci galerií.
Pořadí	Číslo určující pořadí v seznamu galerií.

7. Nahrávání obrázků

V editaci galerie najdete sekci „Obrázky“ se Semapix upload widgetem. Ten se skládá z tlačítka pro výběr souboru a seznamu nahraných obrázků.

Postup nahrání

Klikněte na tlačítko „Vybrat soubory“.
V dialogu vyberte jeden nebo více obrázků (JPG, PNG, WebP…). Můžete vybrat více souborů najednou pomocí Ctrl/Cmd + klik.
Obrázky se automaticky nahrají a zpracují. U každého se vytvoří varianta náhledu (thumb, 300×300 px) a velká verze (large, 1200×900 px).
Po zpracování se pod tlačítkem zobrazí karty s náhledy nahraných obrázků.
Pokud chcete přidat další obrázky, klikněte na „Vybrat soubory“ znovu – nové obrázky se přidají k existujícím.

Tip: Obrázky se zpracují automaticky – změní se velikost, formát i komprese. Nemusíte fotky předem upravovat. Doporučená velikost originálu je alespoň 1200 px na delší straně.

Poznámka: Počet souborů není omezen. U rozsáhlých galerií (50+ fotek) doporučujeme nahrávat po dávkách cca 10–20 obrázků, aby nedošlo k překročení časového limitu serveru.

8. Správa obrázků v galerii

Změna pořadí

Každý obrázek má vlevo ikonu pro přetahování. Chyťte ikonu myší a přetáhněte obrázek na požadované místo v seznamu. Pořadí se uloží při uložení galerie.

Odebrání obrázků

U každého obrázku je vpravo tlačítko „Odebrat“. Po kliknutí se obrázek odebere ze seznamu galerie. Fyzické soubory na serveru zůstanou zachovány – odebrání z galerie znamená jen odpojení od dané galerie.

Důležité: Nezapomeňte po změnách kliknout na „Uložit“ v horním toolbaru. Bez uložení se změny pořadí ani odebrání neprojeví.

9. Parametry galerie

Pod obrázky najdete sekci „Parametry galerie“, kde můžete přizpůsobit zobrazení dané galerie na webu.

Parametr	Popis
Sloupce	Počet sloupců v mřížce náhledu (2–6). Výchozí hodnota je 4. Na mobilních zařízeních se počet sloupců automaticky sníží.
Varianta náhledu	Název varianty pro miniatury v gridu. Výchozí: „thumb“. Tuto hodnotu obvykle není potřeba měnit.
Varianta velkého obr.	Název varianty pro lightbox. Výchozí: „large“. Tuto hodnotu obvykle není potřeba měnit.

Tip: Pokud si nejste jistí, ponechte výchozí hodnoty. Sloupce jsou nejdůležitější parametr – určují, kolik obrázků bude v jednom řádku na desktopu.

10. Uložení a publikování

V horním toolbaru editace galerie najdete několik tlačítek:

Tlačítko	Akce
Uložit	Uloží galerii a zůstane v editaci.
Uložit & Zavřít	Uloží galerii a vrátí se do seznamu galerií.
Uložit & Nový	Uloží galerii a otevře formulář pro nový záznam.
Zavřít	Zavře editaci bez uložení (změny se ztratí!).

Stav publikování můžete nastavit buď přímo v editaci galerie (pole „Stav“ v pravém sloupci), nebo v seznamu galerií kliknutím na ikonku stavu:

Zelená ikonka = Publikováno – galerie je viditelná na webu.
Červená ikonka = Odpublikováno – galerie není viditelná pro návštěvníky.

Aby se galerie zobrazila na webu, musí existovat odpovídající položka v menu. Jsou k dispozici dva typy:

Typ A: „Jedna galerie“

Zobrazí jednu konkrétní galerii s obrázky.

Přejděte do Menu > vyberte cílové menu > klikněte „Nová položka“.
Typ položky: vyberte „Semapix Gallery > Jedna galerie“ (Single Gallery).
V parametrech vyberte galerii z rozevíracího seznamu.
Nastavte název položky v menu a uložte.

Typ B: „Seznam galerií“

Zobrazí přehled všech publikovaných galerií jako dlaždicový grid (každá galerie jako karta s náhledem). Po kliknutí na galerii se otevře její detail.

Přejděte do Menu > vyberte cílové menu > klikněte „Nová položka“.
Typ položky: vyberte „Semapix Gallery > Seznam galerií“ (Gallery List).
Volitelně vyberte kategorii pro filtraci.
Nastavte název a uložte.

Poznámka: U obou typů můžete v parametrech položky nastavit počet sloupců a varianty obrázků. Tato nastavení přepíší hodnoty z parametrů galerie.

Doporučení: Po vytvoření menu položky doporučujeme vyčistit mezipaměť Joomla: System > Vymazat mezipaměť (Clear Cache).

12. Zobrazení na webu

Obrázkový grid

Galerie se na webu zobrazí jako mřížka (grid) náhledových obrázků. Počet sloupců se přizpůsobí velikosti obrazovky:

Desktop: počet dle nastavení (výchozí 4 sloupce)
Tablet: 2–3 sloupce
Mobil: 1 sloupec

Lightbox

Po kliknutí na obrázek se otevře lightbox – velká verze fotky přes celou obrazovku s tmavým pozadím. Ovládání:

Šipka vlevo / vpravo nebo klik na kraje – předchozí / další fotka
Klávesa Esc nebo klik na křížek – zavření lightboxu
Čítač v levém dolním rohu ukazuje pořadí (např. 3 / 24)

Stránkování

Pokud má galerie více obrázků, než se vejde na jednu stránku (výchozí 5 řádků), zobrazí se pod gridem stránkovací tlačítka. I při stránkování lightbox umožňuje procházet všechny fotky galerie.

13. Modul galerie (mod_semapixgallery)

Modul umožňuje zobrazit vybranou galerii v libovolné pozici šablony (sidebar, patička, obsah apod.).

Nastavení modulu

Přejděte do Content > Site Modules.
Najdete modul „Semapix Gallery“ (vytvoří se automaticky při instalaci).
Nebo vytvořte nový modul typu „Semapix Gallery“.

Parametr	Popis
Galerie	Vyberte galerii z rozevíracího seznamu.
Sloupce	Počet sloupců v gridu (2–6).
Varianta náhledu	Název varianty pro miniatury. Výchozí: „thumb“.
Varianta velkého obr.	Název varianty pro lightbox. Výchozí: „large“.
Lightbox	Zapnout/vypnout lightbox při kliknutí na obrázek.
Stránkování	Zapnout/vypnout stránkování při větším počtu obrázků.
Max. obrázků	Omezení maximálního počtu zobrazených obrázků (0 = všechny).
Odkaz	Volitelný URL odkaz – zobrazí tlačítko „Zobrazit galerii“ pod gridem.
Pozice	Pozice v šabloně (sidebar, footer, content apod.).

Důležité: Modul používá CSS a JavaScript z media/com_semapixgallery/. Komponenta com_semapixgallery musí být nainstalována.

14. Správa existujících galerií

Editace

V seznamu galerií klikněte na název galerie – otevře se editace. Můžete změnit název, popis, přidat/odebrat obrázky, změnit parametry a stav publikování.

Hromadné akce

V seznamu galerií můžete vybrat více záznamů (zaškrtávací políčka) a použít tlačítka v toolbaru:

Publikovat – zviditelnění vybraných galerií na webu
Odpublikovat – skrytí vybraných galerií
Do koše – přesunutí vybraných galerií do koše

Vyprázdnění koše

Galerie v koši se zobrazí po nastavení filtru „Stav“ na „V koši“. Vyberte záznamy a klikněte na „Vyprázdnit koš“ pro trvalé smazání.

Vyhledávání a filtrování

Nad tabulkou je vyhledávací pole, kde můžete hledat galerie podle názvu. Filtry umožňují zobrazit jen galerie v určitém stavu nebo kategorii.

15. Odinstalace

Postup

System > Manage > Extensions
Vyhledejte Semapix nebo pkg_semapix.
Vyberte balík a klikněte na Odinstalovat.

Co se smaže

Všech 5 rozšíření (knihovna, plugin, admin modul, komponenta, site modul)
Tabulka #__semapixgallery (data galerií)

Co ZŮSTANE zachováno

Zpracované obrázky ve složce images/semapix/

Pokud chcete odstranit i obrázky, smažte ručně složku images/semapix/ přes FTP nebo File Manager.

16. Řešení problémů

Galerie se nezobrazuje na webu

Ověřte, že galerie má stav „Publikováno“.
Ověřte, že existuje položka v menu odkazující na galerii (viz kapitola 11).
Vyčistěte mezipaměť: System > Vymazat mezipaměť.

Obrázky se po nahrání nezobrazují

Ujistěte se, že jste po nahrání klikli na „Uložit“.
Zkontrolujte, že upload proběhl úspěšně (zobrazily se karty s náhledy).
Při větším počtu fotek zkuste nahrát menší dávku.

Obrázky mají špatnou kvalitu

Nahrávejte obrázky v co největším rozlišení. Zpracování vytvoří optimalizované verze – menší originál znamená horší výsledek.

Chyba při uploadu

Zkontrolujte, že soubory jsou obrázky (JPG, PNG, WebP, GIF).
Zkontrolujte velikost souboru – server může mít limit (obvykle 2–32 MB na soubor).
Zkontrolujte, že je na serveru nainstalován Imagick nebo GD.
Pokud chyba přetrvává, kontaktujte správce webu.

Změna počtu sloupců

Počet sloupců můžete změnit na dvou místech:

V parametrech galerie (sekce „Parametry galerie“ v editaci) – platí pro danou galerii.
V parametrech menu položky – přepíše nastavení galerie pro daný odkaz v menu.

Plugin Semapix se nezobrazuje v seznamu pluginů

Ověřte, že je nainstalován balík pkg_semapix (nikoliv jednotlivé ZIP soubory).
Zkuste Extensions > Manage > Discover pro nalezení rozšíření.

Admin modul se nezobrazuje na dashboardu

Ověřte, že modul je publikovaný: Content > Administrator Modules > vyhledejte „Semapix“.
Zkontrolujte pozici modulu – měla by být cpanel.

Výstupní složka obrázků

Všechny zpracované obrázky se ukládají do:

images/semapix/{preset}/{varianta}/

Například:

images/semapix/gallery/thumb/ – miniatury
images/semapix/gallery/large/ – velké verze

Složky se vytvářejí automaticky. Originální nahrané soubory se neukládají – ukládají se pouze zpracované varianty.

Kontrolní seznam pro spuštění

Balík nainstalován (pkg_semapix.zip)
Plugin Semapix je povolený a pořadí je co nejnižší (System > Plugins)
Presety nastavené podle potřeby (výchozí gallery stačí pro základní použití)
Alespoň jedna galerie vytvořena a publikovaná
Menu položka odkazující na galerii vytvořena
Testovací nahrání obrázků provedeno a obrázky se zobrazují na frontendu
Mezipaměť Joomla vyčištěna