ВКонтакте: Товары

Посмотреть в магазине Webasyst

Плагин "ВКонтакте: Товары" предназначен для экспорта и автоматической актуализации товаров вашего магазина в сервис "Товары"социальной сети ВКонтакте. Основные возможности плагина:

• Массовая публикация товаров магазина
• Публикация товаров по одному из карточки товара в администартивной части магазина
• Автоматическая актуализация ранее сделанных публикаций
• Публикация с использованием цен и валют в соответствии с настройками выбранной витрины
• Удаление товаров из сообщества ВКонтакте
• Произвольное формирование шаблона описания товаров для публикации
• Использование UTM-меток в ссылках на страницу товара на выбранной витрине магазина
• Множество других настроек

Подготовка к работе с плагином

Для корректной работы плагина и обмена информацией с серверами ВК, необходимо создать приложение ВКонтакте с типом Веб-сайт. Подробная инструкция по созданию такого приложения содержится в этой статье.

Настройки плагина

Раздел настроек плагина находится в разделе Магазин -> Плагины -> Настройки -> ВКонтакте: Товары. Ниже приведен полный перечень настроек с описанием каждой из них.

• ID приложения ВКонтакте. В данном поле необходимо указать идентификатор (ID) созданного вами приложения ВКонтакте с типом Веб-Сайт. Подробнее о создании такого приложения тут.
• Защищенный ключ приложения. Здесь необходимо указать защищенный ключ вашего приложения ВК. Информация берется из соответствующего поля в настройках вашего приложения в ВК
• Размер эскиза. В данном поле необходимо указать размер изображений которые будут передаваться в ВК для публикации в сервисе Товары. Число может быть произвольным, на ваше усмотрение. Я бы рекомендовал использовать значения от 750 до 1000 пикселей. Указывать большее значение, на мой взгляд, смысла не имеет, т.к. ВК все равно "ужимает" принимаемые изображения до каких-то своих размеров, которые не известны. Имеет смысл указать такое значение, которое используется вашей темой дизайна. Это позволит избежать генерации изображений другого размера, и, как следствие, сэкономить место на хостинге. Если же у вас указан размер эскиза который отсутствует в системе, то плагин автоматически сгенерирует изображение с размером указанным в данной настройке.
• Отложенные публикации вместе с автоматическим обновлением. Если опция включена, то при запуске автоматического обновления плагин проверит есть ли товары ожидающие публикации, и если такие есть, то опубликует их. Подробнее о настройке автоматического обновления написано в соответствующем разделе данной статьи.
• Публикация товаров которых нет в наличии. При включенной опции плагин не будет учитывать наличие товара на сладе и произведет публикацию. Если же опция выключена, то товары отсутствующие на складе не будут опубликованы. При обновлении (ручном или автоматическом) если данная опция выключена, то плагин автоматически удалит все ранее сделанные публикации такого товара из всех сообществ ВК в которых он был опубликован.
• Публикация товаров с нулевой ценой. При включенной опции товары с ценой равной нулю будут опубликованы в ВК. При этом цена будет установлена равной единице, т.к. ВКонтакте не принимает к публикации товары с нулевой ценой.
• Помещать товары которые не удалось опубликовать в список. При публикации товаров в ВК возможны различные ситуации. Например, размер изображения не соответствует установленным ВК ограничениям, и такой товар не может быть опубликован. Или же, произошел сбой на сервере API ВКонтакте, и плагину не удалось отправить/получить необходимые данные. Если эта опция включена, то у вас появится возможность автоматически добавить товары при публикации которых произошли те или иные сбои с список товаров магазина (Магазин -> Товары -> Списки) для дальнейшего ознакомления и, возможно, повторной публикации. При включенной опции станет доступна следующая опция Список, в которой вам необходимо указать в какой именно из имеющихся списков необходимо помещать такие товары. Список должен быть предварительно создан. Создать новый список со страницы настроек плагина ВКонтакте: Товары невозможно.
• Список. см. предыдущий пункт.
• Переводы строк. Т.к. в разных магазинах возможно разное форматирование описания, с использованием разных тегов и правил, а ВК не принимает описание в формате HTML, то перечень тегов и прочих наборов символов которые при экспорте следует преобразовывать в перевод строки выведен в настройки плагина.
• Выбор цены товара. Эта опция может быть востребована если у товаров вашего магазина есть более 1 артикула. Например, это может быть одежда. У таких товаров цена на каждый из артикулов может различаться. И в таком случае в ВКонтакте будет передаваться именно та цена, которая указана в данной настройке. При публикации цены товара учитывается валюта в которой товар опубликован на указанной витрине.
• Характеристики. Выбор перечня характеристик товара, которые будут включены в описание при публикации в ВК.
• Разделитель характеристик. В случае когда у товара есть несколько выбранных для публикации характеристик, вы можете выбрать один из разделителей: запятая, точка с запятой, перевод строки.
• Шаблон описания товара ВКонтакте. Описание для каждого экспортируемого в ВК товара формируется на основе шаблона. Шаблон может содержать в себе произвольный текст который будет передан в ВК а так же ряд переменных, которые при публикации будут автоматически заменены на соответствующие значения. Шаблон указанный в настройках плагина будет использован при осуществлении автоматического обновления, а так же будет предлагаться по умолчанию в диалоговых окнах при ручной публикации товаров или при формировании перечня отложенных публикаций (эти режимы работы будут рассмотрены далее). В шаблоне описания товара допускается использование следующих переменных:
  
  • %url%. При публикации эта переменная будет автоматически заменена на URL товара на выбранной при осуществлении экспорта витрине. Если вы хотите добавить в ссылку UTM-метки, то просто добавьте их после переменной %url%. Например, в шаблоне это может выглядеть так: Посмотреть: %url%?utm_source=vkgoods&...
  • %name%. Название товара.
  • %tags%. Тэги товара. При публикации товара в ВК тэги товара присвоенные ему в магазине будут автоматически преобразованы в хэштеги ВКонтакте.
  • %summary%. Краткое описание товара
  • %features%. Характеристики товара
  • %desc% Полное описание товара
  • %id%. ID товара в ShopScript. Эта переменная не описана, но при необходимости может быть использована

