Feature release. Adds a full Appearance customizer with live preview \u2014 control every color and radius of the front-end form from the admin dashboard. Includes responsive admin fixes and a regenerated translation template. Safe drop-in upgrade from 3.0.0.<\/p>","3.0.0":"
Major redesign, security hardening, and new developer filters. Now requires PHP 8.0+.<\/strong> All existing settings and custom shortcodes are preserved across the upgrade.<\/p>","2.1.0":" Recommended update \u2014 fixes a leaking nonce on the front-end form and an Update your WHMCS URL in the settings after upgrading.<\/p>","1.5.0":" Update recommended for improved security and styling fixes.<\/p>","1.0.0":" Initial version.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"Icon-128x128.gif":{"filename":"Icon-128x128.gif","revision":3287071,"resolution":"128x128","location":"assets","locale":"","width":150,"height":150},"Icon-256x256.gif":{"filename":"Icon-256x256.gif","revision":3287071,"resolution":"256x256","location":"assets","locale":"","width":150,"height":150}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3256113,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3256113,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2","1.0.3","1.0.4","1.0.5","2.0.0","2.0.1","2.0.2","2.0.3","3.0.0","3.0.1","3.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3523406,"resolution":"1","location":"assets","locale":"","width":1920,"height":1440},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3523406,"resolution":"2","location":"assets","locale":"","width":1920,"height":1440},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3523406,"resolution":"3","location":"assets","locale":"","width":1920,"height":1440},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3523406,"resolution":"4","location":"assets","locale":"","width":1920,"height":1440}},"screenshots":{"1":"Front-end domain search form rendered on a marketing page.","2":"Admin dashboard \u2014 Default Settings tab.","3":"Admin dashboard \u2014 Custom Shortcodes tab with multiple branded forms.","4":"Admin dashboard \u2014 Customization reference for theme designers.","5":"Admin dashboard \u2014 built-in Support center with forum link, email, and system info."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[239273,24441,1456,23300,32609],"plugin_category":[],"plugin_contributors":[191464],"plugin_business_model":[],"class_list":["post-223032","plugin","type-plugin","status-publish","hentry","plugin_tags-domain-registration","plugin_tags-domain-search","plugin_tags-hosting","plugin_tags-web-hosting","plugin_tags-whmcs","plugin_contributors-shiponkarmakar","plugin_committers-shiponkarmakar"],"banners":{"banner":"https:\/\/ps.w.org\/domain-search-for-whmcs\/assets\/banner-772x250.jpg?rev=3256113","banner_2x":"https:\/\/ps.w.org\/domain-search-for-whmcs\/assets\/banner-1544x500.jpg?rev=3256113","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/domain-search-for-whmcs\/assets\/Icon-128x128.gif?rev=3287071","icon_2x":"https:\/\/ps.w.org\/domain-search-for-whmcs\/assets\/Icon-256x256.gif?rev=3287071","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/domain-search-for-whmcs\/assets\/screenshot-1.png?rev=3523406","caption":"Front-end domain search form rendered on a marketing page."},{"src":"https:\/\/ps.w.org\/domain-search-for-whmcs\/assets\/screenshot-2.png?rev=3523406","caption":"Admin dashboard \u2014 Default Settings tab."},{"src":"https:\/\/ps.w.org\/domain-search-for-whmcs\/assets\/screenshot-3.png?rev=3523406","caption":"Admin dashboard \u2014 Custom Shortcodes tab with multiple branded forms."},{"src":"https:\/\/ps.w.org\/domain-search-for-whmcs\/assets\/screenshot-4.png?rev=3523406","caption":"Admin dashboard \u2014 Customization reference for theme designers."}],"raw_content":"\n Domain Search for WHMCS<\/strong> 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.<\/p>\n\n It is purpose-built for hosting providers, domain resellers, ICANN registrars, and white-label hosting brands who already use WHMCS as their billing platform.<\/p>\n\n 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.<\/p>\n\n Drop-in shortcode<\/strong> \u2014 Unlimited custom shortcodes<\/strong> \u2014 create branded forms each pointing at a different WHMCS install with its own placeholder. Reference them as Modern admin dashboard<\/strong> \u2014 tabbed UI, click-to-copy shortcodes, an \"At a Glance\" overview (custom shortcode count, active host, HTTPS status), and a built-in Support tab.<\/p>\n\n Built for speed<\/strong> \u2014 one ~1.7 KB CSS file. No JavaScript, no jQuery, no Ajax, no remote assets, no tracking pixels.<\/p>\n\n Theme-agnostic styling<\/strong> \u2014 six stable, well-named CSS classes you can target from any theme or page builder.<\/p>\n\n Developer extensibility<\/strong> \u2014 five filter hooks let plugins and themes change behavior without forking. See Developer Filters<\/em> below.<\/p>\n\n Secure by default<\/strong> \u2014 nonce verification, capability checks, sanitized I\/O, properly escaped output.<\/p>\n\n Translation-ready<\/strong> \u2014 every string wrapped in the Privacy-friendly<\/strong> \u2014 no data collection, no cookies, no remote services. See Privacy<\/em> below.<\/p>\n\n You do not<\/strong> need to expose any WHMCS API credentials in WordPress. The plugin never calls WHMCS APIs; it just hands off the visitor.<\/p>\n\n That's it. Visitors who type a domain and submit will land on your WHMCS cart with the search pre-filled.<\/p>\n\n Default shortcode<\/strong> (uses the Default Settings<\/em> tab values):<\/p>\n\n Custom shortcode<\/strong> (uses settings from a specific custom shortcode):<\/p>\n\n The If a custom 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.<\/p>\n\n Filter the resolved WHMCS base URL right before the form is rendered.<\/p>\n\n Returns:<\/strong> Filter the placeholder text dynamically.<\/p>\n\n Returns:<\/strong> Filter the full form action URL (default: Returns:<\/strong> Switch the form method. Defaults to Returns:<\/strong> Filter the rendered HTML before it's returned to WordPress. Useful for wrapping the form, injecting analytics attributes, or replacing markup wholesale.<\/p>\n\n Returns:<\/strong> Check the WHMCS URL in Default Settings<\/strong>. It should be the base URL of your WHMCS install (e.g. Make sure your theme isn't blocking plugin stylesheets. The plugin enqueues a file named This usually means the URL was reached without the query parameter. Check that no caching plugin is stripping query strings from form submissions.<\/p>\n\n Update to 3.1.0+. The tab strip is now horizontally scrollable on narrow screens.<\/p>\n\n That's a WordPress core behavior. Update to 3.0.0+ where the plugin uses Domain Search for WHMCS is privacy-respecting by design.<\/p>\n\n 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.<\/p>\n\n This plugin does not connect to any external service.<\/p>\n\n The visitor's browser submits the search form directly to your own WHMCS installation<\/strong> \u2014 a first-party endpoint that you control. Nothing is sent to WordPress.org, third-party domain APIs, analytics services, or the plugin author.<\/p>\n\n This plugin contains no minified or compiled assets. All PHP, CSS, and JavaScript shipped in the plugin is human-readable source.<\/p>\n\n The plugin is hosted on WordPress.org. Issues and pull requests can be submitted via the support forum or by emailing shipon@zendforce.com<\/a>.<\/p>\n\n\n Open Settings \u2192 Domain Search for WHMCS<\/strong> and update the WHMCS URL<\/em> on the Default Settings<\/strong> tab. Use the base URL of your WHMCS install (e.g. Yes. Each shortcode has its own placeholder field. You can also change it programmatically with the Yes \u2014 that is what the Custom Shortcodes<\/strong> tab is for. Each custom shortcode has its own WHMCS URL and placeholder. Reference it as No. The plugin saves only your configuration (WHMCS URLs, placeholders, custom shortcode definitions) in Yes. The output is small, semantic HTML. Tested with classic themes, block themes (FSE), Elementor, Beaver Builder, Bricks, Divi, Oxygen, and Breakdance. If your builder has a \"Shortcode\" element, drop it in there.<\/p><\/dd>\n Open the Customization<\/strong> tab inside the plugin to see the available CSS classes. Add overrides in Appearance \u2192 Customize \u2192 Additional CSS<\/em>, your child theme's stylesheet, or a CSS plugin. The classes are stable and won't change between minor versions:<\/p>\n\n The Community Forum<\/strong> on WordPress.org is the primary support channel \u2014 please open a thread there for the fastest public response. You can also reach the developer directly at shipon@zendforce.com<\/a> for personal assistance. Inside the plugin, the Support<\/strong> tab has both links plus a system info card that's handy to copy-paste into a bug report.<\/p><\/dd>\n Not at the moment \u2014 the plugin hands off to WHMCS's own Yes. All existing default settings and custom shortcode IDs are preserved across upgrades. No data migration is required.<\/p><\/dd>\n Standard WordPress behavior \u2014 third-party plugins (SMTP plugins, security plugins, etc.) hook into the global Yes. Version 3.0.0+ requires PHP 8.0 or higher. PHP 7.x has been end-of-life since November 2022 and is no longer receiving security fixes \u2014 please update your hosting environment.<\/p><\/dd>\n Deactivate, then Delete<\/strong> the plugin from the Plugins screen. The bundled Yes. The plugin does not collect, process, or transmit visitor data. The search form submits the query directly from the visitor's browser to your own WHMCS install (a first-party data flow already covered by your existing privacy policy). The plugin sets no cookies, loads no remote assets, and logs nothing.<\/p><\/dd>\n Yes. Activate per-site or network-activate. Settings are stored per-site, so each site in the network has its own WHMCS URL and shortcodes.<\/p><\/dd>\n Yes \u2014 open a thread on the WordPress.org plugin support forum, or email shipon@zendforce.com<\/a>.<\/p><\/dd>\n\n<\/dl>\n\n\n Feature release: Appearance customizer with live preview.<\/strong><\/p>\n\nuninstall.php<\/code> bug that left orphaned options behind.<\/p>","2.0.0":"TL;DR<\/h4>\n\n
\n
[domain_search_for_whmcs]<\/code> on any page.<\/li>\nWhy this plugin<\/h4>\n\n
\n
Key features<\/h4>\n\n
[domain_search_for_whmcs]<\/code> works in posts, pages, widgets, FSE template parts, page-builder shortcode blocks, or via do_shortcode()<\/code> in PHP.<\/p>\n\n[domain_search_for_whmcs id=\"sc_xxxxx\"]<\/code>.<\/p>\n\ndomain-search-for-whmcs<\/code> text domain.<\/p>\n\nPerfect for<\/h4>\n\n
\n
How it works<\/h4>\n\n
\n
Roadmap<\/h4>\n\n
\n
Quick Start<\/h3>\n\n
\n
https:\/\/billing.example.com<\/code>) and a placeholder (\"Find your domain\").<\/li>\n[domain_search_for_whmcs]<\/code> to any post or page.<\/li>\n<\/ol>\n\nShortcode Reference<\/h3>\n\n
[domain_search_for_whmcs]\n<\/code><\/pre>\n\n[domain_search_for_whmcs id=\"sc_1234567890_456\"]\n<\/code><\/pre>\n\nid<\/code> value is generated when you create a custom shortcode and is shown in the table on the Custom Shortcodes<\/strong> tab. Click it to copy.<\/p>\n\nid<\/code> is provided but doesn't exist (e.g. it was deleted), the plugin falls back to the default settings rather than rendering nothing.<\/p>\n\nDeveloper Filters<\/h3>\n\n
dsfwhmcs_whmcs_url<\/h4>\n\n
add_filter('dsfwhmcs_whmcs_url', function($url, $atts) {\n \/\/ Send logged-in users to the staff portal.\n return is_user_logged_in() ? 'https:\/\/members.example.com' : $url;\n}, 10, 2);\n<\/code><\/pre>\n\nstring<\/code> \u2014 the WHMCS base URL.<\/p>\n\ndsfwhmcs_placeholder<\/h4>\n\n
add_filter('dsfwhmcs_placeholder', function($placeholder, $atts) {\n return get_locale() === 'fr_FR' ? 'Trouvez votre domaine' : $placeholder;\n}, 10, 2);\n<\/code><\/pre>\n\nstring<\/code> \u2014 the placeholder text.<\/p>\n\ndsfwhmcs_form_action<\/h4>\n\n
{whmcs_url}\/cart.php<\/code>).<\/p>\n\nadd_filter('dsfwhmcs_form_action', function($action, $whmcs_url, $atts) {\n return trailingslashit($whmcs_url) . 'domainchecker.php';\n}, 10, 3);\n<\/code><\/pre>\n\nstring<\/code> \u2014 the action URL.<\/p>\n\ndsfwhmcs_form_method<\/h4>\n\n
GET<\/code>; return 'POST'<\/code> for legacy WHMCS configurations that prefer it.<\/p>\n\nadd_filter('dsfwhmcs_form_method', function() {\n return 'POST';\n});\n<\/code><\/pre>\n\nstring<\/code> \u2014 'GET'<\/code> or 'POST'<\/code>.<\/p>\n\ndsfwhmcs_shortcode_html<\/h4>\n\n
add_filter('dsfwhmcs_shortcode_html', function($html, $atts) {\n return '<div class=\"my-wrapper\">' . $html . '<\/div>';\n}, 10, 2);\n<\/code><\/pre>\n\nstring<\/code> \u2014 the final HTML.<\/p>\n\nCompatibility<\/h3>\n\n
\n
cart.php?a=add&domain=register<\/code> URL (WHMCS 6.0+)<\/li>\nTroubleshooting<\/h3>\n\n
The form submits but I get a 404 or blank page on WHMCS<\/h4>\n\n
https:\/\/billing.example.com<\/code>) \u2014 not https:\/\/billing.example.com\/cart.php<\/code>. The plugin appends cart.php<\/code> itself.<\/p>\n\nThe form looks unstyled<\/h4>\n\n
domain-search-for-whmcs.css<\/code> on the front-end. If your theme has aggressive CSS overrides, target the .dsfwhmcs-*<\/code> classes from the Customization<\/em> tab.<\/p>\n\nVisitors land on the cart but the search box is empty<\/h4>\n\n
The Support tab is cut off on my phone<\/h4>\n\n
Other plugins' notices appear inside the green dashboard header<\/h4>\n\n
<hr class=\"wp-header-end\"><\/code> to push third-party notices below the header.<\/p>\n\nPrivacy<\/h3>\n\n
\n
wp_options<\/code> table. This is removed on plugin uninstall.<\/li>\n<\/ul>\n\nExternal Services<\/h3>\n\n
Source Code<\/h3>\n\n
From the WordPress.org directory (recommended)<\/h4>\n\n
\n
Manual installation<\/h4>\n\n
\n
\/wp-content\/plugins\/domain-search-for-whmcs\/<\/code> via SFTP.<\/li>\n\n
How do I change the WHMCS URL?<\/h3><\/dt>\n
https:\/\/billing.example.com<\/code>) \u2014 no trailing slash, no cart.php<\/code>.<\/p><\/dd>\nCan I customize the placeholder text?<\/h3><\/dt>\n
dsfwhmcs_placeholder<\/code> filter.<\/p><\/dd>\nCan I have different search forms for different brands?<\/h3><\/dt>\n
[domain_search_for_whmcs id=\"sc_xxxxx\"]<\/code>. Click any shortcode in the table to copy.<\/p><\/dd>\nDoes this plugin store any user data?<\/h3><\/dt>\n
wp_options<\/code>. The search form submits the visitor's query directly to your WHMCS site \u2014 nothing is logged or transmitted by this plugin.<\/p><\/dd>\nWill it work with my theme or page builder?<\/h3><\/dt>\n
How do I style the form?<\/h3><\/dt>\n
\n
.dsfwhmcs-wrapper<\/code> \u2014 outer container<\/li>\n.dsfwhmcs-form<\/code> \u2014 <form><\/code> element<\/li>\n.dsfwhmcs-search-input-group<\/code> \u2014 input group container<\/li>\n.dsfwhmcs-input-with-button<\/code> \u2014 flexbox wrapper for input + button<\/li>\n.dsfwhmcs-domain-search-input<\/code> \u2014 the <input><\/code> field<\/li>\n.dsfwhmcs-domain-search-button<\/code> \u2014 the submit button<\/li>\n<\/ul><\/dd>\nHow do I get support?<\/h3><\/dt>\n
Does it work with the WHMCS REST\/Domain Lookup API?<\/h3><\/dt>\n
cart.php<\/code> flow. This keeps the integration simple, fast, and dependency-free, with no need to expose WHMCS API credentials to WordPress. An optional inline-availability mode (off by default) is on the roadmap.<\/p><\/dd>\nWill my old shortcodes still work after upgrading?<\/h3><\/dt>\n
Why am I seeing other plugins' admin notices on the settings page?<\/h3><\/dt>\n
admin_notices<\/code> action which fires on every admin screen. Domain Search for WHMCS does not display those notices itself.<\/p><\/dd>\nDoes the plugin require PHP 8?<\/h3><\/dt>\n
How do I uninstall and remove all data?<\/h3><\/dt>\n
uninstall.php<\/code> removes all plugin options from the database.<\/p><\/dd>\nIs the plugin GDPR-compliant?<\/h3><\/dt>\n
Is the plugin compatible with WordPress Multisite?<\/h3><\/dt>\n
Can I contribute or submit a feature request?<\/h3><\/dt>\n
3.1.0<\/h4>\n\n
\n