Инструкция для компонент экспорта и импорта Excel2JS

СОВМЕСТИМОСТЬ.

Компонент работает на версиях Joomla от 2.5.6 до 3.8.

Компонент работает с JoomShopping 3.12 и выше (далее JS3) и JoomShopping 4 и выше (далее JS4)

Компонент работает с Excel 98 - 2010 и CSV, т.е. расширение файла должно быть .xls , .xlsx или . csv

  • Для корректной работы необходимо, чтобы на Вашем сервере был PHP 5.6 - 7.1.
  • Функции iconv и mbstring должны быть включены, иначе будет проблема с кодировкой кириллических символов
  • Дирректива short_open_tag должна быть включена.
  • Для работы системы создания резервных копий на Вашем сервере должна работать php - функция system () – об этом вы можете узнать у своего хостера.
  • Режим safe_mode должен быть выключен.
  • Возможность вашего хостинга поддерживать IonCube 10.2

Рекомендуемые требования к оперативной памяти хостинга – 128 Мб. Минимальные – 64 Мб.

УСТАНОВКА.

Устанавливается, как обычное расширение через Менеджер расширений.

Функции Excel2js - ОСНОВНЫЕ

- ИМПОРТ

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

В форме импорта Вам необходимо указать xls-файл (а также xlsx). Вы можете загрузить его с компьютера или выбрать один (или несколько) из загруженных ранее прайсов.

В следующем поле Вы можете указать zip-архив, в который запакованы изображения товаров.

После нажатия на кнопку "Начать импорт" создастся резервная копия данных JoomShopping и начнётся импорт. За результатами Вы сможете следить в реальном времени. После завершения процесса импорта, появится сводная таблица в которой будет указано, какие категории и товары созданы, а какие добавлены.

- ЭКСПОРТ

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

После нажатия на кнопку "Начать экспорт" Вы будете видеть статистику в реальном времени о ходе экспорта. По окончанию процесса появится ссылка для скачивания xls-файла (файлов). Если файлов будет несколько, то они будут запакованы в zip-архив, для того, чтобы их можно было удобно скачать.

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

- ПРОФИЛИ НАСТРОЕК

С этой вкладки необходимо начинать работу с компонентом. В левой части находится интерфейс для настройки столбцов Excel-файла. Вам необходимо путём перетаскивания из правой колонки (Неактивные столбцы) переместить необходимые столбцы в левую колонку (Активные столбцы) и расположить их в том порядке, в котором они идут в Вашем Excel-файле. С помощью кнопок на панели вы можете создать дополнительные столбцы для пользовательских полей. Если в вашем прайсе есть столбцы, которые не нужно импортировать, то нужно поместить на их место пустой столбец.

В правой части указываются особенности импорта. Здесь Вы можете:

  1. Включить/выключить отображение подсказки по прайсу на вкладке импорта
  2. Включить/выключить автоматическое создание резервных данных магазина перед каждым импортом (SQL или gzip)
  3. Указать, хотите ли Вы только обновлять существующие товары или также создавать и новые
  4. Указать, может ли один товар находиться в разных категориях
  5. Включить/выключить обработку принадлежности товаров к категориям при обновлении (полезно, если Вы не хотите, чтобы у обновляемых товаров изменялась категория. Новые товары будут добавляться согласно разметке прайса)
  6. Активировать автоматическое снятие с публикации всех товаров перед импортом - в процессе импорта будут опубликованы те товары, которые присутствуют в прайсе.
  7. Выбрать валюту, в которой указаны цены в прайсе
  8. Выбрать один из способов генерирования псевдонимов (по наименованию, по артикулу, по ID и по различным их комбинациям)
  9. Выбрать способ импорта изображений - а) в прайсе указываются только названия изображений; б) изображения встроены в прайс
  10. Указать номера первой и последних строк, которыми нужно ограничить импорт

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

- YML

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

Экспортируются в YML только основные поля и характеристики товаров.

Из YML-файлов импортируются только основные поля и характеристики.

На этой же страницы Вы можете найти ссылки для планировщика Cron, чтобы осуществлять импорт/экспорт по расписанию.

Коэффициент пересчета цен - это число, на которое будут умножаться цены во время импорта и экспорта. Т.о. Вы можете задать наценку на товары. Например, для наценки 20%, нужно указать коэффициент: 1.2

- ВКОНТАКТЕ (функция временно не работает)

На этой вкладке осуществляется экспорт товаров из joomshopping в ВК Маркет.

На этой странице Вы можете пройти авторизацию и указать соответствия Ваших категорий категориям ВК.

Товары для экспорта можно фильтровать по категорим и/или производителям.

Есть поддержка экспорта дополнительных изображений.

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

Также на этой странице Вы можете просматирвать и удалять товары своей группы Вконтакте.

НАСТРОЙКА ПРОФИЛЯ ИМПОРТА/ЭКСПОРТА.

После установки компонента в меню сайта «Компоненты» появится подпункт «Импорт товаров JoomShopping». Наведите на него мышь и из появившегося подменю выберите «Профили настроек».

