MS: Интеграция с сервисом ЛитРес
Описание
Модуль ms_litres_integration обеспечивает гибкую интеграцию с книжным маркетплейсом ЛитРес. Модуль позволяет создать свой книжный магазин, интегрируясь с каталогом ЛитРес для продажи электронных книг и других цифровых товаров.
Основные возможности
- Интеграция с ЛитРес: Полная интеграция с API ЛитРес для работы с каталогом книг
- Импорт товаров: Импорт книг из каталога ЛитРес в магазин CS-Cart
- Управление жанрами: Импорт и синхронизация жанров книг из ЛитРес
- Продажа цифровых товаров: Продажа электронных книг с автоматической выдачей файлов для скачивания
- Уведомления о продаже: Автоматическое уведомление ЛитРес о продаже книг
- Управление статусами: Автоматическое управление статусами заказов при работе с ЛитРес
Как работает модуль
Модуль использует следующие механизмы:
- База данных (
func.php): При установке модуль:
- Добавляет поле
ms_litres_genre_idв таблицуcategoriesдля связи с жанрами ЛитРес - Добавляет поля
ms_litres_product_typeиms_litres_product_infoв таблицуproducts - Добавляет поле
ms_litres_file_formatв таблицуproduct_files
- Классы интеграции (
Tygh/Addons/MsLitresIntegration/):
MsLitresIntegration.php- основной класс для работы с API ЛитРесMsLitresIntegrationProduct.php- класс для работы с товарами ЛитРес
- Хуки (
hooks.func.php):
fn_ms_litres_integration_change_order_status()- уведомляет ЛитРес о продаже книги:- Проверяет статус заказа с настройкой "Отправлять запрос в ЛитРес о продаже"
- Отправляет уведомление в ЛитРес о продаже книги
- Обрабатывает ответ от ЛитРес и управляет статусом заказа
- Контроллеры:
controllers/backend/ms_litres_integration.php- управление интеграцией в административной панелиcontrollers/frontend/ms_litres_integration.php- обработка запросов на витрине
Где находится функциональность
- Административная панель:
- Настройки модуля с параметрами подключения к ЛитРес
- Сопоставление характеристик товаров с данными ЛитРес
- Управление жанрами и товарами
- Витрина:
- Страницы товаров с информацией о книгах из ЛитРес
- Скачивание файлов книг после покупки
Настройки модуля
Подключение
- ID партнера (
partner_id): ID партнера в системе ЛитРес - Секретный ключ (
secret_key): Секретный ключ для работы с API ЛитРес - Секретный ключ для уведомлений (
notification_secret_key): Секретный ключ для уведомлений о продаже - Домен для скачивания (
domain_for_download): Домен для скачивания файлов книг - Статус для перевода заказа при получении отказа продажи от ЛитРес (
status_for_error): Статус заказа при ошибке - Тестовый режим (
test_mode): Включить тестовый режим работы
Общие настройки
- Категория для дерева жанров ЛитРес (
categories): Категория для импорта жанров - Автор (
author): Характеристика для автора книги (тип "Группа флажков") - Серия (
series): Характеристика для серии (тип "Текст или число") - Номер в серии (
series_number): Характеристика для номера в серии - ISBN (
isbn): Характеристика для ISBN - Продавец (
company): Продавец, которому будут принадлежать товары из ЛитРес
Использование
- Регистрация в ЛитРес:
- Зарегистрируйтесь как партнер в системе ЛитРес
- Получите ID партнера и секретные ключи
- Настройка модуля:
- Укажите параметры подключения к ЛитРес
- Настройте сопоставление характеристик товаров
- Выберите продавца для товаров из ЛитРес
- Импорт товаров:
- Используйте функции модуля для импорта книг из каталога ЛитРес
- Обновите список жанров из ЛитРес
- Результат:
- Товары из ЛитРес импортируются в магазин
- При продаже книги автоматически отправляется уведомление в ЛитРес
- Покупатель получает доступ к скачиванию файла книги
Технические детали
- Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
- Требует включенной опции "Продажа цифровых товаров" в настройках CS-Cart
- При установке добавляет необходимые поля в таблицы базы данных
- Интегрируется с API ЛитРес для работы с каталогом и уведомлениями
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Владельцам
- English
- Русский
- 4.18.X
- 4.17.X
- 4.16.X
- 4.15.X
- 4.14.X
- 4.13.X
- 4.12.X
После установки модуля в настройках модуля, на вкладке Настройки → Подключение указываем данные для работы полученные от сервиса Литрес, либо ставим галочку Тестовый режим для проверки работы модуля
Далее необходимо создать категорию для книг и характеристики для товаров в этой категории. К ним есть определенные требования(подробнее описаны в настройках)
После этого для первоначальной синхронизации необходимо один раз запустить скрипт по адресу [домен_сайта]/admin.php?dispatch=ms_litres_integration.get_genres_list для получения списка жанров
После его выполнения запускаем скрипт
[домен_сайта]/admin.php?dispatch=ms_litres_integration.get_fresh_book&from=2013-01-01&days=1 для получения книг
Для автоматической синхронизации в дальнейшем добавляем в cron запуск скрипта [домен_сайта]/admin.php?dispatch=ms_litres_integration.get_genres_list раз в 14 дней. И скрипта [домен_сайта]/admin.php?dispatch=ms_litres_integration.get_fresh_book&minutes=15 раз в 15 минут.
После этого выберем статус заказа, при наступлении которого будем сообщать о выполнении покупки на сторону Litres. Перейдем Администрирование → Статусы → Статусы заказов, выберем нужный статус
И в его настройках поставим галочку Отправлять запрос в ЛитРес о продаже
А в настройках самого модуля выберем статус, в который заказ перейдет в случае его отклонения Litres
**v1.0.4** [\*] Изменены короткие теги <? на обычные <?php **v1.0.3** от 26.12.2022 [+] Стандартизация модуля **v1.0.2** от 09.10.2022 [+] Стандартизация модуля **v1.0.1** от 18.07.2022 [\*] Cтандартизация кода модуля **v1.0.0** от 10.11.2021 [+] Первое издание *** [+] Добавлено [-] Удалено [\*] Изменено [!] Исправлена ошибка
Здесь можно поделиться своим мнением и оценить нашу работу.
Ваши отзывы помогают нам стать лучше и предлагать вам еще более качественный сервис.