Semakin
Zákazník

Uživatelská příručka

SemaAdmin for VirtueMart

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žadavekVerze
Joomla5.3 a novější 5.x
VirtueMart4.6.4 a 4.8.2 (ověřeno), další viz Kompatibilita
Šablona VirtueMartvmadmin se zapnutou volbou Admin šablona
Režim administracesvětlý, tmavý nebo podle systému
Aktuální verze1.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:

ModulPo instalaci
Šablona administrace SemaAdminnainstalovaná, výchozí jen při první instalaci (viz níž)
Vzhled administracezapnutý
Menu E-shopzapnutý
Změna dopravy a platbyzapnutý
Číslování objednávekvypnutý
Aktuální faktura po úpravěvypnutý
Oprava + a % v adresáchzapnutý
Kontrola e-shopuzapnutá

Čí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.

KontrolaCo hledáJak to opravit
Metody s neplatným pluginemZveř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 pluginemMetoda 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 jednotekProdukt 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ámSkupina 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.

VolbaVýchozíPopis
Kompaktní řádkyAnoMenší odsazení v tabulkách a tlačítkách lišty, na obrazovku se vejde víc řádků.
Akcentní barvaAzurová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)170Výběr stavu v přehledu objednávek, 120 až 400 px. Zvětšete, když se dlouhé názvy stavů zalamují.

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.

VolbaVýchozíPopis
Menu E-shopAnoBlok E-shop na prvním místě, menu Joomla sbalené pod ním.
Úvod = ObjednávkyAnoPo 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štaNeV horní liště se vykreslí jen moduly ze seznamu. Ostatní zůstanou publikované, jen se nezobrazí.
Moduly horní lištymod_user, mod_cachecleaner, mod_sema_notesTypy 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.

VolbaVýchozíPopis
Přepočítat cenuAnoSpočítá cenu podle nastavení metody, hmotnosti objednávky a země doručení. Při vypnutí zůstane původní cena.
Upravit celkovou částkuAnoO rozdíl v ceně metody upraví i celkovou částku objednávky.
Zachovat data původní metodyAnoPonechá 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é metodyNeHodí se pro sezónní nebo dočasně vypnuté dopravce.
Zapsat změnu do historieAnoKe změně stavu připojí poznámku o tom, z jaké metody na jakou se přešlo.
Ladicí režimNeZapisuje 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í.

VolbaVýchozíPopis
Formát číslaYYnnnnnYYYY = 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 od1Nejnižší pořadové číslo nové řady. Když už jsou v řadě vyšší čísla, pokračuje se za nimi.
Číslo faktury = číslo objednávkyAnoFakturu 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í:

PojistkaChová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 datemFaktuř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.2Ověřeno, podporováno
Joomla 5.4 + VirtueMart 4.6.4, PHP 8.1, 8.2, 8.3 a 8.5Ověřeno, podporováno
Joomla 5.4 + VirtueMart 4.9.3 (beta), PHP 8.2Administrace balíku funguje, ale beta VirtueMart má vlastní chyby. Na ostrý e-shop ji nedoporučujeme.
Joomla 6Zkoušeno, nepodporováno. Oficiální podporu Joomla 6 ve VirtueMart zatím nemáme ověřenou.
Joomla 4Nepodporová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 Tato e-mailová adresa je chráněna před spamboty. Pro její zobrazení musíte mít povolen Javascript..

Jak to vypadá v praxi

Změna dopravy a platby v detailu objednávky
Zákazník si to rozmyslel? Dopravu i platbu změníte přímo v objednávce a cena se přepočítá.
Našeptávač produktu při přidání položky
Novou položku najdete podle názvu nebo SKU, cenu i daň doplní e-shop po uložení.
Kontrola e-shopu
Kontrola e-shopu upozorní na chybné nastavení dřív, než ho zjistí zákazník. Jen čte, nic nemění.
Nastavení číslování objednávek
Čísla objednávek podle vaší masky, třeba rok a pořadí, místo náhodných znaků.
Přehled objednávek v tmavém vzhledu
Přehled objednávek v tmavém vzhledu, který přežije aktualizaci VirtueMart. Jména a adresy jsou smyšlené.

Máte zájem o spolupráci?

Ozvěte se nám a probereme Váš projekt. Rádi Vám poradíme s výběrem řešení.