Отзывы с Яндекс.Карт и 2ГИС на сайт

1. Установка
Установите модуль через «Marketplace» вашего сайта (стандартный путь: «Администрирование → Маркетплейс → Найти и установить»). После установки в меню появится пункт «Маркетинг → Отзывы с Яндекс.Карт и 2ГИС».

2. Настройка модуля
Откройте «Маркетинг → Отзывы с Яндекс.Карт и 2ГИС». Настройки разведены по вкладкам: Настройки, Журнал, Техподдержка.

На вкладке «Настройки» заполните списки организаций — по одной на строку.

Яндекс.Карты — любой из трёх форматов:

• числовой ID организации;
  
• полная ссылка из адресной строки браузера (например, https://yandex.ru/maps/org/.../ID);
  
• короткая ссылка вида https://yandex.ru/maps/-/CTH2zO6y.
  

2ГИС — числовой ID филиала или ссылка вида https://2gis.ru/moscow/firm/70000001057394703 (город в адресе может быть другим). Если указаны организации 2ГИС, обязательно заполните поле «Ключ для загрузки отзывов 2ГИС» (это публичный параметр со страницы отзывов 2ГИС, не ключ из кабинета разработчика). Как получить ссылку и ключ — ниже и на вкладке «Техподдержка».

Дополнительно можно задать:

• интервал агента импорта (от часа до трёх суток, по умолчанию раз в сутки);
  
• способ хранения фото и аватарок: копии на сайте (/upload/xlogic.reviews/) или показ с серверов источника.
  

После заполнения сохраните настройки. Короткие ссылки Яндекс.Карт при сохранении сами превращаются в числовой ID.

3. Импорт отзывов
Нажмите кнопку «Загрузить новые отзывы» и дождитесь сообщения по каждой организации. Импорт обрабатывает карточки Яндекс.Карт и 2ГИС одним запуском.

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

Ход последнего прохода смотрите на вкладке «Журнал»: организация, время, статус, сколько отзывов добавлено, обновилась ли шапка. Если Яндекс.Карты вернули защиту от ботов, в журнале будет отметка «Капча» — повторите загрузку позже.

4. Вывод на странице сайта
На нужной странице добавьте компонент xlogic:reviews (через визуальный редактор или вручную в коде).

В параметрах укажите:

• шаблон — слайдер (карусель), список с пагинацией, сетка карточек или кирпичная вёрстка (masonry) с кнопкой «Показать ещё»;
  
• организацию Яндекс.Карт — конкретная карточка или «Не использовать Яндекс»;
  
• организацию 2ГИС — конкретная карточка или «Не использовать 2ГИС»;
  
• при необходимости включите «Смешивать отзывы Яндекс и 2ГИС в одном блоке» (MIX_SOURCES) — в одном виджете будут отзывы обеих площадок (двойная шапка рейтинга и отдельные кнопки «Оставить отзыв»).
  

Если обе площадки выключены, блок отзывов будет пустым.

Также можно задать число отзывов, сортировку, минимальную оценку, только с текстом или с фото, показ тем отзывов и выпадающего списка сортировки.

Пример вызова:

Как получить короткую ссылку Яндекс.Карт

1. Откройте Яндекс.Карты и найдите нужную организацию.
   
2. Перейдите в карточку организации.
   
3. Нажмите иконку «Поделиться» (стрелка) в карточке.
   
4. Нажмите «Скопировать ссылку» — получится адрес типа https://yandex.ru/maps/-/CTH2zO6y.
   

Эту ссылку вставьте в список «Организации в Яндекс.Картах» (каждая организация — с новой строки) и сохраните настройки.

Альтернатива, если организация ваша: в Яндекс Бизнесе «Главная → Ваша организация в Яндексе → Карты» — оттуда берётся та же ссылка из адресной строки.

Как получить ссылку 2ГИС

1. Откройте 2ГИС и найдите нужную организацию.
   
2. Откройте карточку филиала.
   
3. Скопируйте адрес из строки браузера — вида https://2gis.ru/moscow/firm/70000001057394703.
   
4. Вставьте ссылку или только ID после /firm/ в список «Организации в 2ГИС».
   
5. Получите ключ (см. ниже), сохраните настройки и нажмите «Загрузить новые отзывы».
   

Как получить ключ 2ГИС

Ключ берётся со страницы отзывов на 2gis.ru. Это публичный параметр запроса, а не API-ключ из кабинета 2ГИС Platform.

1. Откройте карточку организации на 2gis.ru и перейдите на вкладку «Отзывы».
   
2. Откройте инструменты разработчика (F12) → вкладка «Сеть» (Network).
   
3. В фильтре введите reviews (или public-api.reviews).
   
4. Найдите запрос к public-api.reviews.2gis.com с /reviews.
   
5. В URL запроса скопируйте значение после key= (набор символов с дефисами) и вставьте его в поле «Ключ для загрузки отзывов 2ГИС».
   

Важно

Повторный импорт не затирает базу — отзывы сопоставляются по внешнему идентификатору, дубли не создаются.

Число отзывов ограничено тем, что отдаёт источник на публичной странице (у Яндекс.Карт это обычно меньше счётчика в карточке). Это ограничение площадки, а не модуля.

Результат работы компонента кешируется; после импорта кеш сбрасывается автоматически.