Краткое описание структуры 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">[email protected]</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