Начало работы

После заполнения всех обязательных полей, а так же выбора необходимых режимов работы плагина на странице его настроек, необходимо авторизоваться в ВК от имени созданного вами приложения ВК с использованием необходимого аккаунта ВКонтакте. Для этого перейдите на страницу Импорт/экспорт в приложении Магазин и выберите в левом столбце ВКонтакте: Товары. В открывшемся окне будет всего одна кнопка Авторизоваться, нажав на которую откроется окно ВК в котором вы должны будете подтвердить свои действия. После этого страница будет автоматически перезагружена и примет вид представленный на рисунке. Если по каким-то причинам вам не удалось авторизоваться, и ВКонтакте выдал сообщение об ошибке, то ознакомьтесь со статьями описывающими ошибки авторизации в ВК и следуйте предложенным там рекомендациям. Если вы не нашли описание возникшей у вас ошибки авторизации, напишите в нашу службу поддержки и мы постараемся оперативно решить вашу проблему.

На данной странице доступны некоторые режимы работы плагина (будут рассмотрены далее) а так же статистическая информация об общем количестве товаров в магазине, количестве опубликованных в ВК товарах, количестве товаров ожидающих публикации, дате последнего полного автоматического обновления и пр.

Так же на этой странице есть возможность изменить аккаунт ВК от имени которого будут осуществляться все действия с товарами в сервисе ВКонтакте. Помните, что возможность публикации, обновления и пр. в ВК зависит от прав пользователя ВКонтакте, от имени которого вы произвели авторизацию на этой странице.

Режимы работы плагина

У плагина ВКонтакте: Товары есть 5 основных режимов работы. Рассмотрим каждый из них отдельно.

Публикация отдельного товара

