Обновлено 15.11.2019

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

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

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

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 дней.

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

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

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

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

С версии 1.6.0 поддерживаются только Яндекс.Карты.
Для работы карт в проекте, требуется обязательное получение API ключа для Яндекс.Карт.
Для получения ключа авторизуйтесь на портале разработчиков, и получите API ключ (JavaScript API и HTTP Геокодер).
После того как ключ будет сгенерирован, сохраните его в настройках модуля в специальном поле.

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 ключи, а также выберите сервер: тестовый или боевой.

FireBase

С версии 1.4.4

  1. Добавьте проект в консоли FireBase
  2. Перейдите в настройки проекта, во вкладке "Сервисные аккаунты" создайте закрытый ключ
  3. Скачайте сгенерированный JSON-файл, и сохраните его в корне проекта. После чего, в настройках модуля, во вкладке iOS/Android, пропишите название файла закрытого ключа, без расширения .json, т.е. например my-secret-key-filename-example-name
  4. Создайте базу данных для проекта
  5. В настройки модуля, во вкладке iOS/Android, пропишите сгенерированный URL-адрес для Realtime Database


Мобильные приложения iOS/Android

С версии 1.4.4

  1. Зарегистрируйте аккаунт разработчика в Google Play (стоимость 25$ единовременно)
  2. Зарегистрируйте аккаунт разработчика в Apple (стоимость 99$ в год)
  3. Перейдите в настройки ранее созданного проекта в консоли FireBase
  4. Во вкладке "Общие настройки" в разделе "Ваши приложения" добавьте Android приложение, в поле "Название пакета Android" пропишите домен вашего проекта в обратной последовательности. Например: ru.mysite - это будуший идентификатор вашего Android приложения
  5. Во вкладке "Общие настройки" в разделе "Ваши приложения" добавьте iOS приложение, в поле "Идентификатор пакета iOS" пропишите домен вашего проекта в обратной последовательности. Например: ru.mysite - это будуший идентификатор вашего iOS приложения
  6. Скачайте файлы google-services.json и GoogleService-Info.plist, для Android и iOS соответственно
  7. Подготовьте картинку в формате PNG с разрешением 1024x1024 (пример) из которого будут в последующем сгенерированы иконки приложений, а также экраны загрузки приложения под все стандартизированные размеры экранов устройств
  8. Отправьте заявку на support@democontent.ru. В заявке укажите наименование клиента, URL проекта, контактны данные (телефон, email, контактное лицо по всем техническим и организационным вопросам). После чего, ожидайте обратной связи. Заявки рассматриваются и обрабатываются в порядке очереди в техподдержке.
  9. После рассмотрения заявки, и согласования порядка действий - выполняется сборка дистрибутивов приложений и передача клиенту.
  10. Первичная сборка приложений выполняется бесплатно.

Важно:
Перед отправкой заявки на сборку мобильных приложений, убедитесь что у вас корректно настроен онлайн-чат (см. выше), т.к. чат является неотъемлемой частью приложений.
Обратите внимание, что у в случае неудачной идентификации клиента, у вас может быть запрошен лицензионный ключ с активным сроком получения обновлений который позволит установить наличие подлинной копии продукта.
Дистрибутивы приложений выдаются в скомпилированном виде, после чего их необходимо разместить в сторах под ранее созданными аккаунтами разработчика.

Можно ли получить исходный код приложений?
Нет, исходный код приложений не выдаётся.
Вы можете приобрести его, при необходимости. Для этого направьте запрос на support@democontent.ru, и укажите контактный номер телефона - с вами свяжутся.
Или позвоните по номеру:  +7 (495) 005-23-76

Можно ли доработать приложения под мои задачи?
Да, можно. На договорной основе в качестве отдельной коммерческой услуги.
Направьте запрос на support@democontent.ru, и укажите контактный номер телефона - с вами свяжутся.
Или позвоните по номеру:  +7 (495) 005-23-76



Политика обновлений мобильных приложений

С версии 1.4.4

Сборка обновлений для мобильных приложений (при необходимости) - это платная услуга, которая предоставляется по желанию, и не является обязательной.
Стоимость услуги составляет 1990 рублей.
Оплатить услугу можно только по безналичному расчёту.

Периодически мы можем выпускать новые версии приложений, актуальность которых будет отражена в демонстрационных приложениях продукта в сторах.
Новые версии могут содержать разный состав изменений, такие как: улучшения, исправления и т.д.
Также конкретная версия приложения может являться зависимой от конкретной версии продукта. Это означает что для того чтобы внедрить условно версию приложения 2.3 - нужно обновить продукт до версии условно 1.9.2.

При этом, вам совсем не обязательно обновляться до каждой новой версии приложения, версии можно пропускать и обновляться до наиболее подходящей, которая уже будет включать функции всех предшествующих.
Например: у вас версия приложений 1.6, пусть вышло несколько версий приложения, допустим 1.7, 1.8, 1.9, 2.0 ... - вы можете все их пропустить если они не кажутся важными, и обновиться скажем сразу после выхода версии 2.5, которая в свою очередь уже будет включать всё что выходило в более ранних версиях.

Разумеется, обновление это опция, т.е. если вам не нужно - вы не обязаны обновляться, и всё будет работать также как и работает на текущей нужной вам версии.

Как настроить PUSH-уведомления в браузере

Для работы push-уведомлений, веб-сайт должен быть доступен по протоколу HTTPS

С версии 1.4.5

  1. Выполните настройки из пункта FireBase
  2. SSL
  3. В настройках проекта FireBase, во вкладке "Общие" добавьте новое WEB-приложение
  4. После создания приложения, перейдите на этой-же странице в сниппет WEB-приложения, выберите опцию "Конфигурация", найдите среди открывшейся информации поле "messagingSenderId", сохраните его значение в настройки модуля в поле Sender ID
  5. В настройках проекта FireBase откройте вкладку Cloud Messaging, пролистайте вниз страницы и найдите сертификаты для Web Push
  6. Сохраните содержимое поля "Пара ключей" в настройки модуля в поле "Пара ключей для push-уведомлений в браузере"
  7. В корне сайта найдите файл firebase-messaging-sw.js, замените в нём PUT_YOUR_SENDER_ID_HERE на полученный ранее messagingSenderId из конфигурации.

С версии 1.6.4

В настройках продукта, во вкладке "iOS/Android/Push" укажите ссылку на файл с иконкой которая будет показана пользователю в браузере при доставке push-уведомления.
Ссылка должна быть в полном формате, например https://pi.democontent.ru/upload/icon.png
Картинку рекомендуется использовать квадратную, для более корректного её отображения.