Из Маркетплейса: «Marketplace → Каталог решений» → найдите решение → «Установить».
Что происходит при установке (вмешательство не требуется):
- создаётся тип инфоблоков topman_reviews и инфоблок «Отзывы» (код topman_yandex_reviews) со всеми свойствами;
- ID созданного инфоблока прописывается в настройки модуля;
- создаются служебные таблицы: список организаций и журнал сборов;
- регистрируется агент автосбора (по умолчанию раз в 7 дней, первый запуск — через сутки);
- в админпанели появляется раздел «Top Man Digital → Отзывы с площадок» с пунктами «Организации», «Журнал сборов», «Настройки».
Если установка прервалась с ошибкой, модуль откатывает за собой изменения сам — повторную установку можно запускать сразу.
Первый запуск- Откройте «Отзывы с площадок → Организации → Добавить организацию».
- Вставьте ссылку на карточку организации на любой поддерживаемой площадке — площадка определится сама:
- Яндекс.Карты — https://yandex.ru/maps/org/<название>/<id>/reviews/
- 2ГИС — https://2gis.ru/<город>/firm/<id>
- ПроДокторов — https://prodoctorov.ru/<город>/lpu/<id>-<название>/
- Zoon — https://zoon.ru/<город>/<рубрика>/<организация>/
- Островок — https://ostrovok.ru/hotel/russia/<регион>/mid<id>/<отель>/
- 101Hotels — https://101hotels.com/main/cities/<город>/<отель>.html
- Яндекс.Карты — https://yandex.ru/maps/org/<название>/<id>/reviews/
Поле «Название» можно не заполнять — подставится из ссылки, потом переименуете.
«Настройки → Настройки продукта → Настройки модулей → Top Man Digital: Сбор отзывов с внешних площадок»
- Инфоблок отзывов. Куда складывать отзывы. Создаётся при установке; меняйте, только если переносите данные в свой инфоблок.
- Публиковать новые отзывы сразу. По умолчанию выключено: новые отзывы неактивны и ждут модерации. Включите, если хотите публиковать без проверки.
- Включить автосбор (агент Bitrix). По умолчанию включено. Периодический обход всех активных организаций.
- Интервал автосбора. По умолчанию 7 дней.
- Импортировать отзывы без текста. По умолчанию включено. Часть площадок отдаёт отзывы без текста, только с оценкой; выключите, если такие не нужны.
- Пауза между организациями. По умолчанию 3 секунды. Задержка при массовом сборе, чтобы не создавать всплеск запросов к площадке.
- User-Agent для запросов. Пусто — используется браузерный User-Agent по умолчанию.
- Публичный ключ API 2ГИС. Пусто — используется встроенный публичный ключ виджета. Заполните, если 2ГИС перестал отдавать отзывы.
- Агент Bitrix — вариант по умолчанию. Важная особенность платформы: агенты выполняются либо по агентскому cron, либо на посещениях сайта. Если агентский cron у сайта не настроен, сбор произойдёт при ближайшем визите посетителя после наступления срока — то есть «раз в неделю» может сдвинуться.
- Системный cron — если нужно строгое расписание. В модуле есть CLI-раннер. Запускать от пользователя веб-сервера. При этом варианте автосбор-агент лучше выключить в настройках, чтобы отзывы не собирались дважды:
/path/to/php -f /home/site/public_html/bitrix/modules/topman.yandexreviews/tools/run_collector.php |
- Кнопка «Собрать сейчас» в списке организаций — ручной сбор по одной организации.
Модуль ставит один компонент — topman:reviews.list — с двумя шаблонами: .default (список с блоком статистики) и carousel (карусель с фильтром по площадкам). Компонент доступен в визуальном редакторе. Если инфоблок выбран в настройках модуля, IBLOCK_ID можно не передавать — компонент подставит его сам.
Список отзывов — страница «Отзывы»:<?php $APPLICATION->IncludeComponent('topman:reviews.list', '.default', [
'SHOW_STATS' => 'Y', // блок статистики: средняя оценка, гистограмма, площадки
'SHOW_LAYOUT_SWITCH' => 'Y', // переключатель «3 в ряд / 1 в ряд»
'SHOW_REPLY' => 'Y', // показывать ответы организации
'SHOW_PAGER' => 'Y', // штатная постраничная навигация Bitrix
'PAGE_SIZE' => 9, // отзывов на странице
'SHOW_LOAD_MORE' => 'Y', // кнопка «Показать ещё» над навигацией
'CLAMP_LINES' => 6, // строк текста до «Читать полностью»
'SORT_BY' => 'ACTIVE_FROM',
'SORT_ORDER' => 'DESC',
'CACHE_TYPE' => 'A',
'CACHE_TIME' => 3600,
]); ?> |
Карусель — блок на главной:
<?php $APPLICATION->IncludeComponent('topman:reviews.list', 'carousel', [
'TITLE' => 'Отзывы клиентов',
'COUNT' => 12, // сколько отзывов загрузить в ленту
'SHOW_PAGER' => 'N', // в карусели навигация не нужна
'SHOW_CHIPS' => 'Y', // чипы-фильтры по площадкам
'AUTOPLAY' => 'Y',
'AUTOPLAY_SECONDS' => 5,
'ALL_REVIEWS_URL' => '/otzyvy/', // ссылка «Читать все отзывы»
'SHOW_REPLY' => 'Y',
'CACHE_TYPE' => 'A',
'CACHE_TIME' => 3600,
]); ?> |
Отзывы только одной организации — например, на странице конкретного филиала. Идентификатор организации на площадке (ORG_YANDEX_ID) — это числовой сегмент из её ссылки либо значение свойства ORG_YANDEX_ID у любого уже импортированного отзыва:
<?php $APPLICATION->IncludeComponent('topman:reviews.list', '.default', [
'ORG_YANDEX_ID' => '183683205873',
'COUNT' => 6,
'SHOW_PAGER' => 'N', // ровно COUNT отзывов, без пагинации
'SHOW_STATS' => 'N',
'MIN_RATING' => 4, // только оценки 4 и выше
]); ?> |
Шаблоны копируются в шаблон сайта штатно, через «Копировать шаблон компонента» — вёрстку и стили можно менять под свой дизайн, обновление модуля их не затрёт.
Если нужен свой вывод
Отзывы — обычные элементы инфоблока, их можно выводить любым своим компонентом. Значимые свойства:
- RATING — оценка 1–5.
- SOURCE — площадка, свойство типа «список».
- AUTHOR_NAME, AUTHOR_LEVEL — автор и его уровень на площадке.
- AUTHOR_AVATAR — исходный URL аватара; скачанный файл лежит в картинке анонса элемента.
- PHOTOS — фотографии из отзыва, множественное свойство типа «файл».
- BUSINESS_REPLY, BUSINESS_REPLY_TIME — ответ организации и его дата.
- ORG_YANDEX_ID, ORG_NAME, SOURCE_URL — привязка к организации.
- ASSESSMENTS — оценки по критериям: ПроДокторов, Островок, 101Hotels.
- IS_VERIFIED, VISIT_DATE, BRANCH_ADDRESS, TRIP_TYPE, ROOM — дополнительные поля отдельных площадок.
Текст отзыва — в анонсе и детальном описании элемента, дата отзыва — в поле «Начало активности».
ДиагностикаВсе прогоны видны в «Журнале сборов»: дата, организация, статус, сколько добавлено и пропущено, сколько отзывов есть на карточке сверх загруженных, текст ошибки.
- Статус «OK» — сбор прошёл. «Добавлено 0» при повторном прогоне это норма: дубли не создаются.
- Статус «Ошибка» — сетевая проблема или изменилась вёрстка площадки. Разовые таймауты бывают; тревожно, если повторяется несколько прогонов подряд.
- Статус «Капча» — площадка ограничила доступ. Помогает увеличенная пауза между организациями и более редкий автосбор.
«Настройки → Модули → Удалить». Модуль спросит, сохранять ли данные: с сохранением инфоблок с отзывами и служебные таблицы остаются на месте, без сохранения — удаляются вместе с настройками. Агент снимается в обоих случаях.
Top Man Digital: Отзывы избавляет от ручного переноса отзывов с площадок-отзовиков на сайт. Вы один раз вставляете ссылку на карточку организации — модуль сам определяет площадку, забирает отзывы, скачивает аватары и фотографии к себе на сайт и складывает всё в инфоблок «Отзывы». Дальше он ходит за новыми отзывами по расписанию, а вы только подтверждаете их публикацию.
Отзывы на сайте — это и социальное доказательство для посетителя, и микроразметка с реальными оценками для поисковых систем. Модуль делает так, чтобы блок отзывов не устаревал сам собой через месяц после запуска сайта.
Возможности- Шесть площадок из коробки. Яндекс.Карты, 2ГИС, ПроДокторов, Zoon, Островок, 101Hotels. Площадка определяется автоматически по вставленной ссылке — выбирать её вручную не нужно.
- Ссылка вместо настройки. В админке добавляется организация: вставили адрес карточки — модуль сам вытащил идентификатор и название. Никаких API-ключей и регистраций (для 2ГИС используется публичный ключ виджета, при необходимости заменяется в настройках).
- Модерация перед публикацией. По умолчанию новые отзывы создаются неактивными: владелец сайта просматривает их в инфоблоке и включает нужные. Режим «публиковать сразу» — переключателем в настройках.
- Дубли не создаются. Дедупликация по идентификатору отзыва на площадке: повторный сбор добавляет только новое, уже импортированные отзывы не трогает.
- Картинки — свои, а не чужие ссылки. Аватар автора и фотографии из отзыва скачиваются на сайт (аватар — в картинку анонса элемента, фото — в свойство-файл). Ничего не отвалится, если площадка сменит адреса своей CDN.
- Полный состав отзыва. Автор, оценка, дата, текст, ответ организации, фотографии, уровень автора. Плюс поля, специфичные для площадки: оценки по критериям, отметка «отзыв проверен», когда был визит, адрес филиала, тип поездки, категория номера.
- Данные лежат в инфоблоке. Обычные элементы Bitrix: их можно править, фильтровать, выводить своими компонентами, отдавать в поиск и в микроразметку — модуль не запирает данные внутри себя.
- Готовый компонент вывода, два шаблона. topman:reviews.list — список с блоком статистики (средняя оценка, гистограмма оценок, разбивка по площадкам), плиткой и штатной постраничной навигацией Bitrix, и карусель с фильтром-чипами по площадкам и автопрокруткой.
- Кнопка «Показать ещё». Без JavaScript — обычная ссылка на следующую страницу, с JavaScript — дозагружает отзывы в текущий список и синхронизирует адресную строку и активную страницу пагинации.
- Адаптивность. Плитка и карусель сами пересчитывают число карточек в ряд под ширину экрана: три, два или один.
- Свой шрифт без дублей. Montserrat поставляется вместе с модулем (лицензия OFL) и подключается только если его ещё нет в шаблоне сайта.
- Сбор по расписанию. Агент Bitrix обходит все активные организации раз в N дней (по умолчанию раз в неделю). Есть кнопка «Собрать сейчас» для одной организации и CLI-скрипт для системного crontab, если нужно строгое расписание без зависимости от посещаемости.
- Журнал сборов. По каждому прогону: дата, организация, статус, сколько добавлено и пропущено, текст ошибки. Видно, когда площадка сменила вёрстку или ограничила доступ.
- Настройки. Инфоблок для отзывов, публиковать сразу или на модерацию, интервал автосбора, пауза между организациями, User-Agent, ключ API 2ГИС, импортировать ли отзывы без текста.
- Русский и английский интерфейс, разграничение прав доступа к модулю штатными группами Bitrix.
Клиникам, отелям и гостевым домам, сервисным компаниям, магазинам с офлайн-точками, ресторанам — всем, у кого отзывы уже накопились на внешних площадках, а на сайте блок отзывов пустует или заполняется вручную.
Что важно знать до покупкиМодуль получает отзывы со страниц самих площадок — публичного API для этого у них нет. Отсюда два следствия, о которых честнее сказать сразу:
- за один прогон по организации забирается до 50 последних отзывов (у части площадок — сколько отдаёт их страница); это осознанное ограничение, чтобы не нагружать площадку и не провоцировать блокировку;
- если площадка изменит вёрстку или ограничит доступ к своим страницам, сбор по ней может временно перестать работать — это будет видно в журнале, и лечится обновлением модуля.
Уже собранные отзывы при этом никуда не исчезают: они хранятся в вашем инфоблоке.
Закажите любой модуль у нас на сайте с бесплатной установкой и гарантией 14 дней
Мы работаем с физическими и юридическими лицами. И предоставляем сразу два варианта оплаты.
- Наличные. Вы подписываете товаросопроводительные документы, расплачиваетесь денежными средствами, получаете товар и чек.
- Безналичный расчет. Принимаем карты Visa и MasterCard. Доступен при курьерской доставке.
Ваш заказ можем доставить собственными ресурсами, при условии вашего нахождения в городе. Либо через 4 варианта доставки:
- Курьерская доставка. Курьерская доставка работает с 9:00 до 19:00. Когда товар поступит на склад, курьерская служба свяжется для уточнения деталей. Специалист предложит выбрать удобное время доставки и уточнит адрес.
- Самовывоз из магазина. Для получения заказа обратитесь к сотруднику в кассовой зоне и назовите номер.
- Сотрудничаем с постаматами. Срок хранения — 3 дня.
- Предоставляем почтовую доставку через почту России. Когда заказ придет в отделение, на ваш адрес придет извещение о посылке. Вскрывать коробку самостоятельно вы можете только после оплаты заказа.
Дополнительная вкладка для размещения информации о товарах, доставке или любого другого важного контента. Поможет вам ответить на интересующие покупателя вопросы и развеять его сомнения в покупке. Используйте её по своему усмотрению.
Вы можете убрать её или вернуть обратно, изменив одну галочку в настройках компонента. Очень удобно.
- Комментарии
- ВКонтакте