Формати адрес

Вступ#

Формат адреси визначає, як адреси покупців відображаються в магазині: в особистому кабінеті, під час оформлення замовлення, у замовленнях, рахунках, листах і списках доставки. Шаблон складається із заповнювачів для частин адреси (ім'я, вулиця, місто тощо), тож адреси кожної країни можна показувати за місцевими правилами. Однакове форматування робить адреси зрозумілішими для покупців, працівників і служб доставки.

Інформація

Відмінність від OpenCart 4. В ocStore 3 немає окремого розділу «Формати адрес» зі списком шаблонів. Формат адреси задається безпосередньо у формі кожної країни — полем Формат адреси в розділі Система → Локалізація → Країни.

Як відкрити налаштування формату адреси#

Крок 1. Перейдіть до країн#

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

Крок 2. Знайдіть країну#

У списку країн показано назву країни та коди ISO (2) і ISO (3). Знайдіть потрібну країну (список упорядковано за назвою, є посторінкова навігація).

Крок 3. Відкрийте форму країни#

Натисніть Редагувати біля країни. Формат адреси задається в полі Формат адреси.

Огляд поля «Формат адреси»#

форма редагування країни з полем «Формат адреси» та підказкою із заповнювачами

Параметри#

Поля форми країни, пов'язані з адресою
  • Назва країни: (обов'язково) від 3 до 128 символів.
  • Формат адреси: шаблон із заповнювачами частин адреси. Кожен новий рядок у полі стає новим рядком у відображеній адресі. Якщо поле порожнє, використовується стандартний формат.
  • Індекс обов'язковий: чи має покупець обов'язково вказувати поштовий індекс для адрес цієї країни.
Доступні заповнювачі

Змінні частин адреси (повний перелік видно в підказці до поля Формат адреси):

  • {firstname} — ім'я
  • {lastname} — прізвище
  • {company} — компанія (необов'язково)
  • {address_1} — основний рядок адреси (вулиця та номер будинку)
  • {address_2} — додатковий рядок адреси (квартира, офіс тощо)
  • {city} — місто чи населений пункт
  • {postcode} — поштовий індекс
  • {zone} — назва регіону (області)
  • {zone_code} — код регіону
  • {country} — назва країни

Приклад (формат США):

{firstname} {lastname}
{company}
{address_1}
{address_2}
{city}, {zone} {postcode}
{country}

Приклад (в один рядок, європейський стиль):

{firstname} {lastname}, {address_1}, {postcode} {city}, {country}

Приклад (Україна):

{lastname} {firstname}
{company}
{address_1}
{address_2}
{city}
{zone}
{postcode}
{country}

Стандартний формат (застосовується, якщо поле країни порожнє):

{firstname} {lastname}
{company}
{address_1}
{address_2}
{city} {postcode}
{zone}
{country}
Інформація

Використання заповнювачів: заповнювачі пишуться точно як у переліку, у фігурних дужках. Під час показу адреси система підставляє замість них дані покупця. Між заповнювачами можна додавати текст і розділові знаки, а нові рядки створюються звичайним переходом на новий рядок у полі (клавіша Enter). Порожні рядки (наприклад, якщо компанію не вказано) автоматично прибираються.

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

Налаштування формату адреси для країни#

Щоб задати власний формат відображення адрес:

  1. Перейдіть до Система → Локалізація → Країни й натисніть Редагувати біля потрібної країни.
  2. У полі Формат адреси складіть шаблон із заповнювачів.
  3. Розташуйте заповнювачі в потрібному порядку, кожен рядок адреси — з нового рядка.
  4. Додайте потрібні розділові знаки (коми, пробіли, дефіси) між заповнювачами.
  5. Натисніть Зберегти.
  6. Перевірте результат: створіть або відкрийте адресу покупця з цією країною та подивіться, як вона показується.

Однаковий формат для кількох країн#

Окремих шаблонів, які можна призначати кільком країнам, в ocStore 3 немає. Щоб використати однаковий формат:

  1. Налаштуйте формат для однієї країни й скопіюйте вміст поля Формат адреси.
  2. Вставте його в поле Формат адреси інших країн.
  3. Збережіть кожну країну.

Формат за замовчуванням#

Окремого параметра для формату за замовчуванням немає. Для країн з порожнім полем Формат адреси використовується стандартний формат, вбудований у код (див. приклад вище). Щоб змінити вигляд адрес для таких країн, заповніть поле Формат адреси у відповідних країнах.

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

Рекомендації щодо шаблонів

Ефективне форматування

  • Вивчіть місцеві стандарти: з'ясуйте, як прийнято записувати адреси в країнах, з якими ви працюєте.
  • Послідовні переноси рядків: однаково розбивайте адресу на рядки для зручності читання в друкованих документах.
  • Необов'язкові частини: {company} і {address_2} можна залишати в шаблоні — порожні рядки приберуться автоматично.
  • Перевірка на реальних даних: перевіряйте формати на реалістичних прикладах адрес.
  • Мовні особливості: переконайтеся, що формат коректно працює з літерами з діакритикою та, якщо потрібно, з мовами письма справа наліво.
Стратегія керування форматами

Організаційний підхід

  • Типові шаблони: підготуйте кілька загальних варіантів (наприклад, «Північна Америка», «Європа», «Азія») і використовуйте їх для кількох країн.
  • Особливі формати: створюйте унікальний формат лише тоді, коли типовий не відповідає місцевим вимогам.
  • Облік змін: фіксуйте зміни форматів, особливо якщо вони впливають на друковані матеріали чи юридичні документи.
  • Документування: ведіть список, яка країна який формат використовує.
Попередження

Про видалення: очищення поля Формат адреси повертає для країни стандартний формат. Саму країну не можна видалити, якщо вона є країною за замовчуванням магазину або використовується в магазинах, адресах, партнерами, зонах чи географічних зонах — перевірте повідомлення про помилку.

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

Не вдається видалити країну

Залежності

  • Країна за замовчуванням: країна вибрана в налаштуваннях магазину.
  • Використання: країна вказана в адресах покупців, у партнерів, у зонах чи географічних зонах. Кількість указано в повідомленні про помилку.
  • Рішення: зазвичай країну краще не видаляти, а вимкнути (поле Статус).
Заповнювачі адреси відображаються неправильно

Помилки в шаблоні

  • Описки: перевірте написання заповнювачів (наприклад, {firstname}, а не {first_name}).
  • Дужки: кожен заповнювач має відкриваючу { і закриваючу } дужки.
  • Переноси рядків: використовуйте звичайні переходи на новий рядок у полі, а не символи \n.
  • Спецсимволи: перевірте адреси з особливими символами чи літерами з діакритикою.
Адреса показується за стандартним форматом

Формат не застосовується

  • Поле порожнє: перевірте, що формат збережено саме для потрібної країни.
  • Інша країна: переконайтеся, що в адресі покупця вибрано ту країну, яку ви редагували.
  • Старі замовлення: у замовленні формат адреси зберігається на момент оформлення, тому зміни стосуються лише нових замовлень.
  • Кеш: очистіть кеш (і кеш CDN, якщо він використовується), щоб побачити зміни.
Різне форматування в замовленнях з різних країн

Узгодженість

  • Формати країн: перевірте, що кожна країна має правильний формат адреси.
  • Стандартний формат: переконайтеся, що стандартний формат прийнятний для країн без власного шаблону.
  • Тестування: оформіть тестові замовлення з адресами з різних країн, щоб виявити розбіжності.
  • Регіональні особливості: деякі країни мають регіональні відмінності, які не враховує загальнонаціональний формат.

«Адреса — це більше, ніж координати: це точка зв'язку між вами та покупцем. Правильно оформлена адреса свідчить про повагу до місцевих традицій та увагу до деталей, а це будує довіру поза кордонами.»

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