Sada Joomla 5 rozsireni pro automaticke zpracovani obrazku (zmena velikosti, format, komprese) a spravu fotogalerii.

Balicek	Verze	Joomla	PHP
pkg_semapix	1.2.0	5.x	8.1+ (Imagick nebo GD)

---

---

1. Pozadavky

• Joomla: 5.x
• PHP: 8.1 nebo novejsi
• PHP rozsireni: Imagick (doporuceno) nebo GD
• MySQL: 5.7+ / MariaDB 10.3+
• Diskovy prostor: dostatek pro zpracovane varianty obrazku (kazdy original se zpracuje na 2+ varianty)

Doporuceni: Imagick poskytuje vyrazne lepsi kvalitu a rychlost zpracovani nez GD. Pokud mate moznost, nainstalujte rozsireni Imagick na serveru.

---

2. Instalace

Ziskani instalacniho balicku

Stahnete soubor pkg_semapix.zip ze SemaHub (semakin.cz).

Postup instalace

1. Prihlaste se do administrace Joomla.
2. Prejdete do System > Install > Extensions.
3. Nahrajte ZIP soubor pkg_semapix.zip.
4. Joomla nainstaluje vsech 5 dilu najednou v tomto poradi:
   • Knihovna: lib_semapix (zpracovani obrazku)
   • Plugin: plg_system_semapix (form field + widget)
   • Modul (admin): mod_semapix (rychly upload na dashboardu)
   • Komponenta: com_semapixgallery (sprava fotogalerii)
   • Modul (site): mod_semapixgallery (zobrazeni galerie v pozici sablony)
5. Plugin se povoli automaticky. Admin modul se publikuje na pozici cpanel.

Upgrade: Stejny postup jako instalace. Joomla pouzije method="upgrade" a zachova existujici data i nastaveni.

---

3. Obsah balicku

Rozsireni	Typ	Popis
lib_semapix	Knihovna	Jadro – zpracovani obrazku (zmena velikosti, format, komprese). Adaptery pro Imagick a GD.
plg_system_semapix	System plugin	Poskytuje upload widget (type="semapix") pro pouziti v libovolne komponente. Definice presetu a variant.
mod_semapix	Admin modul	Drag-and-drop upload primo na dashboardu administrace. Rychle zpracovani bez nutnosti otvirat galerii.
com_semapixgallery	Komponenta	Kompletni sprava fotogalerii – vytvareni, editace, upload, publikovani. Frontend s gridem a lightboxem.
mod_semapixgallery	Site modul	Zobrazeni vybrane galerie v libovolne pozici sablony (sidebar, paticka, apod.).

---

4. Nastaveni pluginu (presety)

Presety definuji, jak se obrazky zpracuji – jakou geometrii, format a kompresi dostanou.

Otevreni nastaveni

1. System > Manage > Plugins
2. Vyhledejte semapix nebo Semapix.
3. Kliknete na nazev pluginu.

Vychozi presety

Po instalaci je k dispozici preset gallery s variantami:

Varianta	Geometrie	Rozmer	Format	Popis
thumb	cover	300×300	webp	Miniatura pro nahled v gridu
large	fit	1200×900	webp	Velka verze pro lightbox

Parametry varianty

