Доступ к странице


Экспорт и импорт продуктов компонента производится в разделе компонента: "База данных". Перейти к разделу можно следующими способами:

Выберите: Компоненты → JoomlaKassa → База данных, из выпадающего меню административной панели Joomla;

menu1

Через меню компонента: Инструменты → База данных;

menu2

Экспорт продуктов


При помощи этого инструмента вы можете экспортировать данные таблицы базы данных продуктов в CSV-файл (Comma-Separated Values – значения, разделённые запятыми) или YML-файл (Yandex Market Language – база данных Яндекс.Маркета) для их последующего редактирования, обновления или копирования.

Подробней о форматах файлов:

Для открытия окна экспорта нажмите кнопку: "Экспорт продуктов".

btn_export

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

modal_export

  1. Сохранённые файлы экспорта.
    Если вы ранее уже проводили экспорт продуктов, вверху окна вам будет показана кнопка: "Показать сохранённые файлы", нажмите на её, чтобы открыть список сохранённых файлов.
    export_saved_files
    1. Имя файла – это дата и время проведения экспорта, нажмите на него, чтобы загрузить этот файл. Файлы хранятся в директории вашего сайта: tmp/jk_export.
    2. Нажмите на значок крестика, чтобы удалить выбранный файл.
    3. Нажмите на кнопку: "Скрыть файлы", чтобы скрыть сохранённые файлы.
  2. Формат файла.
    Используйте это меню для выбора файла формата экспорта: CSV или YML. От выбранного здесь значения зависит отображение дальнейших параметров.
  3. Начиная со строки.
    Если в вашем магазине много продуктов, возможно, ваш сервер не справится с их обработкой для экспорта или импорта. В этом случае вам стоит разделить их на несколько файлов экспорта, с определённым количеством строк (см. параметр ниже). Например, если в предыдущем экспорте был установлен параметр "Количество строк" как 100, то при повторном экспорте, в этом поле, вам нужно установить значение 101. Оставьте пустым при первом экспорте или если вам это не нужно.
  4. Количество строк.
    Позволяет указать количество строк продуктов для экспорта. Чтобы задать номер строки смотрите параметр выше.
  5. Кодировка файла (только для CSV-файла).
    Позволяет выбрать кодировку, в которой будет сохранён файл: utf-8, windows-1251.
  6. Столбцы (только для CSV-файла).
    Позволяет выбрать нужные столбцы из записи в базе данных.
  7. Сохранить.
    После установки параметров экспорта нажмите кнопку "Сохранить" и сохраните файл на компьютер.
  8. Отменить.
    Закрывает окно экспорта продуктов.
Внимание! Большое число продуктов в магазине может привести к ошибке экспорта. Смотрите пункты: 3 и 4.

Строение CSV-файла


Перед импортом CSV-файла его необходимо создать, или провести редактирование файла, который был получен путём экспорта.

В CSV-файле значения отдельных колонок разделяются разделительным символом – точкой с запятой, но если открыть этот файл в программе Microsoft Excel, то он будет выглядеть, как показано на изображении ниже.

csv-files

Ниже приведена таблица с расшифровкой и описанием столбцов в документе Microsoft Excel.

