Приложение "Выгрузка Yandex.Realty": различия между версиями

Материал из CMS Sitebill Wiki
Перейти к навигации Перейти к поиску
 
(не показано 9 промежуточных версий этого же участника)
Строка 412: Строка 412:
 
'''S''' - одно
 
'''S''' - одно
 
'''M''' - несколько
 
'''M''' - несколько
 +
'''E''' - ни одного
 +
'''X''' - недопустимо
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! NNN !! больше !! меньше !! равно !! не равно !! больше или равно !! меньше или равно !! равно нулю или пустой строке !! равно не нулю или не пустой строке
+
! NNN !! равно\не равно !! больше\меньше !! больше\меньше или равно !! свойство установлено\не установлено
 
|-
 
|-
| safe_string || '''S''' || '''S''' || '''M''' || '''M''' || '''S''' || '''S''' || '''E''' || '''E'''
+
| safe_string || одно или несколько значений || одно значение * || одно значение * || '''X'''
 
|-
 
|-
| primary_key || - || - || - || - || - || - || - || -
+
| primary_key || одно или несколько значений || одно значение * || одно значение * || '''X'''
 
|-
 
|-
| price || - || - || - || - || - || - || - || -
+
| price || одно или несколько значений || одно значение * || одно значение * || '''X'''
 
|-
 
|-
| mobilephone || - || - || - || - || - || - || - || -
+
| mobilephone || одно или несколько значений || одно значение * || одно значение * || '''X'''
 
|-
 
|-
| date || - || - || - || - || - || - || - || -
+
| date || '''X''' || выражение даты ** || выражение даты ** || '''X'''
 
|-
 
|-
| dtdate || - || - || - || - || - || - || - || -
+
| dtdate || '''X''' || выражение даты ** || выражение даты ** || '''X'''
 
|-
 
|-
| dtdatetime || - || - || - || - || - || - || - || -
+
| dtdatetime || '''X''' || выражение даты ** || выражение даты ** || '''X'''
 
|-
 
|-
| geodata || - || - || - || - || - || - || - || -
+
| geodata || '''X''' || '''X''' || '''X''' || пустое выражение ***
 
|-
 
|-
| checkbox || - || - || - || - || - || - || - || -
+
| checkbox || одно или несколько значений || '''X''' || '''X''' || пустое выражение ***
 
|-
 
|-
| select_box_structure || - || - || - || - || - || - || - || -
+
| select_box_structure || одно или несколько значений || одно значение * || одно значение * || '''X'''
 
|-
 
|-
| select_by_query || - || - || - || - || - || - || - || -
+
| select_by_query || одно или несколько значений || одно значение * || одно значение * || '''X'''
 
|-
 
|-
 
| select_by_query_multi || - || - || - || - || - || - || - || -
 
| select_by_query_multi || - || - || - || - || - || - || - || -
 
|-
 
|-
| select_box || - || - || - || - || - || - || - || -
+
| select_box || одно или несколько значений || одно значение * || одно значение * || '''X'''
 
|-
 
|-
| textarea || - || - || - || - || - || - || - || -
+
| textarea || '''X''' || '''X''' || '''X''' || пустое выражение ***
 
|-
 
|-
| texarea_editor || - || - || - || - || - || - || - || -
+
| texarea_editor || '''X''' || '''X''' || '''X''' || пустое выражение ***
 
|-
 
|-
| uploads || - || - || - || - || - || - || - || -
+
| uploads || '''X''' || '''X''' || '''X''' || пустое выражение ***
 
|-
 
|-
| docuploads || - || - || - || - || - || - || - || -
+
| docuploads || '''X''' || '''X''' || '''X''' || пустое выражение ***
 
|}
 
|}
 +
 +
'''одно значение''' означает, что строка значений не содержит запятую. Если в таком поле будет передано несколько значений, то для расчета условия будет применено только первое из них, а остальные проигнорированы. Например вы указали
 +
<pre>
 +
city_id | больше | 6,4,7
 +
</pre>
 +
такая запись будет расценена как
 +
<pre>
 +
city_id | больше | 6
 +
</pre>
 +
 +
'''выражение даты''' - специальное выражение содержащее указание на точку отсчета и, при необходимости, размер и направление оффсета. Например
 +
