Переход с версии 1.x

Если у вас стояла версия 1.x, обновитесь как обычно — через «Плагины» или загрузкой нового архива. Настройки переносятся автоматически, и цены остаются прежними. Эта часть рассказывает, что именно переносится, какие сообщения вы увидите и что проверить после обновления.

Перед обновлением #

• Убедитесь, что лицензия действует: «Woodev → Лицензии». Перенос настроек начинается, только когда лицензия действует. До этого способы доставки плагина покупателям не показываются.
• Убедитесь, что ключ DaData указан в настройках версии 1.x. По нему плагин найдёт адрес вашего склада.
• Сделайте резервную копию сайта, как перед любым крупным обновлением.

Как проходит перенос #

Перенос запускается сам, один раз, при первом открытии сайта после обновления. Повторный запуск ничего не меняет, а если перенос прервался, следующий запуск его закончит.

Пока перенос не прошёл, способы доставки этого плагина скрыты. Если включено «Логирование», в журнале причина: «Настройки метода из версии 1 ещё не перенесены: откройте админ-панель, плагин перенесёт их сам». Обычно достаточно открыть любую страницу админки.

Что переносится #

Что было в 1.x	Где это в версии 2
Ключ DaData	«Woodev → Настройки», вкладка «Доставка», раздел «Локация», поле «Токен API DaData». Если ключ там уже указан другим плагином Woodev, он не меняется
Ключ Mapbox, Google или 2ГИС	Подвкладка «Сервисы», строка этого сервиса. В каждом способе доставки выбран этот сервис
Координаты точки отправления	Склад «Основной склад» на подвкладке «Склады». Все способы доставки считают от него
Подсказки адреса, определение города по IP, режим отладки	Общие настройки «Локация» и переключатель «Логирование» на подвкладке «Дополнительно»
Заголовок способа, показ расстояния и времени в названии	Там же, в настройках способа
Способ передвижения и «Избегать»	Там же, в настройках способа
Правила цены	Простая таблица «Цены по расстоянию» или раздел «Цены по правилам (перенесены из версии 1.x)» — см. ниже

Склады, сервисы и ключи теперь живут на странице «Woodev → Настройки», вкладка «Расчёт за расстояние», с подвкладками «Склады», «Сервисы», «Доставка в городе» и «Дополнительно».

Как сохраняются цены #

Чтобы ни одна цена не изменилась, плагин делает три вещи:

• Расстояние по прямой считается как раньше. Коэффициент дороги («коэф.» на подвкладке «Сервисы») после переноса равен 1, а не 1,3, как в новых установках. Хотите приблизить прямую к дороге — увеличьте его сами.
• Склад стоит в тех же координатах. Плагин находит в DaData адрес отправления из ваших настроек, но оставляет координаты из версии 1.x. Так ни одно расстояние не сдвигается.
• Округление как раньше. В поле «Расстояние для расчёта» у перенесённых способов стоит «Округлять до ближайшего целого км» — так считала версия 1.x. У новых способов по умолчанию «вверх».

Ещё два новых поля получают значения, при которых поведение для покупателя не меняется: «Требовать точный адрес» выключено, «Примерная стоимость» — «Показывать под методом».

Уведомление после обновления #

В админке появится уведомление со ссылкой «Открыть настройки». Первая строка — одна из двух:

• «Плагин обновлён до версии 2.0. Склад и цены перенесены автоматически.» — всё перенесено.
• «Плагин обновлён до версии 2.0. Цены перенесены автоматически.» — цены перенесены, а склад нет. Тогда ниже будет предупреждение.

Дальше — только те строки, которые касаются вашего магазина:

• «Для методов с расширенными правилами цены сохранены как есть (методов: N) — менять их не нужно.»
• «Цена зависит от времени в пути у методов: N. Расчёт «По прямой» время не считает, поэтому такие методы не показываются покупателям, пока не подключён сервис расстояний.» — подключите сервис на подвкладке «Сервисы» и выберите его в этих способах.
• «В методах были указаны разные адреса отправления, а расстояние всегда считалось от одной точки. Склад создан по ней — проверьте, что это нужный адрес.» — в версии 1.x адрес в каждом способе был только надписью: расстояние всегда считалось от общих координат. Если вам нужны разные склады, добавьте их и выберите в способах.
• «Ключ Google перенесён. Версия 2 использует Routes API — проверьте ключ кнопкой «Проверить» в разделе «Сервисы»; пока ключ не работает, стоимость считается по прямой.» Для 2ГИС то же с Distance Matrix API. Включите нужный API у сервиса и нажмите «Проверить» — подробнее в части «Сервисы расчёта расстояния и ключи».
• «Подсказки региона и города теперь работают всегда.» — в версии 1.x их можно было выключить, в версии 2 такой настройки нет.
• «Ключ DaData уже указан другим плагином Woodev — он не изменён.»

