Формати адрес
Вступ#
Формат адреси визначає, як адреси покупців відображаються в магазині: в особистому кабінеті, під час оформлення замовлення, у замовленнях, рахунках, листах і списках доставки. Шаблон складається із заповнювачів для частин адреси (ім'я, вулиця, місто тощо), тож адреси кожної країни можна показувати за місцевими правилами. Однакове форматування робить адреси зрозумілішими для покупців, працівників і служб доставки.
Відмінність від 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). Порожні рядки (наприклад, якщо компанію не вказано) автоматично прибираються.
Типові завдання#
Налаштування формату адреси для країни#
Щоб задати власний формат відображення адрес:
- Перейдіть до Система → Локалізація → Країни й натисніть Редагувати біля потрібної країни.
- У полі Формат адреси складіть шаблон із заповнювачів.
- Розташуйте заповнювачі в потрібному порядку, кожен рядок адреси — з нового рядка.
- Додайте потрібні розділові знаки (коми, пробіли, дефіси) між заповнювачами.
- Натисніть Зберегти.
- Перевірте результат: створіть або відкрийте адресу покупця з цією країною та подивіться, як вона показується.
Однаковий формат для кількох країн#
Окремих шаблонів, які можна призначати кільком країнам, в ocStore 3 немає. Щоб використати однаковий формат:
- Налаштуйте формат для однієї країни й скопіюйте вміст поля Формат адреси.
- Вставте його в поле Формат адреси інших країн.
- Збережіть кожну країну.
Формат за замовчуванням#
Окремого параметра для формату за замовчуванням немає. Для країн з порожнім полем Формат адреси використовується стандартний формат, вбудований у код (див. приклад вище). Щоб змінити вигляд адрес для таких країн, заповніть поле Формат адреси у відповідних країнах.
Найкращі практики#
Рекомендації щодо шаблонів
Ефективне форматування
- Вивчіть місцеві стандарти: з'ясуйте, як прийнято записувати адреси в країнах, з якими ви працюєте.
- Послідовні переноси рядків: однаково розбивайте адресу на рядки для зручності читання в друкованих документах.
- Необов'язкові частини: {company} і {address_2} можна залишати в шаблоні — порожні рядки приберуться автоматично.
- Перевірка на реальних даних: перевіряйте формати на реалістичних прикладах адрес.
- Мовні особливості: переконайтеся, що формат коректно працює з літерами з діакритикою та, якщо потрібно, з мовами письма справа наліво.
Стратегія керування форматами
Організаційний підхід
- Типові шаблони: підготуйте кілька загальних варіантів (наприклад, «Північна Америка», «Європа», «Азія») і використовуйте їх для кількох країн.
- Особливі формати: створюйте унікальний формат лише тоді, коли типовий не відповідає місцевим вимогам.
- Облік змін: фіксуйте зміни форматів, особливо якщо вони впливають на друковані матеріали чи юридичні документи.
- Документування: ведіть список, яка країна який формат використовує.
Про видалення: очищення поля Формат адреси повертає для країни стандартний формат. Саму країну не можна видалити, якщо вона є країною за замовчуванням магазину або використовується в магазинах, адресах, партнерами, зонах чи географічних зонах — перевірте повідомлення про помилку.
Усунення проблем#
Не вдається видалити країну
Залежності
- Країна за замовчуванням: країна вибрана в налаштуваннях магазину.
- Використання: країна вказана в адресах покупців, у партнерів, у зонах чи географічних зонах. Кількість указано в повідомленні про помилку.
- Рішення: зазвичай країну краще не видаляти, а вимкнути (поле Статус).
Заповнювачі адреси відображаються неправильно
Помилки в шаблоні
- Описки: перевірте написання заповнювачів (наприклад,
{firstname}, а не{first_name}). - Дужки: кожен заповнювач має відкриваючу
{і закриваючу}дужки. - Переноси рядків: використовуйте звичайні переходи на новий рядок у полі, а не символи
\n. - Спецсимволи: перевірте адреси з особливими символами чи літерами з діакритикою.
Адреса показується за стандартним форматом
Формат не застосовується
- Поле порожнє: перевірте, що формат збережено саме для потрібної країни.
- Інша країна: переконайтеся, що в адресі покупця вибрано ту країну, яку ви редагували.
- Старі замовлення: у замовленні формат адреси зберігається на момент оформлення, тому зміни стосуються лише нових замовлень.
- Кеш: очистіть кеш (і кеш CDN, якщо він використовується), щоб побачити зміни.
Різне форматування в замовленнях з різних країн
Узгодженість
- Формати країн: перевірте, що кожна країна має правильний формат адреси.
- Стандартний формат: переконайтеся, що стандартний формат прийнятний для країн без власного шаблону.
- Тестування: оформіть тестові замовлення з адресами з різних країн, щоб виявити розбіжності.
- Регіональні особливості: деякі країни мають регіональні відмінності, які не враховує загальнонаціональний формат.
«Адреса — це більше, ніж координати: це точка зв'язку між вами та покупцем. Правильно оформлена адреса свідчить про повагу до місцевих традицій та увагу до деталей, а це будує довіру поза кордонами.»