IPrice minimart - руководство пользователя

Импорт товаров осуществляется с помощью файлов импорта в формате CSV. Используются 3 разных файла импорта:

• Файл импорта категорий.
• Файл импорта товаров.
• Файл импорта изображений товаров и категорий.

Сначала необходимо подготовить и загрузить файл импорта категорий, затем файл импорта товаров, а затем файл импорта изображений. Все 3 файла импорта имеют определенный формат: первая строка файла импорта может содержать описательные имена полей. В этом случае вторая строка файла импорта должна содержать системные имена полей. В параметрах импорта перед импортом файлов примера следует параметр "Строка описания столбцов" установить в "Да", чтобы процедура импорта пропустила первую строку с описательным названием полей. Файлы примеров импорта подготовлены в кодировке UTF-8, и их можно открывать с помощью редактора, поддерживающего кодировку UTF-8, например Notepad++. Так же примеры файлов импорта дублируются в формате Excel (.xls). Файлы импорта можно готовить в формате Exсel, а затем перед импортом сохранять в формате CSV. При сохранении файла импорта из Excel в формат CSV необходимо выбрать тип файла "CSV, разделители запятые". Несмотря на наименование типа импорта, разделителем полей в Excel будет точка с запятой. Часто такое несоответствие в Excel сбивает с толку. Это нужно учитывать. При импорте файлов, сохраненных в CSV с помощью программы Excel, необходимо задать в админке компонента параметр импорта "Перекодировка" в значение "CP1251->UTF-8", так как файл из Excel сохраняется в кодировке "Windows 1251".

Импорт категорий

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

Список допустимых системных полей в файла импорта категорий:

• parent_path - обязательное поле. Маршрут родительской категории, состоящий из алиасов родительских категорий, разеленных символом '/'. С помощью данного маршрута задается родительская категория для текущей категории. Например , если в данном поле задан маршрут 'telefony/smartfony', значит у текущей категории есть родительская категрия с алиасом 'smartfony', у которой в свою очередь есть родительская категория 1 уровня 'telefony'. Если категория является корневой и не имеет родителя, то это поле должно быть пустым
• parent_name_path - необязательное поле, может быть исключено из файла импорта. Служит только для информационных целей и не участвует в импорте. Представляет собой маршрут наименований родительских категорий для более понятного представления родительской категории. Например 'Телефоны/Смартфоны'
• alias - обязательное поле. Алиас категории - является идентификатором категории, который участвуует в создании URL ссылки на категорию. Каждая категория должна иметь уникальный алиас в пределах родительской категории. Алиас участвует в формировании url категории, поэтому алиас должен состоять только из латинских символов (допускается знак тире "-").  Например: категория с наименованием "Смартфоны" может иметь алиас "smartphones" и иметь родительскую категорию c алиасом "phones". В таком случае URL категории будет иметь вид: www.мой-сайт.ru/catalog/phones/smartphones.
• name - обязательное поле. Наименование категории. Может быть не уникальным для каждой категории.
• forcart - Категория только для вида корзины (доставка и прочее)? (0-Нет; 1-Да). Если значение '1', то значит позиции в данной категории будут отображаться только на странице корзины при оформлении заказа. Такими позициями могут быть позиции выбора доставки и прочих дополнительных затрат по заказу.
• image - Изображение категории. Должно содержать относительный маршрут до файла изображения категории, например: images/com_ipricecalc/upload/category_netbooks.jpg
• pagetitle - Заголовок для страницы категории.
• mainproptitle - Заголовок для главного свойства товаров данной категории.
• inputfields - Свойства, используемые товарами категории. Необходимо задавать системные имена свойств, разделенных символом ';'.
• customfields - Характеристики, используемые товарами категории. Необходимо задавать системные имена харакетристик, разделенных символом ';'.
• pricefields - Поля, разрешенные для отображения в прайс-листе для товаров категории. Необходимо задавать системные имена полей, разделенных символом ';'.
• formulaprice - Формула цены для товаров категории.
• formulaweight - Формула веса для товаров категории.
• published - Категория опубликована?  (0-нет; 1-да). Если эта колонка остуствует, то по умолчанию категория считается опубликованной.
• discount - Наименование скидки для товаров категории.
• exclgdisc - Исключить товары категории из расчета общей скидки по заказу (0-нет, 1-да).
• salestax - НДС для товаров категории (%).
• ismultiple - Категория это составной товар? 0-нет; 1-да. Смотрите подробнее о категории как составном товаре.
• dropdown - Главное свойство для категории-составного товара.
• totalcost - Цена для категории-составного товара.
• description - Описание категории.

