Типы виджетов и выбор способа установки

Тип виджета определяет, как карта Mapfolio появится на сайте.

Например, карта может постоянно находиться внутри страницы или открываться во всплывающем окне после действия посетителя.

Тип выбирается в первом блоке редактора — «1. Способ установки».

Где выбирается тип виджета

  1. Войдите в личный кабинет Mapfolio.
  2. Откройте раздел «Виджеты».
  3. Нажмите карточку с большим знаком «+».
  4. Откроется редактор нового виджета.
  5. Найдите блок «1. Способ установки».

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

Выбор способа установки нового виджета

Какие типы отображаются в Mapfolio

Тип Как работает Доступность
Встроенный блок Карта постоянно находится в выбранном месте страницы Доступен
Pop-up Карта открывается во всплывающем окне после действия посетителя В разработке

Встроенный блок

«Встроенный блок» — основной доступный тип виджета Mapfolio.

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

Например, карту можно разместить:

  • между текстовыми разделами страницы;
  • после описания компании;
  • перед контактной информацией;
  • внутри отдельного раздела «Наши объекты»;
  • на специальной странице с адресами;
  • в нижней части главной страницы.

Как выглядит встроенный блок

Встроенный блок может содержать:

  • интерактивную карту;
  • маркеры опубликованных точек;
  • список точек;
  • строку поиска;
  • фильтры;
  • карточки объектов;
  • фотографии и видео;
  • кнопку перехода в полноэкранный режим.

Точный внешний вид зависит от параметров и дизайна выбранного виджета.

Где появится карта

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

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

Встроенный виджет внутри страницы сайта

Pop-up

Виджет типа «Pop-up» должен открывать карту во всплывающем окне после действия посетителя.

Например, посетитель нажимает кнопку «Открыть карту», после чего карта появляется поверх страницы.

Почему на Pop-up нельзя нажать

Недоступный тип отображается приглушённым цветом и имеет пометку «В разработке».

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

Как посмотреть описание типа

На карточке каждого типа находится значок вопроса.

Чтобы увидеть описание:

  1. Найдите знак «?» на карточке.
  2. Наведите на него указатель мыши.
  3. На телефоне нажмите на значок.
  4. Прочитайте появившуюся подсказку.

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

«Виджет встраивается в выбранное место страницы».

Для Pop-up:

«Виджет открывается во всплывающем окне по действию пользователя».

Как выбрать встроенный блок

  1. Откройте создание нового виджета.
  2. В блоке «1. Способ установки» нажмите «Встроенный блок».
  3. Убедитесь, что карточка типа выделилась.
  4. Найдите поле «Название виджета (видно только в админ-панели виджетов)».
  5. Введите понятное название.
  6. Нажмите кнопку «Подтвердить выбор».
  7. Дождитесь открытия остальных настроек.

После подтверждения станут доступны следующие блоки:

  • «2. API карты»;
  • «3. Параметры»;
  • «4. Дизайн»;
  • «5. Предпросмотр»;
  • «6. Код для установки».
Подтверждение типа нового виджета

Как назвать виджет

Название помогает найти нужный виджет в личном кабинете. Посетители сайта это название не увидят.

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

Хорошие примеры:

  • «Карта магазинов на главной»;
  • «Карта объектов — Екатеринбург»;
  • «Карта для страницы контактов»;
  • «Карта жилых комплексов»;
  • «Виджет для сайта example.ru».

Неудобные примеры:

  • «Новый»;
  • «Тест»;
  • «Карта»;
  • «Виджет 1».

Можно ли изменить тип существующего виджета

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

При повторном открытии редактора:

  • текущий тип будет выделен;
  • кнопка подтверждения больше не потребуется;
  • выбрать другой тип не получится;
  • название и остальные настройки можно продолжать изменять.

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

Чем тип отличается от остальных настроек

Настройка За что отвечает
Тип виджета Как карта появляется на странице
API карты Какой API-ключ Яндекс Карт используется
Параметры Размеры и поведение виджета
Дизайн Цвета, маркеры и оформление
Предпросмотр Проверка результата перед установкой
Код для установки Подключение готового виджета к сайту

Выбор типа не заменяет остальные настройки.

Даже после выбора встроенного блока необходимо:

  1. Выбрать API-ключ.
  2. Настроить параметры.
  3. Выбрать дизайн.
  4. Проверить предварительный просмотр.
  5. Сохранить виджет.
  6. Скопировать код.
  7. Добавить код на сайт.

Когда создавать несколько виджетов

Создайте отдельные виджеты, если карты должны отличаться настройками.

Например:

  • один виджет предназначен для главной страницы;
  • второй — для отдельной страницы с объектами;
  • третий — для другого сайта;
  • на компьютере и телефоне требуется разное поведение;
  • нужны разные размеры или оформление;
  • один виджет требуется временно отключать независимо от другого.

При этом виджеты могут показывать точки из одного личного кабинета.

Как выбрать подходящий вариант

Задача Что выбрать
Карта должна сразу находиться на странице Встроенный блок
Карта должна быть частью раздела с объектами Встроенный блок
Карта должна располагаться рядом с контактами Встроенный блок
Карта должна открываться после нажатия кнопки Pop-up, но этот тип пока в разработке
Нужен рабочий виджет прямо сейчас Встроенный блок

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

Почему кнопка «Подтвердить выбор» не нажимается

Скорее всего, тип ещё не выбран.

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

Почему нельзя выбрать Pop-up

Тип находится в разработке. Пометка «В разработке» означает, что этот вариант пока нельзя использовать для рабочего сайта.

Почему тип нельзя изменить в существующем виджете

Способ установки связан с кодом и поведением виджета. Поэтому после подтверждения тип фиксируется.

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

Почему карта появилась не в том месте страницы

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

Если вы не знаете, как редактировать страницу, передайте код администратору сайта.

Короткая проверка перед продолжением

Перед переходом к остальным настройкам убедитесь, что:

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

После этого можно переходить к подключению API-ключа и настройке параметров виджета.