InterNetX Domain Plugin for WHMCS is a registrar module which allows you to offer InterNetX domains to your customers. It also allows complex management of ordered domains from both client area and admin area.

Features and Compatibility

Admin Area Features

• Register Domain
• Transfer Domain IN
• Renew Domain
• Manage Contact Details
• Get EPP Authinfo Code
• Delete Domain
• Transfer Domain OUT (ACK/NACK)
• Domain Addon Management
• Premium Domain TIER Management
• Synchronization Of Expired/Transferred Domains
• Synchronization Of Expiry Dates
• Whois Provider Management using WhoisProxy Service

Client Area Features

• Renew Domain
• Enable Autorenew
• Get/Modify Name Servers
• Enable ID Protection (Whois Privacy Service)
• Manage Contacts Details
• DNS Management
• Email Forwarding
• Domain Forwarding
• Get EPP Authinfo Code
• Change Owner

Compatibility

Supports WHMCS V8 and later

Known Limitations

• automated .CA Registration not working (manual processing via AutoDNS Frontend is possible after the WHMCS order arrived)
• automated .HK Registration not working (manual processing via AutoDNS Frontend is possible after the WHMCS order arrived)

Installation and Configuration - JSON API Plugin  (PHP 8.1)

1. Please refer to INSTALL.md and/or UPGRADE.md within the supplied .ZIP-file.

All necessary steps are described in detail there.

2. After setup you have to configure your contact details. At the Setup > General Settings > Domains. Uncheck "Use Clients Details" checkbox, fill contact details and press Save Changes.

3. In order to proceed, go to the Setup > Product/Services > Domain Registrars, find InterNetX and press Activate next to it.

4. Now, enter your API access details, API URL and default name servers.

• The regular API URL is: https://api.autodns.com/v1
• The default name servers for AutoDNS are: a/b/c/d.ns14.net
• if you are using virtual name servers from InterNetX please update /modules/registrars/InterNetX/app/Helpers/Config.php  and change the "ns14.net" entries  to your own virtual name server domain.

Installation and Configuration - XML API Plugin (PHP 7.4)

In this section we will show you how to properly install and configure your InterNetX Domain Plugin for WHMCS.

1. Download the WHMCS Domain Plugin in the WHMCS Marketplace or here on our Help Center page.

2. Unpack the zip-file and upload the files to your server into your root WHMCS directory.

3. Duplicate dist.additionalfields.php file located at the /resources/domains/ directory to additionalfields.php and add code below at the end of the file:

/**
 * InterNetX REGISTRAR ADDITIONAL PARAMETERS
 * This file will load proper additional parameters for InterNetX registrar domain module
 */
$filename = ROOTDIR . DIRECTORY_SEPARATOR . 'resources' . DIRECTORY_SEPARATOR . 'domains' . DIRECTORY_SEPARATOR .'InterNetX_additionaldomainfields.php';
if (file_exists($filename)) {
    include($filename);
} else {
    die('Can not load InterNetX_additionaldomainfields.php File error: resources/domains/dist.additionalfields.php');
}

(This will add domain extensions for the domain plugin and will overwrite some of the standard WHMCS extensions that are not required.)

4. Now, you have to set up your contact details. At the Setup > General Settings > Domains. Uncheck "Use Clients Details" checkbox, fill contact details and press Save Changes.

5. In order to proceed, go to the Setup > Product/Services > Domain Registrars, find InterNetX and press Activate next to it.

6. Now, enter your API access details, API URL and default name servers.

• The regular API URL is: https://gateway.autodns.com/
• The default name servers for AutoDNS are: a/b/c/d.ns14.net
• if you are using virtual name servers from InterNetX please update /modules/registars/InterNetX/classes/class.InternetX_API.php and change the "ns14.net" entries  to your own virtual name server domain.

Addditional Registrar Settings

