The GeoIP Order Blocking addon module for WHMCS requires PHP 5.6 or higher, WHMCS 7.x, OpenSSL (or compatible SSL library) with TLS 1.1 or higher, Ioncube Loader v10.1.x or higher, and cURL with TLS 1.1+ support. The geoip extension is optional. Specific lookup plugins add further dependencies: Geoplugin and Freegeoip need cURL, while Maxmind requires maintaining a local database. These have been tested and validated by our developers. The module may operate under other conditions but support is provided only for these setups. Your environment must also fully satisfy the official WHMCS system requirements.

A clear understanding of WHMCS operations—including uploading, installing, and configuring addons—is a prerequisite. These requirements ensure reliable IP-based geographic lookups during order processing, preventing failures that could allow unwanted orders or disrupt legitimate ones. We provide a dedicated PHP test script to scan your installation for missing components.

#Why These Requirements Matter

GeoIP-based order blocking depends on accurate resolution of visitor IP addresses to countries or regions. Outdated PHP or missing extensions can break this process entirely. TLS 1.1+ support in OpenSSL and cURL is mandatory for secure HTTPS communication with external lookup services. Ioncube Loader is required because the module is encoded for distribution. Running on untested versions or builds (such as WHMCS alphas, betas, or RCs) can introduce instability or incompatibility that our team cannot troubleshoot.

#Core System Requirements

  • Clear understanding of using WHMCS as well as uploading, installing and configuring addons and gateways
  • PHP 5.6 or higher
  • WHMCS 7.x (we do not support alpha, beta or release candidate builds)
  • OpenSSL (or any SSL library) with TLS 1.1+ support
  • Ioncube loader v10.1.x or higher

#PHP Extension Requirements

  • cURL w/ TLS 1.1+ support
  • geoip (optional)

#Lookup Plugin Requirements

The module supports multiple GeoIP lookup providers. Each has its own dependencies that must be satisfied:

  • Geoplugin lookups requires cURL support
  • Freegeoip lookups requires cURL support
  • Maxmind lookups require you to maintain the database

#Testing Your Environment

We offer a PHP script that will quickly and easily check your PHP and WHMCS installation for any missing requirements. The tool can be downloaded here – https://billing.aspnix.com/dl.php?type=d&id=138. Upload it to the root of your WHMCS installation, then access the file directly in a browser. The output lists passed and failed checks with specific guidance on what needs attention.

Manual verification can supplement the test script. Use these commands on your server to confirm basic components.

bash 
php -v
php -m | grep -E 'curl|geoip|ionCube'
php -i | grep OpenSSL

Common issues encountered during setup include cURL compiled without current TLS support (causing remote lookup failures), an outdated or missing Ioncube Loader, and neglected Maxmind database updates that return stale or empty results. Confirm that your WHMCS cron and PHP CLI use the same php.ini as your web server.

Once your server satisfies all listed requirements, install the addon following the instructions packaged with the download. Test order blocking rules thoroughly in a staging environment before going live. Consult the WHMCS system requirements at https://docs.whmcs.com/System_Requirements for the baseline platform needs.