Обратите внимание. Если ID или Алиас продукта указан и в базе данных, и он существует, будет произведено обновление продукта, в противном случае будет создан новый продукт.
Информация. Для создания нового продукта необходимо указать 'Alias', 'Id категории', 'Сумму платежа', 'Описание платежа'.
Примечание. Вы можете использовать только нужные вам столбцы в документе, столбцы с пустыми ячейками можно не указывать.
Внимание! Первая строка в документе должна содержать заголовки столбцов, и строго соответствовать заголовкам в примере ниже.
Столбец Описание Пример
Id товара Это уникальный идентификационный номер для этого элемента присваивается автоматически компонентом. 15
Наименование Не должно быть двух одинаковых имён продукта в одной категории. Произвольное значение. Холодильник X360-B
Title Определяет заголовок документа. Выводится в теге <title>, не является частью документа и не показывается напрямую на веб-странице. Если не используется, будет выведено имя продукта. Лучший холодильник
Алиас Не должно быть двух одинаковых алиаса продукта в одной категории. Алиас вводится латинскими символами, используя строчные буквы и дефисы без пробелов. refrigerator-x360-b
Id категории Цифровое значение. Категория, в которой будет находиться данный продукт. Категория должна быть создана предварительно в менеджере категорий компонента, полученный её идентификатор (id) должен быть введён здесь. 24
Код продукта Произвольное цифробуквенное значение. ИДП15-TCS4
Id производителя Цифровое значение. Производитель должен быть создан предварительно, в менеджере производителей компонента, полученный её идентификатор (id) должен быть введён здесь. 9
Id файлов Цифровое значение. Файл/файлы должны быть созданы предварительно, в менеджере файлов компонента, идентификаторы (id) созданных файлов должны быть указаны здесь, разделённые запятыми. 3,4,5,6
Id формы Цифровое значение. Html-форма которая будет предоставлена покупателю для её заполнения должна быть создана заранее, в менеджере форм компонента, полученный её идентификатор (id) должен быть введён здесь. 2
Изображение продукта Основное изображение продукта должно находиться в корневой папке images или в его вложенных папках. Путь указывается относительно корневой директории сайта. images/joomlakassa/00.png
Изображения Дополнительные изображения, которые будут показаны в галереи продукта (на странице одного продукта), если включен хотя бы один плагин изображений (JoomlaKassa Images). Должно быть указано в строгом формате JSON. См. примечание ниже *
Описание продукта Произвольный текст или HTML для описания продукта.  
Состояние Статус публикации элемента: 1 – опубликовано, 0 – не опубликовано, 2 – в архиве, -2 – в корзине. 1
В наличии Определяет, есть ли продукт в наличии в магазине: 1 – есть в наличии, 0 – нет в наличии. 1
Акция Определяет, включена ли акция: 1 – включена, 0 – выключена. 0
Описание акции Текст описание акции.  
Скидка Определяет, включена ли скидка: 1 – включена, 0 – выключена. 1
Значение скидки Значения скидок для групп пользователей сайта. Должно быть указано в строгом формате JSON. См. примечание ниже **
Id связанных продуктов Идентификаторы (id) продуктов, которые дополнят основной продукт и будут включены, по желанию покупателя к его списку покупок. Разделяются запятыми. 12,14
Доступ Идентификаторы (id) уровня доступа просмотра для данного продукта. См. Менеджер пользователей: Уровни доступа. 1
Порядок Определяет порядковый номер продукта в его категории. 6
Язык Идентификатор (id) контента языка для этого продукта, устанавливается в менеджере языков: Языки контента. Если вы не используете функцию многоязычного сайта Joomla, установите значение по умолчанию – "*" (звёздочка). *
Сумма платежа Стоимость, которую продавец желает получить от покупателя за данный продукт (с учетом валюты и курса магазина, настраивается в настройках магазина). Стоимость должна быть больше нуля, дробная часть отделяется точкой или запятой. 1.00 или 1,00 или 11
Описание платежа Эта строка добавляется в назначение платежа. Максимальная длина для каждой системы платежа варьируется от 100 до 255 символов. Холодильник X360-B белый
Мета-тег Keywords Слова и фразы, разделённые запятыми, которые будут выведены в теге мета Keywords HTML-страницы.  
Мета-тег Description Необязательный текст, который используется в качестве описания HTML-страницы. Как правило, этот текст используется поисковыми системами для показа описания страницы в результатах поиска.  
Мета-тег Robots Инструкция для веб 'роботов', для просмотра этой страницы. Должно быть указано в строгом формате JSON. {"robots":"","rights":""}
Лимит количества продуктов Позволяет установить минимальное количество при покупке данного продукта. Установите "1" – для отмены лимита. 1
Параметры товара Параметры данного продукта.  
Атрибуты Атрибуты для данного продукта.  

* Изображения продукта

Значения ячеек столбца "Изображения продукта" для каждой строки должны быть указаны в строгом формате JSON:

  • Весь текст должен заключаться в квадратные скобки: […];
  • Каждый элемент должен заключаться в фигурные скобки: {…} и разделяться запятой;
  • Все параметры и значения заключаются в двойные кавычки: "…", между собой должны быть разделены двоеточием и разделяться запятыми.

Параметры изображения:

  • name – служит для внутреннего администрирования, также оно будет использоваться как ALT изображения;
  • image – изображение, которое должно находиться в корневой папке images или в его вложенных папках, путь указывается относительно корневой директории сайта, например: images/joomlakassa/01.png;
  • published – позволяет установить состояние публикации изображения: 1 – опубликовано, 0 – не опубликовано;
  • access – позволяет выбрать уровень доступа для просмотра изображения: public – все, registered – зарегистрированные.

Пример:

[{"name":"01","image":"images/01.jpg","published":"1","access":"public"}, {"name":"02","image":"images/02.jpg","published":"0","access":"public"}, {"name":"","image":"images/03.jpg","published":"1","access":"registered"}]

** Значения скидок

Значения ячеек столбца "Значения скидок" для каждой строки должны быть указаны в строгом формате JSON:

  • Весь текст должен заключаться в квадратные скобки: […];
  • Каждый элемент должен заключаться в фигурные скобки: {…} и разделяться запятой;
  • Все параметры и значения заключаются в двойные кавычки: "…", между собой должны быть разделены двоеточием и разделяться запятыми.

Параметры скидок:

  • name – идентификатор (id) группы пользователей, группы должны быть установлены на сайте: Пользователи → Группы.;
  • value – значении скидки на стоимость продукта для группы пользователей в процентах без знака процентов "%";

Пример:

[{"name":"1","value":"10"}, {"name":"9","value":"10"}, {"name":"6","value":""}, {"name":"7","value":""}, {"name":"2","value":"20"}, {"name":"3","value":""}, {"name":"4","value":""}, {"name":"5","value":""}, {"name":"8","value":""}]

Импорт CSV-файла


При помощи этого инструмента вы можете импортировать данные продуктов из CSV-файла в таблицу продуктов базы данных компонента.

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

btn_import

Перед запуском процесса импорта нужно установить параметры импорта.

modal_import

  1. CSV-файл.
    Кнопка, отрывающая окно для выбора, импортируемого файла на вашем компьютере.
  2. Кодировка.
    Позволяет выбрать кодировку, в которой будет импортирован файл: utf-8, windows-1251.
  3. Отправить.
    После установки параметров импорта нажмите кнопку "Отправить" для проведения процесса импорта.
  4. Отменить.
    Закрывает окно импорта продуктов.
Внимание! Большое число продуктов может привести к ошибке импорта.

jkDocs

Мы в соц сетях

Поиск в документации