Интеграция с сервисом ЛитРес

MS: Интеграция с сервисом ЛитРес

Описание

Модуль ms_litres_integration обеспечивает гибкую интеграцию с книжным маркетплейсом ЛитРес. Модуль позволяет создать свой книжный магазин, интегрируясь с каталогом ЛитРес для продажи электронных книг и других цифровых товаров.

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

• Интеграция с ЛитРес: Полная интеграция с API ЛитРес для работы с каталогом книг
• Импорт товаров: Импорт книг из каталога ЛитРес в магазин CS-Cart
• Управление жанрами: Импорт и синхронизация жанров книг из ЛитРес
• Продажа цифровых товаров: Продажа электронных книг с автоматической выдачей файлов для скачивания
• Уведомления о продаже: Автоматическое уведомление ЛитРес о продаже книг
• Управление статусами: Автоматическое управление статусами заказов при работе с ЛитРес

Как работает модуль

Модуль использует следующие механизмы:

1. База данных (func.php): При установке модуль:

• Добавляет поле ms_litres_genre_id в таблицу categories для связи с жанрами ЛитРес
• Добавляет поля ms_litres_product_type и ms_litres_product_info в таблицу products
• Добавляет поле ms_litres_file_format в таблицу product_files

1. Классы интеграции (Tygh/Addons/MsLitresIntegration/):

• MsLitresIntegration.php - основной класс для работы с API ЛитРес
• MsLitresIntegrationProduct.php - класс для работы с товарами ЛитРес

1. Хуки (hooks.func.php):

• fn_ms_litres_integration_change_order_status() - уведомляет ЛитРес о продаже книги:
• Проверяет статус заказа с настройкой "Отправлять запрос в ЛитРес о продаже"
• Отправляет уведомление в ЛитРес о продаже книги
• Обрабатывает ответ от ЛитРес и управляет статусом заказа

1. Контроллеры:

• 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): Продавец, которому будут принадлежать товары из ЛитРес

Использование

1. Регистрация в ЛитРес:

• Зарегистрируйтесь как партнер в системе ЛитРес
• Получите ID партнера и секретные ключи

1. Настройка модуля:

• Укажите параметры подключения к ЛитРес
• Настройте сопоставление характеристик товаров
• Выберите продавца для товаров из ЛитРес

1. Импорт товаров:

• Используйте функции модуля для импорта книг из каталога ЛитРес
• Обновите список жанров из ЛитРес

1. Результат:

• Товары из ЛитРес импортируются в магазин
• При продаже книги автоматически отправляется уведомление в ЛитРес
• Покупатель получает доступ к скачиванию файла книги

Технические детали

• Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
• Требует включенной опции "Продажа цифровых товаров" в настройках CS-Cart
• При установке добавляет необходимые поля в таблицы базы данных
• Интегрируется с API ЛитРес для работы с каталогом и уведомлениями