Импорт товаров

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

• category_path - обязательное поле при добавлении нового товара. Маршрут базовой категории, состоящий из алиасов родительских категорий, разеленных символом '/'. Например: 'telefony/smartfony'. Базовая категория будет определять свойства и характеристики товара, если они заданы. Так же товар будет наследовать скидку от базовой категории, если она задана.
• itemcategory_paths - Маршруты категории товара разделенные запятыми. Например: 'telefony/smartfon, telefony/gsmtelefony'.
• sku - обязательное поле. Артикул товара. Артикул является уникальным идентификатором товара и должен быть уникальным для каждого товара. Если при импорте товар с данным артикулом уже существует, то этот товар будет обновлен. Если товара с данным артикулом не существует, то товар будет добавлен.
• alias - Алиас товара. Если алиас не задан в файле импорта, то он будет автоматически сформирован из поля "Артикул". Если в артикуле использованы русские символы, они будут конвертированы в латинские с помощью транслитерации. Алиас товара будет участвовать в формировании URL ссылки на товар, поэтому должен содержать только латинские символы и символы '-' (тире). Не используйте пробелы и спецсимволы в поле "Алиас". Например для товара с наименованием "Телефон Samsung Galaxy S3" алиас может быть "samsung-galaxy-s3". В этом случае URL страницы товара будет: www.мой-сайт.ru/catalog/viewitem/samsung-galaxy-s3. Алиас товара должен быть уникальным для каждого товара.
• cost - Базовая цена товара.
• curr - Код валюты для товара (USD, RUR и т.п.). Если код валюты не задан в файле импорта, то для товара будет задана валюта, заданная в параметрах компонента.
• name - Наименование товара. Обязательное поле при добавлении нового товара
• item_type - Тип позиции (0-обычная, 1-разделитель).
• weight - вес товара.
• description - краткое описание товара.
• showcount - Тип выбора позиции (0 - обычный выбор-checkbox; 1 - выбор количества; 2 - выбор одного элемента из группы (радио кнопка) ). Тип выбора 2 (радиокнопка) возможен только для позиций доставки и прочих затрат по заказу (только для позиций корзины).
• radiogroup - Номер группы для радиокнопок - номер группы товаров, из списка которых будет выбираться только один с помощью радиокнопок (поле заполняется только для элементов с типом выбора 2 - выбор одного элемента из группы (радио кнопка)).
• defqty - Количество по умолчанию, которое будет проставлено для товара в поле выбора количества в каталоге, прайс-листе или на странице товара. Этот параметр перекрывает общую настройку количества, выбраного по умолчанию в параметрах компонента.
• discount - Наименование скидки для позиции. Скидка с данным наименованием должна быть настроена в управлении скидками.
• exclgdisc - Исключить товар из расчета общей скидки по заказу (0-нет, 1-да).
• salestax - ставка НДС (%).
• enable_file - Разрешить прикреплять файл к позиции товара на странице корзины заказа (1-да;0-нет).
• unit - единица измерения.
• avail - Количество на складе.
• manufacturer - производитель.
• dropdown - список опций главного свойства товара, разделенных символом "#". Формат списка опций главного свойства: имя:сумма:остаток:default#... Где "имя" - наименование опции; "сумма" - добавочная цена для товара при выборе данной опции; "остаток" - кол-во товара с данной опцией в наличии на складе; "default" - признак "по умолчанию", если выставлен у опции, то данная опция будет выбрана по умолчанию при отображении товара. Например: серебро:10:1000:#черный:20:1000:default#золото:15:1000:
  Если какая-то часть опции не задана, то символ-разделитель ':' все равно должен присутсвовать. Например, если вам не нужно задавать остаток и добавочную цену по опции, то список опций должен выглядеть так: серебро:::#черный:::default#золото:::
