Документація щодо встановлення, налаштування та вирішення можливих проблем з розширенням ARTIMEX - імпорт/експорт товарів JoomShopping 5+
Підтримувані формати файлів імпорту/експорту: XLS, XLSX, CSV
Для імпорту можна використовувати файли, зроблені в MS Excel 2003/2010, CSV.
Для імпорту можна використовувати файли, зроблені в MS Excel 2003/2010, CSV.
Підтримувані кодування: UTF-8
Можливість гнучкого налаштування структури (відсутність жорсткої послідовності та наявності стовпців) експортованого файлу.
Для імпорту не важливо в якій послідовності ви будете заповнювати стовпці. Наявність стовпців мінімум = 2. Один залежить від методу оновлення (див. пункт). Другий - що оновлювати (ціна чи кількість чи зображення тощо).
Методи оновлення товарів - ID, EAN, Manufacturer_code.
Колонка для визначення за яким критерієм будуть оновлюватися товари. Який би Ви спосіб не вибрали, ця колонка буде обов'язковою для заповнення. У разі відсутності наприклад коду та обраного способу оновлення "За кодом", буде створено один товар з порожнім кодом і всі наступні значення будуть оновлювати дані цього товару.
Підтримка вкладеності категорій.
Можна вказувати необмежену вкладеність категорій, навіть якщо батьківських категорій ще не існує.
Підтримка залежних атрибутів (кожен до кожного)
Дозволяє створювати комбінування атрибутів для товару. Тобто вказуючи два кольори (Червоний та чорний) та два розміри (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 (літерний код загальноросійського класифікатора валют).
UAHМожуть бути використані всі значення. Потрібно для додавання нової валюти. Останнім значенням необхідно вказати обмінний курс.Гривня:грн.:UAH:1.000000Можуть бути використані лише певні значення, описані вище.
- template
-
Шаблон магазину. Якщо ця колонка відсутня, шаблон використовується за замовчуванням.Може приймати будь-яке значення.
- url
-
Посилання на товар. Це посилання буде показано в картці товару для більш детального ознайомлення з товаром. Наприклад, на сайт виробника.Може набувати значення у форматі посилання (https://domen.com).
- 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 | /div>
- 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Можливість вказівки типу характеристики – список. Формат (Максимальний): list/Група характеристики; Характеристика: Опції через кому. Формат (Мінімальний): Характеристика: Опція. Без вказівки list – Характеристика створюється як множинний список. Можливість вказувати значення характеристики, що містить у собі кому. Формат: delimiter/Характеристика: Опція з комою. (Не можна використовувати з List/). Без вказівки групи – Характеристика створюється без групи. При вказівці опцій у лапках - Характеристика створюється як текстова (За відсутності такої характеристики)
- add_extra_fields
-
Поле add_extra_fields - додає до вже існуючих характеристик товару, ті, що вказані в полі.
Спільне використання можливе, але не має сенсу, тому що всі характеристики можна вносити в поле extra_fields, а не розбивати їх на 2 стовпці. При цьому необхідно враховувати, що стовпці повинні йти в послідовності extra_fields, а потім add_extra_fields. У випадку зворотного порядку, у товару залишаться лише ті характеристики, що вказані в полі extra_fields
- vendor
-
Продавець.Вказується назва магазину продавця або при імпорті можна вказати Ідентифікатор продавця, якщо він відомий. Числові значення записуються як є, а текстові вважаються назвою магазину і здійснюється пошук за назвами магазинів.
Може приймати цифрове значення.
АВТОМАТИЧНИЙ ЕКСПОРТ ТОВАРІВ
ПЛАНУЄТЬСЯ В АПДЕЙТАХ
АВТОМАТИЧНИЙ ІМПОРТ ТОВАРІВ
ПЛАНУЄТЬСЯ В АПДЕЙТАХ