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
Оформление подписки
Мы переходим на новую подписную систему, открывая для вас полный доступ ко всем нашим модулям. Подробную информацию об условиях подписки и часто задаваемых вопросах вы можете найти здесь.
Обратите внимание, что приобретение модулей по отдельности теперь недоступно — воспользоваться ими возможно исключительно в рамках подписки.
За единую стоимость подписки - 2000 руб/мес. Вы получаете доступ ко всем модулям.
Как оформить подписку у нас на сайте
Зарегистрируйтесь или авторизуйтесь на нашем сайте и выберите интересующий вас модуль
Нажмите кнопку Запросить триал доступ
Введите в поле URL сайта ваш домен в формате domain.com, без www и https://
Далее в личном кабинете в разделе загрузки вы сможете скачать нужный вам модуль и менеджер модулей для удобного управления модулями и оформления подписки.
Далее у вас есть 7 дней для тестирования выбранного модуля.
По истечении строка триала, для продолжения работы необходимо оплатить подписку.
Сделать это можно из менеджера модулей.
На выбор вы можете оплатить:
для зарубежных карт - PayPal
для РФ карт - Robokassa
Или на странице на сайте https://makeshop.pro/subscription/
При оплате нужно указать электронную почту с которой вы оформляли триал доступ.
При покупке на маркетплейсе CS-Cart
При покупке любого модуля зарубежной картой или картой РФ
Так как система при оформлении подписки не спрашивает дополнительных вопросов (на какой домен подписка оформляется) желательно вводить электронную почту ту же что и ваша учетная запись у нас на сайте (если она есть), тогда ваши учётки свяжутся между собой.
Выберите интересующий модуль и нажмите кнопку “Оформить подписку“
Далее после оплаты подписки вы сможете скачать модуль перейдя в раздел “Загрузки“, там выберите свой заказ и в нем будет ссылка на скачивание.
В дальнейшем, для получения новых модулей по подписке рекомендуем пользоваться нашим сайтом.
Всё что вам будет нужно сделать это на интересующем вас модуле (после авторизации) нажать кнопку “Запросить модуль по подписке“ и после одобрения скачать его в разделе загрузки.
Если что-то пойдет не так - проверьте выписалась ли лицензия
Найдите заказ с датой оформления подписки
Убедитесь что у вас прописался URL сайта в заказ
Если URL сайта неправильный и вам нужно обновить его: переходите в пункт меню “Мои модули”
Ищите модуль и проверьте URL магазина для которого выписана подписка
После установки модуля в настройках модуля, на вкладке Настройки → Подключение указываем данные для работы полученные от сервиса Литрес, либо ставим галочку Тестовый режим для проверки работы модуля
Далее необходимо создать категорию для книг и характеристики для товаров в этой категории. К ним есть определенные требования(подробнее описаны в настройках)
После этого для первоначальной синхронизации необходимо один раз запустить скрипт по адресу [домен_сайта]/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 [+] Первое издание *** [+] Добавлено [-] Удалено [\*] Изменено [!] Исправлена ошибка
Ваш запрос отправлен!
Ваш запрос на доработку модуля отправлен в техническую поддержку. Мы изучим ваши пожелания и дадим обратную свзязь.
Вам придет уведомление на указанный Email.
Здесь можно поделиться своим мнением и оценить нашу работу.
Ваши отзывы помогают нам стать лучше и предлагать вам еще более качественный сервис.