ПРОФИЛИ НАСТРОЕК.

У Вас есть возможность создавать несколько наборов настроек импорта (профилей). Вы можете легко переключаться между ними, выбрав нужный из выпадающего списка. Чтобы создать новый профиль вместо кнопки «Сохранить» нажмите «Сохранить как профиль», из выпадающего списка выберите «Создать новый» и укажите название нового профиля. Нажмите кнопку «Сохранить» (которая под названием). Если выбрать существующий профиль, то он перезапишется. 4 Удалять можно только текущий профиль с помощью кнопки «Удалить», которая находится правее названия профиля. Экспорт профиля – позволяет сохранить настройки на компьютер, а Импорт профиля – импортировать ранее сохранённые настройки. Эти функции будут полезны, если вы на одном сайте производите экспорт, а на другом – импорт. Также при обращении в поддержку Вы можете приложить файл настроек, для ускорения процесса решения проблемы.

В левой части находится интерфейс для настройки столбцов файла импорта/экспорта. Вам необходимо путём перетаскивания из правой колонки (Неактивные столбцы) переместить необходимые столбцы в левую колонку (Активные столбцы) и расположить их в том порядке, в котором они идут в Вашем файле импорта/экспорта (после определения последовательности обязательно нажимать кнопку «Сохранить»).

Например, на скриншоте указана последовательность для импорта следующего прайса: 5

 

ТИПЫ СТОЛБЦОВ (ПОЛЕЙ)

 

СТАНДАРТНЫЕ СТОЛБЦЫ

 

