Ваш бизнес связан с недвижимостью? Это решение поможет Вам выгрузить информацию из ReCRM на сайт под системой 1С Битрикс.

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

Представляем вашему вниманию видеоролик о Real Estate CRM:

О модуле

При помощи API предоставленной ReCRM, модуль выгружает выбранную Вами информацию в базу данных Вашего сайта на 1С Битрикс.
Первую выгрузку Вы производите вручную, в дальнейшем можно настроить CRON (Планировщик задач), который будет в определенный Вами интервал времени обновлять информацию на сайте.

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

В компонент входят настройки:

• Список объектов
• Интерактивная Яндекс карта с расположением всех объектов
• Подробная информация объекта
• Сортировка и настройка отображения свойств объекта
• Отобразить карточку Агента
• Отобразить видео ролик YouTube
• Настроить SEO параметры из свойств объекта заданных в ReCRM
• Фотографии объекта и планировок
• Описание объекта
• и другие параметры.

Установка:

Решение устанавливается стандартно для Marketplace http://marketplace.1c-bitrix.ru/about/index.php
После установки необходимо настроить модуль.

Настройка модуля:

1. В админ части сайта перейдите по вкладке: "Сервисы -> ReCRM".
2. В открывшемся окне справа выберите пункт "Настройки" и заполните следующие параметры:
   • Поле Ключ ReCrm: запросите у поддержки ReCRM Api Key.
   • Время одного шага при выгрузке (сек): можно не менять, по умолчанию 30 сек.
   • Ширина изображения в списке объектов: какой ширины будут отображаться изображения объекта в списке, указывать только цифры в px
   • Высота изображения в списке объектов: какой высоты будут отображаться изображения объекта в списке, указывать только цифры в px
   • Обрезать главное изображение точно по размеру: нужно ли обрезать изображение, если его размеры непропорциональны желаемым
   • Нужно ли накладывать водный знак на изображение: для этого водный знак должен быть указан в настройках CRM
   • Включить в выгрузку скрытые объекты: те, которые не должны отображаться на сайте.
   • Включить в выгрузку объекты со всеми статусами: по умолчанию выгружаются объекты со статусом 0-активный, если включит эту опцию, в выгрузку будут добавлены объекты со статусом 1-успешный и 2-неудачный.
   • Часовой пояс как в настройках ReCRM: поле желательно заполнить, данные выгружаются учитывая время Вашего сайта и время аккаунта в ReCRM.
   • Какие данные выгружать из ReCRM: Выберите, какие данные вам необходимы. Для нормальной работы модуля достаточно выбрать: "Объекты недвижимости" и "Агенты"
   • Вырезать из описания строку: Бывает в описании объекта расположен текст, который необходимо не отображать на сайте. Укажите его в этом поле.
   • Дата последнего обращения к CRM (unixtime): редактировать не рекомендуется, но вы можете поставить 0 когда хотите по новой выгрузить все объекты из ReCrm.
   • Дата последнего обновления (unixtime): редактировать не рекомендуется, но вы можете поставить 0 когда хотите по новой выгрузить все объекты из ReCrm.
   • Список инфоблоков для данных: для каждого выбранного Вами типа данных, которые необходимо выгрузить, выберите соответствующий инфоблок. Рекомендуем для каждого типа создать свой отдельный инфоблок.
3. После настроек модуля произведите первую выгрузку. Кнопка выгрузки расположена во вкладке "Статистика".
   Если вы выгружаете данные вручную, создайте задание для импорта при помощи кнопки "Запросить данные из ReCRM вручную и добавить в очередь для выгрузки", Время импорта зависит от количества выгружаемых данных.
   После успешного создания временного файла Вы можете загрузить все полученные данные в базу данных Вашего сайта при помощи кнопки: "Загрузить все полученные данные в базу данных сайта"
4. После завершения выгрузки, вам необходимо настроить свойства. Перейдите по вкладке "Настройка свойств". В списке отображены все свойства объекта, которые были указаны в ReCRM.
   • Название: видит посетитель на сайте
   • Ед. изм: отображается после значения свойства, например у цены будет руб.
   • Сорт.: в каком порядке отображать свойства. Вы можете изменить порядок свойств при помощи мыши перетаскивая их друг за другом.
   Нажмите кнопку Сохранить в низу списка.
