Документація

Мови

Вступ#

Розділ Мови дає змогу керувати мовами, доступними у вашому магазині ocStore. Можна додати кілька мов для покупців з інших країн, задати локаль для правильного форматування дат і чисел, а також вмикати й вимикати мови за потреби.

Доступ до керування мовами#

Крок 1. Відкрийте розділ «Мови»#

Увійдіть в адмінку й перейдіть у Система → Локалізація → Мови.

Крок 2. Список мов#

Ви побачите список усіх налаштованих мов із назвою, кодом і порядком сортування.

Крок 3. Керування мовами#

Натисніть Додати, щоб створити нову мову, або Редагувати поруч із наявною мовою, щоб змінити її налаштування.

Огляд інтерфейсу#

форма редагування мови в розділі Система → Локалізація → Мови

Поля налаштування мови#

Основна інформація про мову

Основні параметри

  • Назва мови — (обов’язкове) назва мови, що показується в перемикачі мов (наприклад, «Українська», «English», «Polski»), від 3 до 32 символів.
  • Код — (обов’язкове) код мови, що збігається з назвою теки мовного пакета (наприклад, uk-ua, en-gb). Не змінюйте код мови, яка використовується за замовчуванням.
  • Кодування — (обов’язкове) рядок локалі для форматування дат і чисел, можна кілька через кому (наприклад, uk_UA.UTF-8,uk_UA,ukrainian).
  • Статус — показувати мову в перемикачі мов на вітрині.
  • Порядок сортування — порядок мови в перемикачі.

Окремого поля для зображення прапорця у формі немає: прапорець береться з файлу catalog/language/<код>/<код>.png мовного пакета.

Налаштування локалі

Регіональне форматування

  • Приклади локалей:
    • українська: uk_UA.UTF-8,uk_UA,ukrainian
    • англійська (Велика Британія): en_GB.UTF-8,en_GB,en-gb,english
    • англійська (США): en_US.UTF-8,en_US
    • польська: pl_PL.UTF-8,pl_PL,polish
  • Кілька локалей — указуйте кілька значень через кому: буде використано першу, доступну на сервері.
  • UTF-8 — завжди використовуйте локалі з UTF-8 для коректного кодування символів.
Інформація

Чому важлива локаль. Локаль впливає на формати дат і чисел. Указуйте правильну локаль для кожної мови, щоб покупці бачили звичне для себе форматування.

Типові завдання#

Додавання нової мови#

Мова в ocStore складається з двох частин: мовного пакета (файли перекладу) і запису в розділі «Мови».

  1. Встановіть мовний пакет: файли перекладу мають лежати в теках catalog/language/<код>/ і admin/language/<код>/ (наприклад, catalog/language/pl-pl/). Пакети зазвичай завантажують через Доповнення → Установка доповнень або копіюють на сервер вручну.
  2. Перейдіть у Система → Локалізація → Мови і натисніть Додати.
  3. Введіть Назва мови (наприклад, «Polski»).
  4. Вкажіть Код — точно як назва теки пакета (наприклад, pl-pl).
  5. Вкажіть Кодування для потрібного регіону (наприклад, pl_PL.UTF-8,pl_PL,polish).
  6. Встановіть Статус — «Включено».
  7. За потреби змініть Порядок сортування.
  8. Натисніть Зберегти. Нова мова з’явиться в перемикачі мов магазину.
Попередження

Під час додавання мови ocStore копіює всі описи (товарів, категорій, статей, статусів тощо) з мови за замовчуванням. Після цього перекладіть їх новою мовою — інакше покупці бачитимуть текст мовою оригіналу.

Мови з письмом справа наліво (RTL)#

Для мов, які пишуться справа наліво (арабська, іврит тощо):

  1. Встановіть мовний пакет і додайте мову з правильним кодом і локаллю.
  2. Переконайтеся, що мовний пакет задає напрям тексту (direction = rtl у головному файлі мови).
  3. Використовуйте тему оформлення з підтримкою RTL або додайте RTL-стилі.
  4. Перевірте вирівнювання тексту та макет вітрини.

Вимкнення мови без видалення#

Щоб тимчасово прибрати мову з вітрини:

  1. Відредагуйте мову.
  2. Встановіть Статус — «Виключено».
  3. Натисніть Зберегти. Мова зникне з перемикача мов, але всі переклади залишаться.

Найкращі практики#

Стратегія керування мовами

Планування багатомовності

  • Повний переклад — додавайте мову, коли маєте переклади всіх важливих елементів (категорій, товарів, статей).
  • Точна локаль — з’ясуйте правильну локаль для кожної пари мова/регіон.
  • Мовні пакети — використовуйте готові повні пакети для ocStore 3 / OpenCart 3.
  • Мова за замовчуванням — завжди залишайте увімкненою принаймні одну мову.
Технічні налаштування

Інтеграція із системою

  • UTF-8 скрізь — база даних, PHP і вебсервер мають працювати в UTF-8.
  • Наявність локалі — перевірте, що локаль установлено на сервері (locale -a у Linux).
  • Файли мови — власний переклад означає створення файлів у catalog/language/<код>/ та admin/language/<код>/; окремі фрази можна змінити через Дизайн → Редактор перекладу.
  • Кеш — після змін очистіть кеш (кнопка налаштувань розробника на Панелі стану) і оновіть модифікатори.
Попередження

Видалення мови. Не видаляйте мову, яка є мовою магазину за замовчуванням, мовою адмінки або використовується в наявних замовленнях — ocStore і не дасть цього зробити. Замість видалення вимкніть мову.

Усунення проблем#

Мова не з’являється в перемикачі на вітрині

Видимість

  • Статус — переконайтеся, що мову увімкнено.
  • Кількість мов — стандартна тема показує перемикач лише тоді, коли увімкнено більше ніж одну мову.
  • Тема — перевірте, чи ваша тема виводить перемикач мов.
  • Кеш — очистіть кеш ocStore і браузера.
Неправильне форматування дат і чисел

Налаштування локалі

  • Формат — перевірте рядок у полі Кодування (наприклад, uk_UA.UTF-8).
  • Підтримка сервером — перевірте наявність локалі командою locale -a.
  • Кілька локалей — спробуйте простіше значення або кілька запасних через кому.
  • Мовний пакет — формати дат задаються також у файлі мови (date_format_short, date_format_long тощо).
Не вдається видалити мову

Залежності

  • Мова за замовчуванням — мову вибрано в полі Мова на вкладці Локалізація в Система → Налаштування → Редагувати.
  • Мова адмінки — мову вибрано в полі Мова адмінки на тій самій вкладці.
  • Інші магазини — мова використовується в налаштуваннях інших магазинів мультимагазину.
  • Замовлення — мову використано в наявних замовленнях.
  • Рішення: призначте магазинам іншу мову; якщо мова є в замовленнях — просто вимкніть її.
Спецсимволи відображаються неправильно

Кодування

  • База даних — таблиці мають використовувати кодування utf8mb4 (або utf8).
  • Тема — у шапці має бути <meta charset="UTF-8">.
  • Файли мови — мають бути збережені в UTF-8 без BOM.
  • PHP — default_charset має бути UTF-8.

«Мови — це більше, ніж переклад, це місток між культурами. Кожна нова мова відкриває ваш магазин для нової спільноти, а правильна локаль допомагає покупцям почуватися як удома.»

Сторінку перекладено й адаптовано для ocStore з офіційної документації OpenCart. Ліцензія — GNU GPL v3.
Оновлено: 23.10.2026
На цій сторінці