При "входе" в карточку товара в административной части магазина в режиме просмотра, вам становится доступен блок для публикации/обновления/удаления товара в сервисе Товары социальной сети ВКонтакте (см. рис.). Состав и доступность кнопок в блоке ВКонтакте: Товары может отличаться в зависимости от условий. Так. например, если товар еще не был опубликован, то будет доступна только одна кнопка Опубликовать. Если товар был опубликован ранее, но при этом был отредактирован уже после осуществления публикации в ВК, то станет доступной кнопка Обновление. И т.д.

При нажатии кнопки Опубликовать откроется окно в котором необходимо указать параметры экспорта товара. Рассмотрим каждый из них отдельно.

Витрина. Необходимо выбрать витрину на которую будут проставляться ссылки. Даже если вы не планируете использовать ссылку на товар в магазине, витрину все равно необходимо указать, т.к. эти данные будут использованы плагином в дальнейшем. Например, при обновлении, в случае если вы все же надумаете указать ссылку на данный товар в вашем магазине в дальнейшем.

Сообщество ВКонтакте. Здесь необходимо выбрать сообщество (группу) ВКонтакте в раздел Товары которой будет произведена публикация. Обратите внимание, в предложенном перечне сообществ будут отображены только те, в которых пользователь ВК от имени которого была произведена авторизация является администратором, редактором или модератором. Если вы выберете сообщество в котором сервис Товары недоступен - система предупредит вас об этом. О том как включить сервис Товары в сообществе ВКонтакте можно прочитать в этой статье.

Категория товаров. Каждый товар помещаемый в ВК должен быть отнесен к одной из стандартных категорий. Перечень таких категорий устанавливает ВК и не может быть изменен. Вам необходимо выбрать из предложенного перечня к какой из категорий отнести публикуемый вами товар.

Подборка товаров. В рамках сервиса Товары можно организовать подборки товаров. Это сделано с целью облегчения навигации вашим потенциальным покупателям. По большому счету, это некий аналог категорий в ShopScript, но с некоторыми отличиями. Основное отличие - подборки в ВК не могут быть вложенными как категории. В данной опции вам необходимо выбрать в какую из уже существующих подборок поместить публикуемый товар, или же при публикации создать новую подборку. Если вы создаете новую подборку, то так же необходимо указать ее название (Название подборки).

Выгружать все фото товаров. У каждого товара в ВК может быть не менее 1 и не более 5 изображений. В данном пункте вам надо выбрать, выгружать ли только первое изображение товара, или же выгрузить первые 5 изображений (при их наличии)

Устанавливаемая цена товара. Опция идентичная соответствующей опции в настройках плагина. Может быть востребована если у товаров вашего магазина есть более 1 артикула. Например, это может быть одежда. У таких товаров цена на каждый из артикулов может различаться. И в таком случае в ВКонтакте будет передаваться именно та цена, которая указана в данной настройке. При установке цены используется валюта и значение той цены, которая выбрана в настройках публикации товаров.

Шаблон описания товара в ВКонтакте. По умолчанию вам будет предложен тот шаблон, который вы сохранили в настройках плагина. Здесь вы можете его изменить, и эти настройки никак не повлияют на шаблон указанный в настройках. Шаблон может содержать в себе произвольный текст который будет передан в ВК а так же ряд переменных, которые при публикации будут автоматически заменены на соответствующие значения. Шаблон указанный в настройках плагина будет использован при осуществлении автоматического обновления, а так же будет предлагаться по умолчанию в диалоговых окнах при ручной публикации товаров или при формировании перечня отложенных публикаций (эти режимы работы будут рассмотрены далее). В шаблоне описания товара допускается использование следующих переменных:

• %url%. При публикации эта переменная будет автоматически заменена на URL товара на выбранной при осуществлении экспорта витрине.
• %name%. Название товара.
• %tags%. Тэги товара. При публикации товара в ВК тэги товара присвоенные ему в магазине будут автоматически преобразованы в хэштеги ВКонтакте.
• %summary%. Краткое описание товара
• %desc% Полное описание товара
• %id%. ID товара в ShopScript. Эта переменная не описана, но при необходимости может быть использована