• Context: The default context for AutoDNS is 4. If you are using Personal AutoDNS please use your exclusive URL and the context number you have received.
• Reply To: Defines where the replies of the AutoDNS orders will be sent by email. These emails are required to track orders with errors. You can select from the email addresses of your administrator accounts.
• MX Record: Here you can set the default subdomain name for the MX Record. The MX will point to the same IP that is set in "IP Address". We suggest to use the name webmail .
• IP Address:  The IP address where the DNS Records that are created during domain registration will point. The IP also defines the MX Record subdomain name supplied above.
• Auto Delete: Do not activate this option unless you are using Prepayment/AutoDelete with InterNetX! Else the feature will result in double renewals and costs for domains!
• Admin Contact: The OwnerC will also be AdminC in the public Whois. Else the Client will only be OwnerC.

→ Afterwards, press Save Changes button.

It is also possible to use the AutoDNS Demo System for testing and implementation, if you need access to the AutoDNS Demo System (Sandbox) please contact sales@internetx.com. The sandbox name servers are ns1/ns2.demo.autodns.com
To use the AutoDNS Demo System please activate "Test Mode".

Congratulations! You have just finished the initial installation and configuration of the module.

Management

TLD Management

Your clients will be able to order domains as soon as you set up TLDS for your desired extensions.

1. In order to start, go to the Setup > Products/Services > Domain Pricing.
2. Fill TLD, choose additional features like DNS Management and select InterNetX from Auto Registration dropdown menu if you wish a fully automated registration of your client's orders.
Press Save Changes to add this TLD to your system.

Now, it is time to set up pricing. To do so, press Open Pricing in Pricing column. New window will open, please make sure your browser does not block PopUps.

3. Here you can set up pricing for registering, transferring and renewing domains using created TLD.
    Press Save Changes to finish.

4. Setup of AutoDNS User Profile: In addition you have to set up your AutoDNS User Profile with additional information once.

Go to "User Management" > "User Configuration" > "User Profile"
The tabs "IRTP", "Verification" and "TMCH" should show the Reseller's Company Name and Support email address.

After configuring the TLD and the AutoDNS User Profile you can start ordering the first domain.
Go to Client Area and chose Domains > Register a New Domain:

Next to basic actions

Admin area

The InterNetX Domain Plugin for WHMCS allows you to perform various actions on your client’s domains.

In addition to basic actions (Register, Transfer, Renew and Modify Contact Details) you are able to carry out functions such as Get EEP Authinfo Code, Request Delete, Transfer OUT ACK and Transfer Out NACK.

Client area

Your client can manage all relevant aspects of their domain. In this section we will show the available features. On the domain’s details page your client can view basic details of his domain and order it's renewal.

In the Auto Renew tab you are able to enable/disable the Auto Renew functionality.

You can also change the domain’s name servers, this can be done in the Nameservers tab. 

At the Addons tab you can manage addons ordered along with a domain.

In the Addons tab you can manage addons ordered along with a domain.

• ID Protection allows you to activate and deactivate the Whois Privacy Service.
• DNS Host Record Management allows you to manage the DNS Entries for the domain.
• Email Forwarding allows you to redirect email addresses to other external email addresses.

The InterNetX Domain Plugin for WHMCS also allows you to modify the whois contact details. The only limitation here is you cannot change the first and last name.

SchlundTech allows you to set up email forwarding if you have.

DNS Management addon enables you to manage the DNS records of your domain.

InterNetX allows to set up email forwarding if you have ordered the InterNetX Redirector service. Please contact sales@internetx.com to get the Redirector service activated.

You can easily receive your domain’s EPP Authinfo Code, simply go to the Management Tool > Get EPP Code.

Additionally, you can easily set up domain forwarding. Go to Management Tools > Manage Domain Forwarding:
InterNetX allows to set up domain forwarding if you have ordered the InterNetX Redirector service. Please contact sales@internetx.com to get the Redirector service activated.

You can also change the domain owner.

WhoisProxy

The InterNetX WhoisProxy acts as a singular intermediatery which accesses the various whois servers of the registries, thereby saving users the effort of sending whois queries to every whois server.

Whoisproxy integration into WHMCS

How to change the Whois Server in WHMCS:
http://docs.whmcs.com/WHOIS_Servers

Example TLD List

