=== Adresly — подсказки адресов ===
Contributors: adresly
Tags: address, autocomplete, woocommerce, checkout, russia
Requires at least: 6.2
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Подсказки адресов России при оформлении заказа WooCommerce и в своих формах. Город, индекс и регион заполняются сами.

== Description ==

Покупатель начинает вводить адрес и выбирает его из списка подсказок. Плагин сам заполняет город, индекс и регион, поэтому в заказе меньше ошибок и курьер находит дом с первого раза.

* Классическое оформление заказа WooCommerce и блочное (по умолчанию с WooCommerce 8.3).
* Адрес плательщика и адрес доставки, включаются по отдельности.
* Свои формы, например Contact Form 7: поле адреса задаётся CSS-селектором.
* Скрипт подключается только на странице оформления заказа и на страницах со своими полями.

Плагин бесплатный. Подсказки работают через сервис Adresly, нужен ключ из личного кабинета на [adresly.ru](https://adresly.ru). Условия и цены сервиса — на [adresly.ru/pricing](https://adresly.ru/pricing).

== Внешний сервис ==

Плагин работает через внешний сервис Adresly (ООО «ЕИТ», adresly.ru). Без него подсказок нет.

* На странице оформления заказа и на страницах со своими полями браузер посетителя загружает скрипт подсказок https://adresly.ru/w.js.
* Когда посетитель вводит адрес (от 3 символов), браузер отправляет на https://api.adresly.ru введённый текст и публичный ключ магазина. Сервис видит также IP-адрес посетителя и адрес сайта (заголовок Origin). Ответ — список подсказок.
* Другие данные о посетителе и заказе, в том числе имя, телефон и e-mail, плагин в сервис не передаёт. Сам плагин на сервер ничего не отправляет.

Условия использования (оферта): https://adresly.ru/terms
Политика конфиденциальности: https://adresly.ru/privacy

== Installation ==

1. В личном кабинете Adresly (https://adresly.ru/dashboard/tokens) выпустите публичный ключ и укажите домен магазина, например shop.ru и www.shop.ru.
2. В WordPress откройте «Плагины → Добавить новый плагин → Загрузить плагин», выберите архив и активируйте плагин.
3. Откройте «Настройки → Adresly», вставьте ключ и отметьте, где нужны подсказки: адрес плательщика, адрес доставки.
4. Для своих форм укажите CSS-селекторы полей адреса в поле «Свои поля».
5. Оформите тестовый заказ: выберите адрес из подсказок и проверьте город, индекс и регион.

== Frequently Asked Questions ==

= Какой ключ нужен? =

Публичный, он начинается с pk_. Публичный ключ работает только с доменов, указанных в его настройках. Секретный ключ плагин не примет: на сайте его увидел бы любой посетитель.

= Подсказок нет, в консоли браузера «Домен не разрешён» =

Добавьте домен сайта в настройки ключа в личном кабинете. Сайт с www и без www — это два разных домена.

= Как разложить адрес по полям своей формы? =

Добавьте полю адреса атрибуты: data-adresly-postal_code="#zip" для индекса, data-adresly-city="#city" для города. После data-adresly- идёт имя части адреса, значение — CSS-селектор поля, куда её записать. Список частей адреса: https://adresly.ru/docs

= Работает ли с блочным оформлением заказа? =

Да. Выбранный адрес, город, индекс и регион записываются в данные оформления заказа WooCommerce и попадают в заказ.

== Changelog ==

= 1.0.0 =
* Первая версия: подсказки в классическом и блочном оформлении заказа WooCommerce, свои поля по CSS-селектору.
