Інтерактивний посібник з модуля OLX для OpenCart

Посібник з модуля OLX для OpenCart

Цей інтерактивний посібник допоможе вам встановити, налаштувати та ефективно використовувати модуль інтеграції з OLX. Використовуйте навігацію зліва, щоб швидко переходити до потрібних розділів.

📋 Основні вимоги

OpenCart 3.x (з HTTPS)
PHP 7.2-8.4 (cURL, JSON)
Вихідний HTTPS-доступ
Робочий планувальник CRON / Task Scheduler

✨ Ключові можливості

Підключення акаунтів OLX через OAuth
Експорт товарів на основі кампаній
Зіставлення категорій та атрибутів
Захищений URL для експорту за розкладом
Моніторинг та логування помилок

Процес встановлення

1Завантаження файлів

Завантажте файли модуля в кореневу директорію вашого сайту OpenCart, зберігаючи початкову структуру каталогів.

2Активація в адмін-панелі

Перейдіть до Розширення → Розширення, виберіть тип "Реклама", знайдіть "OLX" у списку та натисніть зелену кнопку "Встановити".

3Налаштування доступу

Перейдіть до Система → Користувачі → Група користувачів, виберіть групу, надайте необхідні дозволи для цієї групи.

4Перехід до налаштувань

Після встановлення, для доступу до панелі керування модулем перейдіть до Розширення → Реклама → OLX та натисніть кнопку "Редагувати".

Інсталятор автоматично створить усі необхідні таблиці в базі даних для коректної роботи модуля.

Початкове налаштування та підключення

Перші кроки

1. Увімкніть модуль

На панелі керування змініть статус на "Увімкнено".

2. Згенеруйте ключ

Натисніть "Згенерувати" для створення секретного ключа експорту.

3. Перевірте URL

Відкрийте URL для експорту в браузері для перевірки ключа.

Авторизація акаунту OLX

Створіть додаток у партнерському акаунті OLX, щоб отримати Client ID та Client Secret.
У модулі, в розділі "Акаунти", додайте новий акаунт, використовуючи отримані дані.
У налаштуваннях вашого додатка на OLX вкажіть Redirect URI, який відображається на сторінці акаунта в модулі.
Натисніть "Авторизувати" в модулі та підтвердіть доступ у вікні OLX, що відкриється.

Зіставлення даних

Цей крок є критично важливим для коректного створення оголошень. Приділіть йому належну увагу.

Категорії

Зіставте категорії вашого магазину з категоріями OLX.

Атрибути

Вкажіть відповідність атрибутів товарів вимогам OLX.

Міста

Виберіть міста для розміщення оголошень.

Експлуатація та автоматизація

Цей розділ описує щоденний робочий процес з модулем: від керування кампаніями до автоматичного експорту та моніторингу.

1Керування кампаніями

Створюйте рекламні кампанії у відповідному розділі модуля та додавайте до них товари, які ви хочете експортувати на OLX. Це основа для автоматизації.

2Умови для експорту товарів

Товар буде автоматично обраний для експорту, тільки якщо він відповідає всім наступним критеріям:

✔ Статус товару в магазині "Увімкнено".
✔ Кількість товару на складі більша за нуль.
✔ Дата доступності товару вже настала.
✔ Минуло понад 24 години з моменту останнього вивантаження цього товару.

3Налаштування планувальника (CRON)

Використовуйте захищений URL з панелі керування для налаштування автоматичного експорту. Рекомендований інтервал — кожні 5-15 хвилин.

Linux (crontab)

*/5 * * * * /usr/bin/curl -fsS "https://<your-domain>/index.php?route=extension/advertise/olx_export&secret=<YOUR_SECRET>" -m 120 -o /dev/null

Windows (Task Scheduler)

curl.exe -fsS "https://<your-domain>/index.php?route=extension/advertise/olx_export&secret=<YOUR_SECRET>" --max-time 120 --output NUL

4Моніторинг та логи

Панель керування модуля надає всю необхідну інформацію для відстеження процесу:

Статистика: Загальна кількість кампаній, опублікованих оголошень та поточних помилок.
Лог помилок: Детальна інформація про помилки валідації від OLX.
Опубліковані оголошення: Список успішно опублікованих оголошень з їхніми статусами та посиланнями.

Вирішення проблем та поради

URL експорту повертає "Invalid secret key" (403)

↓

Секретний ключ в URL не збігається з ключем у налаштуваннях модуля. Згенеруйте новий ключ та оновіть команду у вашому планувальнику.

Помилки авторизації (401 від OLX)

↓

Термін дії токена доступу закінчився, і його не вдалося оновити. Повторно авторизуйте акаунт у модулі. Також перевірте коректність Client ID/Secret та Redirect URI в налаштуваннях вашого додатка на OLX.

Товари не експортуються

↓

Перевірте всі умови експорту: статус товару, кількість, дата доступності та 24-годинний період очікування. Уважно вивчіть лог помилок на предмет повідомлень валідації від OLX та виправте зіставлення або контент товару.