Як перенести каталог із сайту в Elbuz: Elbuz Tunnel для CMS

Що вміє тунель

• Підключається до сайту на OpenCart, Magento, 1C-Bitrix, WooCommerce, PrestaShop, CS-Cart, Shop-Script — а до рідкісної системи на MySQL власним SQL-запитом.
• Переносить категорії, товари, виробників, атрибути, опції й фото — склад ви задаєте галочками шаблону.
• Оновлює вже перенесені картки за ідентифікаторами сайту, без дублів; закріплене позначками в картці не чіпає.
• Тримає каталог дзеркалом сайту — прибирає те, чого на сайті вже немає.
• Забирає замовлення з OpenCart 2, OpenCart 3 і Magento в документи «Замовлення покупця».
• Працює за розкладом — каталог Elbuz регулярно підтягує зміни з сайту.

Де це і хто має доступ

Меню

Довідники → Операції → Завантаження даних

Шаблон

створіть шаблон з типом «Elbuz Tunnel»

Право доступу

вікно «Завантаження» у «Правах груп»

Підготувати

доступ до хостингу сайту (FTP), щоб покласти модуль

Форма шаблону має дві вкладки: «Підключення» — CMS сайту, її версія й адреса, і «Завантаження» — що саме переносити. Файл тут не вказують. Поки з'єднання не налаштоване, кнопка зветься «Підключити», потім — «Перевірити підключення».

1

Вибір CMS сайту

2

Посилання на сайт і кнопка підключення

1. Оберіть CMS вашого сайту зі списку підтримуваних платформ.
2. Вкажіть посилання на сайт і натисніть «Підключити», щоб перевірити з'єднання з модулем тунелю.

Встановлення модуля на ваш хостинг

Тунель — це папка etrade_http_tunnel2 у корені вашого сайту. Поки її там немає, підключатися нема до чого, тож перший крок завжди однаковий: покласти модуль на сервер. Це разова робота на кілька хвилин, і далі до неї не повертаються — оновлюється модуль сам.

1. Завантажте модуль. У шаблоні тунелю, на вкладці «Підключення», є кнопка «Завантажити модуль» — вона віддає актуальний архів. Те саме прямим посиланням: etrade_http_tunnel2.zip.
2. Розпакуйте архів на своєму комп'ютері.
3. Перепишіть вміст на хостинг — у кореневу папку сайту, туди ж, де лежить головний index.php, разом із самою папкою etrade_http_tunnel2. Зручно зробити це FTP-клієнтом, наприклад FileZilla. Після цього адреса модуля виглядає так: https://ваш-сайт/etrade_http_tunnel2/etrade_http_tunnel.php.
4. Підключіться в Elbuz: на вкладці «Підключення» оберіть свою CMS (для OpenCart — ще й версію), вкажіть адресу сайту й натисніть «Підключити».

Далі Elbuz усе робить сам: прописує модулю пароль доступу (якщо це перше встановлення) і читає конфігураційний файл вашої CMS, діставши звідти параметри підключення до бази — сервер, назву бази, користувача, пароль і префікс таблиць. Вручну їх вводити не треба. Коли все вийшло, ви побачите повідомлення «Модуль успішно підключений!».

Усередині папки модуля, крім самого тунелю, лежать порожні теки temp і backup: у першій модуль тримає робочі файли, у другу складає архівні копії бази сайту. На хостингу мають бути ввімкнені розширення PHP mysqli, zip і curl.

Оновлення модуля

Зазвичай оновлювати руками нічого не треба. Натисніть «Перевірити підключення»: програма покаже версію модуля на вашому хостингу й порівняє її з останньою. Якщо вийшла новіша, поруч зʼявиться рядок «Доступна нова версія модуля» і кнопка «Оновити» — вона оновлює файли на сайті сама, нічого копіювати не доведеться.

Ручний шлях потрібен, коли автоматичне оновлення не проходить — наприклад, хостинг не дозволяє модулю писати у власну папку. Тоді беруть архів оновлення: etrade_http_tunnel2_update.zip. Його розпаковують і перезаписують файли в папці etrade_http_tunnel2 на хостингу поверх наявних.

З якими CMS працює і коли обрати тунель

Тунель підключається до бази сайту на популярній CMS. Версію у формі обирають лише для двох систем:

