Автокомплит города
Подсказки города при оформлении заказа — без опечаток в адресе.
Город, вписанный от руки, — источник ошибок в адресе: опечатки, сокращения, посёлок вместо города. Покупатель набирает первые буквы и выбирает свой населённый пункт из подсказок, а службы доставки сразу находят по нему свои отделения.
Что делает
- Подсказывает города и сёла под полем «Город» в оформлении заказа — из справочника, загруженного в магазин.
- Ищет одновременно по украинскому, русскому и английскому написанию, а сверху списка показывает более крупные населённые пункты.
- Передаёт службам доставки название города в том написании, которое знают их справочники: Нова Пошта, Meest и Укрпошта сразу подставляют отделения выбранного города.
- Подставляет город при открытии оформления, определяя его по подключению покупателя; покупатель всегда может выбрать другой, а саму подстановку можно выключить.
- Подсказывает города и в админке — когда вы создаёте заказ вручную.
- Даёт задать, после скольких набранных букв показывать подсказки, и ограничить справочник только теми странами, куда вы доставляете.
- Работает в любом оформлении витрины: править шаблоны не нужно.
Что нужно для работы
- Отметить страны доставки и нажать «Обновить справочник городов» — загрузка идёт в фоне и занимает несколько минут.
- Работающая очередь задач: справочник загружается фоновой задачей.
- Доступ в интернет с сервера магазина: справочник скачивается из открытой базы GeoNames, а город по подключению покупателя определяет бесплатный сторонний сервис.
Что появится в магазине
Так это увидит покупатель после установки.
- В оформлении заказа под полем «Город» появляется список подсказок: покупатель набирает первые буквы и выбирает свой город или село. Подсказки подставляются в поле города любого оформления — отдельный шаблон для этого не нужен и в редакторе оформления ничего править не надо.
Загрузка населённых пунктов отмечается так же, как остальная долгая работа магазина. Если загрузка оборвётся, магазин покажет это в «Настройки → Диагностика» строкой «Незаконченная работа» — раньше об этом нельзя было узнать нигде. Нужен магазин версии 2.47.0 и новее.
Видно состояние справочника
Блок загрузки теперь называется «Справочник населённых пунктов», а рядом с кнопкой написано, что в нём: «В справочнике 29 703 населённых пункта, загружены 04.09.2026». Пока справочник пуст, так и сказано — и сказано, что подсказки города при этом не работают.
Загрузка начинается сразу после нажатия, ждать планировщик больше не нужно.
Лишние настройки не мешают
Список стран относится только к GeoNames, а ссылка на файл — только к официальному кодификатору. Раньше оба поля висели рядом всегда, и было непонятно, какое из них про выбранный справочник. Теперь показывается то, что относится к делу.
Справочник населённых пунктов теперь на выбор
В настройках дополнения появился выбор: официальный кодификатор Украины (КАТОТТГ) или GeoNames. По умолчанию — кодификатор. Это один файл с сайта министерства: украинские названия всех сёл, район и область рядом с названием, никаких ключей и сторонних сервисов. GeoNames остаётся тем, кто доставляет не только по Украине.
Кодификатор хранится отдельно от GeoNames, поэтому справочники не смешиваются: в подсказке не появится два «Києва» — по одному из каждого источника. Подсказка на витрине и подсказка города в панели читают тот справочник, который вы выбрали.
Село теперь видно вместе с принадлежностью: «Чотирбоки — Шепетівський р-н, Хмельницька обл.». Без неё выбирать нельзя вслепую: «Іванівка» встречается в стране 119 раз. Города идут выше селищ, селища выше сёл, а пункты, которых в свежей редакции больше нет, из справочника уходят.
После обновления загрузите справочник кнопкой «Обновить справочник» в настройках дополнения.
Подсказка города показывает адреса, а не куски справочника
К «Київ» подсказка предлагала «Київський район», «Київський квартал» и одинаковые названия подряд. Районы и кварталы городов, заброшенные и разрушенные сёла, исторические места больше не показываются. Это работает и на уже загруженном справочнике, обновлять его для этого не нужно.
Рядом с названием теперь видно область — одинаковые названия сёл больше не путаются между собой. Область берётся из справочника при его обновлении.
Село находится по украинскому названию
У части сёл в справочнике есть только латинское имя — «Чотирбоки» лежит там как «Chotyrboky», и покупатель не находил своё село вовсе. Теперь введённое название ищется ещё и в латинской записи, по украинскому стандарту транслитерации.
Свой значок у дополнения
В разделе «Плагины» и в списке установленного дополнение теперь видно по собственному значку, а не по одинаковой коробке. Нужное вы находите взглядом, а не чтением всего списка. Значок появляется на магазине версии 1.30.0 и новее.
Первый релиз