<pre>
 +
/*добавленные не позже чем 30 дней назад*/
 +
date_added | больше | NOW-30
 +
</pre>
 +
<pre>
 +
/*те, у которых дата в поле export_to_yandex_end_date не больше чем сегодняшняя*/
 +
export_to_yandex_end_date | больше | NOW
 +
</pre>
 +
 +
'''пустое выражение''' - означает, что значение не указывается. Ни пустая строка, ни ноль. Не указывается вообще. Даже если оно будет указано, то не будет обработано. Для данного типа условия необходимо только его наличие, а реальное условие проверки будет создано исходя из типа поля. Для safe_string или textarea - это будет проверка на непустое значение.

Текущая версия на 19:18, 8 марта 2020

Описание

Приложение организовывает xml-фид данных согласно формату Yandex-Недвижимость (Спецификация)

Типы выгрузок

Стандартная - осуществляется через стандартную точку доступа при отсутствии указанного своего алиаса точки доступа в параметре настроек - Алиас приложения (apps.yandexrealty.alias)

Расширенная - осуществляется через точку доступа указанную в параметре настроек - Алиас приложения (apps.yandexrealty.alias). Даже если в этом параметре указать стандартное имя yandexrealty, выгрузка все равно будет выполняться по типу Расширенная

Эти варианты выгрузок отличаются внутренней механикой формирования фида и способом сбора данных для отдачи, что приводит разным возможностям использования полученных данных. Использование Расширенной выгрузки является приоритетным. Так же Расширенная выгрузка может быть модифицирована под нужды пользователя в отличии от Стандартной.

Общая информация

Выгрузка отклоняется для объявлений у которых неуказана (или равна нулю) цена и не указан город.
Адрес выгрузки по умолчанию http://ваш_сайт/yandexrealty/
В новых версиях есть возможность переопределить адрес выгрузки указав в настройках приложения любое друго значение алиаса, кроме yandexrealty. В таком случае обращения к http://ваш_сайт/yandexrealty/ будут обрабатываться встроенным механизмом выгрузки, а обращения по вашему алиасу будут обрабатываться фронтальным обработчиком или, при наличии, локальной копией в Вашем шаблоне.
Механика выгрузок по стандартному адресу и по переопределенному отличается. В первом случае выгрузка именуется Стандартная, а во втором - Расширенная.

Отчет о выгрузке

Информация об успешной выгрузке и об ошибках возникающих при выгрузке записывается в этот файл
http://адрес_вашего_сайта/cache/yandexrealty.last.log.xml



Для того чтобы начать выгружать свои объявления в Яндекс-недвижимость вам нужно зарегистрироваться тут https://compartner.realty.yandex.ru/feeds

Как создать дополнительную точку выгрузки

Что бы добавить дополнительные фиды выгрузки в дополнение к основному воспользуйтесь описанием на форуме

Принимающие участие в выгрузке поля

Общие поля

id - идентификатор объявления внутри системы

optype - поле типа select_box c допустимыми значениями 0 = продажа, 1 = аренда. При отсутствии в модели данного поля в выгрузке будет установлен тип операции "продажа".

property_type - текстовое поле устанавливающее тип недвижимости. В случае отсутствия будет установлен тип "жилая". В противном случае в тег будет помещено значение из этого поля.

country - если в ваших объявлениях явно указана страна с помощью поля country_id, это значение пойдет в выгрузку. Если этого значения нет, оно не указано или указано в виде пустой строки, в выгрузку пойдет информация с указанием страны "Россия"

Агент

Тип агента - собственник (owner) присваивается, если для объявления указано поле fio и объявление привязно к пользователю _unregistered. Или же владельцем объявления является зарегистрированный пользователь, но модуль компаний отключен, либо включен, но пользователю не сопоставлена ни одна из компаний. Остальные данные по владельце (ФИО, телефон, почта) будут взяты из данных объявления (для нерегистрированных), либо из данных профиля пользователя (для зарегистрированных), либо из профиля компании (для агентств)

Валюта.