• fulldescription - полное описание товара.
• destfilename - имя файла для автоматической доставки товара. Имя файла задается без маршрута, например "tovar.zip". Файлы автоматической доставки должны быть записаны в каталог сайта /administrator/components/com_ipricecalc/files/.
• destcode - текст автоматической доставки товара. Может содержать ключ покупки, код и прочее. Отправляется автоматически на e-mail заказчика вместе с файлом для автоматической доставки.
• featured_items - Сопутствующие товары (задается список артикулов через запятую). Используйте эту колонку при обновлении уже добавленных товаров. Иначе, если сопутствующий товар еще не добавлен, он не будет назначен как сопутствующий.
• meta_description - SEO описание товара для тэга META_DESCRIPTION.
• keywords - SEO ключевые слова для товара для тега META_KEYWORDS.
• classname - имя управляющего класса для позиции доставки и прочих затрат по заказу. Например "bonus".
• capacity - объем товара.
• featured - рекомендуемый товар? 0 - нет, 1 - да.
• published - товар опубликован? 0 - нет, 1 - да.
• qtyenabled - Разрешить пользователю редактировать кол-во товара? 0 — нет, 1 - да, -1 - по умолчанию.
• stepqty - Шаг изменения кол-ва товара стрелками.
• minqty - Минимальное значение кол-ва товара.
• maxqty - Максимальное значение кол-ва товара.
• qtylistvalues - Список значений для кол-ва товара (напр. 1;2;5;10). Если задан, то пользователь сможет выбирать кол-во товара только из ътого списка.
• created - дата добавления товара в формате 'YYYY-MM-DD', например '2019-03-28'. Будет подставлена текущая дата, если это поле пустое или отсуствует в файле импорта.

Имена полей должны быть указаны в первой строке файла импорта. Допускается в первой строке для наглядности указывать описательное название полей, тогда системные имена полей должны быть указаны во второй строке и при импорте необходимо отметить параметр "Строка описания столбцов" - "Да".

Кодировка файла импорта.

При подготовке CSV файла импорта в программе MS Excel, получившийся CSV файл содержит символы в кодировке Windows CP1251. Перед импортом такого файла необходимо в параметрах импорта выбрать перекодировку с CP1251 в универсальный формат UTF8 (параметр "Перекодировка" установить в "CP1251->UTF-8"). Аналог программы Excel из пакета Open Office умеет сохранять csv файлы напрямую в кодировке UTF-8. Если csv файл подготовлен сразу в кодировке UTF-8, то в этом случае параметр перекодировки задавать не нужно.

Символы-разделители.

Если ваш вариант CSV файла импорта содержит нестандартные символы-разделители полей, символы, обрамляющие значения полей, а так же символы конца строки, то с помощью параметров "Символы-разделители" нужно установить используемые символы.

Добавление новых товаров.

При добавлении новых товаров файл импорта должен содержать как минимум 4 поля: category_path, sku, name, cost. Поле sku (Артикул) должно быть уникальным для каждого товара. В поле "category_path" указываются маршрут алиасов категории, к которой принадлежит товар.

Обновление существующих товаров.

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

Импорт пользовательских полей товара (свойств и характеристик).

