ZebroidДокументацияИмпортПрофили импорта XML

Профили импорта XML

В программе: Проект → Импорт → Профили импорта XML
Для того, чтобы иметь возможность правильно импортировать XML файлы, программе нужно объяснить какие значения и откуда ей нужно брать. Для этого нужно создать профиль импорта XML.

Профили импорта XML (вкладка «Статья (осн.)»)

Профили импорта XML (вкладка «Статья (осн.)»)


В верхней части окна находятся названия профилей. При двойном клике на профиль он активируется для редактирования.

Редактор состоит из 4 частей:

  1. Статьи (осн.) — правила формирование основных полей для статьи — название и текст;
  2. Статье (доп.) — правила формирование остальных полей для статьи;
  3. Категории — правила формирование категорий;
  4. Комментарии — правила формирование комментариев.

Для того, чтобы создать профиль у вас обязательно должен быть XML файл с нужной структурой (желательно чтобы это был небольшой файл, так как анализ больших файлов может занять некоторое время). Первым делом, после создания нового профиля, необходимо проанализировать файл, для того, чтобы программа знала какая у него структура. После анализа можно заняться заполнением необходимых полей.




Готовые профили


Профили импорта созданные нами поступают вам вместе с обновлениями, но если по каким-то причинам у вас они отсутствуют или файлы были повреждены — вы можете их скачать на этой странице. Если вы хотите изменить один из стандартных профилей, то рекомендуется создать копию профиля под другим названием, иначе есть шанс во время обновления программы затереть ваши изменения.

ContentMonstr.ru.zipРазмер: 337 байт
Instant CMS.zipРазмер: 1.15 Кб
kinoperez.ru.zipРазмер: 528 байт
labirint.ru.zipРазмер: 697 байт
ozon books.zipРазмер: 759 байт
phpBB3.zipРазмер: 514 байт
softmarket.zipРазмер: 705 байт
top-shop.ru.zipРазмер: 558 байт
Wiki.zipРазмер: 373 байт
WordPress.zipРазмер: 841 байт





Статьи (осн.)


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

Пример для XML с такой структурой:

<shop>
    <name>Интернет-магазин OZON.ru</name>
    <company>ООО "Интернет Решения"</company>
    <url>http://www.ozon.ru/</url>
    <currencies>
      <currency id="RUR" rate="1"></currency>
    </currencies>
    <categories>
    ...
    </categories>
    <offers>
        <offer id="83181" type="book" available="true">
           ...
        </offer>
       ...
    </offers>
 </shop>

Нужно выбрать тег: shop => offers => offer (тег offer повторяется в файле столько раз, сколько в нем есть статей)

Название — правило формирование названия статьи. Теги в этом поле указываются в двойных фигурных скобках. Например: {{name}} — {{author}}. По правому клику в поле тег вы можете выбрать необходимый тег и программа сама вставит его в нужном формате.

Текст статьи — правило формирование тегов статьи. Просто расставьте нужные теги в нужных местах. Как и в предыдущем случае теги указываются в двойных фигурных скобках (редактор их подсветит синим).

В тексте и названии статьи для выбора тегов нужно руководится следующим правилом: имя тега или параметра всегда должно быть заключено в двойные фигурные скобки. Так же есть возможность вытягивать значение тегов по условию. Условие может быть 2 типов — значение параметра либо значение тега. Например, у нас есть такой XML код:

...
<param name="Цвет">2х темно-серый, 2х ягодный</param>
<param name="Размер">40/42</param>
...

В обеих случаях имя тега param, но они в себе имеют разную по значению информацию. Для того, чтобы вытащить цвет, необходимо написать такой код {{param [attr_name=Цвет]}}, а чтобы размер, такой {{param [attr_name=Размер]}}. Как вы уже наверное догадались, синтаксис следующий:

{{ИМЯ_ТЕГА [attr_ИМЯ_АТРИБУТА=ЗНАЧЕНИЕ_АТРИБУТА]}}

Если нам нужно получить значение тега в зависимости от того, какое у него значение (понимаю, что звучит глупо, но и такое нужно бывает), тогда формат записи следующий:

{{ИМЯ_ТЕГА [value=ЗНАЧЕНИЕ_ТЕГА]}}

Эти конструкции можно использовать и на остальных вкладках окна, единственное, что необходимости в двойных фигурных дужках нету. Для того, чтобы задать такое значение, необходимо вызвать контекстное меню и выбрать пункт «Задать тег вручную»




Статьи (доп.)


Профили импорта XML (вкладка «Статья (доп.)»)

Профили импорта XML (вкладка «Статья (доп.)»)


Здесь представлена таблица, в которой задаются принадлежность определённых тегов полям статьи. Она состоит из 2 основных столбцов:

Параметр — поле, в которое будет занесено значение тега. Список доступных параметров:

  • Категория (идентификатор)
  • Категория (название)
  • Метки
  • Метка (повторяемое поле)
  • Дата (виндовс формат)
  • Дата (юникс формат)
  • Доп. поле (название)
  • Доп. поле (значение)
  • Признак статической страницы (пример в профиле WordPress)
  • alt_name (что это?)
  • description (что это?)
  • keywords (что это?)
  • Произвольное значение — если вписать в это поле своё значение, тогда Зеброид, содержимое тега файла добавит в доп. поле, название которого будет этим значением. Например, если вписать в это поле значение «seo_description», тогда во время импорта для поста будет создано доп. поле с именем «seo_description», а значение этого доп. поля будет взято из тега, указаного во второй колонке

Таг — имя тега, с которого будет браться значение.




Категории


Профили импорта XML (вкладка «Категория»)

Профили импорта XML (вкладка «Категория»)


Эту закладку стоит заполнять, если в файле отдельно описана структура категорий (так к примеру в WordPress XML). Ничего нового на этой вкладке нету, разве что список параметров для категорий немного отличается:

  • Имя
  • Идентификатор
  • Alt_name
  • Родитель (имя)
  • Родитель (идентификатор)
  • Текст
  • Произвольное значение — если вписать в это поле своё значение, тогда Зеброид, содержимое тега файла добавит в доп. поле, название которого будет этим значением

Родитель (идентификатор) — это поле, по которому можно определить родительскую категорию, например в таком файле:

<category id="1082707" parentid="5735">Биоэнергетика</category>

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




Комментарии


Профили импорта XML (вкладка «Комментарии»)

Профили импорта XML (вкладка «Комментарии»)


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