Для определения валюты используется значение поля name (Название) валюты, которое указано через Менеджер валют. Если названием является одно из обозначений 'RUR', 'RUB', 'USD', 'EUR', 'UAH', 'BYR', 'KZT', то оно и будет выбрано. Если оно имеет другое значение, то будет предпринята попытка найти другие сопоставления:

  • при нахождении "белорусский" установится 'BYR'
  • при нахождении "рубль" установится 'RUR'
  • при нахождении "руб." установится 'RUR'
  • при нахождении "доллар" установится 'USD'
  • при нахождении "США" установится 'USD'
  • при нахождении "евро" установится 'EUR'
  • при нахождении "гривна" установится 'UAH'
  • при нахождении "грн" установится 'UAH'
  • при нахождении "теньге" установится 'KZT'

Во всех остальных случаях валюта не будет определена

UPD. C версии 1.8.2 для определения валюты используется ID валюты и список валют из приложения "Менеджер валют". Текстовое написание названия валюты более не учитывается. Если идентификатор валюты указан у объекта, то будет произведен поиск соотв. валюты в списке валют, получен ее код и именно он будет использован для вывода в фид.

Для моновалютных сайтов у которых не используется поле выбора валюты добавлена настройка Все цены указаны в валюте (apps.yandexrealty.global_currency_code) в котором можно указать один из допустимых кодов валюты в которой хранятся цены без необходимости добавления поля выбора валюты в данные объекта. Эта настройка имеет приоритетное значение - задав ее для мультивалютного сайта Вы перекроете все значения валют и цены будут выгружаться в фид с указанием валюты именно из этого поля.

Настройки

Контракт

Поле:Значение отвечающие за признак продажи (apps.yandexrealty.sell)/Поле:Значение отвечающие за признак аренды (apps.yandexrealty.rent) - настройка позволяющая указать явно системное имя поля отвечающего за тип операции, если таковое присутствует в модели, и значение для него. Например, если у вас за тип операции отвечает поле optype cо значениями 1-Аренда, 2-Продажа, тогда в первом нужно указать optype:2 а во втором optype:1.

Данная настройка является приоритетной. Она будет браться в расчет игнорируя аналогичную настройку и таблицы ассоциаций.

Технические

Выгружать в файл (apps.yandexrealty.tofile) - предписывает выгрузчику кешировать результат выгрузки. Если отметка стоит, значит при обращении за выгрузкой Sitebill сначала попытается найти свежий подготовленный файл с выгрузкой и отдаст его, и, только если его нет или он устарел, проведет динамическую выгрузку, запишет ее в файл и отдаст данные из файла. Если отметка не стоит, тогда каждый запрос за выгрузкой инициирует новую выборку данных и формирование xml-результата "в прямом эфире" без сохранения в файл.

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

Время жизни файла кеша (в секундах) (apps.yandexrealty.filetime) - определяет срок жизни файла кеша выгрузки. При выгрузке "в файл" будет проведена проверка времени создания файла кеша и, если он уже прожил срок указанный в этой настройке, будет произведено его удаление и замена новым кешем.

Системное имя поля, содержащего изображения (apps.yandexrealty.images_field) - указывает системное имя поля в модели, откуда следует брать фотографии. Актуально при использовании полей типа uploads, которые содержат графические материалы и которых в модели может быть несколько - что бы выгрузчик знал конкретно где нужные фотографии, а где иные материалы.

Количество дней за которое будут выбраны объявления для выгрузки (apps.yandexrealty.days_interval) - ограничивающий параметр, который ограничивает отбираемые для выгрузки объявления по давности срока создания.

Алиас приложения (apps.yandexrealty.alias) - позволяет указать свой алиас для точки входа на выгрузчик взамен стандартного yandexrealty. Установка любого значения в это поле переводит выгрузку на алгоритм Расширенная

Локация

Единое название страны (apps.yandexrealty.country_global) - позволяет указать единое для всех выгружаемых объявлений название страны. Данная настройка является первичной и указание в ее поле некоторого значения отменить все остальные обработки. Указав в этом поле значение напр. "Россия", в фиде выгрузки все теги country будут проинициализированы этим значением, вне зависимости от того есть ли в модели объявления поле с именем страны и указано ли оно. Настройка подходит сайтам у которых выбор страны не вынесен в обязательные данные, но все объявления расположены в рамках одной страны