Пользовательские поля товара (характеристики) включаются в файл импорта так же как и обычные поля: добавляется колонка с системным именем пользовательского поля в строке системных имен полей, и эта колонка содержит значение пользовательского поля.
Списки значений свойств товара так же можно включить в файл импорта: добавляется колонка с системным именем свойства в строке системных имен полей с добавлением суффикса values. Например для свойства с системным именем p_size нужно в файл импорта включить колонку p_sizevalues.

Форматы данных импорта.

Числовые поля цены и количества указываются в виде чисел с разделителем дробной части "точка". Поля "Описание", "Полное описание" и пользовательские поля товара допускают включение html кода.
Особый формат имеет поле dropdown (главное свойство товара в виде выпадающего списка). Это поле имеет формат: имя:сумма:остаток_в_наличии:выбран_по_умолчанию#.... (например: "желтый:200:1000:default#розовый:300:2000:#зеленый:400:3000:"). Пример формата поля dropdown можно увидеть в примере файла импорта.

Автоматический импорт по расписанию

Система позволяет настроить автоматический импорт товаров из CSV файла по расписанию. Для этого достаточно в каталог на сайте /administrator/components/com_ipricecalc/import записать CSV файл импорта (файл должен иметь расширение .csv). Затем настроить автоматический импорт в глобальных параметрах компонента в разделе "АВТОМАТИЧЕСКИЙ ИМПОРТ":

• файл импорта - выберите файл импорта
• Установите разделитель столбцов, символ, обрамляющий значения столбцов и разделитель строк, если они отличаются в вашем CSV файле от значений по умолчанию
• Заголовки столбцов - установите в "Да", если ваш CSV файл импорта содержит в первой строке описательные имена столбцов.
• Удалить все позиции перед импортом - установите в "Да", если необходимо перед импортом удалить все товары. Это бывает необходимо, если планируется каждый раз полностью обновлять список товаров из файла импорта. Все же рекомендуется не удалять все товары перед импортом, а отключать показ ненужных товаров с помощью системного поля импорта published: добавьте в файл импорта колонку с системным полем published, проставьте у всех товаров, которые нужно отключить, в этой колонке значение 0, а у товаров, которые нужно отображать - значение 1.

После настройки параметров автоматического импорта добавьте с помощью панели управления хостингом задание Cron на вашем сервере, которое будет запускать по расписанию процедуру автоматического импорта с помощью вызова следующего URL: http://www.yoursite.com/index.php?option=com_ipricecalc&task=autoimport&sc=secretcode
где www.yoursite.com - домен вашего сайта, а secretcode - придуманный вами секретный пароль, заданный в параметре компонента "Секретный пароль" на вкладке "Обязательные параметры".
Например импорт будет запускаться в 12 часов ночи каждый день. Таким образом достаточно будет периодически при необходимости записывать обновленный файл импорта, чтобы поддерживать позиции товаров в актуальном состоянии.

Загрузка большого количества позиций

При загрузке большого количества позиций (больше 3000-5000) скорее всего потребуется увеличить лимит на время выполнения скрипта в файле php.ini. Установите параметр max_execution_time в значение 180 (3 минуты). Возможно потребуется большее значение. Подберите значение опытным путем. Если на хостинге нет возможности установить этот параметр с помощью php.ini, то это можно сделать с помощью файла .htaccess, прописав в нем следующую команду: php_value max_execution_time 180. Так же можно разбить большой файл импорта на несколько частей. например каждая категория товаров - в отдельном файле.

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

Для импорта изображений воcпользуйтесь примером файла импорта изображений.
Перед импортом файла примера рекомендуется скачать изображения для примера, распаковать архив и сохранить изображения в каталоге изображений компонента /images/com_ipricecalc/upload/.

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

Перечень и порядок полей в файле импорта изображений:

