Комплексный XLS импорт-экспорт товаров COMIEL (JoomShopping)

Документация по установке, настройке и решению возможных проблем с расширением Комплексный импорт-экспорт XLS файлов из/в магазин JoomShopping.

Установка производится через панель управления "Установка и Обновление" самого JoomShopping, как обычный аддон.
(/administrator/index.php?option=com_jshopping&controller=update)

Ввода ключа осуществляется здесь ВАШСАЙТ/administrator/index.php?option=com_jshopping&controller=addons

Разберем для начала возможности. Каждую колонку рассмотрим позднее.

Импорт товаров из файла XLS, XLSX, CSV

Для импорта можно использовать файлы сделанные в MS Excel 2003/2010, CSV .

Поддерживаемые кодировки: UTF-8

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

Для импорта не важно в какой последовательности вы будете заполнять столбцы. Наличие столбцов минимум = 2. Один зависит от метода обновления (см. след. пункт). Второй - что обновлять (цена или количество или изображение и т.д.).

Методы обновления товаров - ID, Коду, Название.

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

Поддержка вложенности категорий.

Можно указывать неограниченную вложенность категорий, даже если родительских категорий еще не существует.

Поддержка зависимых атрибутов (каждый к каждому)

Позволяет создавать комбинирование атрибутов для товара. То есть указывая два цвета (Красный и черный) и два размера (56 и 62) будет создано 4 зависимых атрибута:

Красный + 56
Красный + 62
Черный + 56
Черный + 62

Поддержка независимых атрибутов

Позволяет использовать независимые атрибуты с указанием изменения цены

Возможность депубликации всех товаров перед импортом.

Используется в основном для полного обновления списка товаров. Например если в новом прайсе отсутствует позиция которая ранее была опубликована. И чтобы не сверять множество позиций достаточно снять с публикации все товары и после импорта опубликованными останутся только те, что указаны в новом прайсе.

Изменение размеров изображений

В случае импорта изображений, можно указать необходимость изменения размера изображений согласно настройкам JoomShopping.

Создание псевдонимов (Alias)

В случае отсутствия псевдонима у товара, производителя или категории, Импорт позволяет сформировать его согласно стандартным правилам транслитерации Joomla.

На листе импорта (первый лист файла) могут быть формулы, импортируются только результаты вычислений.

Теперь нет необходимости вручную заполнять значения для колонок. Можно использовать любые формулы MS Excel. Импортироваться будет только то что Вы видите в самом файле. Можно использовать второй лист для основных данных (например цена закупки), а на первом листе написать формулу =закупка*процент накрутки.

ВНИМАНИЕ !
НЕ ИСПОЛЬЗУЙТЕ форматирование ячеек (цвет, рамки. особые шрифты и т.д.) это может влиять на импорт.

Теперь разберем каждую колонку импорта более подробно:

id: ID товара можно узнать несколькими способами. Самый сложный это зайти в таблицу товаров в базе. Самый простой это в админке в списке товаров. Самая правая колонка это и есть id товара.
Могут использоваться любые целые числа.

ean: Это код товара. Или другим словом - Артикул в вашем магазине. Он существует у каждого товара, для идентификации. Так называемый второй id.
Может быть использовано любое слово.

manufacturer_code: Это код товара производителя. Или другим словом - Артикул производителя. Он существует у каждого товара, для идентификации и связки вашего кода с кодом производителя.
Может быть использовано любое слово.

name: Название товара. При импорте название присваивается к тому языку, который установлен по умолчанию.
Может быть использовано любое слово.

alias: Псевдоним товара. Сам по себе псевдоним не обязателен, но если Вы хотите видеть в адресной строке красивое название, то лучше заполнять. Например если значение пустое, то адресная строка будет выглядеть так: домен.рф/product/153/65, где 153 категория, а 65 id товара. Если значение заполнено, то адресная строка будет выглядеть так: домен.рф/категория/товар.
Может быть использовано любое слово.

short_description: Краткое описание товара. Показывается в категории в списке товаров.
Может быть использован любой текст.

description: Полное описание товара. Показывает в карточке товара.
Может быть использован любой текст.

meta_title: Именно этот текст будет отображаться в выдаче поисковой системы, поэтому ему надо уделить максимум внимания.
Может быть использован любой текст.

meta_keywords: Ключевые слова. Колонка должна состоять из ключевых слов и фраз. Желательно проследить за тем, чтоб ключевые слова отличались для каждого товара.
Может быть использован любой текст.

meta_description: Описание страницы. Можно его назвать расширенным описанием meta_title.
Может быть использован любой текст.

qty: Количество товара на складе. Если используются зависимые атрибуты или неограниченное количество, то использовать данную колонку не нужно.
Могут использоваться любые целые числа.

unlimited

Неограниченное количество. Чаще всего используется при продажах электронных товаров или под заказ.
Могут использоваться:

