Інтеграція з WooCommerce¶

WooCommerce — це плагін інтернет-магазину для WordPress. На відміну від Хорошопу, для якого в МійДроп є готова інтеграція «під ключ», магазин на WooCommerce підключається через API МійДроп за допомогою невеликого шматка PHP-коду. Це дозволяє автоматично передавати нові замовлення з вашого сайту одразу в CRM-таблицю МійДроп.

Що потрібно перед початком¶

Оскільки підключення йде через API, для акаунта має бути оплачена опція API (для лендінгів, WooCommerce, OpenCart, BAS) або діяти пробний період. Окремої галочки WooCommerce в оплаті підписки немає — її замінює опція API.

Де взяти код інтеграції¶

Готовий код інтеграції на PHP уже згенерований під ваш акаунт. Щоб його отримати:

1. Увійдіть у версію для постачальників.
2. Відкрийте розділ Інтеграції → API.
3. Скопіюйте блок «Код готової інтеграції на PHP» (файл send.php).
4. На цій же сторінці візьміть ваш API-ключ — його потрібно підставити в код замість ваш_API_ключ.

Що ще є на сторінці Інтеграції → API

API-ключ — передається в заголовку запиту X-API-KEY.
Webhooks — URL, на які МійДроп надсилатиме сповіщення про створення/зміну замовлення та зміну наявності товару.
Посилання на повну документацію API — api.mydrop.com.ua.

API МійДроп підтримує два варіанти створення замовлення: за назвою товару та за артикулом (SKU). Для WooCommerce надійніше передавати саме артикул (SKU), оскільки він однозначно ідентифікує товар.

Куди додавати код у WooCommerce¶

Код із розділу Інтеграції → API написаний для «сторінки подяки за замовлення» (наприклад, send.php на саморобному лендингу). У WooCommerce окремого файлу подяки немає — замість цього потрібно підчепити виклик до події WooCommerce, яка спрацьовує після оформлення замовлення.

Рекомендований варіант — хук woocommerce_thankyou: він викликається на сторінці «Замовлення отримано» (Order received / Thank you), тобто рівно в той момент, коли на лендингу відкривалася б сторінка подяки.

Спосіб 1 (рекомендований) — плагін Code Snippets¶

Найбезпечніший спосіб, бо код не загубиться під час оновлення теми:

1. У панелі WordPress встановіть і активуйте плагін Code Snippets (Плагіни → Додати новий).
2. Перейдіть у Snippets → Add New, дайте назву (наприклад, MyDrop integration).
3. Вставте код за схемою нижче та збережіть з опцією Run everywhere.

Спосіб 2 — файл `functions.php` дочірньої теми¶

1. Відкрийте Зовнішній вигляд → Редактор файлів теми.
2. Оберіть файл functions.php (бажано в дочірній темі, щоб зміни не зникли після оновлення основної теми).
3. Додайте код у кінець файлу.

Як адаптувати код¶

Код зі сторінки Інтеграції → API розрахований на статичні змінні лендингу. Для WooCommerce його потрібно обгорнути у функцію-обробник хука та брати дані із замовлення WooCommerce, а не з форми лендингу:

add_action('woocommerce_thankyou', 'mydrop_send_order', 10, 1);

function mydrop_send_order($order_id) {
    if (!$order_id) {
        return;
    }

    $order = wc_get_order($order_id);

    // Дані покупця з замовлення WooCommerce
    $name  = $order->get_billing_first_name() . ' ' . $order->get_billing_last_name();
    $phone = $order->get_billing_phone();

    // Товари замовлення — краще передавати артикул (SKU)
    foreach ($order->get_items() as $item) {
        $product = $item->get_product();
        $sku     = $product ? $product->get_sku() : '';
        $qty     = $item->get_quantity();

        // ... тут виклик API МійДроп із коду зі сторінки «Інтеграції → API»,
        // де ім'я/телефон/артикул/кількість беруться зі змінних вище,
        // а замість `ваш_API_ключ` підставлено ключ із розділу API
    }
}

Наведений приклад показує місце й принцип підключення. Тіло запиту (URL, заголовок X-API-KEY, поля) беріть із готового коду send.php у розділі Інтеграції → API — він уже містить ваш ключ і правильну структуру запиту. Достатньо замінити статичні змінні лендингу на дані з об'єкта $order.

Немає свого програміста?¶

Вставка коду в WooCommerce — технічне завдання, і для нього зазвичай потрібен розробник. Якщо у вас немає власного програміста чи спеціаліста з налаштування API, ми можемо надати контакти фахівців, які виконають інтеграцію за додаткову оплату. Для цього зверніться в підтримку МійДроп — напишіть менеджеру Анні.

Перевірка¶

Після додавання коду оформіть тестове замовлення у вашому магазині на WooCommerce. Якщо все налаштовано правильно, замовлення з'явиться в таблиці замовлень МійДроп із даними покупця та товарами. Якщо замовлення не надходить — перевірте, що API-ключ підставлений правильно, а артикули (SKU) товарів у WooCommerce збігаються з артикулами товарів у МійДроп.