Semapix — zpracování obrázků pro Joomla
Presety, varianty, formáty a komprese. Jeden upload — hotovo.
5 rozšíření v jednom balíku. Nainstalujte za minutu.
Každý web potřebuje obrázky v různých velikostech: náhled, detail, lightbox, WebP pro rychlost. Ručně škálovat, ořezávat, konvertovat a komprimovat desítky fotek stojí hodiny času — a výsledek je pokaždé jiný. Semapix to dělá automaticky.
Proč to potřebujete
Každý obrázek na webu by měl existovat ve správné velikosti, formátu a kvalitě — pro rychlé načítání, responzivní zobrazení i SEO skóre. Ruční zpracování je pomalé, chybové a nekonzistentní.
Bez Semapixu
- Ruční škálování každé fotky v editoru
- Nekonzistentní rozměry a kvalita napříč webem
- Zapomenuté WebP verze — pomalé načítání
- Obrázky 5 MB místo 50 KB — odchod návštěvníků
Se Semapixem
- Nahrajete fotku — preset vygeneruje všechny varianty
- Konzistentní rozměry, formáty i komprese na celém webu
- Automatická konverze do WebP nebo AVIF
- Cílová velikost souboru — nikdy nepřekročíte limit
Co balík obsahuje
Jeden ZIP soubor nainstaluje pět rozšíření ve správném pořadí. Plugin se automaticky povolí, modul se publikuje na dashboard. Žádná ruční konfigurace závislostí.
Zpracování obrázků — jádro
- Presety s variantami — definujete jednou, používáte stále; náhled 300×300 WebP, detail 1200×900 JPG, cokoliv potřebujete
- 4 režimy geometrie — scale (přesný rozměr), fit (vejít bez ořezu), cover (vyplnit s ořezem), pad (plátno s pozadím — žádná deformace)
- Konverze formátů — JPG, WebP, AVIF nebo zachovat originální; Imagick i GD adapter
- Cílová velikost souboru — nastavíte maxKb, Semapix iterativně hledá optimální kvalitu binárním hledáním
- Archivace originálu — volitelně uloží netknutý zdrojový soubor pro budoucí přegenerování
Fotogalerie — komponenta + modul
- Admin CRUD — vytváření galerií, upload fotek přes Semapix widget, řazení drag & drop
- Responzivní grid — konfigurovatelný počet sloupců, automatická adaptace na mobil/tablet
- Lightbox — vanilla JS, žádné závislosti; šipkami procházíte všechny fotky galerie
- Klient-side stránkování — po řádcích, detekuje počet sloupců z CSS gridu, okamžité přepínání
- Frontend modul — zobrazí galerii v libovolné pozici šablony (sidebar, footer, widget area)
- Externí zdroj obrázků — galerie může načítat fotky ze složky jiné komponenty (filesystem scan)
Widget pro vlastní komponenty
- Form field
type="semapix"— vložíte jeden řádek XML do formuláře libovolné komponenty - PHP helper —
SemapixWidget::render()pro programové vložení - JS API —
Joomla.SemapixWidget.init()pro dynamické použití - Multi-file upload — drag & drop řazení, JSON výstup do hidden inputu
Jak to funguje
Zpracování obrázku
Nahrajte obrázek
Přetáhněte fotku do widgetu nebo ji vyberte přes file input. Podporuje hromadný upload více souborů najednou.
Preset zpracuje varianty
Semapix automaticky vygeneruje všechny varianty podle presetu: náhled, detail, WebP verzi — přesně podle vašich pravidel.
Hotovo
Výsledky se uloží do definovaných složek s definovanými názvy. Karty s náhledy a tabulkou variant se zobrazí okamžitě.
Fotogalerie
Vytvořte galerii
V administraci: Komponenty → Semapix Galerie → Nová. Zadejte název a nahrajte fotky přes Semapix widget.
Přidejte do menu
Menu → Nová položka → Semapix Gallery. Vyberte „Seznam galerií" nebo „Jedna galerie" a uložte.
Galerie je na webu
Responzivní grid s lightboxem a stránkováním. Funguje na desktopu, tabletu i mobilu bez dalšího nastavení.
Co vše lze nastavit
| Nastavení | Popis |
|---|---|
| Presety | Libovolný počet presetů, každý s vlastní sadou variant |
| Varianty | Suffix, rozměry, režim (scale/fit/cover/pad), formát, kvalita |
| Cílová velikost | maxKb — automatická komprese pod zadaný limit |
| Výstupní formát | JPG, WebP, AVIF nebo zachovat originální |
| Režim plátna (pad) | Barva pozadí, gravitace, vnitřní padding v % |
| Cesty a názvy | Tokeny {name}, {suffix}, {w}, {h}, {year}, {id}, {ext} |
| Výstupní adresář | Konfigurovatelná báze cest (výchozí images/semapix/) |
| Archivace originálu | Volitelné uložení netknutého zdrojového souboru |
| Adapter | Auto / Imagick / GD — automatická detekce |
| Povolené presety | Whitelist presetů pro konkrétní widgety |
| Max. velikost uploadu | Limit v MB na nahrávaný soubor |
| Frontend upload | Povolení uploadu z frontendu (výchozí: vypnuto) |
| Sloupce galerie | 2–6 sloupců, konfigurovatelné per galerie i per modul |
| Stránkování | Počet řádků na stránku (0 = vypnout) |
Technické parametry
| Parametr | Hodnota |
|---|---|
| Typ rozšíření | Joomla Package (knihovna + plugin + modul + komponenta + site modul) |
| Kompatibilita | Joomla 4.x / 5.x / 6.x, PHP 8.1+ |
| Obrazové adaptery | Imagick (primární, WebP + AVIF) / GD (fallback) |
| JavaScript | Vanilla JS, žádné závislosti (0 kB frameworků) |
| CSS | Izolované styly s prefixem spx-, dark mode kompatibilní |
| Lokalizace | Čeština, Angličtina |
| Instalace | Jeden ZIP přes Joomla Instalátor rozšíření |
| Aktualizace | Plně automatické přes Joomla updater (SemaHub) |
| Bezpečnost | CSRF token, ACL, preset whitelist, MIME validace, prepared statements |
| Licence | GPL v2+ |
| Aktuální verze | 1.2.0 |
Obsah balíku
lib_semapix
Jádro — Processor, presety, adaptery (Imagick/GD). Čistá PHP knihovna bez UI závislostí. Geometrie, formáty, komprese s cílovou velikostí.
plg_system_semapix
Systémový plugin — form field type="semapix", PHP helper, JS API. Přidá Semapix upload do libovolné komponenty jedním řádkem XML.
mod_semapix
Admin modul — drag & drop upload na dashboardu. Tlačítka presetů, progress bar, tabulka výsledků s kopírováním cest.
com_semapixgallery
Fotogalerie — admin CRUD, frontend grid s lightboxem a stránkováním. Dva typy menu položek: seznam galerií a detail galerie.
mod_semapixgallery
Site modul — zobrazí galerii v libovolné pozici šablony (sidebar, footer). Vlastní parametry pro sloupce, lightbox, stránkování, max obrázků.
Časté dotazy
Potřebuji na serveru Imagick?
Ne nutně. Semapix preferuje Imagick (lepší kvalita, podpora AVIF), ale automaticky přepne na GD, pokud Imagick není dostupný. GD je součástí prakticky každého hostingu.
Mohu Semapix použít i v jiné komponentě než galerii?
Ano. Systémový plugin poskytuje form field type="semapix", který vložíte do XML formuláře libovolné komponenty. Stačí jeden řádek.
Co je režim pad (plátno)?
Obrázek se zmenší dovnitř zadaného rozměru bez deformace a ořezu, a vsadí se na plátno s definovaným pozadím. Ideální pro katalogy a e-shopy, kde potřebujete jednotné rozměry.
Jak funguje cílová velikost souboru (maxKb)?
Semapix iterativně hledá optimální kvalitu komprese binárním hledáním. Pokud ani minimální kvalita nestačí, automaticky zmenší rozměr. Výsledek je vždy pod zadaným limitem.
Musím upravovat šablonu pro galerii?
Ne. Galerie funguje okamžitě po vytvoření menu položky. Grid je responzivní, lightbox i stránkování se aktivují automaticky. Pokud chcete přizpůsobit vzhled, můžete vytvořit template override.
Funguje lightbox i na mobilu?
Ano. Lightbox je napsaný ve vanilla JavaScriptu, podporuje dotykové gesto swipe a funguje na všech zařízeních bez dalších závislostí.
Mohu mít více galerií s různým nastavením?
Ano. Každá galerie má vlastní parametry (počet sloupců, varianta náhledu a detailu). Navíc můžete zobrazit tutéž galerii s jinými parametry přes frontend site modul.
Podporuje dark mode v administraci?
Ano. Všechny styly používají neutrální barvy (color-mix, rgba, color: inherit) — fungují správně na světlé i tmavé verzi Atum šablony.
Co se stane po roce?
Rozšíření funguje dál bez omezení — nic se nevypne. Po roce pouze přestanou chodit aktualizace. Obnovou licence získáte další rok aktualizací a e-mailové podpory.
Potřebuji jQuery?
Ne. Celý balík je napsaný ve vanilla JavaScriptu bez jakýchkoli závislostí.