1 (Неограниченное количество)
0 (Количество товара ограничено значениями количество товара или зависимыми атрибутами)

publish

Публикация товара. Используется если необходимо опубликовать товары. По умолчанию товары не опубликованы.
Могут использоваться:

1 (Опубликовано)
0 (Не опубликовано)

categories: КАТЕГОРИЯ. Если товар принадлежит нескольким категориям, необходимо использовать разделитель "|" (без кавычек).
Категория1|Категория2.
Если нужно указать подкатегорию, то указывается разделитель "/" (без кавычек)
. Категория/Подкатегория.

Если нужно использовать несколько подкатегорий, то нужно скомбинировать разделители.
Категория1/Подкатегория1|Категория2/Подкатегория2.

Если нуобходимо указать псевдоним, то используется разделитель ":" (без кавычек).
Категория1:category1

Если нужно указать изображение для категории, то используется дополнительный разделитель ":" (без кавычек).
Категория1:category1:category_image1.jpg (с псевдонимом)
Категория1::category_image1.jpg (без псевдонима)
Может использоваться любой текст.

tax: Налог. Если значение отсутствует, берется первый в списке налогов.

Может быть использовано название налога и его ставка с разделителем ":" (без кавычек) .
НДС 18%:18.00

Можно использовать только ставку, в таком случае если налог с такой ставкой отсутствует, то будет создана ставка с названием значения ставки.
18.00

Обратите внимание, в значении ставки должна быть точка, а не запятая.

Может быть использован любой текст для названия и цифровое значение для ставки.

currency: Валюта. Если значение отсутствует, берется валюта по умолчанию.

Может быть использован id валюты. ID валюты можно узнать административной панели в самой правой колонке в списке валют.
1

Может быть использовано название валюты
Рубль

Может быть использован код валюты
руб.

Может быть использован код ISO (Буквенный код общероссийского классификатора валют).
RUB

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

Рубль:руб.:RUB:1.000000

Могут быть использованы только определенные значения описанные выше.

template: Шаблон магазина. Если данная колонка отсутствует, то шаблон используется по умолчанию.

Может принимать любое значение.

url: Ссылка на товар. Данная ссылка будет показана в карточке товара для более детального ознакомления с товаром. Например на сайт производителя.