Системное имя поля с именем страны (apps.yandexrealty.country_from) - указывает поле хранящее текстовое имя страны для данного объявления. Не имеет смысла указывать в этом поле системные имена полей типов отличных от safe_string, если вы предварительно не модифицировали алгоритм сборки данных так, что в этом поле будет текстовое имя страны.

Единое название региона (apps.yandexrealty.region_global) - позволяет указать единое для всех выгружаемых объявлений название региона. Данная настройка является первичной и указание в ее поле некоторого значения отменить все остальные обработки. Указав в этом поле значение напр. "Московская область", в фиде выгрузки все теги region будут проинициализированы этим значением, вне зависимости от того есть ли в модели объявления поле с именем региона и указано ли оно. Настройка подходит сайтам у которых выбор региона не вынесен в обязательные данные, но все объявления расположены в рамках одного региона

Системное имя поля с именем региона (apps.yandexrealty.region_from) - указывает поле хранящее текстовое имя региона для данного объявления. Не имеет смысла указывать в этом поле системные имена полей типов отличных от safe_string, если вы предварительно не модифицировали алгоритм сборки данных так, что в этом поле будет текстовое имя страны.

Единое название города (apps.yandexrealty.city_global) - позволяет указать единое для всех выгружаемых объявлений название города. Данная настройка является первичной и указание в ее поле некоторого значения отменить все остальные обработки. Указав в этом поле значение напр. "Саратов", в фиде выгрузки все теги locality-name будут проинициализированы этим значением, вне зависимости от того есть ли в модели объявления поле с именем города и указано ли оно. Настройка подходит сайтам у которых выбор города не вынесен в обязательные данные, но все объявления расположены в рамках одного города

Системное имя поля с именем города (apps.yandexrealty.city_from) - указывает поле хранящее текстовое имя города для данного объявления. Не имеет смысла указывать в этом поле системные имена полей типов отличных от safe_string, если вы предварительно не модифицировали алгоритм сборки данных так, что в этом поле будет текстовое имя страны.

Системное имя поля с именем улицы (apps.yandexrealty.street_from) - указывает поле хранящее текстовое имя улицы для данного объявления. Не имеет смысла указывать в этом поле системные имена полей типов отличных от safe_string, если вы предварительно не модифицировали алгоритм сборки данных так, что в этом поле будет текстовое имя страны.

Данные владельца

Режим тонкой настройки контактов и групп (apps.yandexrealty.contacts_export_mode) - позволяет использовать настройку сопоставления сайтовых групп пользователей группам в ЯН и указать варианты источника контактных данных для выгрузки


Строка ассоциирования выгрузки контактов (apps.yandexrealty.contacts_assoc_str) - позволяет указать источник контактных данных для выгрузки объявления в зависмости от группы пользователя, являющегося владельцем объявления на сайте
может иметь вид

Источником контактов служат а) контактные данные в данных объявления, б) контактные данные из профиля пользователя сайта.
Указывается в виде строки пар значений вида N:S разделенных точкой с запятой, где N - числовой идентификатор группы на сайте, S - числовой идентификатор типа источника. В качестве общего идентификатора группы N может использоваться знак * обозначающий "все". Такого рода правило будет действовать в сквозном режиме, но все частные правила будут его переопределять.
Существует 4 типа источников:
1 - все из данных объявления. фактически это data.fio, data.phone, data.email
2 - все из профиля связанного пользователя. фактически это user.fio, user.phone, user.email
3 - из данных объявления, но, если не хватает каких-то полей, то добирается из профиля связанного пользователя (например в data указаны только email владельцев, а отсутствующие телефон и имя берутся уже из re_user)
4 - обратное к 3
Например:

1:1;3:2

для группы ИД=1 источник 1-го типа, для группы 3 - источник 2-го типа

*:3

для всех групп источник 3-го типа

*:2;2:1

для всех групп источник 2-го типа, а для группы 2 - источник 1-го типа


Если тип источника для какой-то группы не будет указан, как например в 1-м примере не указано для группы ИД=2, тогда будет использоваться дефолтное значение 2 (из профиля)

