Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
davidkinnes committed May 15, 2024
1 parent fc2bf09 commit 5069e75
Show file tree
Hide file tree
Showing 4 changed files with 64 additions and 2 deletions.
64 changes: 63 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,63 @@
# WHMCS Module for the DNS Gateway domain platform.
# WHMCS Module for Gateway SRS Domain Reseller Platform

## Overview

This document guides you through integrating the Gateway SRS Module with your WHMCS system. Ensure you follow the prerequisites and steps for a smooth installation and configuration process.

## Prerequisites

- Access to the WHMCS admin area.
- An active Gateway account with API access. Register at [https://portal.dns.business](https://portal.dns.business), accept the terms and conditions, and then request live or OT&E server credentials.

**Note**: DNS Gateway provides both a production environment and a test environment known as OT&E. It is advisable to initially set up and test the WHMCS Registrar module in the OT&E environment before moving to the LIVE/PRODUCTION environment.

## Installation

### Step 1: Access Your WHMCS Directory
Navigate to your WHMCS directory:
```bash
cd /var/www/html/
```

### Step 2: Download the DNS Gateway Module
You can download the module using `wget` or `curl`:
```bash
sudo wget -O dns_gateway.zip https://github.com/DomainNameServices/Gateway-WHMCS/raw/master/dns_gateway.zip
```
Or:
```bash
sudo curl -Lo dns_gateway.zip https://github.com/DomainNameServices/Gateway-WHMCS/raw/master/dns_gateway.zip
```

### Step 3: Extract the Module
Extract the downloaded module:
```bash
sudo unzip -o dns_gateway.zip
```

## Configuration

To configure your WHMCS to use the DNS Gateway, follow these steps:

1. Log into your **WHMCS admin** panel.
2. Navigate to **Setup** menu > **Products/Services** > **Domain Registrars**.
3. Activate the DNS Gateway by clicking **Activate** next to it.
4. Enter your DNS Gateway EPP username and password. To test the module before going live, use your OT&E credentials and enable "OTE Testing Mode".
![Configuration Settings](configure.png)

### Optional Settings
If you encounter issues, enable **Debug Mode** and check the logs at **Utilities > Logs > Module Log**. This setting ensures that only errors returned by the module are logged.

After configuring the settings, click **Save Changes**.

## Deployment

The Gateway SRS module is now ready and will operate like any other built-in WHMCS registrar module. To set Gateway SRS as the automatic registrar and configure TLDs and services for your customers, go to **Setup** menu > **Products/Services** > **Domain Pricing** in your WHMCS admin panel.

For additional information, refer to the [WHMCS Domain Configuration Guide](http://docs.whmcs.com/Domains_Configuration).

For support, please contact [[email protected]](mailto:[email protected]).

### About Us

DNS Africa Ltd is a GBC1 private company incorporated in Mauritius, and Domain Name Services (Pty) Ltd is a private company based in South Africa. As part of the DNS.Business group, we are a team of domain industry experts dedicated to providing robust, adaptable, and cost-effective software solutions. Learn more about us at [www.dns.business](http://www.dns.business).
Binary file added configure.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified dns_gateway.zip
Binary file not shown.
2 changes: 1 addition & 1 deletion modules/registrars/dns_gateway/whmcs.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
"license": "proprietary",
"category": "registrar",
"description": {
"name": "DNS Gateway Version: v4.0.74",
"name": "Gateway SRS Version: v4.0.74",
"tagline": "Need an account? Sign up here: <href a='https:\/\/portal.dns.business\/api\/signup'>portal.dns.business\/api\/signup<\/a>",
"long": "Need an account? Sign up here: <href a='https:\/\/portal.dns.business\/api\/signup'>portal.dns.business\/api\/signup<\/a>",
"features": [
Expand Down

0 comments on commit 5069e75

Please sign in to comment.