Jazykové balíky pre Magento Open Source: inštalácia

Jazykový balík Torevo prekladá systémové rozhranie Magento Open Source: storefront, pokladňu, zákaznícky účet, systémové e-maily a administráciu. Ide o Composer balík typu magento2-language. Nevytvára účet Torevo ani nepripája obchod k externej službe.

V katalógu Magento jazykov nájdete locale, konkrétne testované verzie a odkaz na nákup aj PDF návod každého balíka. Nákup prebieha cez Adobe Commerce Marketplace. Návod konkrétneho zakúpeného vydania má prednosť pred všeobecným príkladom na tejto stránke.

Kompatibilita a rozsah

Pri kontrole 30. septembra 2026 mali publikované balíky verziu 1.0.0:

Balíky	Testované Magento Open Source
Arabčina (ar_SA)	2.4.9
Ostatné jazyky v katalógu	2.4.7-p10, 2.4.8-p5, 2.4.9

Aktuálny rozsah vždy potvrďte na konkrétnej Marketplace stránke. Podľa systémových požiadaviek Adobe používa Magento 2.4.9 PHP 8.5, vetva 2.4.8 PHP 8.3 alebo 8.4 a vetva 2.4.7 PHP 8.2 alebo 8.3.

Používajte aktuálne bezpečnostné opravy zvolenej vetvy. Samotné číslo 2.4.9 nepotvrdzuje ich aplikovanie. Adobe pri septembrovej bezpečnostnej aktualizácii vyžaduje predchádzajúce mesačné opravy a samostatný hotfix pre CVE-2026-75650. Jazykový balík tieto opravy neinštaluje. Stav opráv overuje správca obchodu.

Balík automaticky neprekladá produkty, kategórie, CMS stránky, bloky ani vlastný obsah e-mailov. Texty tém a doplnkov môžu mať vlastné slovníky. Adobe Commerce-only moduly, Hyvä, PWA a headless storefronty potrebujú samostatné overenie. Arabčina a hebrejčina samy nepridávajú RTL rozloženie ani fonty.

Pred inštaláciou

Pripravte si zálohu súborov aj databázy, testovacie prostredie, presnú verziu Magento a PHP, prístup k Composer a oprávnenie spúšťať Magento CLI ako vlastník súborov aplikácie. Overte názov balíka a locale v zakúpenom PDF.

Použite Marketplace účet, ktorým bol balík zakúpený, a jeho prístup ku repo.magento.com. Verejný a súkromný Composer kľúč patria do bezpečnej konfigurácie prihlasovania, nie do verejného repozitára, screenshotu alebo správy podpore. Adobe opisuje inštaláciu balíkov cez Composer.

Príkazy nižšie spúšťajte po jednom z koreňového adresára Magento. Príklad používa poľský balík torevo/language-pl-pl, locale pl_PL a store-view code default. Pre iný jazyk nahraďte názov balíka aj locale. Code store view nie je locale. Prevezmite ho z výstupu store:list.

1. Nainštalujte balík a zistite režim

composer require torevo/language-pl-pl:1.0.0
php bin/magento setup:upgrade
php bin/magento deploy:mode:show
php bin/magento store:list

Composer musí skončiť bez chyby a nainštalovať zakúpený balík. Ak vypíše chybu autentifikácie alebo nenájde balík, overte Marketplace účet, prístupové kľúče, repozitár a názov komponentu v nákupe.

Na stagingu najprv overte celý postup. Produkčné nasadenie vykonajte v dohodnutom servisnom okne cez existujúci proces nasadenia. Údržbový režim zapnite pred zmenou závislostí. Jazykový balík nie je modul, preto preň nepoužívajte module:enable.

2. Nastavte jazyk store view

Režim default alebo developer

V Admin otvorte Stores → Settings → Configuration. V Scope vyberte požadovaný store view. V General → General → Locale Options zrušte Use Website pri poli Locale, vyberte locale a uložte nastavenie.

php bin/magento setup:static-content:deploy -f en_US pl_PL
php bin/magento cache:flush