5. Для настройки автоматической выгрузку Вам необходимо обратиться к поддержке хостинга Вашего сайта с просьбой: "Необходимо поставить задачу в CRON по расписанию: 'каждые 6 часов' для файла на сервере нашего сайта в папке: /bitrix/modules/pr.recrm/cron.php"

Настройка компонента:

Компонент имеет минимальное стилистическое оформление. Размеры макетов адаптируются под ширину Вашего сайта.

1. Перейдите на главную страницу вашего сайта.
2. Создайте новый раздел, например ReCRM.
3. При помощи визуального редактора разместите компонент "Объекты ReCRM", который расположен в привычном для Битриса месте. Компонент находится в папке ПраймВеб. Если вы не увидели компонент, обновите список компонентов.
4. Настройте компонент так, как вам нужно. Большинство настроек схожи с параметрами стандартного комплексного компонента Новости.

Расширение модуля:

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

Событие OnBeforeImport
Срабатывает перед обновлением/добавлением каждого объекта в БД 1С-Битрикс. Событие размещено в классе prReCrmData в файле /classes/general/prReCrmData.class.php

Событие содержит массив данных:
TYPE (text) - тип выгружаемого объекта
NEW (bool) - новый или обновляемый объект
PARAMS (array) - массив с данными (MODIFIED_BY, IBLOCK_ID, NAME, CODE, DETAIL_TEXT, DETAIL_TEXT_TYPE)
PROP (array) - массив со свойствами элемента где ключ - имя свойства, значение - значение.

Должно вернуть массив с:
PARAMS (array) - параметры элемента
PROPS (array) - свойства для элемента

Например, мы хотим у объектов типа estate добавить свое свойство "на лету" во время выгрузки. Создайте свойство в свойствах инфоблока для объектов и разместите в файле bitrix/php_interface/init.php код: Событие OnBeforeTypes
Позволяет расширить типы сущностей выгружаемых из ReCRM. Событие размещено в классе prReCrmProps в файле /classes/general/prReCrmProps.class.php

Событие содержит массив данных:
url (array) - ключ - тип, значение - url для запроса к api
arr (array) - ключ - тип, значение - поля для формирования массива данных из ответа от API
name (array) - ключ - тип, значение - название

Должно вернуть массив с новым добавленным типом.

Событие OnAfterImport
Срабатывает после всей выгрузки выбранных объектов. Событие размещено в классе prReCrmData в файле /classes/general/prReCrmData.class.php

Может быть использовано для сброса кеша:



Событие OnBeforeGetSettings
Срабатывает перед тем, как передать параметры модуля, которые заполнены во вкладке "Настройки". Событие размещено в классе prReCrmData в файле /classes/general/prReCrmData.class.php

Может быть использовано для переопределения параметров перед выгрузкой:

Событие содержит массив данных:
TYPE (text) - тип параметра, если запрошен только 1 параметр
PARAMS (array) - массив с параметрами

Должно вернуть массив.



Короткие ссылки $prReCrmProps->redirect()
Позволяет перенаправить пользователя по ссылке вида http://site.ru/?recrm=12345 на страницу объекта. Метод размещен в классе prReCrmData в файле /classes/general/prReCrmData.class.php

Параметры:
GET recrm - содержит ID объекта из ReCRM
Редирект происходит на страницу DETAIL_PAGE_URL, шаблон которой задан в настройках инфоблока для объектов

Для работы необходимо в файле bitrix/php_interface/init.php разместить код:



Вспомогательные константы
Константы можно определить в init.php
PR_RECRM_CLOSE - если константа определена, содержимое константы будет отображено на месте кнопок для выгрузки во вкладке "Статистика". Например, если необходимо ограничить выгрузку только по CRON.
PR_RECRM_CLOSE_OPTIONS - если константа определена, содержимое константы будет отображено в верхней части вкладки "Настройки".
PR_RECRM_DEBUG - если константа определена, в лог файл (AddMessage2Log) будут добавлены все шаги процесса выгрузки.

Стоимость

Модуль и его компоненты бесплатные.
Если у Вас возникнут вопросы или сложности по установке и настройке модуля, пожалуйста, сообщите нам.