Обновлено 02.09.2019 11:00

Как добавить категорию

Для того чтобы добавить новую категорию объявлений, нужно сделать следующее:

Для добавления категории первого уровня:

1. Перейдите в меню Контент > Типы инфоблоков
1.png

2. Нажмите на кнопку "Добавить новый тип"

3. Заполните форму по образцу
2.png

4. Нажмите кнопку "Сохранить"

ВНИМАНИЕ: в поле Идентификатор обязательно введите префикс democontent2_pi_ и далее желаемый символьный код, где вместо дефисов используйте нижнее подчёркивание в качестве разделителя слов, на сайте в каталоге оно будет автоматически преобразовано в дефис.
Например для идентификатора democontent2_pi_moy_catalog адрес в публичной части сайта будет следующим /moy-catalog/

Для добавления категории второго уровня:

1. Перейдите в меню Контент > Типы инфоблоков > Нужный инфоблок
2. Нажмите на кнопку "Добавить инфоблок"
3. В открывшейся форме нужно заполнить только поле "Название" и поставить галочку напротив сайта. Также при желании, можно сразу задать желаемый символьный код на латинице, в случае если символьный код не будет заполнен - он будет автоматически сгенерирован из названия
3.png

4. Никакие другие поля, в том числе поля в соседних вкладках редактировать не нужно.
5. Нажмите кнопку "Применить"
6. После этого будет создан новый инфоблок, его настройки будут автоматически приведены в соответствие с требованиями продукта, а также будут автоматически добавлены все необходимые служебные свойства (вкладка "Свойства")

Для добавления подразделов в ранее созданный инфоблок:

1. Перейдите в меню Контент > Нужный инфоблок (не тип инфоблока!)
4.png
2. Нажмите "Добавить раздел"
3. В открывшейся форме введите название раздела и символьный код
5.png
4. Нажмите кнопку "Сохранить"

Как добавить город

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

1. Перейдите в меню Контент > Сервисный тип (Поиск исполнителей) > Города
6.png
2. В случае необходимости, если городов много лучше организовать их внутри регионов. Для этого добавьте раздел с названием нужного региона
3. Либо в корне инфоблока, либо внутри региона нажмите "Добавить элемент"
4. Заполните форму по образцу
7.png

ВНИМАНИЕ:
Обратите внимание, что один город должен быть с отмеченной опцией "По умолчанию" = да.
Т.е. например у Вас в проекте 100 городов, выберите тот, который считаете наиболее важным для проекта и отметьте его городом по умолчанию.
Если в Вашем проекте всего один город - отметьте по умолчанию его.
Обязательно установите точку на карте для конкретного города, она будет использоваться в личном кабинете пользователя при выборе местоположения.
Также обязательно заполните название города в предложном падеже в поле "Склонение", например: Пермь - в Перми, Тюмень - в Тюмени и т.д.
Поле "Крупный город" может принимать значения 0 или 1, где 0 - не крупный, 1 - крупный. Эта опция используется в окне изменения города пользователем.

Настройка онлайн-чата

Эта функция доступна только для проектов которые размещаются на VPS или выделенных серверах, т.е. там где есть root доступ и возможность установки ПО.

Порядок настройки чата с использованием облака MongoDB Atlas:

  1. Установить PHP драйвер (расширение)
  2. Установить npm 
  3. Установить pm2 
  4. Настроить хост для чата и проксировать запросы к нему на какой либо порт, например 3000 
  5. Убедиться что хост висит на порту 
  6. Прописать все параметры, кроме полей Хост и Порт, во вкладке "Настройки чата". В поле MongoDb Atlas прописать домен созданного кластера вида cluster0-XXXXXXX.mongodb.net, который будет сгенерирован и доступен в интерфейсе "Connect Your Application", обратите внимание, не всю предложенную строку, а только домен кластера.
  7. Написать на support@democontent.ru письмо-запрос на библиотеку для серверной части чата. В письме указать наименование клиента для которого приобретён лицензионный ключ на продукт (в целях предотвращения пиратского копирования, у Вас может быть запрошен сам ключ для дополнительной идентификации) 
  8. После того как библиотека получена, распаковать её на сервере, затем в её директории выполнить npm install, и затем выполнить запуск используя pm2 
  9. Телефон для справок +7 (495) 005-23-76 (строго в будни с 9.00 до 18.00) 
  10. Включить чат