После выбора необходимых настроек вам останется лишь нажать кнопку Опубликовать и ваш товар появится в сервисе товаров ВК в соответствии с заданными вами настройками.

Кроме возможности публикации товара, в данном режиме вы можете обновить ранее сделанные публикации или удалить их. Для этого необходимо воспользоваться соответствующими кнопками в блоке ВКонтакте: Товары. При обновлении публикаций используются базовые настройки указанные в настройках плагина. Режим удаления публикаций дополнительных настроек не имеет. Режимы обновления и удаления произведут обновление/удаление публикаций товара во всех сообществах в которых этот товар был ранее опубликован. Если вам необходимо обновить информацию только в одном из сообществ, то следует воспользоваться режимом публикации, в настройках которого выбрать нужное сообщество. В этом случае плагин "увидит" что ранее этот товар в этом сообществе публиковался и обновит его.

Массовая публикация категорий, типов и перечней по тегам и прочих списков товаров

Для начала работы в режиме категорий/списков/типов и пр. вам необходимо в административной части магазина в разделе Товары выбрать необходимую вам категорию/список/тип и т.п. (см. рис). Если у вас включен "плиточный" режим просмотра, то удобнее переключить режим просмотра на "список". Это можно сделать над заголовком таблицы соответствующей кнопкой (отмечено на рисунке). После этого достаточно либо выбрать интересующие вас товары, или, если вы хотите экспортировать категорию целиком, поставить галочку в заголовке таблицы и автоматически выделятся все товары. Количество выделенных товаров вы всегда можете увидеть в правой верхней части экрана рядом с блоком Экспорт. Все выделенные товары вы сможете опубликовать в ВКонтакте или прямо сейчас или позже. Для этого после выделения необходимых товаров необходимо нажать на ссылку ВК: Товары, расположенную в блоке Экспорт в правой верхней части экрана (отмечено на рисунке).

После нажатия на эту ссылку откроется окно идентичное описанному в режиме работы Публикация отдельного товара. Там будут представлены точно такие же опции. Разница будет заключаться лишь в том, что кроме возможности тут же опубликовать будет еще возможность добавить эти товары в Отложенные публикации. При нажатии на кнопку Отложенная публикация выбранные товары будут сохранены в БД вместе с выбранными вами настройками. Опубликовать отложенные товары вы сможете в дальнейшем либо автоматически, либо на странице плагина в разделе Импорт/экспорт.

Режим Автоматической публикации новых товаров категорий

Использование этого режима позволит вам полностью автоматизировать процесс публикации товаров вашего магазина в ВКонтакте! Для настройки автоматической публикации новых товаров категории необходимо задать настройки экспорта в диалоговом окне настройки категории

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

Режим отложенных публикаций

Экспорт отложенных публикаций в ВКонтакте может быть осуществлен в двух режимах: ручном и автоматическом. Автоматический режим публикаций предусматривает использование планировщика заданий. В большинстве случаев, в т.ч. и в облачном хостинге Webasyst, это планировщик заданий Cron. Т.к. режим автоматических публикаций совмещен с режимом автоматического обновления ранее сделанных публикаций, то подробнее он будет рассмотрен в соответствующем разделе.

Вручную ж сделать отложенные публикации можно со странице плагина в разделе Импорт/экспорт (см.рис).

Для этого необходимо лишь нажать кнопку Опубликовать отложенные товары. Публикации будут осуществляться в соответствии с выбранными при добавлении товаров в отложенные публикации настройками.

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

Кроме этого,здесь доступен режим удаления товаров из сообщества ВКонтакте.

Удаление товаров из сообщества ВКонтакте.

Плагин ВКонтакте: Товары предоставляет возможность автоматического удаления товаров из сообщества ВКонтакте. Этот режим доступен на странице плагина в разделе Импорт/экспорт. После нажатия на кнопку Менеджер удаления откроется окно, в котором необходимо выбрать параметры удаления товаров из ВК (см. рис.). Плагин предоставляет следующие режимы удаления:

• Товары из выбранной подборки. Плагин удалит все товары из указанной вами подборки. Обратите внимание! Если товар содержится и в других подборках, то он будет удален и оттуда. Происходит полное удаление товаров относящихся к выбранной подборке из сервиса Товары ВК.
• Все товары опубликованные плагином в выбранном сообществе. При выборе этой опции из сообщества будут удалены все товары публикация которых производилась с помощью плагина ВКонтакте: Товары.
• Удалить все товары в выбранном сообществе. При выборе этого режима удаления из сообщества будут удалены все товары.

Выбор сообщества из которого необходимо производить удаление товаров осуществляется в этом же диалоговом окне.

Режим автоматического обновления публикаций и автоматического экспорта отложенных публикаций.

Автоматическое обновление (актуализация) ранее сделанных публикаций осуществляется с использованием планировщика заданий вашей операционной системы. В большинстве случаев это планировщик CRON. Для включения этой функции вам необходимо добавить в ваш планировщик заданий команду вида

[путь до PHP интерпретатора]/php [путь до установки фреймворка Webasyst]/cli.php shop vkgoodsPlugin

Эта же команда, но с уже подставленным путем до установки фреймворка Webasyst доступна на странице плагина в разделе Импорт/экспорт. Путь до php-интерпретатора вы можете уточнить у своего хостинг-провайдера.

Автоматический экспорт отложенных публикаций будет запускать вместе с автоматическим обновлением в случае если в настройках плагина у вас включена соответствующая опция (см. раздел Настройки плагина данной документации).

По завершении каждого вызова команды обновления в папке ./wa-log/shop/plugins/vkgoods/ создается лог-файл vkgoods.update.log который вы можете самостоятельно просмотреть используя бесплатное приложение Логи.

Просмотр неопубликованных товаров

Находясь в любом перечне товаров в разделе Товары вы можете получить перечень товаров которые еще не опубликованы в ВКонтакте. Для этого находясь в каком-либо перчене (список, категория, все товары и пр) необходимо нажать на кнопку Неопубликованные товары .

Сразу после нажатия на экране появится перечень товаров, которые еще не опубликованы в ВКонтакте

С этим перечнем возможно совершать все штатные операции, предусмотренные в ShopScript, в том числе и публикация этих товаров в ВКонтакте.

Некоторые особенности, которые стоит учитывать при работе с ВКонтакте

• ВКонтакте позволяет опубликовать не более 15000 товаров в одном сообществе
• В одной подборке ВК можно опубликовать не более 1000 товаров
• Размер публикуемых изображений не должен быть менее 400 точек для наименьшей и 7000 точек для наибольшей стороны. Так же не допускаются к публикации изображения соотношения сторон которых слишком велики (точная цифра не опубликована)
• Публикация одного товара с одним изображением занимает в среднем около 2-3 секунд, в зависимости от различных факторов (скокрость канала и т.п.). На публикацию каждого дополнительного изображения к товару уходит около 1-2 секунд. Исходя из этих цифр, можно сделать приблизительный прогноз времени публикации товаров. Старайтесь не публиковать очень большое количество товаров за один раз. Эти временные рамки установлены правилами ВКонтакте и их, к сожалению, никак не обойти.

Если у вас что-то не получается или возникают ошибки

Если у вас остались какие-то вопросы, или не удается опубликовать товары в сообществе ВК, вы всегда можете обратиться в нашу службу поддержки. В большинстве случаев при неудачных публикациях плагин ВКонтакте: Товары создает лог-файл, расположенный в папке ./wa-log/shop/plugins/vkgoods/vkgoods.log. По возможности, прикрепляйте его к обращению в службу поддержки. В этой же папке создается лог-файл автоматического обновления. Он называется vkgoods.update.log. Этот и другие лог-файлы удобно просматривать с помощью бесплатного приложения Логи.