Joomla Plugin
Joomla plugin for API access, settings and helper lookup methods.
Overview
The plugin allows endpoint/key management and exposes methods to resolve GEO/IP risk profile during request lifecycle or on-demand for custom IP.
Setup Guide
- Download ZIP archive.
- Install plugin in Joomla.
- Configure endpoint and API key.
- Call helper methods in integration points.
Implementation Notes
- Install and activate the package in your CMS.
- Set API endpoint and API key in module settings.
- Validate client IP detection and User-Agent forwarding.
- Call lookup before auth/checkout/risk decisions.
- Add fallback handling for timeout/429/5xx responses.
Recommended flow: GEO/IP context first, business rules second.
Minimum CMS Version
Joomla 4.4+ / 5.x (PHP 8.1+)
README: implementation details
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);