Порядок настройки чата без использования облака, на своём сервере:

  1. Установить MongoDB
  2. Установить PHP драйвер (расширение)
  3. Установить npm
  4. Установить pm2
  5. Настроить хост для чата и проксировать запросы к нему на какой либо порт, например 3000 
  6. Убедиться что хост висит на порту 
  7. Прописать все параметры, кроме поля MongoDB Atlas, во вкладке "Настройки чата" 
  8. Написать на support@democontent.ru письмо-запрос на библиотеку для серверной части чата. В письме указать наименование клиента для которого приобретён лицензионный ключ на продукт (в целях предотвращения пиратского копирования, у Вас может быть запрошен сам ключ для дополнительной идентификации) 
  9. После того как библиотека получена, распаковать её на сервере, затем в её директории выполнить npm install, и затем выполнить запуск используя pm2 
  10. Телефон для справок +7 (495) 005-23-76 (строго в будни с 9.00 до 18.00) 
  11. Включить чат


Важно: в случае если проект доступен по HTTPS протоколу, хост на котором "висит" чат тоже должен быть доступен по HTTPS. В этом случае не допускается использование самоподписанных SSL сертификатов.

Настройка СМС

1. Перейдите в меню Настройки > Настройки продукта > Настройки модулей > Универсальная доска объявлений
2. Откройте вкладку "Настройки СМС"
8.png
3. Выберите СМС шлюз из трёх предложенных (sms16.ru, sms.ru, sms-uslugi.ru) и зарегистрируйтесь в нём
4. Для конкретного шлюза заполните соответствующие поля
5. В разделе "Использовать по умолчанию" отметьте нужный шлюз и нажмите "Применить"

Настройка SMS16.RU

Для подключения к sms16.ru потребуется заполнить 3 поля в настройках:
1. Логин - Ваш логин в sms16.ru
2. Имя отправителя - можно ввести любое из тех которые имеют статус "Одобрено"
3. API ключ - его можно найти в соответствующем разделе личного кабинета

Настройка SMS.RU

Для настройки подключения в sms.ru потребуется только API ключ (api_id), найти его можно в соответствующем разделе

Настройка SMS-USLUGI.RU

Для настройки подключения к данному сервису, потребуется логин и пароль от личного кабинета

Настройка SMSC.RU

Для настройки подключения к данному сервису, потребуется логин и пароль от личного кабинета


Что делать если СМС не отправляются?

Первым делом следует убедиться что Вы корректно настроили параметры подключения к СМС шлюзу, и выбрали его в качестве используемого по умолчанию.
Здесь и далее будем считать что очевидные вещи вроде активного аккаунта или наличие средств на балансе уже решены.
Важно понять что отправка СМС и его доставка это принципиально разные вещи.

Если вдруг СМС не приходит, или как Вам кажется долго не приходит, первое что нужно сделать это зайти в лог отправки СМС сообщений, найти его можно в меню Контент > Highload-блоки > Лог СМС (сервис поиска исполнителей)
Сюда собирается информация о всех СМС, и первое что Вас интересует это колонка "Ошибка".
Если в данной колонке для конкретной попытки отправки что либо написано, то это либо код ошибки либо сразу её расшифровка.
Обратите внимание, что если Вы используете sms16.ru и заметили в логе записи с текстом ошибки "Неизвестная ошибка: phone_code_user" - имейте ввиду, данная ошибка не описана в документации к шлюзу, но при этом легко расшифровывается.
Эта ошибка означает что для Вашего аккаунта "закрыта" отправка СМС по данному направлению (оператору), для того чтобы решить вопрос, просто позвоните в sms16.ru и сообщите о том что отправляете СМС через интеграцию, и получаете ошибку с таким кодом, при этом обязательно назовите номер на который была отправка.
После того как Вашему аккаунту "откроют" направление вопрос решится.

Если вдруг для конкретного СМС нет ошибок, и тем не менее оно не приходит, или долго не приходит, то самое вероятное что оно стоит в очереди на модерацию.
Проверить это можно либо в личном кабинете конкретного СМС шлюза, либо обратившись в техподдержку конкретного СМС шлюза с просьбой решить вопрос доставка СМС.

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

Приём платежей

Продукт поддерживает интеграцию со следующими платёжными системами:
1. Яндекс.Касса (новый протокол)
2. РобоКасса
3. СберБанк
4. Тинькофф Банк
5. PayTrail
6. Skrill
7. PayPal

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

Обязательно запрашивайте подключение в режиме тестирования и отладки, для проверки корректности обмена данными и проведения тестовых транзакций.

Независимо от платёжной системы, ключевым и основным звеном интеграции являются коллбеки, поэтому при подключении обязательно указывайте менеджеру на это.
Для всех платёжных систем сгенерирован пример URL адреса для отправки коллбеков от платёжной системы.
URL адрес для коллбеков имеет примерно следующий вид: http(s)://example.ru/payments/fdb8922e5b4f4c7017b2395c7ce71575
Замените в нём HTTP протокол и домен на используемые для сайта, и предоставьте на запрос Вашему менеджеру на стороне платёжной системы.
Обязательно передавайте полный адрес как на примере, т.е. всю последовательность символов до конца, не изменяйте, и не удаляйте никакие части сгенерированного URL, кроме HTTP протокола и домена.

