Проверка виджета после установки

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

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

Откройте опубликованную страницу

  1. Опубликуйте изменения на сайте.
  2. Скопируйте адрес страницы с установленным виджетом.
  3. Откройте новую вкладку браузера.
  4. Вставьте адрес в строку браузера.
  5. Нажмите клавишу Enter.
  6. Дождитесь полной загрузки страницы.
  7. Прокрутите страницу до виджета Mapfolio.
Виджет Mapfolio на опубликованной странице сайта

Убедитесь, что виджет загрузился

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

  • список точек;
  • строка поиска;
  • фильтры;
  • карточки точек;
  • дополнительные элементы управления.

Если некоторые элементы были отключены в настройках виджета, их отсутствие не является ошибкой.

Признаки правильной установки

  • На странице появилась карта.
  • Карта занимает отведённую ей область.
  • Вместо карты не показывается текст с HTML-кодом.
  • На месте виджета нет пустого белого блока.
  • На карте появились опубликованные точки.
  • Страница не зависает во время загрузки.
  • Остальные блоки сайта продолжают работать.
  • Виджет не перекрывает меню, текст и кнопки сайта.

Проверьте карту

Сначала проверьте основные действия с картой.

  1. Зажмите карту левой кнопкой мыши.
  2. Переместите указатель в сторону.
  3. Убедитесь, что карта передвигается.
  4. Увеличьте масштаб карты.
  5. Уменьшите масштаб карты.
  6. Нажмите на один из маркеров.
  7. Убедитесь, что открылась соответствующая точка.
  8. Закройте точку и откройте другой маркер.
  9. Проверьте несколько точек в разных частях карты.

Что проверить у маркеров

  • Маркеры находятся в правильных местах.
  • Маркеры не исчезают при изменении масштаба.
  • Нажатие на маркер открывает нужную точку.
  • Для разных точек показывается разная информация.
  • Цвет и внешний вид маркеров соответствуют настройкам виджета.

Проверьте список точек

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

  1. Найдите список рядом с картой.
  2. Прокрутите его вниз.
  3. Убедитесь, что карточки не накладываются друг на друга.
  4. Нажмите на одну из карточек.
  5. Проверьте, что на карте выбрана соответствующая точка.
  6. Вернитесь к списку.
  7. Откройте ещё несколько карточек.

Проверьте поиск

Этот этап нужен только в том случае, если поиск включён в настройках виджета.

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

Если точка не находится

Проверьте:

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

Проверьте фильтры

Если в виджете настроены фильтры, проверьте каждый из них отдельно.

  1. Откройте первый фильтр.
  2. Выберите один вариант.
  3. Убедитесь, что список и маркеры на карте изменились.
  4. Проверьте, что остались только подходящие точки.
  5. Выберите другой вариант.
  6. Если разрешён множественный выбор, отметьте несколько вариантов.
  7. Сбросьте выбранные значения.
  8. Повторите проверку для остальных фильтров.
  9. Одновременно примените поиск и один из фильтров.
  10. Убедитесь, что результаты соответствуют обоим условиям.

Если фильтр не влияет на результаты

Проверьте связь между полем и фильтром:

  1. Откройте настройки полей в Mapfolio.
  2. Убедитесь, что нужное поле участвует в фильтрации.
  3. Откройте редактирование тестовой точки.
  4. Проверьте, заполнено ли это поле.
  5. Сохраните точку.
  6. Обновите страницу с виджетом.

Проверьте карточки точек

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

Проверьте в карточке:

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

Проверка фотографий

  1. Откройте точку с несколькими фотографиями.
  2. Убедитесь, что первая фотография используется как основная.
  3. Переключитесь на следующую фотографию.
  4. Проверьте все изображения.
  5. Убедитесь, что фотографии не растянуты и не обрезаны неправильно.
  6. Проверьте скорость их загрузки.

Проверка видео

  1. Откройте точку с добавленным видео.
  2. Нажмите на обложку видео.
  3. Убедитесь, что видео открывается.
  4. Проверьте, что открывается нужный ролик.
  5. Закройте видео и вернитесь к карточке.