Строка ассоциирования назначения группы (apps.yandexrealty.groups_assoc_str) - указывает соответствие группы пользователя на сайте одной из допустимых групп в классификации ЯН Позволяет установить для разных групп сайта свои определители.
Например
Указывается в виде строки пар значений вида N:G разделенных точкой с запятой, где N - числовой идентификатор группы на сайте, G - буквенный идентификатор группы на ЯН (o - владелец (owner), a - агентство (agency), d - застройщик (developer)). В качестве общего идентификатора группы N может использоваться знак * обозначающий "все". Такого рода правило будет действовать в сквозном режиме, но все частные правила будут его переопределять.
Например:

1:o;3:a;2:d

обозначает, что группа с идентификатором 1 будет выгружена как <category>owner</category>, группа 3 как <category>agency</category> и группа 2 как <category>developer</category>

*:a;1:o

все будут выгружаться как агенты\агентства, а 1-я группа как владельцы.

Дефолтным значением в случае не указания будет owner (o)

apps.yandexrealty.organisation_global_name (Общее для всех агентов название организации)

Общее значение тега organisation, которое будет установлено для всех агентов в выгрузке. Следует применять, если выгрузка содержит в себе объекты только одного агентства. Тег выгружается только для агентов, которые определены как "агентство"

apps.yandexrealty.organisation_src (Системное имя поля в модели профиля хранящее название организации)

Имя системного поля в модели user, которое содержит текстовое название агенства данного агента. Поле должно быть типа safe_string.

Обсудить на форуме и задать свои вопросы по выгрузке можно тут http://goo.gl/rCfzlK

Площади участков

Системное имя поля с площадью участка (apps.yandexrealty.lot_area) - системное имя поля строкового типа в котором хранится площадь земельного участка для объектов типа "земельный участок" или "земля". При не указании используется системное имя lot_area

Размерность значения системного поля с площадью участка (sqm|ha|acr) (apps.yandexrealty.lot_area_dim) - Размерность значения площади участка. Варианты значений: sqm - кв.м., ha - га, acr - сотки. По-умолчанию сотки

Системное имя поля с площадью дополнительного участка (apps.yandexrealty.add_lot_area) - системное имя поля строкового типа в котором хранится площадь дополнительного земельного участка для объектов типа "дом с участком". При не указании используется системное имя lot_area

Размерность значения системного поля с площадью дополнительного участка (sqm|ha|acr) (apps.yandexrealty.add_lot_area_dim) - Размерность значения площади дополнительного участка. Варианты значений: sqm - кв.м., ha - га, acr - сотки. По-умолчанию сотки

Жилые комплексы

apps.yandexrealty.complex_enable (Выгружать информацию о ЖК из приложения Жилые комплексы)

Сопоставления типов для коммерческой

Условия соотвествия коммерческому типу "офисные помещения" (apps.yandexrealty.comm_office_cond)

Условия соотвествия коммерческому типу "торговые помещения" (apps.yandexrealty.comm_retail_cond)

Условия соотвествия коммерческому типу "склад" (apps.yandexrealty.comm_warehouse_cond)

Условия соотвествия коммерческому типу "помещения свободного назначения" (apps.yandexrealty.comm_freepurpose_cond)

Условия соотвествия коммерческому типу "земли коммерческого назначения" (apps.yandexrealty.comm_land_cond)

Условия соотвествия коммерческому типу "производственное помещение" (apps.yandexrealty.comm_manufacturing_cond)

Условия соотвествия коммерческому типу "производственное помещение" (apps.yandexrealty.comm_autorepair_cond)

Условия соотвествия коммерческому типу "производственное помещение" (apps.yandexrealty.comm_business_cond)

Условия соотвествия коммерческому типу "юридический адрес" (apps.yandexrealty.comm_legaladdress_cond)

Условия соотвествия коммерческому типу "общепит" (apps.yandexrealty.comm_publiccatering_cond)

Условия соотвествия коммерческому типу "гостиница" (apps.yandexrealty.comm_hotel_cond)

