Универсальная, мультиязычная доска объявлений

Обновлено 04.08.2020

Регламент работы технической поддержки

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

Перед началом работы с порталом, ознакомьтесь пожалуйста со следующими документами:
  1. Регламент оказания поддержки
  2. Пользовательское соглашение
  3. Тарифы на платные услуги (в том случае, если требуется)
  4. Договор на оказание платных услуг (в том случае, если требуется)
Оказание поддержки и любых консультаций по функционалу продукта по любым средствам связи (телефон, электронная почта, skype, whatsapp и т.д.) кроме портала поддержки - невозможно.

Минимальная версия PHP

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

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

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

Миграция на версию 2.0.8 и выше

Важная информация для всех клиентов которые приобрели лицензию на ПО до 28.04.2020 г. (версия продукта 2.0.7 и ниже)

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

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

Компоненты:
Как обычно при любом обновлении продукта все файлы компонентов расположенные в папке /bitrix/components/democontent2.board будут перезаписаны.
Но в обновлении до версии 2.0.8 часть компонентов в указанной папке будут физически удалены, в связи с тем что не используются более в бизнес-логике продукта, это все компоненты которые начинаются с префикса api.*, а также компоненты auth и bottom.create.button
В связи с этим, если Вы модифицируете продукт под свои задачи, и используете в своей реализации указанные выше компоненты - вам необходимо предварительно скопировать и вынести их в собственное пространство имён.
Обратитесь по этому вопросу к разработчику и/или администратору Вашего проекта.

Основной шаблон:
Как обычно при любом обновлении продукта все файл основного шаблона расположенные в папке /bitrix/templates/democontent2.board будут перезаписаны.
Но в обновлении до версии 2.0.8 часть файлов шаблона будет физически удалена.
В связи с этим, если Вы модифицируете продукт под свои задачи, и используете в своей реализации указанный выше шаблон - вам необходимо предварительно скопировать и вынести его в собственное пространство имён.
Обратитесь по этому вопросу к разработчику и/или администратору Вашего проекта.
Папки которые будут удалены вместе с содержимым из основного шаблона:
  1. css
  2. js
  3. fonts
  4. images
Однако, в том случае если папки css и/или js содержат файлы custom.css и/или custom.js соответственно, эти файлы будут перенесены в папку app основного шаблона.

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

1. Открыть в административной части сайта файл index.php на редактирование в режиме PHP
2. Найти в нём макрос #INDEX_TITLE# (4 шт.) и заменить его на нужные данные. В частности это заголовок страницы, описание и H1

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

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

Также имеется ряд подключаемых файлов которые будут физически удалены из папки inc основного шаблона:
  1. social.php
  2. footer/app.php
  3. footer/copyright.php
  4. footer/social.php
  5. index/advatnages.php
  6. index/banner.php
  7. index/create.php
  8. header/logo.php
Список файлов и их предназначение (пути указаны от папки inc):
  1. 404/default.php - Подключается при 404 странице
  2. advert/detail.full.width.php - Подключается в карточке объявления. Подразумевается использование кода вызова контекстной рекламы.
  3. advert/index.full.width.php - Подключается в на главной странице. Подразумевается использование кода вызова контекстной рекламы.
  4. advert/list.top.php - Подключается в каталоге объявлений. Подразумевается использование кода вызова контекстной рекламы.
  5. components/detail/attention.php - Подключается в карточке объявления. Должен содержать текст предупреждения о предоплате.
  6. footer/footer_site_name.php - Подключается в подвале каждой страницы. Содержит название сайта.
  7. footer/before_body.php - Подключается на каждой странице непосредственно перед тегом </body>. Как правило может использоваться для встраивания различных сервисов (онлайн-чаты и пр.) которые требуют размещения кода перед данным тегом.
  8. header/counters.php - Подключается в HEAD каждой страницы. Предназначен для счётчиков аналитики (Яндекс.Метрика и тп.)
  9. header/after_body.php - Подключается на каждой странице, сразу после тега <body>
  10. index/bottom1.php - Подключается внизу главной страницы. Содержит текстовый блок.
  11. index/bottom2.php - Подключается внизу главной страницы. Содержит текстовый блок.
  12. index/bottom3.php - Подключается внизу главной страницы. Содержит текстовый блок.
В процессе обновления до версии 2.0.8 будет предпринята попытка автоматически создать резервную копию главной страницы, всей папки основного шаблона а также всей папки с компонентами democontent2.board, т.е. файлы и папки версии 2.0.7.
В случае успешного копирования данных файлов и папок, после обновления до этой версии в административной панели появится ряд сообщений с описанием операции.
Файл главной страницы и папки с шаблоном и компонентами будут скопированы в папку /upload/_democontent2.board/backups/2.0.7_*
В случае особой необходимости (забыли скопировать и тд.) - Вы можете найти созданные копии в указанной папке.
Однако, наличие этой опции никак не отменяет предварительное создание Вами полной резервной копии всего проекта о чём написано в начале данной инструкции.

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



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

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

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

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.8.7 появилась поддержка MongoDB Atlas
MongoDB Atlas - это облачный сервис с поддержкой кластеризации, автоматическим бэкапом и графическим интерфейсом для управления базами данных и коллекциями MongoDB.
Сервис отлично подойдёт тем, кто не владеет инструментами администрирования сервера, или тем кому подходит вариант облачного хранения данных.
Сервис имеет бесплатный тариф.

