WHMCS - Admin Configuration Addon

The CentralNic Reseller Configuration Addon for WHMCS allows you to manage additional domain fields for TLDs in your WHMCS system. This addon is exclusively designed for CentralNic Reseller partners using our registrar module.

NOTE: We use 'CNR' as abbreviation for CentralNic Reseller in this article.

Prerequisites

Before using this addon, please ensure you have:

• An active CNR account
• WHMCS with admin access
• Our CNR Registrar Module (id "CNIC") properly working
• TLDs properly configured and assigned to the module

Features

• TLD-specific additional fields configuration
• DNS Zone management with Internal/External filtering
• DNS resource record viewing and zone deletion
• Bulk domain expiry date synchronization
• Contact Data Repair Tool for fixing registry handle issues
• Event List with filtering and detailed view capabilities
• Mobile-responsive interface
• Recent TLD history tracking
• Simple lookup interface
• Visibility toggle for additional domain fields

Installation & Access

1. Upload the cnicconfig addon module to your WHMCS /modules/addons/ directory (part of the bundle)
2. Activate the module in WHMCS admin area under Setup Addon Modules
3. Configure permissions for your admin roles
4. Access via the WHMCS > Addons > CNIC Configuration

Basic Configuration

1. Navigate to the "CentralNic Reseller - Configuration Addon" in your WHMCS admin area
2. Use the TLD lookup to select a TLD assigned to the "cnic" registrar
3. View and configure available fields for the selected TLD
4. Use the visibility toggle to enable or disable specific additional domain fields for the selected TLD
5. Save your changes to apply the updated configuration

⚠️ Important Guidelines

We DO NOT recommend pre-filling end-customer specific fields (e.g.):

Personal Information:

• Birth date
• City of birth
• Birth place
• Personal ID numbers
• Individual contact details

Company Information:

• Tax ID
• VAT ID
• Registration numbers
• Business licenses

Safe to pre-fill:

• Technical details
• Standard administrative information
• Common domain additional fields

Bulk Domain Expiry Date Sync

⚠️ Important: Use this feature only if instructed by your registrar's support team.

This feature synchronizes domain expiry dates between your registrar and WHMCS database. It only updates the expiry date information in WHMCS and does not affect the actual domain status at the registrar. This is particularly useful after migrating from an older module version that handled expiry dates differently.

The bulk sync works with multiple registrar modules including CNIC, ISPAPI, IBS, TPP, and Moniker.

How to Use

1. Go to Addons → CentralNic Reseller Configuration
2. Click the "Bulk Expiry Date Sync" tab
3. Choose your options:
   • Select registrars (CNIC, ISPAPI, IBS, TPP, Moniker)
   • Filter by domain extension or search for specific domains or TLD-specific domains.
4. Click "Start Sync"
5. Watch the progress bar and wait for completion

Tips

• Test with a few domains first before syncing many
• Run during quiet hours to avoid system slowdown
• Keep the page open while sync is running

DNS Zone Management

The DNS Zone Management feature allows you to view, filter, and manage all DNS zones in your CentralNic Reseller account directly from WHMCS. This tool helps you distinguish between internal zones (associated with domains) and external zones (standalone DNS zones).

How to Access

1. Navigate to Addons → CentralNic Reseller Configuration
2. Click the "DNS Zone Management" tab
3. Click "Start Zone Discovery" to fetch all DNS zones
4. Use the filter cards to view All, Internal, or External zones
5. Search and manage zones as needed

Key Features

• View all DNS zones with Internal/External categorization
• Interactive statistics cards for filtering
• Search and pagination for easy navigation
• View DNS records for any zone
• Delete external DNS zones (internal zones cannot be deleted)

⚠️ Important Notes

• Only external DNS zones can be deleted through this interface
• Internal zones are associated with WHMCS domains and protected from deletion
• Always verify external zones are not in use before deletion

Registrar Settings

The Registrar Settings section allows you to configure global renewal and transfer options for all domains managed under your CentralNic Reseller account.

Key Features

• Set how domains are renewed after internal transfers between accounts
• Choose account-wide renewal mode: Auto Renew, Auto Expire, or Auto Delete
• All changes apply globally to your reseller account and managed domains

⚠️ Important Notes

• Settings affect all domains managed under your reseller account
• Changes are applied instantly to your CentralNic Reseller registrar account
• Recommended: Use Auto Expire for best compatibility with WHMCS

Contact Data Repair Tool

This tool fixes domain contact data by replacing registry contact handles with proper contact objects. Use only when instructed by support or when contact handles don't start with P- or O- prefixes.

How to Use

1. Go to Addons → CentralNic Reseller Configuration
2. Click the "Contact Data Repair Tool" tab
3. Enter the domain name and click "Check Domain Contacts"
4. If registry handles are detected, click "Repair Domain Contacts"

⚠️ Important Notes

• Safe operation - does not affect domain functionality or DNS
• Works only with domains using the CNIC registrar module
• Contact support if repair shows partial success or fails

Event List

The Event List feature allows you to view and filter all events associated with your CentralNic Reseller account. This powerful tool helps you track domain activities, monitor account operations, and troubleshoot issues efficiently.

How to Access

1. Navigate to Addons → CentralNic Reseller Configuration
2. Click the "Event List" tab in the sidebar
3. Configure your filters (optional) to narrow down results
4. Click "Load Events" to view events
5. Use the "Details" button to view complete event information

Key Features

• Filter events by class, subclass, and object ID
• Configurable results per page (50, 100, 200)
• Detailed event information modal with complete data
• Responsive design for all screen sizes
• Real-time event loading with pagination

Available Filters

These are currently supported filters, but if you are missing something please contact us via support portal mentioned below in this article.

• Event Classes - A dropdown field (e.g. "All Classes", "Domain Transfer")
• Subclass - Optional free text (e.g., "DELETION_FAILED")
• Object ID - Optional free text (e.g., domain name)
• Per Page - Number of events to display per page

Usage Tips

• Use specific filters to quickly find relevant events
• Click "Details" to view complete event information and troubleshooting data
• Start with broader filters and refine as needed
• Use the Object ID filter to track specific domain activities

⚠️ Important Notes

• Events are displayed in chronological order (newest first)
• Event data is retrieved directly from your registrar account
• Use this tool to monitor and troubleshoot domain operations
• Contact support if you need help interpreting specific event data

Support

If you need assistance:

• Contact CNR Support
• Open a ticket via the Reseller Portal
• Check our support documentation

For additional support, please contact your CNR account manager or visit our support portal.