IPFlow for WHMCS

Localization, FAQ & Troubleshooting

This guide explains how to configure multi-language localization, customize translation strings, handle Right-to-Left (RTL) layouts, and troubleshoot common operational questions in IPFlow.

Licensing System & 72-Hour Offline Grace Period

IPFlow connects to the RoostKit licensing engine to validate your License Key upon activation and automatically caches validation status locally for 24 hours:

  • Instant Local Validation: Your WHMCS server does not need to make an external request for every page load or customer checkout.
  • 72-Hour Offline Grace Period: If your server temporarily loses Internet access or the licensing server is unreachable during network maintenance, IPFlow provides a built-in 72-hour grace period during which all automated customer provisioning and IP assignments continue working without interruption.
  • Re-validating Your License: Go to Settings & Licensing and click Re-Validate License at any time to refresh your license metrics.

Multi-Language & RTL Support

IPFlow includes 21 native translations out-of-the-box and automatically adapts to each administrator’s or client’s preferred language in WHMCS.

21 Supported Languages:

  • English (Master Dictionary)
  • Persian / Farsi (فارسی) (Native RTL)
  • Arabic (العربية) (Native RTL)
  • Hebrew (עברית) (Native RTL)
  • Spanish, French, German, Italian, Portuguese (BR & PT), Russian, Turkish, Dutch, Swedish, Norwegian, Danish, Ukrainian, Hungarian, Czech, Croatian, and Catalan.

Automatic Right-to-Left (RTL) Layout

When an admin or client switches to an RTL language (such as Farsi, Arabic, or Hebrew), IPFlow automatically mirrors its tables, navigation tabs, modal popups, and badges for a native reading experience.

Customizing Translations (Language Overrides)

To change any wording, button label, or message in IPFlow without having your modifications overwritten during future updates:

  1. In your WHMCS installation, navigate to:
    text
    modules/addons/ipflow/lang/
  2. Create a folder named overrides/ if it does not already exist:
    text
    modules/addons/ipflow/lang/overrides/
  3. Inside overrides/, create a PHP file matching your language name (e.g. english.php or farsi.php).
  4. Define only the specific phrases you wish to customize:
<?php
// modules/addons/ipflow/lang/overrides/english.php

$_ADDONLANG['subnets_title'] = 'Enterprise Network Pools';
$_ADDONLANG['ips_title'] = 'Fleet IP Directory';
$_ADDONLANG['btn_add_subnet'] = '+ Provision New Subnet';

IPFlow will load your custom strings while keeping all other standard translations intact.

Frequently Asked Questions & Troubleshooting

1. “License Invalid or Expired” Warning Banner

  • Symptom: A banner states that your license key is invalid or expired.
  • Solution:
  • Navigate to Addons > IPFlow > Settings & Licensing.
  • Verify that your license key is entered correctly with no leading or trailing spaces.
  • Click Re-Validate License.
  • Ensure your server firewall allows outbound HTTPS traffic on port 443 to roostkit.site.

2. “No active IP pools with available free addresses found”

  • Symptom: Customer ordering a VPS or hosting service encounters a provisioning error.
  • Solution:
  • Go to Addons > IPFlow > Subnets & Pools and verify that your subnet is set to Active status.
  • Check Addons > IPFlow > Pool Mappings to confirm that the ordered WHMCS product or product group is mapped to a pool that still has free IPs remaining.
  • Add a new subnet pool or expand your capacity.

3. “Terminated service IPs are not being freed automatically”

  • Symptom: An account was cancelled or terminated, but its IP is still listed as Assigned.
  • Solution:
  • Verify that your WHMCS Daily Cron job is running regularly under Utilities > System > Automation Status.
  • Click Reconcile Now on the IPFlow Dashboard to perform an immediate manual sweep.
  • Check the Audit Logs tab to confirm whether the service status has updated.

4. Inspecting Debug Traces in WHMCS Module Log

If you encounter an unexpected issue during order checkout:
1. Navigate to WHMCS Admin > Utilities > Logs > Module Log.
2. Click Enable Debug Logging.
3. Attempt the action again.
4. Filter by module name: ipflow to view clean, sanitized diagnostic logs.

Contacting Support & Feature Requests

Need assistance, custom feature integrations, or have a question?