После того как всё готово, проведите тестирование применения платных услуг с оплатой тестовыми банковскими картами.
Обязательно проверяйте лог запросов от платёжных систем, найти который можно в меню Контент > Highload-блоки > Лог запросов от платёжных систем, который создаётся автоматически при первом же коллбеке со стороны платёжной системы.
Если у Вас не появился данных Highload-блок после первого же тестового платежа - то это значит что коллбеки Вам не поступают в принципе, и необходимо проверить переданный URL менеджеру, а также уточнить подключение коллбеков со стороны платёжной системы.

Если коллбеки успешно поступают, то для некоторых платёжных систем, например СберБанк и Тинькофф Банк автоматически добавляются Highload-блоки с детализацией транзакций и ошибок. Проверяйте информацию из данных справочников, особенно на этапе тестирования, а также при наличии любых спорных ситуаций первым делом.

Когда тестирование завершено, все тестовые платежи проходят двухсторонний обмен - можно сделать запрос на перевод Вашего аккаунта в боевой режим.

Монетизация

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

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

Как настроить модерацию

В настройках продукта, во вкладке "Общие настройки" в разделе "Настройки для заданий" установите нужные значения для опций модерации.

Настройка карты

В настройках продукта во вкладке "Общие настройки" пункт "Карты по умолчанию".
Доступен выбор между Яндекс.Картами и Google Maps. Обратите внимание, что для Google Maps может потребоваться получение API ключа, в этом случае его нужно получить, и добавить в поле "API ключ Google Maps" во вкладке "Общие настройки"

CRON

На странице настроек продукта во вкладке "Справка" доступен список заданий который необходимо поставить на CRON.
Этот пункт является строго обязательным.

Как настроить бесплатный лимит заданий

В настройках продукта во вкладке "Общие настройки" параметр "Лимит бесплатных объявлений для одного пользователя" устанавливает ограничение на количество заданий объявлений для одного пользователя.

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

Существует возможность установить персональный лимит бесплатных объявлений для конкретного пользователя, для этого нужно перейти в меню Настройки > Пользователи > Список пользователей, перейти в профиль нужного пользователя. Затем открыть вкладку "Доп. поля", в открывшемся списке найти "Персональный лимит (сервис поиска исполнителей)" и указать число.
Таким образом например Вы можете установить для всей системы лимит по умолчанию равным 3, а для конкретного пользователя например 100.

Персональная настройка имеет приоритет над общей.

Как одобрить или отклонить задание

Если задание пользователя находится на модерации, и вы его хотите одобрить, то для этого нужно в поле "Модерация" поставить флаг 0 (ноль), а также флаг 1 (единица) для поля "Оплачено".
Если задание пользователя находится на модерации и вы хотите по какой либо причине отклонить его, то для этого в поле "Модерация" нужно установить или оставить флаг 1 (единица), и в поле "Причина по которой объявление отклонено модератором" указать причину по которой объявление не допущено к публикации, и после этого пользователь увидит данную причину в карточке объявления в личном кабинете.

Добавить счётчики систем аналитики

Разместите коды счётчиков систем аналитики (Яндекс.Метрика и пр.) во включаемом файле /bitrix/templates/democontent2.pi/inc/header/counters.php

Установка в режиме многосайтовости

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

См. как создать символьную ссылку

REST API

Параметры для включения опции доступны в настройках продукта во вкладке REST API.
Документация для разработчиков (дополняется)

Настроить регистрационный взнос исполнителя

В настройках продукта, во вкладке "Общие настройки" можно указать сумму которую исполнитель будет оплачивать в качестве регистрационного взноса.
По умолчанию стоимость равна нулю, что означает что любой желающий может стать исполнителем без оплаты.

Как добавить чек-лист к заданию

В настройках продукта, во вкладке "Общие настройки" доступна опция "Разрешить добавлять чек-лист для откликов при добавлении задания?", при включении которой при размещении задания будет доступна возможность прикрепить к заданию некий чек-лист с произвольным количеством пунктов.
Данный чек-лист будет отображён исполнителю предложившему свои услуги, т.е. оставившим отклик к заданию, а также заказчику, в карточке задания в разделе с откликами.
Заказчику также будет доступна фильтрация откликов по данному чек-листу.

Как включить построение маршрута для заданий

В настройках продукта, во вкладке "Общие настройки" в разделе "Инфоблоки для которых доступно построение маршрута", выберите нужные инфоблоки при размещении заданий в которые будет доступна опция построения маршрута.
Например это могут быть категории связанные с курьерскими услугами, или грузоперевозками.

Как настроить безопасную сделку

Первое что нужно сделать - заключить договор с сервисом SafeCrow.ru
Затем в настройках продукта, во вкладке "Общие настройки" в разделе SafeCrow сохраните полученные API ключи, а также выберите сервер: тестовый или боевой.