Тип виджета определяет, как карта Mapfolio появится на сайте.
Например, карта может постоянно находиться внутри страницы или открываться во всплывающем окне после действия посетителя.
Тип выбирается в первом блоке редактора — «1. Способ установки».
Где выбирается тип виджета
- Войдите в личный кабинет Mapfolio.
- Откройте раздел «Виджеты».
- Нажмите карточку с большим знаком «+».
- Откроется редактор нового виджета.
- Найдите блок «1. Способ установки».
В этом блоке отображаются доступные типы виджетов и краткие подсказки к ним.
Какие типы отображаются в Mapfolio
| Тип | Как работает | Доступность |
|---|---|---|
| Встроенный блок | Карта постоянно находится в выбранном месте страницы | Доступен |
| Pop-up | Карта открывается во всплывающем окне после действия посетителя | В разработке |
Встроенный блок
«Встроенный блок» — основной доступный тип виджета Mapfolio.
После установки карта становится частью страницы сайта. Она располагается там, куда был добавлен код виджета.
Например, карту можно разместить:
- между текстовыми разделами страницы;
- после описания компании;
- перед контактной информацией;
- внутри отдельного раздела «Наши объекты»;
- на специальной странице с адресами;
- в нижней части главной страницы.
Как выглядит встроенный блок
Встроенный блок может содержать:
- интерактивную карту;
- маркеры опубликованных точек;
- список точек;
- строку поиска;
- фильтры;
- карточки объектов;
- фотографии и видео;
- кнопку перехода в полноэкранный режим.
Точный внешний вид зависит от параметров и дизайна выбранного виджета.
Где появится карта
Карта появится в том месте страницы, куда добавлена часть кода с контейнером виджета.
Если код вставлен между двумя текстовыми блоками, карта появится между ними. Если код добавлен в нижнюю часть страницы, карта будет находиться внизу.
Pop-up
Виджет типа «Pop-up» должен открывать карту во всплывающем окне после действия посетителя.
Например, посетитель нажимает кнопку «Открыть карту», после чего карта появляется поверх страницы.
Почему на Pop-up нельзя нажать
Недоступный тип отображается приглушённым цветом и имеет пометку «В разработке».
Если нажать на такую карточку, выбор не произойдёт. Это не ошибка браузера и не проблема вашей учётной записи.
Как посмотреть описание типа
На карточке каждого типа находится значок вопроса.
Чтобы увидеть описание:
- Найдите знак «?» на карточке.
- Наведите на него указатель мыши.
- На телефоне нажмите на значок.
- Прочитайте появившуюся подсказку.
Для встроенного блока отображается описание:
«Виджет встраивается в выбранное место страницы».
Для Pop-up:
«Виджет открывается во всплывающем окне по действию пользователя».
Как выбрать встроенный блок
- Откройте создание нового виджета.
- В блоке «1. Способ установки» нажмите «Встроенный блок».
- Убедитесь, что карточка типа выделилась.
- Найдите поле «Название виджета (видно только в админ-панели виджетов)».
- Введите понятное название.
- Нажмите кнопку «Подтвердить выбор».
- Дождитесь открытия остальных настроек.
После подтверждения станут доступны следующие блоки:
- «2. API карты»;
- «3. Параметры»;
- «4. Дизайн»;
- «5. Предпросмотр»;
- «6. Код для установки».
Как назвать виджет
Название помогает найти нужный виджет в личном кабинете. Посетители сайта это название не увидят.
Используйте названия, по которым понятно назначение виджета.
Хорошие примеры:
- «Карта магазинов на главной»;
- «Карта объектов — Екатеринбург»;
- «Карта для страницы контактов»;
- «Карта жилых комплексов»;
- «Виджет для сайта example.ru».
Неудобные примеры:
- «Новый»;
- «Тест»;
- «Карта»;
- «Виджет 1».
Можно ли изменить тип существующего виджета
После подтверждения и создания виджета выбранный тип блокируется.
При повторном открытии редактора:
- текущий тип будет выделен;
- кнопка подтверждения больше не потребуется;
- выбрать другой тип не получится;
- название и остальные настройки можно продолжать изменять.
Если потребуется другой способ установки, создайте отдельный виджет.
Чем тип отличается от остальных настроек
| Настройка | За что отвечает |
|---|---|
| Тип виджета | Как карта появляется на странице |
| API карты | Какой API-ключ Яндекс Карт используется |
| Параметры | Размеры и поведение виджета |
| Дизайн | Цвета, маркеры и оформление |
| Предпросмотр | Проверка результата перед установкой |
| Код для установки | Подключение готового виджета к сайту |
Выбор типа не заменяет остальные настройки.
Даже после выбора встроенного блока необходимо:
- Выбрать API-ключ.
- Настроить параметры.
- Выбрать дизайн.
- Проверить предварительный просмотр.
- Сохранить виджет.
- Скопировать код.
- Добавить код на сайт.
Когда создавать несколько виджетов
Создайте отдельные виджеты, если карты должны отличаться настройками.
Например:
- один виджет предназначен для главной страницы;
- второй — для отдельной страницы с объектами;
- третий — для другого сайта;
- на компьютере и телефоне требуется разное поведение;
- нужны разные размеры или оформление;
- один виджет требуется временно отключать независимо от другого.
При этом виджеты могут показывать точки из одного личного кабинета.
Как выбрать подходящий вариант
| Задача | Что выбрать |
|---|---|
| Карта должна сразу находиться на странице | Встроенный блок |
| Карта должна быть частью раздела с объектами | Встроенный блок |
| Карта должна располагаться рядом с контактами | Встроенный блок |
| Карта должна открываться после нажатия кнопки | Pop-up, но этот тип пока в разработке |
| Нужен рабочий виджет прямо сейчас | Встроенный блок |
Частые вопросы
Почему кнопка «Подтвердить выбор» не нажимается
Скорее всего, тип ещё не выбран.
Нажмите на карточку «Встроенный блок». После выделения карточки кнопка станет доступной.
Почему нельзя выбрать Pop-up
Тип находится в разработке. Пометка «В разработке» означает, что этот вариант пока нельзя использовать для рабочего сайта.
Почему тип нельзя изменить в существующем виджете
Способ установки связан с кодом и поведением виджета. Поэтому после подтверждения тип фиксируется.
Для другого способа установки потребуется создать новый виджет.
Почему карта появилась не в том месте страницы
Встроенный блок появляется там, куда добавлен его код. Переместите код виджета в нужный раздел страницы.
Если вы не знаете, как редактировать страницу, передайте код администратору сайта.
Короткая проверка перед продолжением
Перед переходом к остальным настройкам убедитесь, что:
- выбран «Встроенный блок»;
- карточка типа выделена;
- указано понятное внутреннее название;
- нажата кнопка «Подтвердить выбор»;
- открылись разделы API, параметров, дизайна и предпросмотра;
- вы понимаете, в каком месте сайта должна находиться карта.
После этого можно переходить к подключению API-ключа и настройке параметров виджета.