Модуль Drupal
Модуль Drupal с настраиваемым API-клиентом и сервисами для разработчика.
Описание
Настройки модуля хранят endpoint и ключ, а сервис-методы позволяют получать GEO/IP профиль текущего посетителя или любого IP.
Инструкция
- Скачайте ZIP модуля.
- Установите модуль в Drupal.
- Заполните API URL и ключ в форме настроек.
- Используйте сервис в кастомном коде.
Практические рекомендации
- Установите и активируйте пакет в вашей CMS.
- Укажите API endpoint и API-ключ в настройках модуля.
- Проверьте определение IP и корректную передачу User-Agent.
- Вызывайте lookup до авторизации, checkout и risk-решений.
- Добавьте fallback-обработку для timeout/429/5xx ответов API.
Рекомендуемый поток: сначала GEO/IP-контекст, затем бизнес-правила.
Минимальная версия CMS
Drupal 9.4+ / 10.x (PHP 8.1+)
README: детали применения
Drupal module quick flow:
1) Copy portcore_geoip -> web/modules/custom/
2) Enable module: drush en portcore_geoip
3) Configure /admin/config/services/portcore-geoip
Lookup:
$geo = portcore_geoip_lookup('2001:bc8:1da0:1e:da5e:d3ff:fe6f:dc87');
Optional context:
$geo = portcore_geoip_lookup('8.8.8.8', ['user_id' => 'crm_501', 'user_agent' => 'Custom-UA/1.0']);
Summary array:
$summary = portcore_geoip_summary_array($geo, FALSE);