Документация Сообщения ВКонтакте

Документация

Лицензионный ключ отправляется автоматически на почту аккаунта покупателя, если письма Вы не нашли, проверьте папку спам, если письмо в спаме, то пожалуйста поставьте отметку не спам. При отсутствии ключа в папке спам напишите в поддержку. Подробная информация о получении файлов и ключа по ссылке.

 

Установка:

1. Разархивируйте архив
2. В админ панели сайта меню Дополнения - Установка дополнений - Загрузите архив artvk.ocmod.zip
3. Меню Менеджер дополнений (Модификации) - обновите кэш модификаций
4. Установите модуль в разделе Админ панель - Дополнения - Модули - ART&PR Сообщения ВКонтакте (при отсутвии данного модуля в меню воспользуйтесь установкой вручную описанной ниже)
5. Зайдите в настройки модуля (ссылка Изменить)
6. Введите настройки. (Если Вы не получили лицензионный ключ, то запросите его по ссылке).
7. Включить модуль (статус включено). Сохранить настройки.
8. Для магазинов 3.0 Очистите кеш шаблонов (главная страница админ панели -> шестеренка справа вверху)

Установка вручную:

1. Разархивируйте архив
2. Разархивируйте архив artvk.ocmod.zip, внутри папка upload и файл install.xml
3. С помощью файлового доступа к сайту (ftp или ssh) загрузите все содержимое папки upload в корень сайта
4. Для магазинов 2.0-2.1 Переименуйте install.xml в artvk.ocmod.xml
5. В админ панели сайта меню Дополнения - Установка дополнений - Загрузите файл artvk.ocmod.xml
6. Меню Менеджер дополнений (Модификации) - обновите кэш модификаций
7. Установите модуль в разделе Админ панель - Дополнения - Модули - ART&PR Сообщения ВКонтакте (ВНИМАНИЕ! отсутствие данного пункта может быть свзяно с отсутвием языка модуля, копируйте папку языка из архива в свою папку языка, либо вы произвели копирование файлов не корректно)
8. Зайдите в настройки модуля (ссылка Изменить)
9. Введите настройки. (Если Вы не получили лицензионный ключ, то запросите его по ссылке)
10. Включить модуль (статус включено). Сохранить настройки.
11. Для магазинов 3.0 Очистите кеш шаблонов (главная страница админ панели -> шестеренка справа вверху)

Настройка:

1. Создайте сообщество вконтакте
2. Меню сообщества Управление - работа API скопируйте и вставьте в настройки модуля ключ доступа (ключ должен быть с правами СООБЩЕНИЯ СООБЩЕСТВА)
3. ID сообщества можно найти в адресной строке браузера посетив страницу сообщества (последние цифры в строке)
4. ID администратора можно найти на странице профиля ВКонтакте в разделе Управление VK ID - Личные данные
5. Для получения уведомления администаром обязательно разрешите сообщения от сообщества (зайдите на страницу сообщества Меню ЕЩЕ - разрешить сообщения)
6. Для получения уведомлений покупателем ему необходимо подписаться на уведомления, для возможности подписки выведите блок модуля для подписки на нужной схеме (отображдается только зарегистрировыанным покупателям), для этого зайдите в ажмин панели сайта в раздел Дизайн - Схемы (Макеты) - выбирете нужное схему и включите на ней модуль  ART&PR Сообщения ВКонтакте
7. После того как покупатель нажмет получатть уведомления он сможет получать автоматические сообщения от вашего сайта.

 

Обновление на новую версию:

1. Создайте резервную копию базы данных и файлов сайта
2. Для магазинов 2.0-2.1 Удалите модификатор модуля
3. Установите модуль согласно инструкции УСТАНОВКА выше с перезаписью файлов (не забудте обновить модификаторы и кеш шаблона)
4. Внимание! Обязательно пересохраните настройки.

 

Инструкция по работе:

 

1. При смене статуса или создания заказа отправляется сообщение созданное Вами в настройках модуля
2. Вы можете использовать разные сообщения для разных статусов а также в зависимости от Нового заказа или смены статуса уже созданного заказа.
3. В настройках модуля добавьте нужное сообщение нажатием на кнопку "карандаш", введите текст, сохраните настройки.
4. В тексте комментариев Вы можете использовать переменные из заказа указанные ниже в разделе Переменные.

Не работает отправка сообщения:

Включите режим отладки в настройках модуля (Отладка - да)
Смените статус у заказа на тот для которого настроены уведомления
Смотрите журнал ошибок магазина на предмет записи artvk Debug:

 

Использование шаблонов с сылками на оплату:

