Виджет шахматки

Шахматка на вашем сайте — одной строкой кода

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

Работает на Tilda, WordPress, Битрикс, Webflow и самописных сайтах

🔒app.domxml.ru
DomXMLНедвижимостьCRMПубликацияАС

‹ К списку каналов

Публикация

Виджет на странице «Квартиры»

Как выглядит

Пресет
Сетка
Планировки
Компактный

Где разрешён виджет

Домены, по одному в строке zarechye.ru
www.zarechye.ru

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

Код вставки

Поставьте эту строку в том месте страницы, где должна появиться шахматка.

<script src="https://domxml.ru/w/v1.js" data-key="dxp_3f9c2a71d0e84b56" async></script>
Скопировать кодОткрыть предпросмотр

Виджет на странице «Квартиры»

Виджет · Сетка

Опубликован
ЖК
ЖК «Заречье»
Работает
zarechye.ru, www.zarechye.ru
За 30 дней
3180 показов · 45 заявок
1

Пресет

Сетка, Планировки, Компактный, Просторный, План этажа: стартовый режим и плотность, дальше — по одной настройке.

2

Список доменов

Поддомены разрешены вместе с доменом. С чужого сайта тот же ключ получит отказ.

3

Код с вашим ключом

Панель выдаёт строку целиком: скопировать и вставить в блок HTML на странице ЖК.

4

Видно, где работает

В карточке канала — домены, показы и заявки за 30 дней.

Так это выглядит на сайте

Демонстрационный ЖК, данные ненастоящие

Как это работает

4 шага до шахматки на сайте

1

Выберите ЖК

В разделе «Публикация» создайте виджет и отметьте, какие комплексы он показывает.

2

Возьмите пресет

Пять готовых наборов: сетка, планировки, компактный список, премиум-карточки, план этажа.

3

Скопируйте код

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

4

Вставьте на сайт

Одна строка в нужное место страницы. Высота подстраивается сама, вёрстка сайта не меняется.

Где в панели: кнопка «Публикация» в шапке → «Создать» → «Виджет» → ЖК и шаблон → «Где разрешён виджет» → «Код вставки». Виджет показывает квартиры, пока он опубликован: кнопки «Опубликовать» и «Выключить» — в списке каналов.

Преимущества

Почему виджет, а не выгрузка в таблицу

Цены всегда сегодняшние

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

Три режима в одной сборке

Шахматка по этажам, сетка планировок и план этажа. Посетитель переключается сам, вы выбираете, с какого режима открыть. У коттеджного посёлка — генплан с участками и список.

Не тормозит страницу

Загрузчик 2,5 КБ, вся начинка — около 21 КБ в сжатом виде. Загрузка асинхронная, данные отдаются с кэшем и перепроверяются по ETag.

Сразу под телефон

Плотность подбирается по ширине контейнера, а не окна: в узкой колонке виджет сам переходит к списку карточек.

Заявка — в CRM

Форма в карточке квартиры создаёт клиента в CRM: сразу видно, какой лот смотрел человек и с какой рекламы пришёл.

Ключ привязан к домену

Список доменов задаёте вы, поддомены разрешаются вместе с доменом. С заполненным списком виджет на чужом сайте не получит данные. Пустой список — «на любом сайте»: удобно для проверки, но перед запуском впишите свои домены.

Как это устроено

Виджет — это iframe и небольшой загрузчик. Загрузчик вставляет рамку, передаёт ей ключ канала и настройки из тега, а дальше следит за высотой содержимого: когда посетитель открывает карточку квартиры или меняет фильтр, рамка растёт и сжимается вместе с содержимым. Стили сайта и стили виджета не пересекаются, поэтому «поехавшей» вёрстки не бывает.

Данные виджет берёт из публичного API. Сначала он спрашивает версию шахматки — короткий ответ с хэшем и счётчиками, — а снимок квартир запрашивает, только если версия изменилась. Если изменилось немного, приходит дельта: несколько квартир вместо всего каталога. За счёт этого виджет остаётся быстрым и на ЖК в тысячу квартир.

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

Что умеет виджет

  • Фильтры: комнатность и тип объекта, корпус, цена «до»
  • Коммерция, машиноместа и кладовые — в той же вставке, со своим фильтром и характеристиками
  • У посёлка — генплан, где участки окрашены по статусу
  • Карточка квартиры с планировкой и видом из окна
  • Ипотечный платёж по вашим условиям
  • Форма заявки с согласием на обработку данных
  • Скрытие проданных квартир
  • Светлая и тёмная тема, свой акцентный цвет
  • Ограничение по доменам и защита от ботов
  • Статистика показов и заявок за 30 дней

Вставка

Одна строка в HTML

<script src="https://domxml.ru/w/v1.js"
        data-key="dxp_ваш_ключ" async></script>

Скрипт ставит на страницу iframe и сам подгоняет его высоту под содержимое, поэтому виджет не ломает вёрстку и не конфликтует со стилями сайта. Поведение можно задать прямо в теге: data-mode="plans" — открыть на планировках, data-density="compact" — зафиксировать плотность, data-complex="123" — показать один ЖК из нескольких.

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

FAQ

Частые вопросы

Подойдёт ли для Tilda или WordPress?

Да. Нужен блок, куда можно вставить HTML: в Tilda это T123 «HTML-код», в WordPress — блок «Произвольный HTML», в Битриксе — включаемая область. Плагины и доступы к коду сайта не нужны.

Виджет замедлит сайт?

Загрузчик — 2,5 КБ в сжатом виде и грузится асинхронно, то есть не задерживает отрисовку страницы; вся начинка виджета внутри рамки — около 21 КБ. Данные отдаются с кэшем и проверяются по ETag: при неизменной шахматке ответ занимает сотни байт.

Как виджет выглядит на телефоне?

Плотность подбирается по ширине контейнера: в широкой колонке — таблица по этажам, в узкой — карточки списком. Отдельную мобильную версию делать не нужно.

Как часто обновляются цены?

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

Ключ виден в коде страницы — это безопасно?

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

Поставьте шахматку на свой сайт

Создайте канал, скопируйте строку кода и вставьте на страницу ЖК — это бесплатно

Начать бесплатно