Краткое описание структуры 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— ищу/куплю
- тег не является обязательным, в случае его отсутствия будет использована категория указанная в настройках импорта.
- атрибут type определяет тип объявления (версия 2.2.4+) и принимает следующие значения:
<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