Проверьте виджет на телефоне

Даже если виджет правильно выглядит на компьютере, на телефоне его необходимо проверить отдельно.

  1. Возьмите телефон.
  2. Откройте браузер.
  3. Перейдите на опубликованную страницу.
  4. Дождитесь загрузки виджета.
  5. Проведите пальцем по карте.
  6. Увеличьте карту двумя пальцами.
  7. Нажмите на маркер.
  8. Откройте карточку точки.
  9. Прокрутите текст карточки.
  10. Проверьте фотографии и видео.
  11. Воспользуйтесь поиском.
  12. Примените фильтр.
  13. Закройте карточку и фильтры.
  14. Поверните телефон горизонтально и снова проверьте страницу.
Проверка карточки точки на мобильном устройстве

На что обратить внимание на телефоне

  • Виджет помещается по ширине экрана.
  • У страницы нет лишней горизонтальной прокрутки.
  • Текст можно прочитать без увеличения.
  • Кнопки можно нажать пальцем.
  • Поиск и фильтры не выходят за границы экрана.
  • Карточку можно полностью прокрутить.
  • Карточка и фильтры закрываются.
  • Виджет не перекрывает меню сайта.
  • Остальные элементы страницы не перекрывают карту.

Проверьте виджет в другом браузере

Расширения браузера, сохранённые файлы и старые данные страницы иногда мешают правильной проверке. Поэтому откройте страницу ещё одним способом.

  1. Скопируйте адрес опубликованной страницы.
  2. Откройте другой браузер или режим инкогнито.
  3. Вставьте адрес страницы.
  4. Дождитесь загрузки карты.
  5. Проверьте открытие одной точки.
  6. Проверьте поиск и фильтры.
  7. Сравните результат с основным браузером.

Как обновить страницу без старых файлов

Иногда браузер продолжает показывать старую версию страницы даже после публикации изменений.

Сначала попробуйте обычное обновление. Если оно не помогло, выполните обновление без использования старых сохранённых файлов.

Устройство Действие
Windows Нажмите Ctrl + F5
macOS Нажмите Command + Shift + R
Телефон Закройте вкладку и откройте страницу заново

Распространённые проблемы

Что произошло Возможная причина Что проверить
На странице виден код Код вставлен в текстовый блок Используйте специальный HTML-блок
На месте виджета пусто Не загрузился файл виджета или была удалена часть кода Сравните вставленный код с кодом из Mapfolio
Карта сообщает об ошибке Проблема с API-ключом Яндекс Карт Проверьте ключ и разрешённые домены
Карта есть, но точек нет Нет опубликованных точек Проверьте состояние точек
Не находится отдельная точка Точка скрыта или не подходит под фильтр Сбросьте поиск и фильтры
Не работает фильтр Поле не участвует в фильтрации или не заполнено Проверьте настройки поля и точки
На телефоне обрезан виджет Неподходящие размеры блока на сайте Проверьте мобильную версию страницы
Изменения не появились Браузер или сайт показывает старую версию Обновите страницу без кеша
Виджет работает только у администратора Проверяется черновик или неопубликованная страница Откройте публичный адрес в режиме инкогнито

Проверка API-ключа и домена

Если область виджета появилась, но Яндекс Карты не загружаются, проверьте API-ключ.

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

Например, если посетители открывают карту по адресу https://example.ru/contacts, в настройках ключа должен быть разрешён домен example.ru.

Итоговая проверка

Перед тем как отправлять страницу посетителям, убедитесь, что:

  1. Страница опубликована.
  2. Виджет загружается по публичному адресу.
  3. Карта передвигается и меняет масштаб.
  4. Маркеры находятся в правильных местах.
  5. Нажатие на маркер открывает нужную точку.
  6. Список точек работает.
  7. Поиск находит нужные точки.
  8. Фильтры изменяют результаты.
  9. Карточки содержат правильную информацию.
  10. Фотографии и видео открываются.
  11. Виджет работает на телефоне.
  12. Виджет работает в другом браузере или режиме инкогнито.
  13. На странице нет текста с HTML-кодом.
  14. Остальные элементы сайта работают как раньше.