Порядок настройки чата с использованием облака 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. Откройте вкладку "Настройки СМС"
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. Тинькофф Банк
  5. Paytrail
  6. Skrill
  7. PayPal
  8. Click.uz (Узбекистан)
  9. Qiwi
  10. BePaid (Беларусь)
Приём платежей можно настроить на любой редакции 1С-Битрикс, начиная со Старт (включительно).
В настройках продукта во вкладке "Настройки платёжных систем" для каждой конкретной платёжной системы есть свой перечень настраиваемых параметров в зависимости от требований конкретной платёжной системы.
Для начала работы Вам необходимо получить все нужные данные (ключи и пр.) непосредственно у менеджера или в технической поддержку выбранной платёжной системы с которой у Вас имеется договор, сохранить их, и включить платёжную систему по умолчанию.

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

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

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

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

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

Платные опции

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

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

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

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

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

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

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

Как включить 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. Скопировать компонент в папку local. Например: стоковый компонент лежит в /bitrix/components/detail, чтобы его модифицировать копируете его в /local/components/detail, и автоматически будет подключаться тот который в папке local. При этом важно понимать, что т.к. при обновлении перезаписывается только стоковый компонент, актуализировать функционал в модифицированном это задача владельца проекта.

2. Скопировать основной шаблон продукта (democontent2.board) в папку local/templates (templates создать если не существует). Далее в настройках сайта определить новый шаблон. После этого можно копировать шаблоны нужных компонентов в папку с основным шаблоном в папку components и модифицировать их на своё усмотрение без необходимости выносить весь компонент целиком в отдельное пространство имён.

3. (Для программистов) Если нет необходимости выносить весь компонент в папку local, а нужно лишь модифицировать шаблон компонента, то вы можете использовать правила в urlrewrite.php. Для этого найдите среди правил одно или несколько с обработкой нужного компонента и в RULE добавьте параметр template, например template=myTemplate&component=list, что означает что подключится компонент list с шаблоном myTemplate. Таким образом, можно переопределить только конкретный шаблон.

4. Скопировать только шаблон нужного компонента в папку основного шаблона.

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

С версии 1.9.9

  1. Авторизуйтесь под администратором
  2. Перейдите в личном кабинете в раздел "Модерация"
  3. В открывшемся списке, перейдите в нужное объявление
  4. Если хотите одобрить объявление - Нажмите кнопку "Одобрить объявление"
  5. Если хотите отклонить объявление - нажмите кнопку "Отклонить объявление", и обязательно укажите причину по которой объявление отклонено. Данная информация будет отображена в личном кабинете пользователя в карточке объявления

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

Разместите коды счётчиков систем аналитики (Яндекс.Метрика и пр.) во включаемом файле /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.

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

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

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

Добавление и настройка языков

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

В целом работа с языками выполняется в следующей последовательности:
1. Добавление нового языка
2. Временная деактивация языка до момента готовности переводов
3. Перевод статических языковых файлов для компонентов
4. Перевод данных из инфоблоков (названия ИБ, свойства ИБ, значения свойств ИБ)
5. Перевод названий разделов инфоблоков
6. Перевод мета-данных для инфоблоков и типов инфоблоков
7. Перевод названий регионов
8. Перевод названий городов
9. Перевод включаемых областей
10. Активация нового языка

Возможно в процессе развития этого функционала будут появляться новые возможности и новые данные для переводов.

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

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

В публичной части сайта перейдите из списка в конкретный язык, откроется страница с несколькими вкладками для добавления/редактирования перевода.
Каждая вкладка - отдельная форма, т.е. выполняйте перевод последовательно в рамках одной вкладки, при этом порядок перевода не важен, можете начать с любой.
Обязательно, после добавления/редактирования перевода для вкладки нажимайте в самом низу формы кнопку "Сохранить".
Любая фраза для перевода состоит из двух колонок: слева - исходная фраза на русском языке, справа - поле для перевода. По умолчанию поле для перевода будет либо пустым, либо с продублированной фразой на русском языке в случае отсутствия перевода на конкретный язык. Таким образом достаточно легко ориентироваться в общем списке, и наглядно видно что переведено, а что пропущено.
Выполняйте перевод в любой последовательности, но при этом особо обращайте внимание на некоторые языковые фразы которые могут содержать макросы для динамической замены текста вида #XXXXX# или html теги.
Перевод таких фраз нужно выполнять аккуратно, в точности копируя макрос и html разметку. Не используйте в переводе компонентов одинарные и двойные кавычки, в крайнем случае если пропустили и получили на странице синтаксическую ошибку, нужно зайти в файл перевода конкретного компонента и исправить.