Может принимать значение в формате ссылки (http://domen.ru).

old_price: Старая цена для товара. Если установлено значение и в настройках указано показывать старую цену, то в списке товаров и карточке товара эта цена показывается перед основной стоимостью перечеркнутой.

Может принимать числовое значение.

buy_price: Закупочная цена.

Может принимать цифровое значение.

price: Основная цена товара.

Может принимать цифровое значение.

add_price: Дополнительные цены для товара.

Может принимать цифровое значение.

Формат строки: Единица измерения;Количество от:Количество до:Скидка (%)|Количество от:Количество до:Скидка (%)
Например: Liter;1:10:5|11:20:10|21:30:15 (От 1 до 10 скидка - 5%, от 11 до 20 скидка 10%, от 21 до 30 скидка 15%)

basic_price: Базовая цена. Необходимо указать количество единиц в общем объеме. Используется только совместно с полем unit

Может принимать цифровое значение.

unit: Единица измерения веса товара. Необходимо указать в чем именно измеряется вес: В килограммах, литрах или штуках.
Указывать необходимо название которое отображается в выпадающем списке при ручном заполнении товара. Например Kg, Liter или pcs.

Может принимать любое значение.

images: Изображения товара. Указывается название изображений, которые лежат в папке \components\com_jshopping\files\img_products.
Изображения разделяются сиволом "|" (без кавычек). Основным изображением назначается первое в списке (если нужно не первое - см. столбец image).

Изображение1.jpg:Название1|Изображение2.png:Название2|Изображение3.jpg|image4.png

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

Пример:
https://сайтпоставщика.com/.../IMAGES/image.jpg

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

Также можно указать желаемое имя файла картинки, которое будет оличаться от названия на сайте поставщика.

Пример:
https://сайтпоставщика.com/.../IMAGES/image.jpg:ТАЙТЛ-КАРТИНКИ:ЖЕЛАЕМОЕ-ИМЯФАЙЛА-НА-ВАШЕМ-СЕРВЕРЕ.jpg
или без тайтла картинки

https://сайтпоставщика.com/.../IMAGES/image.jpg::ЖЕЛАЕМОЕ-ИМЯФАЙЛА-НА-ВАШЕМ-СЕРВЕРЕ.jpg (обратите внимание: тайтла для картинки нет, но параметр пропущен, а не просто отсутствует, т.е.указаны разделители ::)

Может принимать любое значение.

image: Название для главного изображения товара. Необходимо указывать название изображение, которое лежит в папке \components\com_jshopping\files\img_products.
Указанное изображение назначается основным изображением для товара, которое отображается в списке товаров и в товаре по умолчанию.

Пример:
image4.png

Рекомендация: используйте это поле только если надо назначить главным изображение, отличное от первого изображения в списке поля images. Во всех остальных случая достаточно использовать только поле images.
Может принимать любое значение.

video: Видео демонстрационное для товара. Формат для импорта "name;video1.avi;video_preview1.avi|name;video2.avi;video_preview2.avi|code;<iframe width="560" height="315" src="http://www.youtube.com/embed/uH6Qkdp2eNY" frameborder="0" allowfullscreen></iframe>;video_preview_code.avi".
- первое значение определяет тип видео (файл или код),
- второе значение это непосредственно имя файла или код
- третье значение имя файла превью (необязательное).

Разделяются значения с помощью разделителя точка с запятой (;). Несколько видео для товара разделяются прямой чертой (|)

Может принимать любое значение.

files: Файлы на продажу и демо файлы.
Формат импорта:
Имя файла на продажу:Описание файла:Имя демо файла:Описание Демо

Несколько файлов перечисляются через разделитель |

Например:
File.zip:File Buy Desc:Demo.jpg:Demo Desc|::Demo2.jpg:Demo2

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

Если в строке указать слово clear все файлы товара обнулятся. Например:

clear|File.zip:File Buy Desc:Demo.jpg:Demo Desc|::Demo2.jpg:Demo2
Данная строка удалит все файлы, а потом добавить один файл на продажу и два демо файла.

related: Назначает товару сопутствующие товары. Значения нужно перечислять с использованием разделителя прямая черта "|".

Например:

xt00100|xt00102
Либо
1|2

Может принимать список id Товаров либо ean товаров

manufacturer

Производитель. Указывается название производителя и при необхомости псевдоним и изображение. Используемый разделитель ":" (без ковычек).

Можно указать название производителя.

Coca-Cola

Можно указать название и псевдоним производителя.

Coca-Cola:coca-cola

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

Coca-Cola:coca-cola:logo_coca.jpg

Может принимать любое значение.

delivery_times: Срок доставки. Указывается количество дней в течении которого товар может быть доставлен. Например: До 10 дней.

Может принимать любое значение.

hits: Количество просмотров карточки товара.

Может принимать любое целое число.

weight: Вес товара. Указывается номинальный вес товара, желательно Брутто, так как данное поле учитывается при использовании автоматического расчета стоимости доствки. Может быть дробное число (с точкой) Например: 5.400
Если необходимо указать что этот вес измеряется например в килограммах, то используйте поле unit.

Например: 5.400

Может принимать дробное значение (с точкой).

label

Метка товара. Указывается название и при необходимости изображение для метки.

New
New:new.jpg

Может быть использовано любое значение.

attributes

Зависимые и независимые атрибуты для товара. Указываются для выбора пользователем определенных значений при заказе товара. Например цвет и размер.

Формат зависимых атрибутов: Атрибут:Значение;Цена:цена;Количество:количество;Код:код товара;Изображение:изображение. Несколько атрибутов указываются с разделителем "|" (без ковычек). Все предыдущие значения атрибутов у товара при обновлении - удаляются.

Атрибут:Значение. Можно использовать несколько таких групп и в каждой группе несколько значений. Комбинации групп Цвет:Красный,Черный и Размер:56,62, с ценой 10, количеством 5, с кодом "товар" и изображением image.jpg нужно записать так: Цвет: Красный,Черный;Размер:56,62;Цена:10;Количество:5;Код:товар;Изображение:image.jpg. Такая запись создаст 4 зависимых атрибута:

Цвет = Красный, Размер = 56, Цена = 10, Количество = 5, Код = товар, Дополнительные значения = image.jpg
Цвет = Красный, Размер = 62, Цена = 10, Количество = 5, Код = товар, Дополнительные значения = image.jpg
Цвет = Черный, Размер = 56, Цена = 10, Количество = 5, Код = товар, Дополнительные значения = image.jpg
Цвет = Черный, Размер = 62, Цена = 10, Количество = 5, Код = товар, Дополнительные значения = image.jpg

Значения Код, Изображения - не обязательны.

Внимание!
Слова: Цена, Количество, Старая цена, Закупочная цена, Базовая цена, Изображение - должны соответствовать языковым переменным по умолчанию _JSHOP_PRICE, _JSHOP_QUANTITY, _JSHOP_OLD_PRICE, _JSHOP_PRODUCT_BUY_PRICE, _JSHOP_BASIC_PRICE, _JSHOP_IMAGE соответственно

Формат независимых атрибутов: Атрибут:Значение:Действие:Цена. Несколько атрибутов указываются с разделителем "|" (без ковычек). Все предыдущие значения атрибутов у товара при обновлении - удаляются. Действия могут быть следующими: +, -, *, /, =, %
Например: Цвет:Синий:+:50.00|Цвет:Красный:/:2.00|Размер:M:-:10.00|Размер:S:*:2.00

free_attributes: Для добавление свободных аттрибутов. При указании в данной колонке список свободных атрибутов заменит существуюший список назначенных атрибутов товару.
Для добавления к уже существующим, нужно указывать полный список включая существующие.
Свободные атрибуты. Перечисляются в помощью знака разделителя "|" (без кавычек). Используются только названия свободных атрибутов.

Могут принимать любые значения

extra_fields: Характеристики. Указываются характеристики товара с помощью разделителя "|" (без кавычек) в виде отдельных блоков: Характеристика:Опция. Для мультивыбора можно перечислять опции через зяпятую.

Поле extra-fields - заменяет все существующие характеристики товара, на указанные в поле.

Цвет:Красный,Черный|Размеры:56,62

Возможноcть указания типа характеристики - список. Формат (Максимальный): list/Группа характеристики;Характеристика:Опции через запятую. Формат (Минимальный): Характеристика:Опция. Без указания list - Характеристика создается как множественный список. Возможность указывать значения характеристики содержащей в себе запятую. Формат: delimiter/Характеристика:Опция с запятой. (Нельзя использовать с list/). Без указания группы - Характеристика создается без группы. При указании опций в кавычках - Характеристика создается как текстовая (При отсутствии такой характеристики)

add_extra_fields: Поле add_extra_fields - добавляет к уже существующим характеристикам товара, те, что указаны в поле.
Совместное использование возможно, но не имеет смысла, так как все характеристики можно вносить в поле extra_fields, а не разбивать их на 2 столбца. При этом необходимо учитывать, что столбцы должны идти в последовательности extra_fields, а потом add_extra_fields. В случае обратного порядка, у товара останутся только те характеристики, что указаны в поле extra_fields

vendor: Продавец.

Указывается название магазина продавца или при импорте можно указать Идентификатор продавца, если он известен. Числовые значения записываются как есть, а текстовые считаются названием магазина и производится поиск по названиям магазинов.
Может принимать цифровое значение.

bonus_add: Начисление бонусов за товар.

Указывается значение в процентах (%) бонусов которые будут начислены за заказа товара. Указанный процент будет относится к общей стоимости товара в корзине с учетом количества единиц. Это значение имеет смысл указывать при необходимости и только при использовании бонусной системы
Может принимать только цифровое значение.

bonus_sub: Оплата бонусами за товар.

Указывается значение в процентах (%) бонусов которые можно потратить на оплату заказа данного товара бонусами. Указанный процент будет относится к общей стоимости товара в корзине с учетом количества единиц. Это значение имеет смысл указывать при необходимости и только при использовании бонусной системы
Может принимать только цифровое значение.

АВТОМАТИЧЕСКИЙ ЭКСПОРТ ТОВАРОВ

Начиная с версии 2.0.2 введена поддержка автоматического экспорта товаров.
Для этого необходимо задать задание в Cron (на хостинге). Строка для размещения задания в Cron имеет следующий вид:
_http://{your site}/index.php?option=com_jshopping&controller=importexport&task=start&key={Security Key} (без _ в начале)
{Security Key} - это секретный ключ, который берется из настроек магазина (/administrator/index.php?option=com_jshopping&controller=config&task=general) Ключ безопасности.

АВТОМАТИЧЕСКИЙ ИМПОРТ ТОВАРОВ

Запуск со фронта и ссылка запуска для Cron задачи:
_http://{your site}/index.php?option=com_jshopping&controller=importexport&task=start&key={Security Key}&restoreFile={Exists File}
{your site} = Ваш домен
{Security Key} = Ключ безопасности (http://{your site}/administrator/index.php?option=com_jshopping&controller=config&task=general)
{Exists File} = Имя существующего файла находящегося в папке: \components\com_jshopping\files\importexport\comiel\

СВОЙ РАЗДЕЛИТЕЛЬ ПОЛЕЙ ДЛЯ CSV

добавьте нужный разделитель в файле \administrator\components\com_jshopping\importexport\comiel\forms\export.xml , например

<field name="csvDelimiter"
type="list"
showon="extension:csv"
class="span12"
label="COMIEL_CSV_DELIMITER"
description="COMIEL_EXPORT_CSV_DELIMITER_DESC"
default="">
<option value=";">COMIEL_CSV_DELIMITER_1</option>
<option value=",">COMIEL_CSV_DELIMITER_2</option>
<option value="~">Тильда</option>
</field>

Поддержка ПРИОБРЕСТИ

Ваша корзина

ОБРАТИТЕ ВНИМАНИЕ

Комплексный XLS импорт-экспорт товаров COMIEL (JoomShopping)

Условия поставки

Политика возврата и обмена

Лицензионное соглашение