Плагин Joomla
Плагин Joomla для доступа к API, настроек и helper-методов проверки IP.
Описание
Плагин позволяет управлять endpoint/ключом и использовать методы получения GEO/IP профиля в жизненном цикле запроса и для произвольных IP.
Инструкция
- Скачайте ZIP-архив.
- Установите плагин в Joomla.
- Укажите endpoint и API-ключ.
- Вызывайте helper-методы в точках интеграции.
Практические рекомендации
- Установите и активируйте пакет в вашей CMS.
- Укажите API endpoint и API-ключ в настройках модуля.
- Проверьте определение IP и корректную передачу User-Agent.
- Вызывайте lookup до авторизации, checkout и risk-решений.
- Добавьте fallback-обработку для timeout/429/5xx ответов API.
Рекомендуемый поток: сначала GEO/IP-контекст, затем бизнес-правила.
Минимальная версия CMS
Joomla 4.4+ / 5.x (PHP 8.1+)
README: детали применения
Joomla plugin quick flow:
1) Copy plg_system_portcoregeoip -> plugins/system/portcoregeoip/
2) Install + enable "System - Portcore GEOIP Integration"
3) Set API Endpoint URL + API Key in plugin params
Lookup:
$geo = PortcoreGeoipHelper::getByIp('2001:bc8:1da0:1e:da5e:d3ff:fe6f:dc87');
Optional context:
$geo = PortcoreGeoipHelper::getByIp('8.8.8.8', ['user_id' => 'crm_501', 'user_agent' => 'Custom-UA/1.0']);
Summary:
echo PortcoreGeoipHelper::renderSummary($geo);