В продукте поддерживается возможность выполнять подключение включаемых файлов (областей) в зависимости от выбранного языка.
Все используемые включаемые файлы расположены в папке основного шаблона продукта (/bitrix/templates/democontent2.board/inc), и в том числе объединены для удобства в папки.
Т.е. включаемые файлы содержат любой произвольный контент. html вёрстку и т.д., и в платформе 1С-Битрикс не существует решения для их корректного перевода.
Тем не менее, раз в продукте реализовано добавление языков, не логично что при переключении языка например на английский, контент из включаемых файлов будет на русском.
Решение простое, после того как вы добавили и активировали новый язык, создайте в папке /bitrix/templates/democontent2.board/inc папку lang (если отсутствует) и внутри неё папку с названием соответствующим коду нужного языка, например пусть это будет папка /bitrix/templates/democontent2.board/inc/lang/en - для английского языка.
Далее вы можете скопировать в эту папку все включаемые файлы из папки /bitrix/templates/democontent2.board/inc (кроме lang), или только часть включаемых файлов.
Но при этом обязательно сохранять структуру вложенности, например вы добавили язык en (/bitrix/templates/democontent2.board/inc/lang/en), и хотите переопределить для него включаемые файлы которые используются для главной страницы и расположены в /bitrix/templates/democontent2.board/inc/index.
В этом случае вы копируете папку /bitrix/templates/democontent2.board/inc/index в /bitrix/templates/democontent2.board/inc/lang/en, и в итоге получаете /bitrix/templates/democontent2.board/inc/lang/en/index.
Всё, после этого при смене языка на английский будут подключаться файлы из этой папки, остаётся только отредактировать их на своё усмотрение.

В продукте поддерживается интеграция с Google Translate
Это значит что вы можете выполнять весь, или часть перевода используя автоматические средства переводчика Google, при этом опционально рекомендуется всё таки перепроверять перевод, т.к. перевод машинным способом может быть выполнен не точно, или без учёта контекста переводимой фразы.

Для настройки интеграции выполните следующее:
1. Зарегистрируйтесь, и получите API ключ в Google Console
2. Перейдите в настройки модуля "Универсальная доска объявлений" в админке сайта и добавьте полученный API ключ в поле "API ключ Google Translate"

Обратите внимание, что доступ к API переводчика условно бесплатный, т.е. это значит что вам потребуется указать данные своей банковской карты с которой для проверки будет списан доллар и возвращён назад.
После проверки карты Google активирует вам купон на 300$ которые вы можете тратить на API.
Если вы истратите лимит деньги не будут списываться с вашей карты если вы вручную не подтвердите переход на платный тариф.
Если вы используете переводчик Google, то на перевод интерфейсов на один язык вы будете тратить примерно 3$ из предоставленных 300, таким образом бесплатно сможете перевести сайт на множество языков при необходимости.
С более подробной информацией по использованию сервисов Google вы можете ознакомиться на официальном сайте.

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

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

После выполнения перевода для конкретного языка, не забудьте активировать его в хайлоадблоке если деактивировали ранее.

Начиная с версии 1.6.4 в продукте есть возможность установить язык по умолчанию.
Суть в том, что Языком по умолчанию в платформе 1С-Битрикс является Русский язык, и данная опция позволяет установить другой в качестве языка по умолчанию.
В настройках соответствующего языка в хайлоадблоке поставьте галочку для поля UF_DEFAULT, после чего следует обязательно очистить кеш.

HTML вёрстка шаблона

Начиная с версии 2.0.8 в папке основного шаблона (/bitrix/templates/democontent2.board) находится папка src, которая содержит исходники вёрстки

Как добавить/изменить логотип

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

Отправка уведомлений в Telegram

С версии 2.0.8 в продукте поддерживается отправка некоторых видов уведомлений в Telegram (например уведомление об объявлении ожидающем проверки, поступлении платежа и т.д. перечень будет пополняться).
Чтобы начать нужно создать бота:

  1. Откройте Telegram, найдите @BotFather
  2. Отправьте ему /start
  3. Затем отправьте ему ещё одно сообщение - /newbot и следуйте инструкциям
  4. После того как бот будет создан, вы увидите токен (обычно выделен красным), скопируйте его
  5. Отправьте только что созданному боту любое сообщение. Для этого перейдите к боту, нажмите start и напишите любое сообщение
  6. Сохраните в настройках модуля в поле Telegram API ключ, полученный ранее API ключ бота
  7. Если всё прошло успешно, в админке в настройках модуля под полем с сохранённым ключом появится поле с идентификатором чата, в противном случае будут выведены сообщения о различных ошибках

Жалобы на объявления

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

Переустановка доски объявлений

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

Поэтому последовательность шагов при повторной установке или переустановке модуля примерно следующая:
  1. Удалить инфоблоки добавленные продуктом
  2. Удалить хайлоадблоки добавленные продуктом
  3. Удалить модуль
  4. Запустить повторно мастер установки