內容簡介
**總結：**
Domain Search for WHMCS 是一款輕量級的外掛，可以在您的 WordPress 網站上為域名搜索添加一個簡單的表單，並將用戶重定向到 WHMCS 安裝以進行域名註冊。只需在設置中添加 WHMCS URL，將短代碼放在希望出現搜索表單的位置，外掛將處理將用戶重定向到適當的 WHMCS 域名註冊頁面。
**問題與答案：**
- 這個外掛的特點有哪些？
- 乾淨且響應靈敏的域名搜索表單
- 輕鬆使用短代碼進行集成
- 可定制的占位符文本
- 支持自定義 CSS
- 直接集成 WHMCS 域名註冊
- 針對移動設備友好的設計
- 如何使用這個外掛？
- 只需在希望出現域名搜索表單的任何帖子或頁面中添加 [whmcs_domain_search] 短代碼。
- 如何進行配置？
- 前往「設置 > Domain Search for WHMCS」
- 輸入您的 WHMCS URL
- 自定義搜索占位符文本
- 如有需要，添加任何自定義 CSS
- 儲存您的更改
- 如何獲得支援或提出功能要求？
- 請訪問外掛的 WordPress.org 支援論壇。
外掛標籤
開發者團隊
原文外掛簡介
Domain Search for WHMCS is a lightweight WordPress plugin that adds a polished domain search form to your site and hands the visitor off to your existing WHMCS billing portal to complete registration.
It is purpose-built for hosting providers, domain resellers, ICANN registrars, and white-label hosting brands who already use WHMCS as their billing platform.
TL;DR
Install, activate, paste [domain_search_for_whmcs] on any page.
No JavaScript on the front-end. No external requests. No tracking.
Create unlimited branded shortcodes pointing at different WHMCS installs.
Modern admin dashboard with built-in support center.
Translation-ready, multisite-friendly, GDPR-friendly.
Why this plugin
Most WHMCS integrations are heavy or hard-coded. This one is the opposite: a single, dependency-free shortcode that drops into any layout. It does one thing and does it cleanly.
No external API calls — submits directly to your own WHMCS install.
No JavaScript on the public site (admin-only JS for the dashboard tabs).
Works with classic themes, block themes, and every major page builder.
Visitor queries never touch a third-party server.
Key features
Drop-in shortcode — [domain_search_for_whmcs] works in posts, pages, widgets, FSE template parts, page-builder shortcode blocks, or via do_shortcode() in PHP.
Unlimited custom shortcodes — create branded forms each pointing at a different WHMCS install with its own placeholder. Reference them as [domain_search_for_whmcs id="sc_xxxxx"].
Modern admin dashboard — tabbed UI, click-to-copy shortcodes, an “At a Glance” overview (custom shortcode count, active host, HTTPS status), and a built-in Support tab.
Built for speed — one ~1.7 KB CSS file. No JavaScript, no jQuery, no Ajax, no remote assets, no tracking pixels.
Theme-agnostic styling — six stable, well-named CSS classes you can target from any theme or page builder.
Developer extensibility — five filter hooks let plugins and themes change behavior without forking. See Developer Filters below.
Secure by default — nonce verification, capability checks, sanitized I/O, properly escaped output.
Translation-ready — every string wrapped in the domain-search-for-whmcs text domain.
Privacy-friendly — no data collection, no cookies, no remote services. See Privacy below.
Perfect for
Hosting providers running WHMCS as their billing system.
Domain resellers with multiple storefronts (TLD niches, geographic markets, white-label brands).
ICANN registrars offering retail domain sales through WordPress.
Agencies building landing pages for hosting clients.
How it works
The shortcode renders a clean HTML form on your page.
When a visitor submits it, the browser navigates (in a new tab) to:
https://your-whmcs.com/cart.php?a=add&domain=register&query=THE-DOMAIN
WHMCS handles availability, pricing, TLDs, cart, and checkout — exactly as it would for any other entry point.
You do not need to expose any WHMCS API credentials in WordPress. The plugin never calls WHMCS APIs; it just hands off the visitor.
Roadmap
Optional Gutenberg block wrapper.
Optional Elementor and Bricks widgets.
Optional inline Ajax availability check (off by default; would call your WHMCS Domain Availability API).
Bulk import/export of custom shortcodes.
Quick Start
Install and activate the plugin.
Go to Settings → Domain Search for WHMCS.
On the Default Settings tab, enter your WHMCS base URL (e.g. https://billing.example.com) and a placeholder (“Find your domain”).
Click Save Changes.
Add [domain_search_for_whmcs] to any post or page.
That’s it. Visitors who type a domain and submit will land on your WHMCS cart with the search pre-filled.
Shortcode Reference
Default shortcode (uses the Default Settings tab values):
[domain_search_for_whmcs]
Custom shortcode (uses settings from a specific custom shortcode):
[domain_search_for_whmcs id="sc_1234567890_456"]
The id value is generated when you create a custom shortcode and is shown in the table on the Custom Shortcodes tab. Click it to copy.
If a custom id is provided but doesn’t exist (e.g. it was deleted), the plugin falls back to the default settings rather than rendering nothing.
Developer Filters
The plugin exposes five filters for runtime customization. All filters fire inside the shortcode renderer, so you can vary output per page, per user, or per locale.
dsfwhmcs_whmcs_url
Filter the resolved WHMCS base URL right before the form is rendered.
add_filter('dsfwhmcs_whmcs_url', function($url, $atts) {
// Send logged-in users to the staff portal.
return is_user_logged_in() ? 'https://members.example.com' : $url;
}, 10, 2);
Returns: string — the WHMCS base URL.
dsfwhmcs_placeholder
Filter the placeholder text dynamically.
add_filter('dsfwhmcs_placeholder', function($placeholder, $atts) {
return get_locale() === 'fr_FR' ? 'Trouvez votre domaine' : $placeholder;
}, 10, 2);
Returns: string — the placeholder text.
dsfwhmcs_form_action
Filter the full form action URL (default: {whmcs_url}/cart.php).
add_filter('dsfwhmcs_form_action', function($action, $whmcs_url, $atts) {
return trailingslashit($whmcs_url) . 'domainchecker.php';
}, 10, 3);
Returns: string — the action URL.
dsfwhmcs_form_method
Switch the form method. Defaults to GET; return 'POST' for legacy WHMCS configurations that prefer it.
add_filter('dsfwhmcs_form_method', function() {
return 'POST';
});
Returns: string — 'GET' or 'POST'.
dsfwhmcs_shortcode_html
Filter the rendered HTML before it’s returned to WordPress. Useful for wrapping the form, injecting analytics attributes, or replacing markup wholesale.
add_filter('dsfwhmcs_shortcode_html', function($html, $atts) {
return '
';
}, 10, 2);
Returns: string — the final HTML.
Compatibility
WordPress: 5.0+ (tested up to 7.0)
PHP: 7.4+ required (PHP 8.0, 8.1, 8.2, 8.3 fully tested; PHP 8.1+ recommended)
WHMCS: any version supporting the standard cart.php?a=add&domain=register URL (WHMCS 6.0+)
Multisite: fully compatible; settings are per-site
Page builders: Gutenberg, Classic Editor, Elementor, Beaver Builder, Bricks, Divi, Oxygen, Breakdance
Caching plugins: fully compatible (the form is static HTML)
HTTPS: strongly recommended for both WordPress and WHMCS — the dashboard’s “At a Glance” panel flags HTTP connections
Troubleshooting
The form submits but I get a 404 or blank page on WHMCS
Check the WHMCS URL in Default Settings. It should be the base URL of your WHMCS install (e.g. https://billing.example.com) — not https://billing.example.com/cart.php. The plugin appends cart.php itself.
The form looks unstyled
Make sure your theme isn’t blocking plugin stylesheets. The plugin enqueues a file named domain-search-for-whmcs.css on the front-end. If your theme has aggressive CSS overrides, target the .dsfwhmcs-* classes from the Customization tab.
Visitors land on the cart but the search box is empty
This usually means the URL was reached without the query parameter. Check that no caching plugin is stripping query strings from form submissions.
The Support tab is cut off on my phone
Update to 3.1.0+. The tab strip is now horizontally scrollable on narrow screens.
Other plugins’ notices appear inside the green dashboard header
That’s a WordPress core behavior. Update to 3.0.0+ where the plugin uses
to push third-party notices below the header.
Privacy
Domain Search for WHMCS is privacy-respecting by design.
No tracking. The plugin sets no cookies and loads no remote scripts.
No data collection. Visitor search queries pass directly from the browser to your WHMCS install — they do not touch the WordPress server, are not logged, and are not transmitted to any third party.
No external services. All assets (CSS, fonts, icons) are served from your own site. No CDN or remote dependency.
Stored data. Only configuration is stored — WHMCS URL, placeholder text, custom shortcode definitions — in the WordPress wp_options table. This is removed on plugin uninstall.
You should still ensure your WHMCS install has its own privacy policy in place, since the visitor will be entering personal data on that side of the integration.
External Services
This plugin does not connect to any external service.
The visitor’s browser submits the search form directly to your own WHMCS installation — a first-party endpoint that you control. Nothing is sent to WordPress.org, third-party domain APIs, analytics services, or the plugin author.
Source Code
This plugin contains no minified or compiled assets. All PHP, CSS, and JavaScript shipped in the plugin is human-readable source.
The plugin is hosted on WordPress.org. Issues and pull requests can be submitted via the support forum or by emailing [email protected].