Функционал доступен только для магазинов 2.3 и 3.0.
Теперь вы можете использовать ссылки на оплату для формирования шаблона с использованием переменной ~paylink~
эта переменная работает только когда в заказе установлен метод оплаты ART&PR с возможностью генерации ссылок.

 

Переменные и использование полей из Simple:

Свои поля стандартного оформления заказа

Расположение Адрес оплаты
~payAddrCustom_IDПОЛЯ~

Расположение Адрес доставки
~shipAddrCustom_IDПОЛЯ~

Расположение Аккаунт
~accCustom_IDПОЛЯ~

ID поля можно найти в адресной строке браузера при редактировании поля.

 

Свои поля simple

ID поля берется из вкладки "Настройка полей"

Для Simple 4.x
~paymentsimple4_IDполя~ - поле привязанное к адресу оплаты
~shippingsimple4_IDполя~ - поле привязанное к адресу доставки
~simple4_IDполя~ - поле привязанное к учетной записи покупателя или поле привязанное к методу

Выбор отображения отчества покупателя
Пример: 
Отчество: ~simple4_otchestvo~

 

Сторонние модули (работает в эксперементальном режиме):

Трек-номер заказа (toporchillo):
переменная ~track_no~ - добавляет номер накладной при условии что он существует в заказе.

 

Перемененная ~status_comment~ добавляет текст комментария из данного обновления статуса (например модули оплаты добавляют свои комментарии или вы вручную вписали текст комментария через просмотр заказа и добавление истории, или модули доставки которые меняют статус и добавляют в комментарий трек номер, теперь эти данные можно отправить в сообщении)

Также доступны переменные:
~order_id~ - номер заказа
~totals~ - итого заказа в валюте заказа
~products~ состав заказа
~dateNumOrder~ - дата заказа в формате 20.12.2021
~status_update~ - имя статуса на который происходит смена
~invoice_no~ - номер счета 
~invoice_prefix~ - префикс счета 
~store_id~ - id магазина 
~store_name~ - название магазина 
~store_url~ - url магазина 
~customer_id~ - id покупателя 
~customer_group_id~ - id группы покупателя
~fax~ - факс 
~email~ - почта 
~payment_firstname~ - имя плательщика 
~payment_lastname~ - фамилия плательщика 
~payment_company~ - компания плательщика 
~payment_address_1~ - адрес плательщика 
~payment_address_2~ - адрес2 плательщика 
~payment_postcode~ - индекс плательщика 
~payment_city~ - город плательщика 
~payment_zone_id~ - id гео зоны плательщика 
~payment_zone~ - гео зона плательщика 
~payment_zone_code~ - код зоны плательщика 
~payment_country_id~ - id страны плательщика 
~payment_country~ - страна плательщика 
~payment_iso_code_2~ - iso код плательщика 
~payment_iso_code_3~ - iso код плательщика 
~payment_address_format~ - формат адреса плательщика 
~payment_method~ - метод оплаты 
~payment_code~ - код оплаты    
~shipping_firstname~ - имя для доставки 
~shipping_lastname~ - фамилия для доставки 
~shipping_company~ - компания для доставки 
~shipping_address_1~ - адрес доставки 
~shipping_address_2~ - адрес2 доставки 
~shipping_postcode~ - индекс для доставки 
~shipping_city~ - город доставки 
~shipping_zone_id~ - id гео зоны доставки 
~shipping_zone~ - гео зона доставки 
~shipping_zone_code~ - код зоны доставки 
~shipping_country_id~ - id страны доставки 
~shipping_country~ - страна доставки 
~shipping_iso_code_2~ - iso код доставки 
~shipping_iso_code_3~ - iso код доставки 
~shipping_address_format~ - формат адреса доставки 
~shipping_method~ - метод доставки 
~shipping_code~ - код метода доставки 
~comment~ - комментарий 
~total~ - итого (из базы данных) 
~order_status_id~ - id статуса заказа 
~order_status~ - статус заказа зи базы данных (предыдущий статус)
~language_id~ - id языка 
~language_code~ - код языка 
~language_filename~ - файл языка 
~language_directory~ - дирректория языка 
~currency_id~ - id валюты 
~currency_code~ - код валюты 
~currency_value~ - курс валюты 
~ip~ - ip 
~forwarded_ip~ - переадресованный ip 
~user_agent~ - юзер агент 
~accept_language~ - язык 
~date_modified~ - дата изменения заказа 
~date_added~ - дата создания заказа

 

Использование из сторонних модулей:
Вызвать модель модуля можно из сторонних модулей, это позволит отправить сообщение указав текст и номер телефона (код страны обязателен) .
$this->load->model(extension/module/artvk);
$this->model_extension_module_artvk->startWaMessager('text', 'phone')