Набор настроек, которые помогают указать конкретный тип коммерческой недвижимости, если это не возможно сделать с помощью таблицы ассоциаций по разделам сайта. Для каждой настройки можно прописать набор условий, при выполнении которых объекту будет сопоставлен данный тип. Например на сайте присутствует раздел Коммерческая (ID=4) без дальнейшей детализации подразделов. Но, вместе с этим, существует отдельное поле Тип коммерческой недвижимости вида select_box с вариантами {1~~Торговля}{2~~Склад}{3~~Офисное} и системным именем commercial_subtype. Тогда для обозначения типа "офисные помещения" нам необходимо задать в настройку apps.yandexrealty.comm_office_cond значение

topic_id=4|commercial_subtype=3

Для "торговые помещения"

topic_id=4|commercial_subtype=1

Условия указываются в виде равенств и разделяются знаком | который обозначает И Условия можно указать в несколько строк. В таком случае каждая строка будет означать отдельное условие и выполнение одного из них будет означать совпадение. Запись вида

условие1|условие2
условие3|условие4

будет трактоваться как (условие1 И условие2) ИЛИ (условие3 И условие4)

Сопоставления типов для гаражей

Сопоставление типа гаража (гараж) (apps.yandexrealty.garage_ga)

Сопоставление типа гаража (машиноместо) (apps.yandexrealty.garage_pp)

Сопоставление типа гаража (бокс) (apps.yandexrealty.garage_bx)


Набор настроек, которые помогают указать конкретный тип гаража. Мы указываем как вывести конкретный тип гаража по версии ЯН из данных наших объектов. Глобальный тип "Гаражи" должен быть установлен для объектов через таблицу ассоциаций. Например все гаражи расположены в ветке разделов Гаражи. Тогда для этой ветки в таблице ассоциаций Вы указываете тип "Гараж", включая вложенные ветки. А уже конкретные типы гаражей (гараж, машиноместо, бокс) присваиваете через упомянутые выше настройки.

Для каждой настройки можно прописать набор условий, при выполнении которых объекту будет сопоставлен данный тип. Например на сайте присутствует раздел Гаражи (ID=12) с вложенными подразделами Парковка (ID=121), Гараж (ID=215), Бокс (ID=598). Так как для веток Гаражи, Гаражи\Парковка, Гаражи\Гараж, Гаражи\Бокс Вы ужеуказали глобальный тип гараж в таблице ассоциаций, то можете указать теперь и конкретные правила для определения детальных типов гаража.

Тогда для обозначения типа "гараж" нам необходимо задать в настройку apps.yandexrealty.garage_pp значение

topic_id=215

Для "машиноместо" нам необходимо задать в настройку apps.yandexrealty.garage_ga значение

topic_id=121

Для "бокс" нам необходимо задать в настройку apps.yandexrealty.garage_bx значение

topic_id=598

Если возможности указать какой-то конкретный тип гаража нет - не указывайте его. Оставьте поле настройки пустым.

Условия указываются в виде равенств и разделяются знаком | который обозначает И Условия можно указать в несколько строк. В таком случае каждая строка будет означать отдельное условие и выполнение одного из них будет означать совпадение. Запись вида

условие1|условие2
условие3|условие4

будет трактоваться как (условие1 И условие2) ИЛИ (условие3 И условие4)

Сопоставления типов здания

Сопоставление типа здания (бизнес-центр) (apps.yandexrealty.cbt_bc)

Сопоставление типа здания (отдельно стоящее здание) (apps.yandexrealty.cbt_db)

Сопоставление типа здания (встроенное помещение) (apps.yandexrealty.cbt_rb)

Сопоставление типа здания (торговый центр) (apps.yandexrealty.cbt_sc)

Сопоставление типа здания (складской комплекс) (apps.yandexrealty.cbt_wh)

Набор настроек, которые помогают указать тип здания для коммерческой недвижимости. Настройки задаются в виде строк сопоставления в формате

системное_имя_поля_сравнения|значения_соответствия

где системное_имя_поля_сравнения содержит системное имя поля в модели объекта по которому проводится сравнение, а значения_соответствия содержат перечень значений разделенных запятой.

Например на сайте присутствует свойство объекта Тип здания с системным именем building_type типа seect_box и значениями {1~~склад}{2~~ТЦ}{3~бизнес центр}{4~большой бизнес центр}. Тогда для обозначения типа здания "торговый центр" нам необходимо задать в настройку apps.yandexrealty.cbt_sc значение

building_type:3,4

