Balík pro administraci e-shopu na VirtueMart: šablona administrace SemaAdmin se světlým i tmavým režimem, přehledné menu, změna dopravy a platby v objednávce, číslování objednávek, aktuální faktury, oprava znaků + a % v adresách a Kontrola e-shopu, která jen čte a ukáže, co je na e-shopu potřeba opravit.
| Požadavek | Verze |
|---|---|
| Joomla | 5.3 a novější 5.x |
| VirtueMart | 4.6.4 a 4.8.2 (ověřeno), další viz Kompatibilita |
| Šablona VirtueMart | vmadmin se zapnutou volbou Admin šablona |
| Režim administrace | světlý, tmavý nebo podle systému |
| Aktuální verze | 1.2.0 |
1. Než začnete
- Balík je nadstavba nad šablonou
vmadmin, která je součástí VirtueMart. V konfiguraci VirtueMart musí být zapnutá Admin šablona, jinak VirtueMart kreslí klasický vzhled a vzhled balíku se neprojeví. - Balík obsahuje šablonu administrace SemaAdmin. Režim (světlý, tmavý, podle systému), barevnou sadu a velikost zobrazení si každý uživatel volí v záhlaví administrace v nabídce Vzhled, stránky VirtueMart se přizpůsobí.
- Balík neupravuje soubory jádra VirtueMart. Každý modul je samostatný plugin a jde vypnout zvlášť.
2. Instalace a aktualizace
Instalace: v administraci otevřete Systém → Instalace → Rozšíření a nahrajte soubor pkg_semavmtuning-<verze>.zip stažený ze semakin.cz. Instalace se zastaví a na webu nic nezmění, pokud web běží na Joomla starší než 5 nebo na něm není VirtueMart.
Po první instalaci je stav modulů tento:
| Modul | Po instalaci |
|---|---|
| Šablona administrace SemaAdmin | nainstalovaná, výchozí jen při první instalaci (viz níž) |
| Vzhled administrace | zapnutý |
| Menu E-shop | zapnutý |
| Změna dopravy a platby | zapnutý |
| Číslování objednávek | vypnutý |
| Aktuální faktura po úpravě | vypnutý |
| Oprava + a % v adresách | zapnutý |
| Kontrola e-shopu | zapnutá |
Číslování a faktury zůstávají vypnuté, protože mění doklady. Moduly zapnete a nastavíte v Systém → Spravovat → Pluginy, hledejte „SemaVM“.
Aktualizace nepřepíše vaše volby. Výchozí stav se nastavuje jen modulům, které na webu ještě nebyly.
Šablona SemaAdmin: při první instalaci se nastaví jako výchozí šablona administrace a VirtueMart přestane zavírat menu Joomla. Při aktualizaci z verze 1.1 nebo když už SemaAdmin na webu je, se výchozí šablona nemění; přepnete ji v Systém → Šablony administrace. Pokud máte samostatný balík SemaAdmin for Joomla, tenhle balík si šablonu převezme i s nastavením a samostatný balík už neaktualizujte.
Přechod ze starého pluginu VM Dark Admin: nový modul vzhledu převezme jeho nastavení a starý plugin vypne. Pak ho můžete odinstalovat.
Aktualizační klíč zadáte v Systém → Aktualizace → Stránky aktualizací, u položky balíku v poli Aktualizační klíč.
3. Kontrola e-shopu
Stránku otevřete z menu E-shop → Kontrola e-shopu nebo v Komponenty. Je přístupná uživatelům s právem spravovat komponentu. Kontrola jen čte a na webu nic nemění, výsledek odpovídá stavu při načtení stránky.
| Kontrola | Co hledá | Jak to opravit |
|---|---|---|
| Metody s neplatným pluginem | Zveřejněná metoda neukazuje na svůj plugin, takže se neuloží ani nepřepočítá její cena. Typicky po přesunu webu nebo přeinstalaci pluginu. | Otevřete metodu, znovu vyberte plugin a uložte ji. |
| Metody s vypnutým pluginem | Metoda je zveřejněná, ale její plugin je vypnutý. | Zapněte plugin, nebo metodu přestaňte zveřejňovat. |
| Chybějící datové tabulky pluginů | Plugin si do tabulky ukládá údaje k objednávce a ta na webu není. | Otevřete metodu a uložte ji, VirtueMart tabulku založí. |
| Metody v jiné měně | Měna metody není mezi měnami obchodu, cena se může přepočítat jinak, než čekáte. | Upravte měnu v metodě, nebo ji přidejte mezi přijímané měny obchodu. |
| Produkty bez jednotek | Produkt nemá jednotku hmotnosti nebo rozměrů. Na novějším PHP to může rozbít odpověď košíku a nesedí výpočet hmotnosti pro dopravu. | Doplňte jednotky v kartě produktu. |
| Šablona administrace VirtueMart | Šablona vmadmin chybí nebo je Admin šablona vypnutá. | Nainstalujte šablonu z balíčku VirtueMart a zapněte Admin šablonu v konfiguraci. |
| Skupiny bez přístupu k objednávkám | Skupina smí do administrace VirtueMart, ale nemá oprávnění vm.orders. | Pokud má skupina objednávky vyřizovat, povolte jí vm.orders. Jinak je to v pořádku. |
Stav Nelze ověřit znamená, že se kontrolu nepodařilo provést, ne že je vše v pořádku. Důvod najdete v administrator/logs/semavmcheck.php.
Pod kontrolami je přehled modulů balíku se stavem a verzí a odkazem na jejich nastavení.
4. Vzhled administrace
Plugin Systém - SemaVM Admin: vzhled. Kreslí stránky VirtueMart ve vzhledu šablony SemaAdmin nad šablonou vmadmin, takže přežije aktualizaci VirtueMart. Přebírá režim, barevnou sadu i velikost zobrazení ze SemaAdmin. Mění jen stránky VirtueMart.
| Volba | Výchozí | Popis |
|---|---|---|
| Kompaktní řádky | Ano | Menší odsazení v tabulkách a tlačítkách lišty, na obrazovku se vejde víc řádků. |
| Akcentní barva | Azurová | Barva odkazů, aktivních položek a rámečků při zaměření. Platí jen se šablonou Atum, pod SemaAdmin se barva řídí barevnou sadou. |
| Šířka výběru stavu (px) | 170 | Výběr stavu v přehledu objednávek, 120 až 400 px. Zvětšete, když se dlouhé názvy stavů zalamují. |
5. Menu E-shop
Plugin Systém - SemaVM administrace. V levém menu přidá blok E-shop a menu Joomla sbalí pod něj.
Blok obsahuje položky Přehled, Objednávky, Odstoupení od smlouvy, Export faktur a Kontrola e-shopu. Položka se zobrazí jen tehdy, když je příslušná komponenta nainstalovaná a zapnutá a uživatel ji smí spravovat. Přehled, Odstoupení od smlouvy a Export faktur patří k samostatným produktům, bez nich v menu nebudou.
| Volba | Výchozí | Popis |
|---|---|---|
| Menu E-shop | Ano | Blok E-shop na prvním místě, menu Joomla sbalené pod ním. |
| Úvod = Objednávky | Ano | Po přihlášení a po kliknutí na logo se otevře přehled objednávek VirtueMart. Nástěnka Joomla zůstává v menu Joomla. |
| Zjednodušená horní lišta | Ne | V horní liště se vykreslí jen moduly ze seznamu. Ostatní zůstanou publikované, jen se nezobrazí. |
| Moduly horní lišty | mod_user, mod_cachecleaner, mod_sema_notes | Typy modulů oddělené čárkou. |
Na webu s více moduly administračního menu se blok přidá jen do prvního z nich.
6. Změna dopravy a platby
Plugin Systém - Sema VM Změna dopravy a platby. V detailu objednávky přibude výběr Změnit dopravu a Změnit platbu. Změna se projeví až po uložení objednávky.
| Volba | Výchozí | Popis |
|---|---|---|
| Přepočítat cenu | Ano | Spočítá cenu podle nastavení metody, hmotnosti objednávky a země doručení. Při vypnutí zůstane původní cena. |
| Upravit celkovou částku | Ano | O rozdíl v ceně metody upraví i celkovou částku objednávky. |
| Zachovat data původní metody | Ano | Ponechá v databázi záznam původní metody. U platebních bran obsahuje údaje o transakci, proto doporučeno nechat zapnuté. |
| Nabízet i nepublikované metody | Ne | Hodí se pro sezónní nebo dočasně vypnuté dopravce. |
| Zapsat změnu do historie | Ano | Ke změně stavu připojí poznámku o tom, z jaké metody na jakou se přešlo. |
| Ladicí režim | Ne | Zapisuje průběh přepočtu do protokolu. Zapínejte jen při hledání chyby. |
Výdejní místo se z původní objednávky nepřenáší. Pokud ho nová doprava vyžaduje, doplňte ho před předáním zásilky dopravci.
U metody, jejíž plugin chybí nebo je vypnutý, cenu spočítat nejde. Po uložení zůstane původní cena, jinou můžete zadat ručně.
Přidání produktu do objednávky
Tentýž plugin pomáhá v detailu objednávky při úpravě položek (Upravit objednané produkty, Nová položka). Funguje, jen když je zapnutá Kontrola e-shopu, která hledání zajišťuje.
- Název: po napsání aspoň dvou znaků (nebo čísla ID) nabídne produkty podle názvu, SKU i ID. Vybírá se myší nebo šipkami a Enterem.
- SKU: po zadání SKU a Enteru (nebo po opuštění pole) doplní ID produktu. Neexistující SKU ohlásí červeně.
- Po výběru zůstane pole názvu prázdné a produkt je vidět šedě a pod polem. Název, cenu a daň doplní e-shop po uložení, ceny podle skupiny zákazníka objednávky, stejně jako při nákupu.
- Pokud u nové položky ručně zadáte cenu nebo vyberete daň, plugin je nemění.
- U existující položky se po změně produktu doplní jen název, cena zůstane původní.
7. Číslování objednávek
Plugin Systém - SemaVM číslování objednávek, po instalaci vypnutý. Nové objednávky dostanou čísla v čitelné řadě podle formátu. Čísla už existujících objednávek se nemění.
| Volba | Výchozí | Popis |
|---|---|---|
| Formát čísla | YYnnnnn | YYYY = rok, YY = rok dvojmístně, MM = měsíc, nnnn = pořadové číslo (počet n = počet číslic), ostatní znaky zůstanou. |
| Začít od | 1 | Nejnižší pořadové číslo nové řady. Když už jsou v řadě vyšší čísla, pokračuje se za nimi. |
| Číslo faktury = číslo objednávky | Ano | Fakturu dál vytváří VirtueMart ve stavech z konfigurace, plugin jí jen dá číslo objednávky. |
Příklad: formát YY3nnnn dá v roce 2026 číslo 2630080. Řada začne znovu, jakmile se změní datová část, tady s novým rokem.
Před zapnutím si ověřte, že číslování nekoliduje s vaším účetnictvím. Když se číslo nepodaří přidělit, objednávka se nezastaví, VirtueMart použije své vlastní číslo a důvod se zapíše do administrator/logs/semavmordernumber.php.
8. Aktuální faktura po úpravě
Plugin Systém - SemaVM přegenerování faktury, po instalaci vypnutý. Po změně položek nebo hlavičky objednávky v administraci smaže uložené PDF faktury a dodacího listu. VirtueMart je při dalším stažení nebo e-mailu vytvoří znovu z aktuálních dat, se stejným číslem a datem faktury.
Pozor: modul přepisuje už vystavená PDF faktur. Pokud faktury průběžně předáváte do účetnictví, nastavte Pojistku uzavřeného období, aby se neměnily doklady z uzavřeného období:
| Pojistka | Chování |
|---|---|
| Vypnuto (výchozí) | PDF se vytvoří znovu vždy. |
| Chránit faktury z dřívějších měsíců | Faktuře z dřívějšího měsíce zůstane původní PDF. |
| Chránit faktury před zadaným datem | Faktuře vystavené před tímto dnem zůstane původní PDF. Dokud datum není vyplněné, jsou chráněné všechny faktury. |
U chráněné faktury dostane správce upozornění a rozdíl je potřeba vyřešit opravným dokladem. Dodací list se vytvoří znovu vždy.
9. Oprava + a % v adresách
Plugin System - SemaVM Userfields, bez nastavení. VirtueMart při ukládání adresy ztrácí znaky + a %: telefon +420… se uloží s mezerou a e-mail s + neprojde. Plugin to opravuje.
Sám si ověřuje, jestli se chyba na webu projevuje. Až ji opraví VirtueMart, plugin se vyřadí a zapíše to do administrator/logs/, aby se znaky nekódovaly dvakrát. Soubory VirtueMart nemění.
10. Kompatibilita
| Prostředí | Stav |
|---|---|
| Joomla 5.4 + VirtueMart 4.8.2, PHP 8.2 | Ověřeno, podporováno |
| Joomla 5.4 + VirtueMart 4.6.4, PHP 8.1, 8.2, 8.3 a 8.5 | Ověřeno, podporováno |
| Joomla 5.4 + VirtueMart 4.9.3 (beta), PHP 8.2 | Administrace balíku funguje, ale beta VirtueMart má vlastní chyby. Na ostrý e-shop ji nedoporučujeme. |
| Joomla 6 | Zkoušeno, nepodporováno. Oficiální podporu Joomla 6 ve VirtueMart zatím nemáme ověřenou. |
| Joomla 4 | Nepodporováno, instalace se zastaví. |
Verze VirtueMart starší než 4.6.4 zatím ověřené nejsou, stejně jako kombinace PHP mimo tabulku, například PHP 8.4. PHP 8.1 už jeho autoři nepodporují, doporučujeme přejít na novější verzi. Faktury v PDF potřebují knihovnu TCPDF z balíku VirtueMart. Spusťte po instalaci Kontrolu e-shopu a projděte přehled i detail objednávky.
11. Řešení problémů
Vzhled se neprojevil. Spusťte Kontrolu e-shopu. Nejčastěji je v konfiguraci VirtueMart vypnutá Admin šablona.
Vzhled VirtueMart nesedí se zbytkem administrace. Výchozí šablona administrace je jiná než SemaAdmin. Přepněte ji v Systém → Šablony administrace.
Po přechodu na objednávky zmizí levé menu. VirtueMart ho na svých stránkách sám zavírá. Rozbalte ho přepínačem menu Joomla.
Uživatel vidí položku Objednávky, ale stránka ho odmítne. Skupina nemá oprávnění vm.orders. Kontrola e-shopu takové skupiny vypíše.
Položka v menu E-shop chybí. Komponenta není nainstalovaná nebo zapnutá, případně ji uživatel nesmí spravovat.
Faktura se po úpravě nezměnila. Zkontrolujte, že je modul zapnutý a že fakturu nechrání pojistka uzavřeného období.
Kontrola hlásí Nelze ověřit. Důvod je v administrator/logs/semavmcheck.php. Pokud mu nerozumíte, pošlete nám ho na
Jak to vypadá v praxi