Техническая поддержка оказывается исключительно в рамках обмена сообщениями на портале поддержки согласно регламенту.
Адрес портала поддержки: https://support.pixel365.ru
Для работы с порталом требуется предварительная регистрация.
После регистрации, и последующей авторизации на портале поддержки, необходимо создать тикет согласно регламенту.

Перед началом работы с порталом, ознакомьтесь пожалуйста со следующими документами:

1. Регламент оказания поддержки
2. Пользовательское соглашение
3. Тарифы на платные услуги (в том случае, если требуется)
4. Договор на оказание платных услуг (в том случае, если требуется)

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

Начиная с версии 1.8.1, минимальная версия PHP которая требуется для работы доски объявлений - 7.4

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

Обязательно учитывайте этот при планировании обновления с более ранней версии или новой установке продукта.

Важная информация для всех клиентов у которых версия продукта 1.7.0 и ниже.

В версии 1.7.1 изменён основной шаблон интерфейса продукта, а также шаблоны абсолютно всех компонентов продукта (/bitrix/components/democontent2.pi), как следствие шаблон интерфейса который существовал до версии 1.7.0 включительно - больше не будет доступен, и не будет поддерживаться.
В том случае, если по какой либо причине, Вам нужно сохранить шаблон который существовал до версии 1.7.0 включительно, Вам нужно либо сохранить и после каждого обновления переносить изменения, либо не обновляться до версии 1.7.1 и всех последующих.

В связи с этим, перед обновлением до этой версии необходимо внимательно прочитать данный текст и выполнить все необходимые требования и подготовительные работы (если версия Вашей текущей копии продукта менее 1.7.1)

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

Компоненты:
Как обычно при любом обновлении продукта все файлы компонентов расположенные в папке /bitrix/components/democontent2.pi будут перезаписаны.
Но в обновлении до версии 1.7.1 часть компонентов в указанной папке будут физически удалены, в связи с тем что не используются более в бизнес-логике продукта.
Список компонентов которые будут физически удалены:

1. top.auth
2. top.balance
3. top.chat
4. top.notification
5. top.notifications

В связи с этим, если Вы модифицируете продукт под свои задачи, и используете в своей реализации указанные выше компоненты - вам необходимо предварительно скопировать и вынести их в собственное пространство имён.
Обратитесь по этому вопросу к разработчику и/или администратору Вашего сайта/сервера.

Основной шаблон:
Как обычно при любом обновлении продукта все файл основного шаблона расположенные в папке /bitrix/templates/democontent2.pi будут перезаписаны.
Но в обновлении до версии 1.7.1 часть файлов шаблона будет физически удалена.
В связи с этим, если Вы модифицируете продукт под свои задачи, и используете в своей реализации указанный выше шаблон - вам необходимо предварительно скопировать и вынести его в собственное пространство имён.
Обратитесь по этому вопросу к разработчику и/или администратору Вашего сайта.
Папки которые будут удалены вместе с содержимым из основного шаблона:

1. css
2. js
3. fonts
4. images

Однако, в том случае если папки css и/или js содержат файлы custom.css и/или custom.js соответственно, эти файлы будут перенесены в папку app основного шаблона.

Главная страница:
В обычных обновлениях главная страница сайта никогда не перезаписывается.
Однако нужно обратить внимание, что в связи в существенными изменениями в html-вёрстке основного шаблона, в обновлении до версии 1.7.1 главная страница сайта (файл index.php в корне сайта) будет перезаписана.
В связи с этим, первым делом после обновления до этой версии, Вам нужно внести определённые изменения в файл главной страницы, а именно - отредактировать на своё усмотрение мета-теги.


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