Для "складской комплекс" в настройку apps.yandexrealty.cbt_wh

building_type:1

Можно указать условие только по одному свойству.

Сопоставления типов ремонта

Условия соответствия ремонту "дизайнерский" (apps.yandexrealty.renovation_design_cond)

Условия соответствия ремонту "евро" (apps.yandexrealty.renovation_euro_cond)

Условия соответствия ремонту "с отделкой" (apps.yandexrealty.renovation_withdecor_cond)

Условия соответствия ремонту "требует ремонта" (apps.yandexrealty.renovation_reqrepair_cond)

Условия соответствия ремонту "хороший" (apps.yandexrealty.renovation_good_cond)

Условия соответствия ремонту "частичный ремонт" (apps.yandexrealty.renovation_patialrep_cond)

Условия соответствия ремонту "черновая отделка" (apps.yandexrealty.renovation_roughing_cond)


Набор настроек, которые помогают указать конкретный тип ремонта недвижимости.

Указание настроек производится аналогично описанному в разделе "Сопоставление типов для коммерческой"

Сопоставления типов состояния

Условия соответствия состоянию "отличное" (apps.yandexrealty.quality_best_cond)

Условия соответствия состоянию "хорошее" (apps.yandexrealty.quality_good_cond)

Условия соответствия состоянию "нормальное" (apps.yandexrealty.quality_norm_cond)

Условия соответствия состоянию "плохое" (apps.yandexrealty.quality_bad_cond)


Набор настроек, которые помогают указать конкретный тип состояния объекта недвижимости.

Указание настроек производится аналогично описанному в разделе "Сопоставление типов для коммерческой"

Определение типа "Студия"

Условия соответствия "студия" (apps.yandexrealty.studio_cond)

Набор настроек, которые помогают указать принадлежит ли объект недвижимости к виду "Студия".

Указание настроек производится аналогично описанному в разделе "Сопоставление типов для коммерческой"

Определение типа "Апартаменты"

Условия соответствия "апартаменты" (apps.yandexrealty.apartment_cond)

Набор настроек, которые помогают указать принадлежит ли объект недвижимости к виду "Апартаменты".

Указание настроек производится аналогично описанному в разделе "Сопоставление типов для коммерческой"

Название организации

Общее для всех агентов название организации (apps.yandexrealty.organisation_global_name) - настройка позволяющая указать глобальное (общее для всех) название организации. Если в этом поле указано любое значение, то оно будет выведено в тег organisation у всех выгружаемых объектов. Ни одна другая настройка связанная с этой информацией не будет использована.

Системное имя поля в модели профиля хранящее название организации (apps.yandexrealty.organisation_src) - системное имя поля в модели Пользователя, содержащее название организации. Поле должно быть текстового типа (safe_string или textarea) и содержать текстовое имя организации.

Номер квартиры

Системное имя поля в модели объекта хранящее номер квартиры (apps.yandexrealty.aptnr_from) - системное имя поля в модели Объекта, содержащее номер квартиры. Поле должно быть текстового типа (safe_string или textarea) и содержать текстовое значение. Данное значение используется только для типов "жилая".

Кадастровый номер

Системное имя поля в модели объекта хранящее кадастровый номер (apps.yandexrealty.cadastralnr_from) - системное имя поля в модели Объекта, содержащее кадастровый номер объекта. Поле должно быть текстового типа (safe_string или textarea) и содержать текстовое значение.

Форма налогообложения арендодателя для аренды

Условия форме налогообложения арендодателя "НДС" (apps.yandexrealty.taxation_nds)

Условия форме налогообложения арендодателя "УСН" (apps.yandexrealty.taxation_usn)

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

Указание настроек производится аналогично описанному в разделе "Сопоставление типов для коммерческой"

Дополнительная информация об аренде коммерческой недвижимости

Условия "Клининг входит в договор аренды" (apps.yandexrealty.rent_cleaning_yes)

Условия "Коммунальные услуги включены в стоимость в договоре" (apps.yandexrealty.rent_utilities_yes)

Условия "Электроэнергия включена в стоимость в договоре" (apps.yandexrealty.rent_electricity_yes)

