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