• MySQL (власний SQL-запит) — для саморобної чи рідкісної системи на MySQL: дані забирають своїм запитом до бази, див. SQL-запити в тунелі.
• Elbuz CMS — той самий тунель для сайтів на нашій CMS.
• Додаткові поля окремих CMS з'являються у формі після вибору системи: для багатомовного сайту — мова, дані якою забирати; для 1C-Bitrix обов'язково — інфоблок із товарами.

Тунель обирають, коли каталог уже живе на вашому сайті. Він читає базу такою, як вона є: зі зв'язками між товарами, категоріями й характеристиками, з повними описами й усіма зображеннями. Файлове вивантаження з CMS часто губить частину цих зв'язків.

До маркетплейсів (Епіцентр, Rozetka, Prom) тунель не підключається: для них є імпорт через API. Порівняння способів — який спосіб обрати.

Що перенести: галочки шаблону

Склад переносу задають у блоці «Вибір завантаження даних із сайту» на вкладці «Завантаження». У новому шаблоні ввімкнені «Категорії», «Товари» й «Виробники»; решту додають самі.

Фото тунель забирає посиланнями. Elbuz бере адреси зображень, файли лишаються на вашому хостингу, окремого перемикача для цього немає. Виняток — увімкнена послуга «Хмарне зберігання фото»: тоді файли викачуються у хмару Elbuz, по двадцять паралельних завантажень.

Галочка «Видаляти записи в базовому каталозі, яких немає на сайті» у розділі «Додатково» перетворює перенос на дзеркало сайту. Без неї дані лише додаються й оновлюються. Детальніше — дзеркальний режим.

Як запустити перенос і перевірити результат

Коли з'єднання встановлене, натисніть у шапці форми «Отримати каталог товарів». Товари з'являться в базовому каталозі: ярлик «Товари базового каталогу» або меню «Довідники» → «Базовий каталог товарів».

Прогін іде у два етапи. Спершу Elbuz по черзі забирає з сайту набори даних і складає їх у себе. Потім розкладає по базовому каталогу: видалення (у дзеркальному режимі), категорії, виробники, товари, характеристики, замовлення, фото. Наприкінці — формули полів, перевірка цілісності й індексування, як у будь-якому завантаженні (що відбувається після прогону).

Як зрозуміти, що перенос відпрацював. У журналі прогону мають бути рядки з числами:

• «Усього категорій завантажено:», «Всього товарів завантажено:», «Всього виробників завантажено:»;
• «Всього замовлень завантажено:» — якщо забирали замовлення;
• «Завантаження даних завершено!» і «Витрачено часу:» — у кінці.

Дата й тривалість потім видно в колонці «Останнє завантаження» списку шаблонів. Журнал живе в панелі «Операції», вікно шаблону можна закрити. Детальніше: як перевірити, що завантаження пройшло.

Скільки Elbuz чекає на сайт

Стелі за кількістю товарів немає: кожен набір даних — категорії, товари, ціни, фото, характеристики, замовлення — запитується окремим запитом.

Не вклався модуль у ці межі — набір даних просто не приїде, без помилки в журналі: зникне лише рядок із кількістю записів цього набору. У дзеркальному режимі порівняння тоді піде з неповною вибіркою.

Якщо перенос обірвався або його зупинили

• Обрив під час вичитки базовий каталог не змінює. Якщо сайт не відкрив з'єднання або модуль повернув помилку, у журналі червоним видно відповідь сайту й рядок «Вивантаження перервано!».
• Обрив під час запису лишає записане записаним. У дзеркальному режимі видалення йде першим, тож каталог може лишитися без прибраних записів до наступного прогону.

Кнопка «Зупинити» в панелі «Операції» спрацьовує на найближчій контрольній точці, повторний запуск безпечний. Детальніше: якщо прогін обірвався або його зупинили.

Розклад і вимкнення шаблону

Розклад запусків задає кнопка «Налаштування розкладу» у блоці «Повʼязані налаштування» форми шаблону. Перемикач активності в шапці форми лише зупиняє автоматичні запуски; ручний запуск і всі налаштування лишаються. Видалення шаблону тунелю забирає й доступи до бази сайту та правила відбору — вимкнути чи видалити шаблон.

Що перепише повторний перенос

Тунель звіряє записи за ідентифікаторами з бази сайту, тож повтор оновлює картки, а не задвоює їх (як програма впізнає товар). Картку, заведену в Elbuz руками, він не чіпає. Картку, що приїхала тунелем, кожен прогін оновлює так:

Закріпити своє значення можна позначками в картці товару: «Не оновлювати» лишає вашими ціну, наявність, артикул, габарити, активність, сортування, назву, описи й SEO-поля; «Фіксована ціна» — ціну, стару й рекомендовану ціну. Де вони: як закріпити своє значення.

1

Не оновлювати

2

Фіксована ціна

1. Не оновлювати — імпорт не змінює цей товар.
2. Фіксована ціна — імпорт не змінює ціну товару.

Чия ціна лишиться в картці

У поле ціни пишуть двоє: тунель — ціну сайту, оновлення базового каталогу з прайс-листів — ціну з вашою націнкою. Пріоритету джерел немає, виграє той, хто відпрацював пізніше.

• Порядок запусків. Розклад тунелю й розклад обробки прайс-листів визначають, чиє значення ляже останнім.
• «Фіксована ціна» в картці. Зупиняє обох: ні тунель, ні оновлення з прайсу ціну, стару й рекомендовану ціну не перепишуть.

Якщо ціни ведуться на сайті, не давайте оновленню з прайс-листів чіпати ціну цих товарів. Помилки ви не побачите: у картках просто чергуватиметься то одна ціна, то інша.

Видалили категорію чи виробника — наступний прогін поверне

Категорії тунель бере з сайту як є. Виробників — із довідника сайту, а ще з поля виробника товару та з характеристики, що називається саме «Производитель». У кожного такого запису зберігається джерело — назва шаблону, яким він приїхав.

Видалену категорію чи виробника наступний прогін створить знову, а прив'язки товарів розставить за сайтом. Видалення категорії забирає й товари, для яких вона основна, — що видаляється разом із категорією чи брендом.

Як прибрати з каталогу те, чого немає на сайті

Галочка «Видаляти записи в базовому каталозі, яких немає на сайті» додає прогону крок видалення, і він іде першим. Усе, що не приїхало з сайту, видаляється фізично — з описами, фото, прив'язками й супутніми товарами. У журналі крок підписаний «Видаляємо категорії та товари в базовому каталозі, яких немає у файлі». Кошика немає.

1

Видаляти записи, яких немає на сайті

2

Перевірити унікальність записів

3

Завантаження замовлень з ID

1. Видаляти записи в базовому каталозі, яких немає на сайті — дзеркальний режим.
2. Перевірити унікальність записів з урахуванням цього джерела завантаження.
3. Завантаження замовлень починаючи з ID — з якого замовлення почати.

• Що прибирається: лише набори, які забирає шаблон, — категорії з галочкою «Категорії», товари з «Товари», записи довідника атрибутів з «Атрибути».
• Без галочки «Перевірити унікальність записів з урахуванням цього джерела завантаження» під видалення йде все, чого немає на сайті, зокрема товари інших шаблонів.
• З нею записи інших шаблонів лишаються, але товари, заведені руками, з прайс-листів і з парсера видаляються так само.

Як повернути прибране. Полагодьте віддачу на сайті й прогоніть тунель ще раз без галочки видалення: картки створяться заново за тими самими ідентифікаторами сайту. Саме не повернеться:

• ваші ручні правки в картках — вони ніде не зберігаються, крім самої картки;
• зіставлення з прайс-листами — позначка «знайдено в базовому каталозі» з рядків прайсів знімається; ручні пари «рядок прайсу — картка» тунель відновлює сам за ідентифікатором сайту;
• зв'язок рядків замовлень із карткою — назва, артикул, кількість і ціна в документі лишаються, посилання на картку не відновлюється.

Як забрати замовлення з сайту

Увімкніть галочку «Замовлення». Кожне замовлення сайту стане документом «Замовлення покупця»: номер — за вашим нумератором, номер сайту — окремим полем, за ним замовлення впізнаються надалі. Товари лягають рядками: назва, артикул, кількість, ціна й сума.

1

Налаштування розкладу

2

Статуси замовлення

1. Налаштування розкладу — відкриває вікно розкладу завантаження.
2. Статуси замовлення — відкриває вікно зіставлення статусів замовлень.

Сценарії

Переїжджаю в Elbuz і забираю весь каталог

Задача: перенести з працюючого сайту каталог разом зі структурою, фото й характеристиками.

Що ввімкнути: у блоці «Вибір завантаження даних із сайту» лишити «Категорії», «Товари» й «Виробники» і додати «Атрибути» та «Фото». Галочку «Видаляти записи в базовому каталозі, яких немає на сайті» не ставити. Запуск — «Отримати каталог товарів».