• Type - Тип изображения, может принимать 2 значания: item - для изображения товара, category - для изображения в галерее категории.
• SKU - Артикул товара для типа item, наименование категории для типа category.
• File name - имя файла изображения, предварительно загруженного в каталог на сайте /images/com_ipricecalc/upload/
• Image name - наименование изображения, вставляется в команду ALT тэга IMG.
• Main image - признак главного изображения. Для товара одно из изображений должно быть помечено как главное с помощью флага 1. Если у товара одно изображение, то оно должно быть помечено как главное. Если для разных опций главного свойства товара имеются разные изображения, то одно из изображений товара для одного и того же свойства должно быть помечено как главное.
• Property - если у товара есть опции главного свойства, и для каждой опции должен быть свой набор изображений, то в этом поле можно задать имя опции, для которой загружается изображение.
• Description - описание изображения. Вставляется в команду Title тэга IMG.

Параметры импорта изображений

Для импорта изображений перейдите в админке компонента в раздел "Импорт CSV" и выберите вкладку "Изображения".

Параметры импорта:

• Файл CSV - выберите подготовленный для загрузки CSV файл импорта изображений.
• Создавать эскизы - если Да, то для каждого изображения будут автоматически созданы 3 эскиза: большой - для увеличенного изображения, средний - для главного изображения товара в режиме каталога, маленький - для изображения в галерее изображений товара или для изображения товара в прайс-листе. Размеры эскизов вы можете задать в настройках компонента в разделе "Изображения".
• Удалить старые изображения - Если "Да", то перед импортом изображений товара из файла импорта старые изображения товара будет удалены из базы данных (но останутся в папке изображений сайта). Если вы заменяете изображения товаров, то установите эту опцию в "Да". При этом важно, чтобы изображения одного товара в файле импорта шли подряд друг за другом. Если вы хотите добавить новые изображения товаров, не удаляя старых, то установите эту опцию в "нет".
• Перекодировка - если ваш файл CSV подготовлен в кодировке UTF-8 (например с помощью пакета Open Office), то оставьте значение "Не конвертировать". Если ваш файл CSV подготовлен в кодировке Windows 1251 (например с помощью программы MS EXCEL), то выберите значение CP1251 -> UTF-8.
• Символы разделители - проставьте символы разделители, если ваш файл содержит разделители столбцов, строк, и символы, обрамляющие значения полей, отличные от стандартных.

В разделе "Инструменты" вы можете воспользоваться утилитами для работы с изображениями:

• Пересоздать все эскизы - пересоздает все эскизы для всех изображений. Эта функция бывает полезна, когда вам необходимо сменить размер эскизов в параметрах компонента. После задания новых размеров эскизов необходимо запустить эту фукнцию. Обратите внимание, если у вас большое кол-во товаров с изображениями (к примеру больше 5000) и каждый товар имеет несколько изображений выского качества и разрешения, то эта фукнция потребует значительного времени выполнения. Возможно вам придется увеличить лимит на время выполнения php скриптов в настройках вашего сервера, или для пересоздания эскизов воспользоваться загрузкой файлов импорта изображений, предварительно разбив файл импорта на несколько частей (примерно по 1000 изображений на часть) и загрузить каждый файл импорта изображений отдельно.
• Удалить все эскизы - вы можете удалить все файлы эскизов перед импортом файла изображений или перед пересозданием эскизов.
• Выбрать главные изображения - для автоматического выбора главного изображения товара в прайс-листе вы можете воспользоваться этой функцией. Так же эта функция выбирает гланое изображение для категории, если для нее задано несколько изображений.
• Удалить 'зависшие' изображения - эта функция позволит вам очистить базу данных от изображений, которые ссылаются на уже несуществующие файлы изображений. Если вы хотите массово загрузить новые изображения товаров вместо старых изображений, то удалите старые изображения в папке /images/com_ipricecalc/upload/, скопируйте в эту папку новые файлы изображений и загрузите файл импорта новых изображений товаров. Затем воспользуйтесь этой функцией для очистки старых изображений в базе данных. Так же для удаления старых изображений из базы данных можно перед импортом установить опцию "Удалить старые изображения"