The whois server list is located at: /resources/domains/whois.json

You can edit the whois file according to your needs and overwrite the regular WHMCS whois configuration per TLD.

Example list of TLDs and Whois Servers:

[
  {
     "extensions": ".com,.net,.org,.de,.cat,.ca,.travel",
     "uri": "socket://whois.autodns3.de",
     "available": "free"
  },
  {
     "extensions": ".bike",
     "uri": "socket://whois.autodns3.de",
     "available": "free"
  },
  {
     "extensions": ".at",
     "uri": "socket://whois.autodns3.de",
     "available": "free"
  }
]

A complete list of all available WhoisProxy TLDs can be retrieved using the following command:
whois -h whois.autodns3.de tld

Premium Domains

Additional Feature For InterNetX WHMCS Domain Registrar: Premium Domains

The Premium Domains module adds premium domain functionality inside the existing InterNetX WHMCS Domain Registrar module.

Installation instructions

• Go to Admin Area of your WHMCS.
• Go to Setup > Addon Modules and activate "InterNetX Premium Domains Addon".
• There is no need to configure the addon, just click "Activate" button.
• Go to Setup > Products/Services > Domain Pricing, and change your Lookup Provider to "InterNetX" by clicking on "Change" button in "Lookup Provider" section:

Then select "InterNetX" from all lookup providers list:

Please make sure that the premium domain button is set to "ON":

window to allow user enter

Functionalities:

The Premium Domains module allows the user to set his own price for each premium domain class. To do this you have to:
Click "Configure" button in the premium domains section:

The module will change the "Configure Premium Domains Levels" window to allow the user to enter and save their premium domains classes.
Enter premium domain class names inside text fields and save them into database by clicking "Save" button:

Premium domian classes can also be deleted from the database by clicking on "Delete" button:

After adding a premium domain class to the database, the user has the possibility to configure it's pricing by clicking on the "Configure" button:

In the next window the user can set the Register, Transfer, and Renewal prices for selected price class, and save it into the database by clicking the "Save" button:

From now on if a premium domain will be detected by the WHMCS Domain Registrar the price will be taken from the database and set in the "Client Area" during the domain registration process.

Additional information about Custom Client Area Forms and Custom Localistation:

Custom Forms in Client Area

• Email Forwarding → /modules/registrars/InterNetX/domainForwarding.tpl
• Domain Redirect → /modules/registrars/InterNetX/domainForwarding.tpl
• Owner Change → /modules/registrars/InterNetX/changeOwner.tpl

Changes to Design and Localisation can be done here, but Localisation should be done by using Language Tags.

Custom Localisation via Language Tags

Your will find language Tags all over WHMCS, we are using separated "internetx" Language Tags to make it visible who made the localisation

e.g.

$LANG.internetxchangeowner

$LANG.internetxchangeownerdesc

$LANG.clientareasavechanges

$LANG.clientareacancel

Language Tags beginning with "$LANG.internetx" are located in

/lang/overrides/german.php

/lang/overrides/english.php

These individual Language Tags can be changed as needed.

Other Language Tags like "$LANG.clientareacancel" without the "internetx" are WHMCS Language Tags.

They can also be overwritten by inserting $LANG.clientareacancel in /lang/overrides/xxxxx.php

e.g. if you do not like the Button "Cancel" in your Client Area forms, because the button does not cancel but does undo, you simply can override $LANG.clientareacancel from "Cancel" to "Undo Changes" in /lang/overrides/english.php

Localisation of Domain Extensions

Some TLDs require additional data, e.g. a VAT Number or a Passport number.

These Extensions are managed in a separate file and are not translated on purpose:

/resources/domains/InterNetX_additionaldomainfields.php

If you want to translate these extension names you can either create own Language Tags or change it directly in InterNetX_additionaldomainfields.php if you are only offering one single language for your customers.

e.g.

$additionaldomainfields[".ru"][] = array("Name" => "ID Card Number".......

After the initial " array("Name" => " is the localisation, you can change "ID Card Number" to "ID Number" as you like it.

Last updated 03-07-2023