Стандартные – это столбцы по умолчанию, которые есть в любом магазине на JoomShopping. Некоторые поля можно использовать для импорта данных категорий при способах маркировки «Нумерованный. Номера вместе с названиями», «Нумерованный. Номера в от дельной ячейке», «Спец. Символ перед названием», «Спец. Символ после названия», «Группировка строк в Excel»

  1. Код товара – уникальный циферно - буквенный идентификатор товара. Необходим для корректной работы магазина. В прайсе обязательно должен присутствоват ь или код товара, или ID товара, или Наименование товара – т.к. по этим значением происходит поиск товаров на сайте и принимается решение – создавать товар или обновлять. При отсутствии в прайсе столбцов для идентификации товары нельзя будет корректно обно влять.
  2. Наименование товара – это название товара. По наименованию возможна идентификация товара, если отсутствуют Код товара и ID товара в прайсе. При импорте присваивается значение тому языку, который указан в профиле.
  3. ID товара – это уникальный цифирный идентификатор товара, который присваивается системой автоматически при создании товара. Используется в качестве идентификатора товар при импорте в тех случаях, когда нет Кода товара или необходимо обновить Коды товаров.
  4. Категория (Номер/ ID / Название) – этот столбец необходим для указания категории в некоторых способах маркировки категорий («Нумерованный. Номера в отдельных ячейках»;«ID категории для каждого товара»;«Название категории для каждого товара»), о которых речь пойдет ниже.
  5. Цена – базовая цена товара. Числовое значение, дробная часть может быть отделена от целой как запятой , так и точкой . Пример – «200.50» или «200,50»
  6. Псевдоним товара – необходим лишь для «красивых» ссылок. Может быть любым словом, желательно на латинице. Слова отделяете дефисом. Это поле может быть использовано для импорта данных категории.
  7. Краткое описание – Краткое описание товара. Показывается в категории в списке товаров. При импорте значение присваивается тому языку, который указан в профиле. Это поле может быть использовано для импорта данных категории.
  8. Полное описание товара – Полное описание товара. Показывается на странице товара. При импорте значение присваивается тому языку, который указан в профиле. Это поле может быть использовано для импорта данных категории.
  9. Изображение – необходимо указывать только названия файлов изображений, например – risunok.jpg. Эти поля можно указывать в прайсе и для категорий. Для товаров можно указывать несколько изображений – для этого их необходимо разделять символом «|». Например, risunok.jpg|risunok2.jpg|risunok.jpg. Примечание: вы также можете указывать внешние ссылки (начинаются с http://) на изображения (когда они находятся на другом сайте) – изображения будут скачиваться сразу на Ваш сайт, но из - за этого скорость импорта может упасть в несколько десятков раз. Это поле может быть использовано для импорта данных категории.
  10. Старая цена – Старая цена для товара. Если установлено значение и в настройках указано показывать старую цену, то в списке товаров и на странице товара эта цена показывается перечеркнутой. Числовое значение, дробная часть может быть отделена от целой как запятой , так и точкой. Пример – «220.50» или «220,50»
  11. Закупочная цена – Числовое значение, дробная часть может быть от делена от целой как запятой, так и точкой. Пример – «180.50» или «180,50»
  12. Мета-описание – Описание страницы. Текстовое значение. Это поле может быть использовано для импорта данных категории.
  13. Ключевые слова – в ячейках должны быть указаны ключевы е слова и фразы. Это поле может быть использовано для импорта данных категории.
  14. Title страницы – текст, который отображается в названии вкладки браузера, а также в поисковой выдаче. Это поле может быть использовано для импорта данных категории.
  15. Title изображения – текст, который «всплывает» при наведении на изображение. Если изображений несколько, то значение этой ячейки необходимо разделить символом « | ». Например, «title1|title2|title3»
  16. Статус публикации – цифровое значение. 1 – «Опубликован», 0 – «Не опубликован».
  17. Вес – вес товара. Числовое значение
  18. Внешняя ссылка – В этом столбце может быть указана ссылка, которая будет отображаться на странице товара. Текст ссылки – «Читать подробнее»
  19. Количество – числовое значение количества товара. Если не указывать его, т о для новых товаров будет установлено значение по умолчанию, указанное в профиле. Если указать « -1» - то будет установлено неограниченное количество.
  20. Срок доставки – текстовое значение. Например, «До 7 дней»
  21. Единицы товара – если необходимо, чтобы единицы измерения товара отличались от тех, что установлены по умолчанию, укажите их в этой колонке. Например, «мг»
  22. ID производителя – числовой идентификатор производителя.
  23. Производитель – название производителя. Если производитель не существует на сайте, то он будет создан.
  24. Сопутствующие товары – в этом столбце можно указать ID сопутствующих товаров. Например, 55|89|13|45. Этот столбец желательно использовать вместе с ID товара , чтобы чётко задать соответствие между товарами.
  25. Коды сопутствующих товаров – аналог ичен предыдущему столбцу. Указываются коды сопутствующих товаров. Например, Byk55|amllb|Article58
  26. Валюта – если необходимо, чтобы валюта цены товара отличались от той, что установлена по умолчанию, укажите ее в этой колонке. Например, «USD». Если Валюта создается в процессе импорта, то Вам необходимо будет потом вручную задать обменный курс.
  27. Ставка налога – Указывается только число, без знака «%». Если налог с указанной ставкой не существует, то он будет создан – название будет соответствовать ставке. Если ставка не указана, то для новых товаров будет установлен первый в списке налог. Если указать символ очистки «-», то налог не будет назначен.
  28. Метка – Укажите название метки. Если метка не будет найдена по названию, то она будет создана. Пример - « New » или « Sale »
  29. Доступ – Укажите ID уровня доступа к товару. 1 – «Для всех», 2 – «Только зарегистрированным», 3 – «специальный», 6 – «Для супер администраторов », 5 – «Для гостей».
  30. Цифровой товар – В этом поле необходимо указать название файла или файлов, которые должны быть загружены по ФТП в папку «/components/com_jshopping/files/files_products». Пример – «product.zip » или «product.zip|product2.zip» (если необходимо прикрепить несколько файлов). Если указан символ очистки «-», то от товара будут откреплены все файлы, но сами файлы не удалятся.
  31. Дата создания – необязательно поле. Формат даты «2018-01-23 14:12:22»
  32. Дата модификации – необязательно поле. Формат даты «2018-01-23 14:12:22»
  33. Сортировка товаров – вы можете вручную указать сортировку товаров в пределах категории
  34. Список характеристик – В этом поле вы можете указать все необходимые характеристики, совмещенные в одной ячейке. Отделяются характеристики друг от друга вертикальной чертой (|). Название характеристики отделяется от значений двоеточием (:). Значения характеристик (если их несколько) отделяются запятыми (,). Пример – Цвет:Красный,Синий,Желтый|Размер:XXL,XL|Материал:"Замшевый".

Если характеристика с указанным названием не существует, то она будет создана. Тип характеристики по умолчанию - список. Если значение характеристики заключено в кавычки, то тип характеристики будет - текст.

НЕ ИМПОРТИРУЕМЫЙ СТОЛБЕЦ

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

ХАРАКТЕРИСТИКИ

Вам достаточно создать характеристики через админку JoomShopping, опции заполнять необязательно – они создадутся автоматически во время импорта. После этого добавятся поля, соответствующие харак теристикам в профили настроек. Каждой характеристике соответствует одно поле. Если характеристика является списком с мультивыбором, то в ячейке можно указать несколько значений, разделенных символом – « | » . Например – «Матовая|Глянец»

НЕЗАВИСИМЫЕ АТРИБУТЫ

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

  1. Только значение – «Красный» – к товару будет добавлено это значение, цена при выборе данного значения изменяться не будет.
  2. Значение и модификатор цены – «Красный;+20 » – к товару будет добавлено это значение, цена при выборе данного значения цена увеличится на 20. Значение и модификатор должны быть разделены точкой с запятой «;». В модификаторе могут быть использованы знаки «-», «*», «/», «=».
  3. Значение и точная цена – «Красный;=200» или «Красный;200» – в озможна запись без знака «=». При выборе данного значения, будет установлена цена – 200 .
  4. Несколько Значений и модификаторов – «Красный;+20|Синий;+40|Белый » – Несколько пар значение - модификатор разделяются символом вертикальной черты «|». К товару будет д обавлено 3 значения. Красный – увеличит цену на 20 , Синий увеличит цену на 40 , Белый – соответствует базовой цене .