Короткий опис структури XML-файлу імпорту

<?xml version="1.0" encoding="UTF-8"?>
<bbs type="items-import-export">
  <items>
    <item id="0" external="0">
      <title>Заголовок объявления</title>
      <description>Текст подробного описания объявления</description>
      <user id="10" shop="0">user@gmail.com</user>
      <category type="offer">31</category>
      <geo delivery="0">
        <city id="255">Киев</city>
        <station id="30">Площадь Независимости</station>
        <district>5</district>
        <addr>переулок Тараса Шевченко, 8б</addr>
        <lat>50.451099</lat>
        <lon>30.530300</lon>
      </geo>
      <price currency="1" free="0" exchange="0" agreed="0" mod="1">1000.00</price>
      <images>
        <image id="8">http://example.com/files/image1.jpg</image>
        <image id="4">http://example.com/files/image2.jpg</image>
      </images>
      <contacts>
        <name>Имя пользователя</name>
        <phones>
          <phone>123 00 11 11</phone>
          <phone>123 00 22 22</phone>
        </phones>
        <skype>_Skype1_</skype>
        <icq>1234567890</icq>
      </contacts>
      <video></video>
    </item>
    <item id="0" external="0">...</item>
  </items>
</bbs>

Основной элемент <items> с вложенными <item>.

• <item> включает в себя следующие атрибуты:
  • id который может быть равен нулю (0), в таком случае будет создано новое объявление, либо больше нуля, в таком случае будет выполнен поиск объявления по id в базе и если такое будет найдено, данные объявления будут обновлены.
  • external, при помощи которого доступна возможность указать ID во внешнем источнике, что позволяет в дальнейшем обновлять существующие объявления по указанному ID не привязываясь к ID в базе данных проекта. Данный атрибут принимает значения 0 или 1, в случае если указано значение 1, значение атрибута idобрабатывается как ID из внешнего источника (версия 2.2.4+).

В тег <item> входят следующие вложенные теги:

• <title> — заголовок объявления (обязательный элемент)
• <description> — описание
• <user id="10" shop="0">Email пользователя</user> — пользователь, владелец создаваемого объявления, id — ID пользователя в базе, shop — ID магазина привязанного к данному пользователю либо 0.
• <category type="offer">31</category> — ID категории, в которой будет размещено объявление, в данной категории не должно быть подкатегорий (обязательный элемент).
  • атрибут type определяет тип объявления (версия 2.2.4+) и принимает следующие значения:
    • offer — предлагаю/продам (по-умолчанию)
    • seek — ищу/куплю
  • тег не является обязательным, в случае его отсутствия будет использована категория указанная в настройках импорта.
• <geo delivery="0"> — гео. данные (обязательный элемент):
  • <city id="255">Киев</city> — ID города, название необязательно, главное указать атрибут id
  • <station id="30">Площадь Независимости</station> — ID станции метро, название необязательно
  • <district>5</district> — ID района города (версия 2.2.4+)
  • <addr>переулок Тараса Шевченко, 8б</addr> — адрес на карте
  • <lat>50.451099</lat> — координата Lat на карте
  • <lon>30.530300</lon> — координата Lon на карте
  • атрибут delivery — возможность доставки в регионы, варианты 1 или 0 (по-умолчанию). В случае если в категории, в которую добавляется объявление, настройка «Доставка в регионы» выключена — данный атрибут игнорируется.
• <price currency="1" free="0" exchange="0" agreed="0" mod="1">1000.00</price> — цена указываемая в объявлении.
  • атрибут currency — ID валюты
  • атрибут free — пометка «Даром», 0/1
  • атрибут exchange — пометка «Обмен», 0/1
  • атрибут agreed — пометка «Договорная», 0/1
  • атрибут mod — пометка «Торг возможен», 0/1
  • Значение — стоимость
• <images> — изображения, прикрепляемые к объявлению
  • <image id="8">http://example.com/files/image1.jpg</image>
  • Атрибут «id» — ID изображение в таблице bff_bbs_items_images на случай если оно уже было загруженно ранее или 0
  • Значение — URL изображения для загрузки
• <contacts> — контакты владельца объявления, указываются в каждом объявлении
  • <name> — имя
  • <phones> — телефоны
  • <skype> — skype
  • <icq> — icq
• <video> — видео-ссылка(url) на ролик youtube / vimeo