Интеграция Яндекс Доставка и Woocommerce

Интеграция Яндекс Доставка и Woocommerce

Интеграция WooCommerce с Яндекс Доставкой https://dostavka.yandex.ru: расчёт, оформление, создание заявок (claims), трекинг, ПВЗ на карте или списком, подсказки адреса (DaData).

Лицензия Pluginhub

Функциональность плагина на сайте **включается только при активной лицензии Pluginhub**:

1. Укажите ключ лицензии в **Yandex Delivery → Settings** (или **WooCommerce → Настройки → Интеграции → Yandex Delivery**).
2. Ключ проверяется через API `pluginhub.pro`.
3. Без ключа или при недействительной лицензии: методы доставки не считают тарифы, AJAX чекаута (слоты, ПВЗ, DaData) отключены, скрипты оформления не подключаются, автоматизация заказов не выполняется.
4. Для разработки можно задать в `wp-config.php`: `define( 'WC_YD_SKIP_LICENSE_GATE', true );` — проверка ключа обходится (не используйте на продакшене).

Требования

- WordPress 5.0+
- PHP 7.4+
- WooCommerce 5.0+
- Аккаунт и OAuth-токен Яндекс Доставки (в кабинете сервиса)
- Для карты ПВЗ — ключ API [Яндекс Карт](https://developer.tech.yandex.ru/)
- Для подсказок адреса — токен (и при необходимости секрет) [DaData](https://dadata.ru/)

Установка

1. Скопируйте папку плагина в `/wp-content/plugins/`.
2. Активируйте плагин в админке WordPress.
3. Введите **лицензию Pluginhub** и **OAuth-токен** Яндекс Доставки в настройках плагина.

Основные возможности

- Профили API: Express (РФ / другие страны), «Другой день» (platform).
- Режимы окружения: production / test.
- **Тип отгрузки в зоне доставки (метод):**
  - **Курьер забирает со склада** — точка `source` в заявке = склад (из списка складов плагина или адрес магазина WooCommerce).
  - **Привезу на пункт приёма** — точка `source` = выбранный на чекауте пункт сдачи (вы сами везёте отправление в ПВЗ Яндекса); на чекауте показывается блок выбора пункта на карте.
- Склады: справочник в настройках, привязка к методу доставки.
- Расчёт стоимости, окна доставки, ПВЗ: карта или **выпадающий список** (настройка «Pickup UI»).
- Подсказки DaData; опция **автозаполнения** полей адреса после выбора подсказки.
- Замена адреса/индекса при выборе ПВЗ покупателем (опция).
- Автоэкспорт в Яндекс по статусам заказа, синхронизация статусов, cron с настраиваемым интервалом.
- Письмо WooCommerce со ссылкой трекинга.
- Логи и режим отладки API.

Настройки

Полный экран: **Yandex Delivery → Settings**. Карточка в **WooCommerce → Настройки → Интеграции** ведёт туда же.

Языки и переводы

- Интерфейс плагина переводится через стандартный механизм WordPress (**text domain:** `wc-yandex-delivery`).
- **Русский по умолчанию на сайте:** в **Настройки → Общие** выберите язык сайта **Русский** — подхватится файл `languages/wc-yandex-delivery-ru_RU.mo` (или копия в `wp-content/languages/plugins/`).
- **Другие языки:** в комплекте есть каталоги `en_US`, `kk_KZ`, `zh_CN`, `uz_UZ`; при смене языка сайта или профиля пользователя (в админке) WordPress загружает соответствующий `.mo`. При отсутствии перевода строка показывается на языке исходного кода (английский `msgid`).
- **Переопределение только для плагина:**  
  `add_filter( 'wc_yandex_delivery_locale', fn() => 'ru_RU' );`  
  (используйте только если нужно принудительно зафиксировать локаль независимо от настроек WP.)
- **Loco Translate / Poedit:** правьте `.po` в `languages/`, затем сохраните `.mo` рядом или в `wp-content/languages/plugins/`. Сборка из командной строки: `msgfmt -o wc-yandex-delivery-LOCALE.mo wc-yandex-delivery-LOCALE.po`.

Прочее

- Лицензия кода плагина: GPL v2 or later.
- Автор и коммерческая лицензия: https://pluginhub.pro.