WithoutDNS For WHMCS

About WithoutDNS For WHMCS

WithoutDNS For WHMCS is an addon module that integrates the WithoutDNS platform with your WHMCS. It simplifies website testing and migration by generating a temporary URL that points your domain to a selected server IP via a proxy. This lets you preview and test your site on the new server without editing your local hosts file.

• Main Functionality:

✔ Allow Clients To Generate Temporary URLs To View Their Websites Without Configured DNS

✔ Use WithoutDNS Free Plan Without Account:

✔ All Generated URLs Are Valid For 15 Minutes

✔ URLs Are Branded With WithoutDNS Service

✔ Daily Limit Of 3 URLs Shared Across All Clients

✔ Use WithoutDNS Paid Pro Plans To Access All Functionalities Without Free Plan Limits

• Admin Area:

✔ Configure API Connection With Pro Plan:

✔ API Token

✔ Temporary Domain

✔ Test Connection

✔ Set Up Addon Module Configuration:

✔ Select Menu Location In Client Area:

✔ Main Menu

✔ "My Domain" Page

✔ "My Services" Page

✔ Enable WithoutDNS For:

✔ All Clients

✔ Clients With Active Products

✔ Clients With Specific Products

✔ Generated URL Limit Type:

✔ Unlimited

✔ Limit Per Client

✔ Limit Per Product

✔ Set URL Limit Value

✔ Set URL Expiration Time In Hours

✔ View Temporary Website URLs:

✔ View Related Client And Item

✔ View Domain/URL And IP Address

✔ View/Copy Temporary URL

✔ View Expiration Date

✔ View/Manage Module Logs

✔ Access WithoutDNS Management Account

• Client Area:

✔ Create Temporary Website URLs:

✔ Provide URL For Already Owned Service

✔ Provide Target Server IP Address

✔ View Website Original URL/Domain

✔ View Website IP Address

✔ View Website Temporary URL

✔ View Temporary URL Expiration Date

✔ Delete Website Temporary URL

• General Info:

✔ Multi-Language Support

✔ Supports PHP 8.3 Back To PHP 8.1

✔ Supports WHMCS Themes "Twenty-One" And "Lagom WHMCS Client Theme"

✔ Supports WHMCS V8.13 Back To WHMCS V8.9

✔ Requires ionCube Loader V14 Or Later

Installation and Synchronization

We have prepared a short but comprehensive tutorial that will show you how to successfully install WithoutDNS For WHMCS module and synchronize your WHMCS with WithoutDNS platform. Although the process is extremely easy and intuitive, go over the below guide to assure it is fast, smooth and trouble-free.

Install The Addon

1. First of all, you need the package, therefore log in to our client area and download the module.

2. Open the FTP Client, log into the server with WHMCS installed. Then, open the main catalogue and upload the folder with files you have extracted previously. The content of your package should look like on the below screen:

Activate The Addon

3. Now, you have to activate the addon module in your WHMCS system. Please log in to your WHMCS admin area. Once there, navigate to the 'System Settings' section and select 'Addon Modules'. Find 'WithoutDNS' on the list of addons and click the 'Activate' button.

4. After the module has been activated, you will need to enable access to your Admin Role. To do that, click on 'Configure', select the admin roles that should have access to the module, and save changes.

Your module has just been successfully installed and activated!

Sign Up With WithoutDNS Account

Creating an account and purchasing a Pro plan is entirely optional. The addon works without a WithoutDNS account, though certain limitations will apply. If you want to use the addon with full functionality and no restrictions, please follow the guide below to set up the API connection. It is possible to connect your WHMCS to a WithoutDNS account directly from the addon interface. Simply, press the Manage Account button in the addon menu.

You will be redirected to the WithoutDNS login page. Log in with your existing account, or if you're a new user, choose a plan that suits your needs and sign up.

Once logged in, navigate to the API Configuration section, which you can find in the dropdown menu under your account name in the top-right corner.

Click the "Generate Token" button to create a new API token.

Copy the generated API token and store it securely. You’ll need it shortly to complete the connection setup in WHMCS.

Return to the WHMCS admin area to complete the addon configuration and establish a connection between your WHMCS and your WithoutDNS account if needed.

WithoutDNS Addon Management

Once the addon is installed and activated, you can proceed with its configuration to begin using it fully. Read through the sections below to learn about all the possibilities of the WithoutDNS For WHMCS module. You will find out how to adjust the module to your business's attributes.

API Configuration