Parametr	Popis
Nazev varianty	Identifikator varianty (napr. thumb, large).
Geometrie	scale = zmena velikosti, fit = vejde se do rozmeru, cover = vyplni rozmer (s oriznutim), pad = doplni pozadim.
Sirka / Vyska	Cilovy rozmer v pixelech.
Format	jpg, png, webp nebo auto (zachova original).
Kvalita	1–100. Vychozi 82. Vyssi = lepsi kvalita, vetsi soubor.
Max. velikost (kB)	Volitelne. Binarnim hledanim najde nejlepsi kvalitu pro cilovou velikost.
Gravitace	Pro geometrii cover a pad. Urcuje, ktera cast obrazku se zachova (center, north, south…).
Pozadi	Pro geometrii pad. Barva vyplne okraju (hex, napr. #ffffff).

Tip: Presety nastavuje spravce webu. Bezny uzivatel (redaktor) je nepotrebuje menit – pouziva je automaticky pri nahravani obrazku do galerie.

---

5. Admin modul – rychly upload

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

Pouziti

1. Na dashboardu najdete panel Semapix s tlacitky presetu.
2. Kliknete na tlacitko presetu (napr. „gallery“).
3. Vyberte obrazky z pocitace.
4. Obrazky se okamzite zpracuji podle vybraneho presetu.
5. Vysledky se ulozi do slozky images/semapix/.

Poznamka: Admin modul je urcen pro rychle jednorazove zpracovani obrazku bez nutnosti vytvaret galerii. Pro spravne fotogalerie pouzijte komponentu (kapitola 6).

---

6. Fotogalerie – sprava galerii

Ke sprave galerii se dostanete pres hlavni menu administrace Joomla:

1. Prihlaste se do administrace vaseho webu (/administrator).
2. V levem menu kliknete na polozku „Semapix Galerie“ (nebo „Components > Semapix Galerie“).
3. Zobrazi se seznam vsech galerii s poctem obrazku a stavem publikovani.

Pokud polozku Semapix Galerie v menu nevidite, komponenta neni nainstalovana. Kontaktujte spravce webu.

Seznam galerii

V seznamu galerii vidite tabulku se sloupci:

• Zasktavaci policko – pro hromadne akce (publikovat, odpublikovat, smazat)
• Stav – zelena ikonka = publikovano, cervena = odpublikovane
• Nazev – kliknete pro otevreni editace galerie
• Obrazky – pocet nahranych obrazku
• Poradi – cislo urcujici razeni galerii

Vytvoreni nove galerie

1. V seznamu galerii kliknete na tlacitko „Nova“ (nebo „New“) v hornim toolbaru.
2. Otevre se formular pro editaci galerie.

Pole	Popis
Nazev (Title)	Povinne pole. Nazev galerie, ktery se zobrazi na webu i v administraci.
Alias	Volitelne. URL-pratelsky identifikator. Pokud ponechate prazdne, vygeneruje se automaticky z nazvu.
Popis	Volitelny textovy editor. Popis galerie zobrazeny nad obrazky na webu.
Obrazky	Semapix upload widget – viz kapitola 7.
Stav	Publikovano / Odpublikovane / V kosi.
Kategorie	Volitelna kategorie pro organizaci galerii.
Poradi	Cislo urcujici poradi v seznamu galerii.

---

7. Nahravani obrazku

V editaci galerie najdete sekci „Obrazky“ se Semapix upload widgetem. Ten se sklada z tlacitka pro vyber souboru a seznamu nahranych obrazku.

Postup nahrani

1. Kliknete na tlacitko „Vybrat soubory“.
2. V dialogu vyberte jeden nebo vice obrazku (JPG, PNG, WebP…). Muzete vybrat vice souboru najednou pomoci Ctrl/Cmd + klik.
3. Obrazky se automaticky nahraji a zpracuji. U kazdeho se vytvori varianta nahledu (thumb, 300×300 px) a velka verze (large, 1200×900 px).
4. Po zpracovani se pod tlacitkem zobrazi karty s nahledy nahranych obrazku.
5. Pokud chcete pridat dalsi obrazky, kliknete na „Vybrat soubory“ znovu – nove obrazky se pridaji k existujicim.

Tip: Obrazky se zpracuji automaticky – zmeni se velikost, format i komprese. Nemusite fotky predem upravovat. Doporucena velikost originalu je alespon 1200 px na delsi strane.

Poznamka: Pocet souboru neni omezen. U rozsahlych galerii (50+ fotek) doporucujeme nahravat po davkach cca 10–20 obrazku, aby nedoslo k prekroceni casoveho limitu serveru.

---

8. Sprava obrazku v galerii

Zmena poradi

Kazdy obrazek ma vlevo ikonu pro pretahovani. Chytnete ikonu mysi a pretahnete obrazek na pozadovane misto v seznamu. Poradi se ulozi pri ulozeni galerie.

Odebrani obrazku

U kazdeho obrazku je vpravo tlacitko „Odebrat“. Po kliknuti se obrazek odebere ze seznamu galerie. Fyzicke soubory na serveru zustanou zachovany – odebrani z galerie znamena jen odpojeni od dane galerie.

Dulezite: Nezapomente po zmenach kliknout na „Ulozit“ v hornim toolbaru. Bez ulozeni se zmeny poradi ani odebrani neprojevi.

---

9. Parametry galerie

Pod obrazky najdete sekci „Parametry galerie“, kde muzete prizpusobit zobrazeni dane galerie na webu.

Parametr	Popis
Sloupce	Pocet sloupcu v mrizce nahledu (2–6). Vychozi hodnota je 4. Na mobilnich zarizenich se pocet sloupcu automaticky snizi.
Varianta nahledu	Nazev varianty pro miniatury v gridu. Vychozi: „thumb“. Tuto hodnotu obvykle neni potreba menit.
Varianta velkeho obr.	Nazev varianty pro lightbox. Vychozi: „large“. Tuto hodnotu obvykle neni potreba menit.

Tip: Pokud si nejste jisti, ponechte vychozi hodnoty. Sloupce jsou nejdulezitejsi parametr – urcuji, kolik obrazku bude v jednom radku na desktopu.

---

10. Ulozeni a publikovani

V hornim toolbaru editace galerie najdete nekolik tlacitek:

Tlacitko	Akce
Ulozit	Ulozi galerii a zustane v editaci.
Ulozit & Zavrit	Ulozi galerii a vrati se do seznamu galerii.
Ulozit & Novy	Ulozi galerii a otevre formular pro novy zaznam.
Zavrit	Zavre editaci bez ulozeni (zmeny se ztrati!).

Stav publikovani muzete nastavit bud primo v editaci galerie (pole „Stav“ v pravem sloupci), nebo v seznamu galerii kliknutim na ikonku stavu:

• Zelena ikonka = Publikovano – galerie je viditelna na webu.
• Cervena ikonka = Odpublikovane – galerie neni viditelna pro navstevniky.

---

11. Menu polozky

Aby se galerie zobrazila na webu, musi existovat odpovidajici polozka v menu. Jsou k dispozici dva typy:

Typ A: „Jedna galerie“

Zobrazi jednu konkretni galerii s obrazky.

1. Prejdete do Menu > vyberte cilove menu > kliknete „Nova polozka“.
2. Typ polozky: vyberte „Semapix Gallery > Jedna galerie“ (Single Gallery).
3. V parametrech vyberte galerii z rozeviraciho seznamu.
4. Nastavte nazev polozky v menu a ulozte.

Typ B: „Seznam galerii“

Zobrazi prehled vsech publikovanych galerii jako dlazdicovy grid (kazda galerie jako karta s nahledem). Po kliknuti na galerii se otevre jeji detail.

1. Prejdete do Menu > vyberte cilove menu > kliknete „Nova polozka“.
2. Typ polozky: vyberte „Semapix Gallery > Seznam galerii“ (Gallery List).
3. Volitelne vyberte kategorii pro filtraci.
4. Nastavte nazev a ulozte.

Poznamka: U obou typu muzete v parametrech polozky nastavit pocet sloupcu a varianty obrazku. Tato nastaveni prepisi hodnoty z parametru galerie.

Doporuceni: Po vytvoreni menu polozky doporucujeme vycistit mezipamet Joomla: System > Vymazat mezipamet (Clear Cache).

---

12. Zobrazeni na webu

Obrazkovy grid

Galerie se na webu zobrazi jako mrizka (grid) nahledovych obrazku. Pocet sloupcu se prizpusobi velikosti obrazovky:

• Desktop: pocet dle nastaveni (vychozi 4 sloupce)
• Tablet: 2–3 sloupce
• Mobil: 1 sloupec

Lightbox

Po kliknuti na obrazek se otevre lightbox – velka verze fotky pres celou obrazovku s tmavym pozadim. Ovladani:

• Sipka vlevo / vpravo nebo klik na kraje – predchozi / dalsi fotka
• Klavesa Esc nebo klik na krizek – zavreni lightboxu
• Citac v levem dolnim rohu ukazuje poradi (napr. 3 / 24)

Strankovani

Pokud ma galerie vice obrazku, nez se vejde na jednu stranku (vychozi 5 radku), zobrazi se pod gridem strankovaci tlacitka. I pri strankovani lightbox umoznuje prochazet vsechny fotky galerie.

---

13. Modul galerie (mod_semapixgallery)

Modul umoznuje zobrazit vybranou galerii v libovolne pozici sablony (sidebar, paticka, obsah apod.).

Nastaveni modulu

1. Prejdete do Content > Site Modules.
2. Najdete modul „Semapix Gallery“ (vytvori se automaticky pri instalaci).
3. Nebo vytvorte novy modul typu „Semapix Gallery“.

Parametr	Popis
Galerie	Vyberte galerii z rozeviraciho seznamu.
Sloupce	Pocet sloupcu v gridu (2–6).
Varianta nahledu	Nazev varianty pro miniatury. Vychozi: „thumb“.
Varianta velkeho obr.	Nazev varianty pro lightbox. Vychozi: „large“.
Lightbox	Zapnout/vypnout lightbox pri kliknuti na obrazek.
Strankovani	Zapnout/vypnout strankovani pri vecim poctu obrazku.
Max. obrazku	Omezeni maximalniho poctu zobrazenych obrazku (0 = vsechny).
Odkaz	Volitelny URL odkaz – zobrazi tlacitko „Zobrazit galerii“ pod gridem.
Pozice	Pozice v sablone (sidebar, footer, content apod.).

Dulezite: Modul pouziva CSS a JavaScript z media/com_semapixgallery/. Komponenta com_semapixgallery musi byt nainstalovana.

---

14. Sprava existujicich galerii

Editace

V seznamu galerii kliknete na nazev galerie – otevre se editace. Muzete zmenit nazev, popis, pridat/odebrat obrazky, zmenit parametry a stav publikovani.

Hromadne akce

V seznamu galerii muzete vybrat vice zaznamu (zasktavaci policka) a pouzit tlacitka v toolbaru:

• Publikovat – zviditeni vybranych galerii na webu
• Odpublikovat – skryti vybranych galerii
• Do kose – presunuti vybranych galerii do kose

Vyprazdneni kose

Galerie v kosi se zobrazi po nastaveni filtru „Stav“ na „V kosi“. Vyberte zaznamy a kliknete na „Vyprazdnit kos“ pro trvale smazani.

Vyhledavani a filtrovani

Nad tabulkou je vyhledavaci pole, kde muzete hledat galerie podle nazvu. Filtry umoznuji zobrazit jen galerie v urcitem stavu nebo kategorii.

---

15. Odinstalace

Postup

1. System > Manage > Extensions
2. Vyhledejte Semapix nebo pkg_semapix.
3. Vyberte balik a kliknete na Odinstalovat.

Co se smaze

• Vsech 5 rozsireni (knihovna, plugin, admin modul, komponenta, site modul)
• Tabulka #__semapixgallery (data galerii)

Co ZUSTANE zachovano

• Zpracovane obrazky ve slozce images/semapix/

Pokud chcete odstranit i obrazky, smazte rucne slozku images/semapix/ pres FTP nebo File Manager.

---

16. Reseni problemu

Galerie se nezobrazuje na webu

• Overte, ze galerie ma stav „Publikovano“.
• Overte, ze existuje polozka v menu odkazujici na galerii (viz kapitola 11).
• Vycistete mezipamet: System > Vymazat mezipamet.

Obrazky se po nahrani nezobrazuji

• Ujistete se, ze jste po nahrani klikli na „Ulozit“.
• Zkontrolujte, ze upload probehl uspesne (zobrazily se karty s nahledy).
• Pri vetsim poctu fotek zkuste nahrat mensi davku.

Obrazky maji spatnou kvalitu

Nahravejte obrazky v co nejvetsim rozliseni. Zpracovani vytvori optimalizovane verze – mensi original znamena horsi vysledek.

Chyba pri uploadu

• Zkontrolujte, ze soubory jsou obrazky (JPG, PNG, WebP, GIF).
• Zkontrolujte velikost souboru – server muze mit limit (obvykle 2–32 MB na soubor).
• Zkontrolujte, ze je na serveru nainstalovan Imagick nebo GD.
• Pokud chyba pretrvava, kontaktujte spravce webu.

Zmena poctu sloupcu

Pocet sloupcu muzete zmenit na dvou mistech:

• V parametrech galerie (sekce „Parametry galerie“ v editaci) – plati pro danou galerii.
• V parametrech menu polozky – prepise nastaveni galerie pro dany odkaz v menu.

Plugin Semapix se nezobrazuje v seznamu pluginu

• Overte, ze je nainstalovan balik pkg_semapix (nikoliv jednotlive ZIP soubory).
• Zkuste Extensions > Manage > Discover pro nalezeni rozsireni.

Admin modul se nezobrazuje na dashboardu

• Overte, ze modul je publikovany: Content > Administrator Modules > vyhledejte „Semapix“.
• Zkontrolujte pozici modulu – mela by byt cpanel.

---

Vystupni slozka obrazku

Vsechny zpracovane obrazky se ukladaji do:

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

Napriklad:

• images/semapix/gallery/thumb/ – miniatury
• images/semapix/gallery/large/ – velke verze

Slozky se vytvarei automaticky. Originalni nahrane soubory se neukladaji – ukladaji se pouze zpracovane varianty.

---

Kontrolni seznam pro spusteni

• Balik nainstalovan (pkg_semapix.zip)
• Plugin Semapix je povoleny a poradi je co nejnizsi (System > Plugins)
• Presety nastaveny podle potreby (vychozi gallery staci pro zakladni pouziti)
• Alespon jedna galerie vytvorena a publikovana
• Menu polozka odkazujici na galerii vytvorena
• Testovaci nahrani obrazku provedeno a obrazky se zobrazuji na frontendu
• Mezipamet Joomla vycistena