XML - импорт объявлений (XML-выгрузка)

Фид составляется на языке XML — eXtensible Markup Language (расширяемый язык разметки).

Основные требования для наполнения фида:
  • ЗАПРЕЩЕНА повторная подача одного и того же объявления; Подробнее о запрете
  • Фид предназначен для всех актуальных объявлений, доступных на сайте;
  • Каждое объявление передается с максимальным набором параметров;
  • Тексты объявлений и описания-характеристики должны быть свободны от HTML-кода;
  • Цена указывается в корректном виде и отвечает реальности;
  • В фиде передаются лишь параметры, введенные подателем объявления;
  • Если податель объявления не указал какого-либо параметра, то соответствующий тег передавать не следует.

Важно для владельцев «Магазины»
Для реализации функции «ИМПОРТА» объявлений следует сделать соответствующий запрос с указанием темы «XML — импорт».

После того, как модератор проверит ваш запрос, ваш «Личный кабинет» получит соответствующую вкладку Импорт

Узнать о требуемом формате фида возможно после скачивания шаблона требуемой категории/подкатегории



Краткое описание структуры XML файла импорта для Раздела Аренда Недвижемости:

<code class="language-xml">
<?xml version="1.0" encoding="UTF-8"?>
<bbs type="items-import-export">
  <items>
    <item id="0">
      <title>Заголовок объявления</title>
      <description>Текст подробного описания объявления</description>
      <user id="10" shop="0">user@gmail.com</user>
      <category>31</category>
      <geo>
        <city id="1004">Санкт-Петебург</city>
        <station id="371">Гостиный двор</station>
        <addr>Набережная реки Фонтанки, 22</addr>
        <lat>59.932914</lat>
        <lon>30.343806</lon>
      </geo>
      <price currency="3" free="0" exchange="0" mod="1">850.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>888 00 11 11</phone>
          <phone>888 00 22 22</phone>
        </phones>
        <skype>_Skype1_</skype>
        <icq>1234567890</icq>
      </contacts>
      <video></video>
    </item>
    <item id="0">...</item>
  </items>
</bbs>
</code>

Основной элемент <items> с вложенными <item>.
Тег <item> включает в себя атрибут id <item id="0">, который может быть равен нулю (0), в таком случае будет создано новое объявление, либо больше нуля, в таком случае будет выполнен поиск объявления по id в базе и если такое будет найдено, данные объявления будут обновлены. В него входят следующие вложенные теги:

  • <title> — заголовок объявления
  • <description> — описание
  • <user id="10" shop="0">Email пользователя</user>  — пользователь, владелец создаваемого объявления, id — ID пользователя в базе, shop — ID магазина привязанного к данному пользователю либо 0.
  • <category>31</category> — ID категории, в которой будет размещено объявление, в данной категории не должно быть подкатегорий.
  • <geo> — гео. данные:
    • <city id="1004">Санкт-Петебург</city> — ID города, название необязательно, главное указать атрибут id
    • <station id="371">Гостиный двор</station> — ID станции метро, название необязательно
    • <addr>Набережная реки Фонтанки, 22</addr> — адрес на карте
    • <lat>59.932914</lat> — координата Lat на карте
    • <lon>30.343806</lon> — координата Lon на карте
  • <price currency="3" free="0" exchange="0" mod="1">850.00</price> — цена указываемая в объявлении.
    • атрибут currency — ID валюты
    • атрибут free — пометка «Даром», 0/1
    • атрибут exchange — пометка «Обмен», 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