Integrating the API is optional, but without it, certain limitations will apply: Links generated without the API will only remain active for 15 minutes. URLs will include WithoutDNS branding. A daily limit of 3 links applies, and this quota is shared across all clients. To gain unrestricted access and additional features, you will need to enter your generated API credentials as described in the previous steps. If you do not have an API key yet, you can get a plan here.

Paste the API token you generated during the setup process into the API Token field. This is required to authenticate your WHMCS system with the WithoutDNS API. Click "Test Connection" to confirm that the API token is working. If the connection is successful, save your changes.

Once connected, the Temporary Domain field will appear. Select one of the available proxy domains linked to your account. Choose between an EU or US-based domain, which will be used for generating temporary URLs.

That is all, you may now use the module without restrictions.

Addon Configuration

Use the settings below to customize how the WithoutDNS addon behaves within your WHMCS installation: Menu Location - Choose where the Site Previes button will appear in the client area navigation: Main Menu - Appears as a new menu item after "Open Ticket" (default). Services - Displays under "My Services" section. Domains - Displays under "My Domains" section. Enable WithoutDNS for - Define which clients are granted access to the addon functionality: All Clients - Enabled for every client (default). Clients with an active product - Only available to clients with at least one active service. Clienta with specific products - Only available to clients with selected products defined in the Required Products dropdown. Generated URL Limit Type - Set how limits on URL generation should be enforced: Unlimited - No restrictions on how many URLs a client can generate (default). Limit Per Client - Each client is given an individual limit. Limit per product - The limit is applied based on the specific product(s) the client owns. URL Expiration Time (hours) - Defines how long generated URLs remain active. The default is 48 hours, but this can be customized. Once your configuration is complete, click Submit to save your settings.

Websites

The Sites section in the admin area displays all temporary sites created by clients. This list includes all fields visible to clients, along with additional administrative details: Client - Displays the username of the client who created the site. Related Item - Product or service associated with the temporary site Domain/URL - The domain linked to the temporary URL. IP Address - Server IP assigned to the site. Temporary URL – An access link, valid for a limited time. Expires At – Time when the temporary URL will expire. Note: Expired sites are automatically removed from the system during the daily WHMCS cron job, no additional cron setup is required. If a client's account is deleted from WHMCS, all of their associated sites will also be removed.

Logs

The module keeps a detailed log of all client activity within the module. This includes actions such as URL generation, setting changes, and access events. For more information about logging functionality, refer to the ModulesGarden Logs wiki article.

Client Area

The Site Previews section, where clients can manage their temporary access links, is available in one of three locations depending on the addon configuration: Main Menu - Displays as a new item after "Open Ticket" (default, as presented on the screen below). Services - Listed under the "My Services" section. Domains - Listed within the "My Domains" section. Locate the appropriate menu item based on your setup and click it to access the 'Site Previews'.

This section allows you to create temporary URLs to preview your website, even if DNS records are not yet set up. Press Create Site button to generate a new, temporary link.

Fill in the following fields: Site URL/Domain - Enter the full URL or just the domain name of the site you want to preview. Service - Select a service from the dropdown to automatically fetch the associated IP address. If the service has a dedicated IP, it will be used. Select "No Service" to manually specify an IP address. Note that this option is available only if Enable WithoutDNS for is set to "All Clients" in the addon configuration. Target Server IP Address - This field appears if you select "No Service" in the Service field. Enter the IP address of the server hosting the website for the entered Site URL/Domain. Leave it empty to preview the site on the current server. Press Confirm to generate the temporary URL.

Once created, your temporary site will appear in the list below. The following details are displayed: Domain/URL - The domain linked to the temporary URL. IP Address - The IP address associated with the selected service. Temporary URL - The active access link. Click the copy icon for quick sharing. Expires At - The expiration time of the generated link. Actions - Option to manually delete a URL (available only on paid plans). Note: Free URLs cannot be deleted manually. They expire automatically after 15 minutes.

Tips

1. To unlock the full potential of the WithoutDNS For WHMCS addon, consider configuring the API connection with your WithoutDNS Pro account. While the addon functions without an account, setting up the API removes limitations such as the 15-minute URL lifespan and the daily limit of three URLs.

Update Instructions

An essential guidance through the process of updating the module is offered here. Ensure successful completion of the module update by carefully following each step, thereby preventing data loss or any unforeseen issues. Additionally, you will find a current list of supplementary actions necessary for a smooth update process there.

Common Problems

1. When you encounter problems with connection, check whether your SELinux or firewall does not block ports.