Homie Floating WhatsApp Selector

A self-contained WordPress plugin that displays a floating WhatsApp launcher. The launcher opens a compact conversation card with independently configurable Nigeria and International destinations.

Created by Toxima and released under the MIT License.

Repository: github.com/iamtoxima/homie-whatsapp-selector

Install

1. Download the ready-to-install homie-whatsapp-selector.zip package.
2. In WordPress, open Plugins → Add New → Upload Plugin and upload the ZIP.
3. Activate Homie Floating WhatsApp Selector.
4. Open the dedicated WhatsApp menu in the WordPress admin sidebar.
5. Enter each WhatsApp number using digits and its country code, such as 2348012345678.
6. Enable the destination or destinations you want to show and save the settings.

For development, clone this repository and copy the repository folder into wp-content/plugins/homie-whatsapp-selector.

The widget remains hidden if it is disabled or if no enabled destination has a valid number.

Use

1. Open WhatsApp in the WordPress admin sidebar.
2. Turn the complete widget on or off under General.
3. Under Nigeria option and International option, change the public option name, description, WhatsApp number, and prefilled message.
4. Enable only the destination or destinations you currently use. Disabling an option keeps its saved details for later.
5. Under Appearance and behaviour, choose the launcher position, launcher/header colour, WhatsApp icon colour, accent colour, tooltip behaviour, and whether WhatsApp opens in a new tab.
6. Select Save Changes and verify the launcher on the public website.

Settings

• Master widget enable/disable switch.
• Editable Nigeria and International numbers.
• Independent enable/disable switch for each destination.
• Editable public option names, descriptions, and URL-encoded prefilled messages.
• Panel title, introduction, response note, and launcher tooltip.
• Bottom-left or bottom-right placement.
• Configurable launcher/header and WhatsApp accent colours.
• Separate colour control for the real WhatsApp icon on the launcher and panel header.
• Same-tab or new-tab WhatsApp links.
• Optional removal of plugin settings during uninstall.

Security and privacy

• Uses the WordPress Settings API and its capability/nonce handling.
• Restricts settings to users with manage_options.
• Sanitizes submitted fields and validates phone numbers as 7–15 digits.
• Escapes dynamic output for its HTML context.
• Generates links only for the exact https://wa.me/ destination.
• Loads no third-party scripts, fonts, analytics, or trackers.
• Stores no visitor data and creates no custom database tables.

Development checks

From the plugin directory:

php -l homie-whatsapp-selector.php
php -l includes/class-hws-settings.php
php -l includes/class-hws-frontend.php
php -l uninstall.php
node --check assets/js/frontend.js
php tests/run.php

Runtime acceptance testing should be completed in a WordPress installation with a theme that calls wp_footer().

License

MIT. See LICENSE.