Подключаемые пользовательские файлы (включаемые области):
После завершения обновления, Вам необходимо перейти в папку основного шаблона (/bitrix/templates/democontent2.pi), найти в ней папку inc и перейти в неё.
Данная папка содержит различные пользовательские подключаемые файлы которые никогда при обычном обновлении не перезаписываются, однако в обновлении до версии 1.7.1 в связи с существенными изменениями в вёрстке, файлы в папке inc и вложенных в неё - будут перезаписаны.
В связи с этим, Вам необходимо вручную отредактировать под свои нужды каждый файл в этой папке и вложенных в неё.

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

1. footer/copyright.php
2. footer/social.php
3. index/advantages.php
4. index/search.php
5. header/logo.php
6. header/menu.php
7. adv/vertical.php
8. create/steps-create.php
9. balance/description.php

Список файлов и их предназначение (пути указаны от папки inc):

1. 404/default.php - Подключается при 404 странице
2. adv/list.php - Подключается в каталоге заданий. Подразумевается использование кода вызова контекстной рекламы.
3. footer/footer_site_name.php - Подключается в подвале каждой страницы. Содержит название сайта.
4. header/counters.php - Подключается в HEAD каждой страницы. Предназначен для счётчиков аналитики (Яндекс.Метрика и тп.)

В процессе обновления до версии 1.7.1 будет предпринята попытка автоматически создать резервную копию главной страницы, всей папки основного шаблона а также всей папки с компонентами democontent2.pi, т.е. файлы и папки версии 1.7.0.
В случае успешного копирования данных файлов и папок, после обновления до этой версии в административной панели появится ряд сообщений с описанием операции.
Файл главной страницы и папки с шаблоном и компонентами будут скопированы в папку /upload/_democontent2.pi/backups/1.7.0_*
В случае особой необходимости (забыли скопировать и тд.) - Вы можете найти созданные копии в указанной папке.
Однако, наличие этой опции никак не гарантирует её исполнение, и не отменяет предварительное обязательное создание Вами полной резервной копии всего сайта о чём написано в начале данной инструкции.

После завершения обновления, и завершения работы с редактированием файлов указанных выше, перейдите в настройки модуля в админке (/bitrix/admin/settings.php?lang=ru&mid=democontent2.pi&mid_menu=1).
На первом экране настроек, загрузите файл с логотипом который будет отображаться в публичной части сайта.
В дальнейшем, при любой необходимости Вы можете менять логотип просто заменив существующий на новых, аналогично через настройки модуля.
Вёрстка шаблона предполагает что логотип будет в горизонтальном исполнении. Оптимально размером 203х48px, но Вы можете экспериментировать с размерами на свой вкус, в крайнем случае, Вы можете модифицировать вёрстку шаблона.
Поддерживаются следующие типы файлов: image/png, image/jpg, image/jpeg, image/svg+xml
В целях отличного качества и отображения в том числе на мобильных устройствах, настоятельно рекомендуется использовать тип файла image/svg+xml (расширение .svg)

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

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

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


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

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


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

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

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

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


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

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

1. Перейдите в меню Контент > Нужный инфоблок (не тип инфоблока!)

2. Нажмите "Добавить раздел"
3. В открывшейся форме введите название раздела и символьный код

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

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

1. Перейдите в меню Контент > Сервисный тип (Поиск исполнителей) > Города

2. В случае необходимости, если городов много лучше организовать их внутри регионов. Для этого добавьте раздел с названием нужного региона
3. Либо в корне инфоблока, либо внутри региона нажмите "Добавить элемент"
4. Заполните форму по образцу


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

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

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

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

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

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

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

1. Перейдите в меню Настройки > Настройки продукта > Настройки модулей > Универсальная доска объявлений
2. Откройте вкладку "Настройки СМС"

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.
Этот пункт является строго обязательным.

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

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

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

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

Авторизуйтесь под администратором.
Затем перейдите в личном кабинете в раздел модерации заданий.
Перейдите в нужное задание, и нажмите одну из кнопок "Одобрить" или "Удалить".

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

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

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

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

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

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

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

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

С версии 1.4.4

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

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

С версии 1.4.5

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