Що вийде: картки з'являться в базовому каталозі з ідентифікаторами сайту, наступний запуск їх оновить, а не задвоїть. З каталогу нічого не видалиться; замовлення не приїдуть — для них окрема галочка.

Сайт лишається головним, Elbuz регулярно підтягує зміни

Задача: ціни й наявність ведуться на сайті, а каталог Elbuz має їх повторювати.

Що ввімкнути: розклад запусків. У картках, ціну яких ставите в Elbuz самі, — «Фіксована ціна»; у картках, які від сайту не мають мінятися, — «Не оновлювати».

Що вийде: кожен прогін переписує ціни, активність, наявність і сортування так, як на сайті; картки з позначками зберігають своє. Товари, заведені руками, тунель не оновлює. Якщо ціну пише й оновлення з прайс-листів, лишиться значення того, хто відпрацював пізніше, — чия ціна лишиться.

Замовлення з сайту на OpenCart 3 мають потрапляти в Elbuz

Задача: бачити замовлення сайту документами в Elbuz, не переносячи їх руками.

Що ввімкнути: галочку «Замовлення»; кнопку «Статуси замовлення» — щоб статуси сайту лягали вашими; у розділі «Додатково» — «Група контрагентів» і, якщо стара історія не потрібна, «Завантаження замовлень починаючи з ID».

Що вийде: нові замовлення стануть непроведеними документами «Замовлення покупця», покупці — контрагентами обраної групи. Замовлення з ID, не більшим за вказаний, і без статусу не заберуться. Залишок і резерв не зміняться, доки документ не проведено.

Каталог Elbuz має точно повторювати сайт

Задача: товар, знятий із сайту, має зникати й з базового каталогу.

Що ввімкнути: «Видаляти записи в базовому каталозі, яких немає на сайті»; якщо в каталозі є товари інших шаблонів — ще «Перевірити унікальність записів з урахуванням цього джерела завантаження».

Що вийде: першим кроком прогону приберуться категорії, товари й атрибути, яких не віддав сайт. Товари інших шаблонів лишаться, а заведені руками, з прайс-листів і з парсера — ні. Вмикайте після кількох прогонів з очікуваним числом товарів у журналі — дзеркальний режим.

Що робити, коли тунель не забирає дані

Часті запитання

Навіщо ставити модуль на сайт, чому не підключитися прямо до бази?

Прямий доступ до бази ззовні хостинги майже завжди закривають. Модуль працює на самому сайті, приймає запити від Elbuz за окремим логіном і паролем і вже локально звертається до бази.

Моєї CMS немає в списку — що робити?

Якщо магазин працює на MySQL, оберіть «MySQL (власний SQL-запит)» і заберіть дані своїм запитом — SQL-запити в тунелі. Без доступу до бази тунель не підійде: дивіться універсальний імпорт.

Тунель викачує фотографії на сервер Elbuz?

Ні, береться лише адреса зображення, файл лишається на вашому хостингу. Викачування вмикає послуга «Хмарне зберігання фото».

Повторний запуск задвоїть товари?

Ні. Позиції зіставляються за ідентифікаторами сайту, тож повтор оновлює наявні картки — і перезаписує їх даними сайту. Що саме — у розділі про повторний перенос.

Дзеркальний режим прибрав потрібні товари — як повернути?

Кошика немає. Полагодьте віддачу на сайті й прогоніть тунель ще раз без галочки видалення — картки створяться заново. Ручні правки в них не повернуться (дзеркальний режим).

Чи зменшиться залишок від замовлень, які приїхали з сайту?

Ні. Документ «Замовлення покупця» створюється непроведеним, а залишок і резерв Elbuz рахує лише по проведених документах.

Чи можна через завантаження з Епіцентру забрати товари в каталог?

Ні. Тунель з маркетплейсами не працює, а шаблон «Епіцентр» приносить лише замовлення. Каталог іде у зворотний бік — XML-фідом: імпорт замовлень з Епіцентру і вивантаження каталогу на Епіцентр.

Суміжні теми

• Якщо треба віддати каталог з Elbuz на сайт — вивантаження через Elbuz Tunnel.
• Якщо вашої CMS немає в списку, але база на MySQL — SQL-запити в тунелі.
• Якщо каталог приходить файлом, а не з бази сайту — завантаження готових форматів.
• Якщо завантажили не те і треба знайти зайве — завантажили не те.