Уведомление видно, пока вы его не закроете.

Если склад не перенёсся #

Предупреждение звучит так: «Не удалось определить склад по адресу отправления из прежней версии (причина). Пока склада нет, способы доставки не показываются покупателям — добавьте склад.» В скобках — одна из причин:

• «не указан ключ DaData»;
• «DaData не ответила»;
• «DaData не нашла адрес отправления»;
• «DaData нашла другое место, чем то, от которого считались цены» — адрес в настройках и координаты были далеко друг от друга, больше чем на километр;
• «в методах не был указан адрес отправления»;
• «координаты точки отправления не были сохранены»;
• «адрес не подошёл для склада».

Что делать: перейдите по ссылке «добавьте склад» и добавьте склад вручную, как описано в части «Склады и настройки способа доставки». Первый склад станет основным, и все способы доставки начнут считать от него.

Правила цены: простая таблица или «Цены по правилам» #

В версии 1.x цена задавалась правилами с условиями. Версия 2 для каждого способа проверяет: можно ли записать его правила простой таблицей так, чтобы на любом расстоянии цена получилась такой же?

• Можно — способ получает обычную таблицу «Цены по расстоянию».
• Нельзя — например, в правилах есть условия по весу, сумме заказа, количеству товаров или времени в пути. Тогда правила остаются как были, в разделе «Цены по правилам (перенесены из версии 1.x)».

Подсказка у заголовка раздела: «Правила из версии 1.x, перенесённые при обновлении, чтобы цены не изменились. Их можно править; новые способы доставки работают по простой таблице.»

Как устроен раздел «Цены по правилам» #

• Каждое правило — «Правило 1», «Правило 2» и так далее.
• «Если:» — условия. Условие проверяет расстояние (км), время в пути (мин), вес заказа, сумму заказа или количество товаров, с границами «от» и «до». Условия соединяются кнопками «+ и» и «+ или».
• «Цена:» — сумма, при желании «за» километр или минуту и «× количество товаров».
• «Дальше правила не проверять» — если правило сработало, следующие не проверяются.
• «Скрыть доставку» — если правило сработало, способ доставки не показывается.
• «+ Добавить правило» добавляет правило, значки рядом удаляют правило или условие.

Правила можно править и сохранять, как раньше. Если в правиле ошибка, плагин не сохранит правила и скажет, что не так, например: «Цены по правилам, правило 2: добавьте хотя бы одно условие. Правила не сохранены.»

Как перейти на простую таблицу #

Над правилами написано одно из двух:

• «Эти правила можно превратить в простую таблицу без изменения цен.» — тогда внизу есть кнопка «Перейти на простую таблицу». Она появляется, пока вы не меняли правила: плагин проверил именно сохранённые.
• «Эти правила нельзя превратить в простую таблицу без изменения цен.» — тогда внизу кнопка «Начать заново с простой таблицы». Плагин спросит: «Правила версии 1.x будут отключены, а цены начнут считаться по новой простой таблице. Начать заново?» После этого заполните таблицу «Цены по расстоянию» и сохраните.

Оставлять правила как есть — нормально. Переходить на таблицу стоит, когда вы хотите поменять цены и вам удобнее простая таблица.

Что проверить после обновления #

1. Прочитайте уведомление и сделайте то, о чём оно просит.
2. Откройте подвкладку «Склады»: склад есть, адрес верный.
3. Откройте подвкладку «Сервисы»: если в версии 1.x был ключ сервиса, нажмите «Проверить».
4. Откройте каждый способ доставки «Стоимость за расстояние» и сохраните его, если всё в порядке.
5. Оформите тестовый заказ на знакомый адрес и сравните цену с прежней.

Если способ доставки пропал у покупателей, откройте часть «Если способ доставки не показывается».

Резервная копия и возврат на 1.x #

Перед тем как изменить способ доставки, плагин сохраняет копию его прежних настроек — отдельно для каждого способа. Общие настройки версии 1.x тоже остаются в базе нетронутыми. Итог переноса записывается в журнал плагина, даже если «Логирование» выключено.

Возвращаться на версию 1.x мы не советуем: перенесённые настройки версия 1.x читает неправильно. Если без возврата не обойтись, напишите в поддержку — мы поможем восстановить прежние настройки способов из сохранённых копий.

Остались вопросы? #

Напишите в поддержку — она входит в лицензию.