Ak sú Locale a Use Website neaktívne, overte režim aplikácie a prípadné uzamknutie konfigurácie. Pri produkčnom režime pokračujte cez CLI.

Produkčný režim

Produkčný režim môže zobraziť Locale a Use Website ako neaktívne ovládacie prvky. Použite CLI podľa návodu balíka. Obchod kvôli zmene jazyka neprepínajte do developer režimu.

php bin/magento maintenance:enable
php bin/magento config:set --scope=stores --scope-code=default general/locale/code pl_PL
php bin/magento setup:static-content:deploy -f en_US pl_PL
php bin/magento cache:flush
php bin/magento config:show --scope=stores --scope-code=default general/locale/code

Posledný príkaz musí vypísať pl_PL. Príklad generuje statické súbory pre angličtinu a poľštinu vrátane Admin assets. Pri viacerých jazykoch zachovajte v nasadení všetky používané locale. Na viacerých uzloch používajte rovnaký release artefakt a konfiguráciu.

Ak je konfigurácia spravovaná cez config.php, env.php alebo cloudový deployment, zosúlaďte zmenu s týmto procesom. Neprepisujte existujúce uzamknutie bez jeho správcu. Adobe dokumentuje scope a config:set.

Po úspešnom nasadení a kontrole obnovte bežnú prevádzku:

php bin/magento maintenance:disable

Pri chybe príkazu najprv vyriešte jej príčinu alebo obnovte predchádzajúci release. Neotvárajte obchod s neúplným nasadením.

3. Nastavte jazyk účtu administrátora

Storefront a Admin používajú samostatné nastavenia. Po nasadení statických súborov pre zvolené locale otvorí administrátor Account Setting, zmení Interface Locale a uloží ho po potvrdení vlastným heslom. Heslo zadáva iba do Magento, nikdy podpore Torevo.

4. Overte výsledok

V novej relácii prehliadača skontrolujte:

• navigáciu, kategóriu, vyhľadávanie a produkt,
• košík, dopravu, platbu, validáciu a potvrdenie testovacej objednávky,
• registráciu, prihlásenie, adresy a zákaznícky účet,
• systémové e-maily objednávky, faktúry a zásielky,
• administráciu, JavaScript texty, cache a vlastné doplnky.

Neúplný preklad vo vlastnej téme môže pochádzať z jej slovníka, inline prekladu alebo z frázy doplnku. Neupravujte preto súbory v vendor/. Vlastné úpravy robte cez podporovaný slovník témy alebo modulu.

Aktualizácia a odinštalovanie

Pred aktualizáciou overte nové vydanie na Marketplace a zálohu. Na stagingu použite composer update torevo/language-pl-pl, skontrolujte zmeny v lock súbore a zopakujte setup:upgrade, nasadenie statického obsahu a kontrolu. Do produkcie preneste overený release vlastným deployment procesom.

Pred odstránením prepnite dotknuté store views aj Admin účty na locale, ktoré zostane nainštalované. Potom na stagingu spustite:

composer remove torevo/language-pl-pl
php bin/magento setup:upgrade
php bin/magento cache:flush

Znovu vygenerujte statický obsah pre zostávajúce locale a otestujte obchod. Odstránenie slovníka nemaže produktový alebo CMS obsah obchodníka.

Riešenie problémov a podpora

Situácia	Čo overiť
Locale nemožno zmeniť v Admin	režim aplikácie, uzamknutie konfigurácie a produkčný CLI postup
Obchod zostáva v angličtine	správny store-view code, config:show, nasadenie presného locale a cache
Len niektoré texty nie sú preložené	slovník témy alebo doplnku, inline preklad a vlastný obsah
Arabské alebo hebrejské texty majú nesprávne rozloženie	RTL a fonty v konkrétnej téme. Samotný slovník ich nenastavuje
Composer nevie stiahnuť balík	účet nákupu, autentifikáciu, repozitár a presný názov komponentu

Kontaktujte support@torevo.tech. Uveďte názov a verziu balíka, locale, Magento a PHP verziu, režim nasadenia, store-view code a anonymizované znenie chyby. Neposielajte Composer kľúče, heslá, auth.json, env.php ani údaje zákazníkov.