Описание формата импорт данных через CFI

Описание формата файла

Данные экспортируются в файл и импортируются из файла формата CSV с обязательным разделителем ;.

Кодировка файла по умолчанию UTF-8, поддерживается автоматическое преобразование кодировки, указанной в единственной настройке плагина.

Первая строка файла всегда представляет собой заголовки полей файла.

Зарезервированные имена полей:

articleid – id обновляемого материала, содержит значение 0 для вновь добавляемого материала, игнорирует строки для материалов с несуществующим id (обязательное поле);

articletitle – заголовок материала (обязательное поле);

articlecat – id категории материала, для новых материалов при отсутствии поля или указания id несуществующей категории будет применена категория «Uncategorised», для существующих материалов игнорируется;

articlelang – язык материала, для новых материалов при отсутствии поля материал будет доступен для всех языков, для существующих материалов игнорируется;

articleintrotext – вступительный текст материала;

articlefulltext – полный текст материала.

Поля articleid и articletitle являются обязательными, при их отсутствии импорт данных из файла не производится.

Любые иные основные поля материала игнорируются.

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

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

Данные об ошибках импорта хранятся в логе cfi.php в стандартной папке логов Joomla.

При отсутствии ошибок импорта данных импортируемый файл удаляется, в противном случае файл сохраняется в стандартной папке временных файлов Joomla.

Формат данных

При экспорте данные записываются в файл как есть, в том формате, в котором они хранятся в БД вашего сайта: простой текст, текст с разметкой HTML, структуры json, иные сложные строковые структуры.

Для стандартных дополнительных полей Joomla списочного типа, возвращающих структуры хранимых данных в виде неассоциированных массивов, в результирующий файл возвращается json. Для нестандартных полей в файл перед json-значением записывается структура array::: это необходимо для того, чтобы при возможном последующем импорте этих данных плагин смог разобрать json-значение из файла и подставить соответствующему полю подготовленный массив. Если из вышеуказанной фразы вы ничего не поняли – не страшно, просто не трогайте значение array:: в вашем файле или удалите этот столбец полностью во избежание повреждения данных соответствующего поля материала.