Обновлено 25.12.2018 13:10

Как добавить категорию объявлений

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

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

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

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

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

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

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

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

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

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

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

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

SEO настройки

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

Например: "Купить квартиру #CITY_DECLENSION#" - будет автоматически заменено на: "Купить квартиру в Саратове", или на "Купить квартиру" соответственно.

Однако т.к. архитектура продукта базируется на применении в обработке каталога инфоблоков как отдельных сущностей и типов инфоблоков, которые в свою очередь не имеют штатных SEO настроек, в продукте реализована установка мета-тегов на базе Highload-блоков для Типов инфоблоков и вложенных в них Инфоблоков.

В меню Контент > Highload-блоки есть два Highload-блока: Настройки SEO для типов инфоблоков и Настройки SEO для инфоблоков в которых соответственно можно настроить мета-теги для каталога первого и второго уровней.

Здесь также поддерживается макрос #CITY_DECLENSION#

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

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

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

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

Как настроить онлайн-чат

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

Порядок действий для подготовки проекта к внедрению онлайн-чата:
1. Установить MongoDB
2. Установить PHP драйвер (расширение)
3. Установить npm
4. Установить pm2
5. Настроить хост для чата и проксировать запросы к нему на какой либо порт, например 3000 
6. Убедиться что хост висит на порту 
7. Прописать все параметры во вкладке "Настройки чата" 
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

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

Как настроить приём платежей

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

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

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

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

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

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

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

Как изменить стоимость платных опций

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

Как включить Google ReCaptcha

1. Зарегистрируйтесь
2. Добавьте домен и выберите тип reCAPTCHA v2, проверка "Флажок"
3. Получите публичный и секретные ключи
4. Пропишите ключи в соответствующие поля в настройках продукта
5. Сохраните настройки

Как настроить модерацию объявлений

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

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

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

Как изменить название валюты в каталоге

На странице настроек продукта, во вкладке "Общие настройки" поле "Название валюты"

CRON

На странице настроек продукта во вкладке "Справка" доступен список заданий который необходимо поставить на CRON.
Это является обязательным, т.к. это сервисные скрипты которые выполняют ряд фоновых операций, например управление очередью поднятий объявлений в ТОП, управление активацией и деактивацией платных услуг и пр.

Как изменить бесплатный лимит объявлений

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

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

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

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

Как настроить PRO аккаунт

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

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

Не отправляются СМС сообщения

В системе используется отправка СМС в двух случаях:
  1. При регистрации (отправляются логин и пароль)
  2. При восстановлении пароля

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

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

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

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

Не удалось обнаружить код вызова компонента

Не все компоненты продукта имеют редактируемые параметры.
Часть компонентов каталога и личного кабинета подключается динамически на основе правил обработки адресов (urlrewrite.php) которые в свою очередь основываются на регулярных выражениях, и не существует в физической файловой структуре.
Поэтому такие компоненты не будут иметь параметров вызова.
Для кастомизации (редактирования/расширения) таких компонентов, следует использовать стандартные сценарии модификации компонентов и/или их шаблонов.

Для того чтобы модифицировать шаблон конкретного компонента и при этом не потерять свои изменения при очередном обновлении, есть несколько вариантов на выбор:

1. (Для программистов) Скопировать компонент в собственное пространство имён, далее в файле urlrewrite.php для соответствующего правила (или нескольких правил) в ключ RULE добавить параметр namespace с названием пространства имён. Например: namespace=myNameSpace&component=list, что означает что подключится компонент list из пространства имён myNameSpace
2. (Для всех) Скопировать основной шаблон продукта (democontent2.board) в папку local/templates (templates создать если не существует). Далее в настройках сайта определить новый шаблон. После этого можно копировать шаблоны нужных компонентов в папку с основным шаблоном в папку components и модифицировать их на своё усмотрение ьез необходимости выносить весь компонент целиком в отдельное пространство имён.
3. (Для программистов) Если нет необходимости выносить весь компонент в собственное пространство имён (п.1), то по аналогии можно вместо параметра namespace добавить параметр template, например template=myTemplate&component=list, что означает что подключится компонент list с шаблоном myTemplate. В этом варианте нет необходимости выполнять манипуляции из п.2, новый шаблон компонента может находиться в исходной папке компонента. Т.е. например Вы скопировали шаблон .default в той-же папке под именем newDefault и подключили шаблон при помощи параметра template

