Даний модуль реалізує інтеграцію інтернет-магазину (далі Магазин) під керуванням HostCMS v.6 з сервісом «Покупка на Яндекс.Маркет» (далі Маркет).
Модуль дозволяє користувачам Яндекс.Маркета оформляти замовлення в вашому інтернет-магазині прямо зі сторінок Маркета, без переходу на ваш сайт, на ті товари, які ви розміщуєте на Маркеті засобами стандартного експорту товарів в нього.
Модуль знаходиться в стадії бета-тестування, про початок продажу буде додатковий анонс на офіційному форумі HostCMS.
Справжня документація є невід'ємною частиною дистрибутива Модуля, і повинна поширюватися в складі дистрибутива в обов'язковому порядку і в повному обсязі.
Умови та вимоги, що пред'являються до магазину
Для підключення до сервісу «Покупка на Яндекс.Маркет» магазин повинен відповідати наступним вимогам, що пред'являються з боку Яндекс.Маркет
- Тип магазину - інтернет-магазин (У магазину повинен бути власний сайт з описом товарів і формою замовлення);
- Магазин повинен бути підключений до Яндекс.Маркет і передавати прайс-лист в форматі YML;
- Рейтинг магазину - 3 зірки і більше;
- Тривалість розміщення магазину на Яндекс.Маркеті до підключення до програми - не менше 90 діб;
- Укладення договору між Магазином і Яндексом про участь в програмі.
Крім того, для магазинів, що працюють під управлінням HostCMS важливо виконання наступних специфічних умов:
- В налаштуваннях інтернет-магазину повинно бути включено резервування товарів;
- Кількість товару на складах, вказане в картці товару, має відповідати реальній кількості товару, доступному для замовлення. В іншому випадку, покупець не зможе оформити замовлення;
- В умовах доставки, для тих способів доставки, які ви пропонуєте на Маркеті, повинна бути описана вартість доставки в усі регіони, доставку в які ви пропонуєте. В іншому випадку, покупець не зможе оформити замовлення. Вартість доставки може бути як задана набором правил, так і обчислюватися динамічно за допомогою запитів до api-сервісів різних служб доставки.
Порядок підключення до сервісу «Покупка на Яндекс.Маркет»
Для підключення магазину за допомогою даного модуля, порядок дій може бути наступним:
Системні вимоги
- Система управління сайтом HostCMS v6.1.7 і вище;
- На сервері повинен бути встановлений інтерпретатор php версії 5.2.2 і вище, зібраний з підтримкою OpenSSL (в результатах phpinfo () в рядку «Registered Stream Socket Transports» має бути присутнім хоча б одне зі значень ssl / sslv2 / sslv3);
- Ви повинні мати доступ до настройками вашого веб-сервера, з можливістю налаштувати доступ до сторінок вашого сайту по протоколу https.
- modules / core / http.php
- modules / core / http / curl.php
- modules / core / http / socket.php
- modules / core / request.php
ліцензійна політика
Модуль інтеграції з сервісом «Покупка на Яндекс.Маркет» призначений для комерційної реалізації замовникам сайтів, веб-студіям, інтеграторам і іншим третім особам (далі - Покупці).
Реалізацію модуля можуть здійснювати розробник модуля, а також дилери, з якими у розробника укладено відповідну угоду (далі - Дистриб'ютори)
Код модуля прив'язується до конкретного екземпляру HostCMS, встановленому на сервері. Прив'язка здійснюється за номером ліцензії системи. При цьому, в ліцензійній політиці не міститься обмежень на кількість сайтів та інтернет-магазинів, що працюють під управлінням одного і того ж примірника системи.
Тобто, одна ліцензія на модуль інтеграції з сервісом «Покупка на Яндекс.Маркет» видається на один номер договору на установку системи HostCMS на сервер, і покриває необмежену кількість сайтів і магазинів на цьому екземплярі системи.
Дистрибутив модуля і ліцензійний ключ доступні Покупцеві після оплати ліцензії, і передачі Дистрибьютору модуля наступних даних:
- Логін, до якого прив'язана ліцензія HostCMS;
- Номер договору;
- Пін код.
У відповідь на ці дані, дистриб'ютор надає Покупцеві архів з вихідним кодом модуля та інструкцію з його встановлення. Ліцензійні ключі будуть згенеровані і вбудовані в систему автоматично, в момент установки модуля.
Важливо При здійсненні в системі деяких операцій, пов'язаних з Модулем, він час від часу автоматично перевіряє коректність ліцензійного ключа.
Важливо Роботи по настройки модуля на сайті (сайтах) Покупця до складу ліцензії не входять, але при необхідності можуть бути замовлені у дистриб'юторів з окремою оплатою.
установка модуля
Установка модуля дуже проста, і складається з двох кроків:
- вам необхідно скопіювати в кореневу папку системи, на яких серверах, файли і папки, що знаходяться в дистрибутиві:
- в центрі адміністрування системи перейти в розділ «Модулі», ви випадаючому меню вибрати «Модуль» - «Додати», заповнити форму такими даними:
- Назва модуля - Купівля на Яндекс.Маркет;
- Галочка «Активний» - включена;
- Галочка «індексувати» - вимкнена;
- Шлях до модуля - shopmarket;
- натиснути на кнопку «Застосувати».
Модуль автоматично внесе необхідні зміни в базу даних і підключить потрібні хукі. Крім того, до всіх магазинах в системі буде додана нова платіжна система «Покупка на Яндекс.Маркет» (створюється в статусі «Неактивна», так що користувачам вона доступна не буде), також в систему додадуться нові статуси замовлень, і нова ТДС «Купівля на Яндекс.Маркет »в групі« Інтернет-магазин ».
Налаштування модуля
Налаштування модуля складається з декількох етапів:
1. Налаштування веб-сервера
Яндекс.Маркет взаємодіє з магазинами тільки по захищеному з'єднанню SSL, тому вам необхідно налаштувати ваш сервер таким чином, щоб сторінки вашого сайту могли відкриватися як по протоколу http, так і по протоколу https.
При цьому Маркет не накладаються вимог на сам сертифікат, він може бути як офіційним, придбаним в центрі сертифікації, так і самоподпісним. Справжність сертифіката Маркет перевіряє по його відбитку SHA1, який ви вказуєте в налаштуваннях в особистому кабінеті Маркета. Для користувачів ж можна залишити звичайний доступ до сайту по http.
Тут я не буду приводити інструкцій з налагодження SSL-з'єднань для конкретних веб-серверів (Nginx, Apache і т.п.), тому що вони значною мірою залежать від конфігурації вашого сервера і встановленої на ньому панелі управління.
Ознакою успішного виконання даного пункту є те, що сторінки вашого сайту (наприклад, головна) відкриваються в браузері за протоколом https. (Якщо ви використовували самоподпісной сертифікат, то браузер перед цим буде видавати попередження про те, що сертифікат не є довіреною - це нормально, і не буде заважати роботі модуля)
2. Створення та налагодження розділу структури
- На сайті вашого магазину, зайдіть в центр адміністрування HostCMS, і перейдіть в розділ «Структура сайту».
- У випадаючому меню виберіть пункт «Розділ» - «Додати»
- У формі введіть наступні параметри:
- Назва розділу в меню - Купівля на Яндекс.Маркет
- Перейти до основного розділу - залиште значення порожнім (...) або виберіть бажаний батьківський розділ
- Меню - будь-яке значення
- Галочка «Показувати в меню сайту» - не включена
- Макет - будь-яке значення
- Назва розділу - наприклад, shopmarket
- Група доступу - Все
- Галочка «Активність сторінки» - включена
- Галочка «індексувати» - не включена
- Галочка «Доступ через HTTPS» - Включена (Обов'язково!)
- Тип розділу - Типова динамічна сторінка
- Розділ - Інтернет-магазин
- Сторінка - Купівля на Яндекс.Маркет
- Ідентифікатор магазину - ідентифікатор потрібного вам магазину, наприклад, Демонстраційний магазин [1]
- Натисніть кнопку «Застосувати»
Створений розділ структури, при зверненні за протоколом http буде автоматично перемикатися на протокол https, це є коректною поведінкою.
Важливо При відкритті в браузері сторінки взаємодії з Маркетом, в залежності від налаштувань ТДС, ви повинні бачити порожню сторінку, або повідомлення про помилку виду>. Така поведінка є коректним.
3. Налаштування параметрів підключення до сервісу в особистому кабінеті Маркета
5. Налаштування інтеграції для магазину
На цьому настройка модуля завершена.
налагодження модуля
Налагодження модуля здійснюється за допомогою інструментів налагодження в особистому кабінеті Яндекс.Маркет.
Обмеження на дії, що здійснюються в Центрі адміністрування HostCMS із замовленнями, оформленими через Яндекс.Маркет
Як було сказано вище, відповідно до вимог протоколу взаємодії між Магазином і Маркетом, для замовлень, оформлених через Яндекс.Маркет введений ряд обмежень на дії, що здійснюються в списку замовлень і в картці замовлення.
розробники модуля
Всі права на код Модуля і супроводжуючу його документацію виключно належать тільки Розробникові.
Порядок надання технічної підтримки та вирішення спірних питань
Розробник надає технічну підтримку тільки дистриб'юторам модуля, а також Покупцям, що здобувало модуль особисто у нього. Покупцям, що здобувало модуль у інших дистриб'юторів за технічною підтримкою необхідно звертатися до того Дистрибьютору, у якого вони набули модуль.
Розробник бере участь у вирішенні спірних питань тільки з Покупцями, що здобувало модуль особисто у нього. Покупцям, що здобувало модуль у інших дистриб'юторів за дозволом спірних питань необхідно звертатися до того Дистрибьютору, у якого вони набули модуль.
Модуль надається «Як є», розробник не несе відповідальності за будь-які збитки, отриманий покупцем в результаті придбання і / або використання даного модуля.
До складу технічної підтримки входить усунення виявлених і стабільно відтворюваних помилок в роботі Модуля і у взаємодії Модуля і Яндекс.Маркет. Усунення таких помилок здійснюється безкоштовно, за винятком таких випадків:
- помилки, що з'явилися в результаті зміни параметрів API з боку Яндекс.Маркет;
- помилки, що виникли в результаті невірних дій адміністратора Магазину, що працює із замовленнями і з Модулем;
- помилки, що виникли в результаті порушення Покупцем вищевикладеної ліцензійної політики Модуля.
Розробник приймає від Покупців і дистриб'юторів запити на розширення функціональності модуля, проте залишає за собою рішення про можливість і терміни реалізації конкретних запитів. Роботи з розширення функціональності модуля здійснюються тільки за додаткову плату.
Розробник, за окрему плату, може надавати Покупцеві послуги з налаштування Модуля для конкретного Магазину, проте залишає за собою рішення про можливість і терміни надання такої послуги.
Розробник дякує вам за придбання та використання даного Модуля!
P.S. Розробник висловлює свою вдячність команді KAD Systems і особисто Артему за участь в розробці цього модуля.