Inštalácia jazykového balíka Torevo pre OpenCart 4 a OpenCart Cloud
Kompletný postup výberu správneho balíka, inštalácie, aktivácie, nastavenia a overenia ľubovoľného jazykového balíka Torevo pre OpenCart 4.
Na tejto stránke
Tento návod platí pre všetky jazykové balíky Torevo pre OpenCart 4. Snímky používajú nemčinu na OpenCart 4.1.0.3, ale rovnaké kroky použite aj pre slovenčinu, češtinu, poľštinu, francúzštinu, španielčinu, taliančinu, holandčinu a ďalšie jazyky z Marketplace profilu Torevo.
Každý platený jazykový balík Torevo obsahuje preložené rozhranie administrácie a storefrontu, checkout, zákaznícky účet, texty systémových e-mailov a jazykové súbory pribalených základných rozšírení. Bežné stiahnutie poskytuje samostatné inštalátory pre presné verzie OpenCart 4 uvedené pri produkte; podporované Cloud verzie dostávajú priamy Cloud inštalátor. Súčasťou produktu sú aj publikované aktualizácie kompatibility a prekladu, technická pomoc s inštaláciou a tento obrazový návod.
OpenCart 4 najprv nasadí súbory v Rozšírenia → Inštalátor. Jazyk sa zaregistruje až po samostatnej inštalácii modulu jazykového balíka v Rozšírenia → Rozšírenia → Moduly. Balík zobrazený ako nainštalovaný v Installeri ešte neznamená, že je jazyk aktívny.
Pred inštaláciou
Pripravte si:
- administrátorský účet s oprávnením spravovať inštalátor, rozšírenia, jazyky a nastavenia obchodu,
- presnú štvordielnu verziu OpenCart, napríklad
4.1.0.3, - zálohu súborov a databázy alebo snapshot testovacieho Cloud obchodu,
- jazykový balík zakúpený cez OpenCart Marketplace,
- testovací produkt v košíku, aby ste po aktivácii mohli skontrolovať aj checkout.
OpenCart uvádza, že inštalovateľný balík má končiť na .ocmod.zip, nahráva sa cez Extensions → Installer a modul sa následne inštaluje cez Extensions → Extensions → Modules. Pozrite si aj oficiálny postup OpenCart pre rozšírenia.
Vyberte správny súbor
| Typ obchodu | Súbor z Marketplace | Čo nahrať do OpenCart |
|---|---|---|
| Bežný OpenCart 4 | vonkajší ZIP so všetkými podporovanými verziami | ZIP rozbaľte v počítači, v VERSION-MAP.md nájdite presnú verziu a nahrajte iba zodpovedajúci vnútorný .ocmod.zip |
| OpenCart Cloud | priamy Cloud balík pre jednu presnú verziu | nahrajte dodaný súbor ...cloud_opencart_4_1_0_3.ocmod.zip priamo; nerozbaľujte ho a nepremenúvajte |
Cloud balík je zámerne viazaný na jednu presnú verziu OpenCart. Názov súboru, kód balíka, namespace kontroléra a interné cesty musia zostať zhodné. Pri zmene verzie Cloud obchodu použite nový balík označený pre túto verziu.
Pri bežnom Marketplace stiahnutí nenahrávajte do OpenCart ZIP obsahujúci priečinok installers. Najprv ho rozbaľte lokálne. Pri Cloud stiahnutí je naopak dodaný súbor už priamy inštalátor a ďalej ho nerozbaľujte.
1. Nahrajte presný inštalátor
V administrácii otvorte Rozšírenia → Inštalátor, stlačte tlačidlo na nahratie a vyberte správny .ocmod.zip. Ukážkový Cloud súbor pre nemčinu sa volá torevo_german_language_cloud_opencart_4_1_0_3.ocmod.zip.
Snímky administrácie v tomto návode sú zámerne vytvorené s anglickým rozhraním OpenCart, aby názvy menu presne zodpovedali inštalačným krokom. Storefront a checkout zostávajú v nemčine ako dôkaz nainštalovaného prekladu.
2. Nainštalujte nahraný balík
V zozname Installer kliknite pri nahranom balíku na Nainštalovať. Tento krok skopíruje súbory do priestoru rozšírenia. Po úspechu zostane balík v zozname označený ako nainštalovaný.
3. Aktivujte registračný modul
Otvorte Rozšírenia → Rozšírenia, v rozbaľovacom poli vyberte Moduly a nájdite položku s názvom zakúpeného jazyka, napríklad German Language Pack. Kliknite na Nainštalovať iba raz.
4. Skontrolujte zaregistrovaný jazyk
Otvorte Systém → Lokalizácia → Jazyky. V zozname musí byť nový jazyk povolený a musí mať správny kód. V ukážke je to German s kódom de-de; slovenský balík používa sk.
Otvorte úpravu jazyka a overte názov, kód, locale, rozšírenie, stav a poradie. Pri balíku Torevo nemeníte pole rozšírenia ani adresárový kód.
5. Nastavte jazyk obchodu a administrácie
V Systém → Nastavenia otvorte svoj obchod a kartu Miestne. Vyberte nový jazyk v poli Jazyk pre storefront a podľa potreby aj v poli Jazyk administrácie. OpenCart môže po pridaní jazyka vyžadovať lokalizované povinné polia, napríklad názov obchodu alebo Meta názov. Doplňte ich pred uložením.
6. Overte celý nákupný tok
Po uložení obnovte storefront v novom okne. Skontrolujte domovskú stránku, kategóriu, produkt, košík, checkout, zákaznícky účet a systémové e-maily. Text vlastných produktov, kategórií a informačných stránok sa neprekladá jazykovým balíkom automaticky; dopĺňa ho správca obchodu.
OpenCart Cloud
Rovnaká dvojstupňová aktivácia platí aj v OpenCart Cloud:
- z Marketplace stiahnite priamy Cloud
.ocmod.zipurčený pre presnú verziu obchodu, - súbor bez rozbalenia nahrajte a nainštalujte v Installeri,
- v časti Moduly nainštalujte registračný modul jazykového balíka,
- jazyk overte v Lokalizácii a nastavte pre storefront alebo administráciu,
- otestujte storefront aj checkout.
Cloud pripravenosť je uvedená pri konkrétnom Marketplace stiahnutí. Bežný viacverziový ZIP zostáva určený pre vlastný hosting; Cloud riadok používa samostatný priamy inštalátor iba pre uvedenú verziu. Nemecký a slovenský postup bol overený na OpenCart 4.1.0.3 vrátane Installera, registračného modulu, administrácie, storefrontu a checkoutu.
Aktualizácia
Pred aktualizáciou urobte zálohu a dočasne prepnite predvolený jazyk storefrontu aj administrácie na iný jazyk. Potom:
- odinštalujte registračný modul a pôvodný balík,
- nainštalujte nový balík určený pre presnú verziu OpenCart,
- znova nainštalujte registračný modul,
- overte existujúci záznam jazyka a nové súbory,
- vráťte predvolené jazyky a zopakujte funkčný test.
Balík .ocmod.zip svojvoľne nepremenúvajte. OpenCart 4 používa jeho základný názov ako kód rozšírenia.
Riešenie problémov
| Stav | Najpravdepodobnejšia príčina | Riešenie |
|---|---|---|
| balík je v Installeri, ale jazyk chýba | registračný modul nebol nainštalovaný | Rozšírenia → Rozšírenia → Moduly → nainštalovať príslušný Language Pack |
| OpenCart odmietne ZIP | bol nahraný vonkajší viacverziový ZIP alebo nesprávna verzia | rozbaľte zákaznícky ZIP a vyberte vnútorný súbor podľa VERSION-MAP.md; pri Cloud použite priamy Cloud súbor |
| nastavenia sa nedajú uložiť | chýba povinná hodnota nového jazyka | doplňte všetky jazykové karty, najmä názov a Meta názov |
| administrácia sa prepne do neznámeho jazyka | bol zmenený aj Jazyk administrácie | v nastaveniach obchodu vráťte známy jazyk administrácie |
| časť obsahu zostane v pôvodnom jazyku | ide o vlastný katalógový obsah | doplňte preklady produktov, kategórií, atribútov a informačných stránok |
Ak problém zostane, pošlite podpore názov balíka, presnú verziu OpenCart, krok, pri ktorom nastala chyba, a text chyby. Neposielajte heslá, tokeny, databázu ani zákaznícke údaje.