Как одобрить или отклонить объявление

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

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

Мобильное приложение и размещение в Google Play

Приложение написано на Java и не требует приобретения каких - либо дополнительных лицензий.

Единственное требование - ваш активный сайт.
Для того, чтобы получить .apk файл для публикации приложения, необходимо следующее:
  1. Приобрести лицензию на решение
  2. Зарегистрироваться и оплатить регистрационный взнос в Google Console, в размере 25$
  3. Подготовить иконки приложения
  4. Подготовить логотип для интеграции в приложение
  5. Подготовить необходимые рекламные материалы для приложения, а также его описание для Google Play
  6. Выбрать цветовую схему приложения
  7. Далее, необходимо написать заявку на support@democontent.ru


В заявке необходимо указать:
  1. Адрес действующего сайта с установленным решением
  2. Ранее активированный лицензионный ключ на решение
  3. Приложить для проверки все подготовленные материалы для приложения (картинки и пр.)
  4. Контакты для обратной связи по вопросам предоставленного материала и публикации приложения

Базовая адаптация приложения под ваш бренд производится бесплатно.
Заявки на сборку и публикацию приложения обрабатываются в порядке очереди.
Абонентской платы и лимита на срок использования приложения после публикации нет.

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

Получение новых версий Android приложения

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

Как добавить счётчики аналитики

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

Как разместить рекламу

Если вы установили продукт на редакцию Бизнес, то в систему были автоматически добавлены необходимые типы баннеров, используйте их, экспериментируйте с форматами.
Если вы установили продукт на редакцию младше редакции Бизнес, то вы можете размещать только контекстную рекламу, для этого используйте включаемые файлы из папки /bitrix/templates/democontent2.board/inc/advert/

Как выгружать объявления в VK (ВКонтакте)

Данный функционал доступен с версии 1.4.0

Продукт позволяет производить автоматический постинг по расписанию некоторых объявлений в группу (группы) VK.
Для того чтобы начать пользоваться этой функцией, предварительно необходимо создать одну или множество тематических групп в VK, желательно с тематическим разделением по городам и категориям.
Затем для каждой из групп создать Standalone приложение, и получить access_token, app id, public id.

Допустим вы уже создали группу, знаете её ID, получили access_token, и app id, можно переходить к добавлению конфигурации в админке:

vk_hl.png

На данной странице, нажмите кнопку "Добавить запись", после чего откроется форма такого вида:

10.png
Необходимо ввести ранее полученные данные для группы VK, а также обязательно указать ID города и ID инфоблока (категории) из которой будут выбираться объявления для выгрузки.

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

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

Также можно указать через запятую хеш-теги, которые при выгрузке будут привязаны к посту и автоматически отформатированы, а также UTM-метки в полном формате вида: utm_source=vk&utm_term=my_term&utm_XXXXX=XXXXX и т.д, метки будут добавлены к гиперссылке на сайт.

В UTM-метках можно использовать два специальных макроса #PUBLIC_ID# и #OBJECT_ID#, где #PUBLIC_ID# - ID группы, а #OBJECT_ID# - ID объявления

Например: utm_term=#OBJECT_ID#&utm_XXXX=XXXX и т.д.

После того как всё готово, перейдите в настройки модуля, во вкладке "Справка" найдите CRON-задание для выгрузки, и добавьте его на исполнение.

Обратите внимание, что для постинга в группы с использованием API существуют ограничения на количество постов, поэтому не все объявления будут копироваться в группу, а только одно, по умолчанию один раз в 40 минут.

Установка вторым (третьим и т.д) сайтом

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

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

Не все объявления отображаются на карте

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