Эти настройки позволяют указать наличие соответствующих опций. Указание условий наличия производится аналогично описанному в разделе "Сопоставление типов для коммерческой"

Персональные фиды

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

Для разрешения такого доступа необходимо в настройках приложения отметить чекбокс "Разрешить персональные фиды пользователей" и указать значение токена доступа "Токен доступа к персональным фидам пользователей" в виде произвольной строки. Режим активируется когда одновременно включена галочка разрешения и указана непустая строка в виде токена.

Доступ к фидам выполняется посредством запроса на стандартный адрес фида выгрузки с передачей дополнительных параметров в запросе user_id и token. Например Ваш стандартный фид доступен по адресу

/my_yandexfeed

Тогда для получения выгрузки для пользователя с ID равным 1154 необходимо отправить запрос по адресу

/my_yandexfeed?user_id=1151&token=ACCESS_TOKEN

где вместо ACCESS_TOKEN указать значение токена из параметра настройки "Токен доступа к персональным фидам пользователей".

Hooks для замены контактов

Для замены номеров телефонов пользователей можно разметстить файл
/template/frontend/ваш_шаблон/hooks/hooks.php с таким содержанием


<?php
function yandex_data_hook ($data_item) {
    switch ($_SERVER['REQUEST_URI']) {
        case '/exportyandex/234123123':
            $data_item['phone'] = 'test replace 1';
        break;
    
        case '/exportyandex/908a0sd9809823':
            $data_item['phone'] = 'test replace 2';
        break;
    
        default:
    }
    return $data_item;
}

Фиды

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

Параметры фида:

Активен - устанавливает активность фида - его доступность по указанному адресу.

Игнорировать активность при выгрузке - по-умолчанию в фид идут объекты только в активном состоянии (неархивные). Включив этот чекбокс, Вы можете изменить это поведение на такое, что в фид будут идти объекты без учета их активности.

Длина фида - максимальное число выгружаемых объектов. При не указании фид не ограничивается. При его указании возможно будет иметь смысл указать сортировочные параметры.

Алиас - адрес фида. Указывайте только алиас, без домена сайта и языкового префикса. Не допускается указание GET-переменных. Сортировка - системное имя своства в модели data для сортировки фида. При не указании сортировка отсутствует.

Направление сортировки - устанавливает направление сортировки

Примечание или описание - произвольное описание фида

Параметры - набор фильтрующих параметров. Если ни один параметр не указан, то фид будет содержать все активные объекты без любой сортировки.


Количество значений: S - одно M - несколько E - ни одного X - недопустимо

NNN равно\не равно больше\меньше больше\меньше или равно свойство установлено\не установлено
safe_string одно или несколько значений одно значение * одно значение * X
primary_key одно или несколько значений одно значение * одно значение * X
price одно или несколько значений одно значение * одно значение * X
mobilephone одно или несколько значений одно значение * одно значение * X
date X выражение даты ** выражение даты ** X
dtdate X выражение даты ** выражение даты ** X
dtdatetime X выражение даты ** выражение даты ** X
geodata X X X пустое выражение ***
checkbox одно или несколько значений X X пустое выражение ***
select_box_structure одно или несколько значений одно значение * одно значение * X
select_by_query одно или несколько значений одно значение * одно значение * X
select_by_query_multi - - - - - - - -
select_box одно или несколько значений одно значение * одно значение * X
textarea X X X пустое выражение ***
texarea_editor X X X пустое выражение ***
uploads X X X пустое выражение ***
docuploads X X X пустое выражение ***

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

city_id | больше | 6,4,7

такая запись будет расценена как

city_id | больше | 6

выражение даты - специальное выражение содержащее указание на точку отсчета и, при необходимости, размер и направление оффсета. Например

/*добавленные не позже чем 30 дней назад*/
date_added | больше | NOW-30
/*те, у которых дата в поле export_to_yandex_end_date не больше чем сегодняшняя*/
export_to_yandex_end_date | больше | NOW

пустое выражение - означает, что значение не указывается. Ни пустая строка, ни ноль. Не указывается вообще. Даже если оно будет указано, то не будет обработано. Для данного типа условия необходимо только его наличие, а реальное условие проверки будет создано исходя из типа поля. Для safe_string или textarea - это будет проверка на непустое значение.