Быстрый старт

1. Настройки

В Система → Настройки системы → geolocation2 задайте:

Ключ	Рекомендация для старта
`geolocation2_detect_method`	`sxgeo` — определение по IP при первом визите
`geolocation2_debug`	`0` на проде, `1` при отладке

В <head> или перед </body> подключите инициализацию (CSS/JS и Bootstrap 5, если ещё нет на странице):

fenommodx

fenom

{'!GeoLocation2Initialize' | snippet}

modx

[[!GeoLocation2Initialize]]

Параметры loadBootstrap, loadCss, loadJs — в GeoLocation2Initialize.

В шапке или футере:

fenommodx

fenom

{'!GeoLocation2Current' | snippet : [
  'tpl' => 'tpl.GeoLocation2.current'
]}
{'!GeoLocation2Modal' | snippet}

modx

[[!GeoLocation2Current? &tpl=`tpl.GeoLocation2.current`]]
[[!GeoLocation2Modal]]

Чанк tpl.GeoLocation2.current поставляется с пакетом. В нём кнопка с data-gl2-open="1" открывает модалку.

Откройте сайт в режиме инкогнито.
Должна появиться модалка с предложением города (SxGeo) или списком городов.
После выбора город сохраняется в $_SESSION['gl2'].
Запрос GET /assets/components/geolocation2/action.php?action=state (с заголовком X-Requested-With) возвращает JSON с state, confirmed и полями сессии.

Если заполнили gl_data в менеджере:

fenommodx

fenom

{'!GeoLocation2Data' | snippet : [
  'forCurrent' => 1,
  'tpl' => 'tpl.GeoLocation2.data.current'
]}

modx

[[!GeoLocation2Data? &forCurrent=`1` &tpl=`tpl.GeoLocation2.data.current`]]