Обновление расширения OpenCart

Когда выходит новая версия расширения, модуль сам показывает плашку «Доступна версия …» на своей странице настроек: Расширения → Модули → «ReplAI Feed» → Редактировать.

Обычный путь: кнопка «Обновить»

Нажмите «Обновить» — расширение скачает и установит новую версию само. Статус, токен и ссылка фида сохраняются, в кабинете ReplAI менять ничего не нужно.

Проверить наличие обновлений вручную можно ссылкой «Проверить обновление» рядом с номером версии — модуль делает это и сам, раз в сутки.

Ручное обновление

Нужно, если кнопка выдала ошибку — так бывает на дешёвых хостингах: закрыты исходящие соединения, нет расширения ZipArchive или прав на запись файлов. Текст ошибки покажет причину. Порядок такой:

1. Скачайте свежий replai_feed.ocmod.zip.
2. Проверьте имя скачанного файла — оно должно заканчиваться ровно на .ocmod.zip (см. предупреждение ниже).
3. Расширения → Установка расширений → Загрузить — файлы перезапишутся поверх старых.
4. Если OpenCart пишет, что расширение уже установлено, удалите старую запись в «Установке расширений» (красная кнопка там убирает только файлы, настройки не трогает) и загрузите zip заново.
5. Откройте настройки модуля и убедитесь, что номер версии сверху обновился.
6. Проверьте результат кнопкой «Обновить сейчас» в кабинете ReplAI.

Что делает обновление

Заменяются только файлы самого расширения. Перед перезаписью старые версии копируются в storage/replai_feed_backup/ на вашем хостинге — если что-то пойдёт не так, их можно вернуть.

С версии 1.5.4 обновление идёт по принципу «всё или ничего»: если копию сохранить не удалось или новый файл не записался, модуль сам возвращает прежние файлы и остаётся на своей версии. Нажмите «Обновить» ещё раз или обновите вручную по инструкции выше. Так работают обновления после 1.5.4: переход на саму 1.5.4 идёт ещё по-старому.

Никакие данные магазина (товары, заказы, настройки OpenCart) не затрагиваются.

Версия 1.3.0 — обновитесь вручную один раз

Начиная с 1.3.0 расширение берёт обновления с replai.kg: раньше они лежали на отдельном домене, который мы закрываем. Версии до 1.3.0 про новый адрес не знают — их нужно один раз обновить вручную по инструкции выше.

Дальше всё как обычно: модуль сам проверяет новый адрес раз в сутки, и кнопка «Обновить» работает как прежде.

Версия 1.4.2 — настоящий артикул отдельно от номера товара

Расширение передаёт поле SKU карточки OpenCart отдельно от технических ID товара и выбранных опций. Ссылки фида и старых заказов сохраняются. Поле «Модель» или номер товара вместо незаполненного SKU не подставляются; у выбираемых цветов и размеров не создаётся выдуманный отдельный артикул. Подписи «Кредит», «Рассрочка» и варианты «через банк» в EAN не отправляются как штрихкоды.

После установки убедитесь, что в модуле показана версия 1.4.2, нажмите «Обновить сейчас» в ReplAI и дождитесь полного обхода. Проверьте один товар с заполненным SKU и один с цветами/размерами: цена, остаток и ссылка заказа должны сохраниться, а артикул — соответствовать исходной карточке.

Версия 1.4.3 — «под заказ» и понятные названия опций

Что меняется для магазина:

• Под заказ. Когда товар закончился, расширение передаёт его статус с сайта. «Под заказ», «Предзаказ», «2-3 дня», «Ожидание» агент называет «под заказ» и предлагает оформить через менеджера; «Нет в наличии» и статусы с отрицанием («Недоступен для заказа», «Заказ невозможен») — нет в наличии. Товар с остатком больше нуля по-прежнему в наличии, а вариант с распроданным на сайте цветом или размером — нет в наличии. Подробнее — в инструкции.
• Больше товаров с вариантами. Цвет, размер и память распознаются и в длинных названиях обязательных опций: «Выбрать цвет смартфона», «Встроенная память», «Объём накопителя», «Цвет ремешка», «Цвет картриджа»; а «Размер:» или «— Цвет —» — у любой опции. Товары с такими обязательными опциями раньше скрывались с пометкой «Требуется выбор на сайте» — теперь агент их видит, с ценой и наличием каждого варианта.
• У таких товаров меняются технические ID и ссылки заказа. Если опция впервые стала цветом или размером, вместо прежней записи товара появятся варианты с новыми техническими ID, и в их ссылке заказа будет выбранное значение. Прежние записи снимаются с продажи: без заказов удаляются, с заказами скрываются, старые заказы открываются как прежде. Артикул SKU остаётся у карточки: отдельного артикула у вариантов нет.
• Допы остаются допами. Необязательная опция «Размер защитного стекла», «Цвет чехла» или «Добавить карту памяти» вариантом не становится и не меняет цену и наличие товара. Обязательные «Карта памяти», «Размер рассрочки» и другие опции с признаками допа или оплаты по-прежнему скрывают товар у агента.
• Меньше лишних пометок. «Дополнительная опция на сайте» ставится только у допа, который покупатель может выбрать на сайте. Пустые опции (например «Цвет» без значений) и текстовые поля больше её не дают.
• Без изменений: обязательный выбор, который ReplAI не может сделать за покупателя (оплата, чековая лента, гравировка), по-прежнему скрывает товар у агента. У товаров, где новых цветов и размеров не появилось, технические ID, ссылки заказов и артикулы не меняются.

После установки убедитесь, что в модуле показана версия 1.4.3, нажмите «Обновить сейчас» в ReplAI и дождитесь полного обхода. Проверьте товар с нулевым остатком и статусом «Под заказ» и товар с опцией вроде «Размер:». Варианты, пропавшие из полного снимка, ReplAI убирает сам: без заказов — удаляет, с заказами — скрывает (подробнее).