Floating Contact Widget
| 开发者 | armanbasir |
|---|---|
| 更新时间 | 2026年7月25日 17:55 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.2 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Floating Contact Widget displays a floating chat button in the corner of your website. When clicked, it instantly opens a panel with contact options: WhatsApp, Tokopedia, Shopee, TikTok, and Email — complete with icons that automatically slide inside the bubble before it's opened.
Everything is configured from a single admin page, no code editing required:
- WhatsApp number + a pre-filled automatic message
- Tokopedia and Shopee store links
- TikTok profile link
- Destination email address
- Additional (custom) contacts — add as many other contacts as you like (Instagram, Telegram, a website, etc), each with its own icon
- Custom icons for WhatsApp, Tokopedia, Shopee, TikTok, and Email — upload your own image via the Media Library, or leave it empty to use the official logo automatically
- Bubble background gradient color (color picker)
- Widget position (bottom right/left) plus spacing (padding) from the screen edge — set separately for desktop and mobile
- Icon slide animation speed
- Enable/disable each contact platform individually
- Optional pulse ring animation around the closed bubble to draw attention
- Instant open/close with no animation — immediate response when clicked
- Auto-sliding icons inside the bubble before it's clicked
- Fully responsive (desktop & mobile), including automatic scrolling if the contact list is long
- Lightweight — no external library dependencies on the visitor's side
- Does not store any visitor data
https://www.google.com/s2/favicons?domain={domain}&sz=128
This request is sent directly from the visitor's browser (not from your server) every time the widget is displayed, and only contains the domain name of the relevant platform (e.g. whatsapp.com), with no personal visitor data. If you upload your own icon for every active contact, no request to this service will occur at all.
Google's privacy policy: https://policies.google.com/privacy
安装:
- Upload the
floating-contact-widgetfolder to the/wp-content/plugins/directory, or install it directly via the Plugins > Add New menu in wp-admin. - Activate the plugin through the Plugins menu in WordPress.
- Go to the Floating Contact menu in the admin sidebar.
- Fill in your WhatsApp number, Tokopedia/Shopee/TikTok links, and email address.
- Adjust the appearance (colors, position, slide speed) and custom icons as needed.
- Click Save Settings — the widget will immediately appear on every page of your website.
屏幕截图:
常见问题:
Do I have to fill in every contact platform?
No. Each platform (WhatsApp, Tokopedia, Shopee, TikTok, Email) has its own "Show" toggle. If a contact is disabled or left empty, it will automatically not appear in the widget. The widget only displays if at least one contact is active and filled in.
How do I add contacts other than the 5 built-in platforms?
Use the Additional Contacts (Custom) section on the settings page. Click "+ Add Contact", fill in the name and destination link, then upload an icon (optional — if left empty, the plugin automatically fetches a favicon from that link's domain).
Are the automatic WhatsApp/Tokopedia/etc icons the official logos?
The default icons are pulled from a public favicon service based on each platform's official domain. For full control over the appearance, you can upload your own image/logo for each contact from the settings page.
Does this plugin slow down my website?
No. The widget is built with pure CSS and JavaScript (no external library such as jQuery on the visitor-facing side), and is only loaded once in the page footer.
Does this plugin store visitor data?
No. This plugin does not store any visitor data at all. The only data stored is the settings you fill in yourself on the admin page (numbers, links, colors, etc), saved as a single option in your WordPress database.
更新日志:
2.1.0
- Changed: redesigned the widget interaction — the main round button now stays fixed at the bottom and morphs into an "X" close icon when opened, while the contact list floats as a card directly above it (instead of the button being replaced by a full panel). Clicking outside the widget, or clicking the button again, closes it.
- Removed: the "Panel title" setting and its typography options, since there's no longer a panel header in the new design.
- Fix: renamed every internal function, constant, option group, script/style handle, and JS global variable from the short
fcwprefix tofloacowi, per WordPress.org's plugin review requirement that prefixes be longer than 4 characters to avoid naming collisions with other plugins/themes. This is an internal-only change; no settings, features, or behavior are affected. If you had already saved settings under the old option name, please re-enter and save your settings once after updating, since the plugin now stores its data under a new option key (floacowi_settingsinstead offcw_settings).
- Fix: the pulse ring is now hidden using
display:noneinstead ofopacity:0when the panel is open, since a running CSS animation can otherwise override a plain opacity rule and cause the ring to remain (partially) visible. - Changed: author name updated to Arman Basir.
- New: a color picker for the pulse ring, so it can be adjusted to stand out against any website background (previously fixed to white).
- Fix: the pulse ring element has been moved out of the bubble's clipped container entirely (instead of only adjusting the
overflowproperty), so it reliably animates and expands beyond the bubble in every browser.
- Fix: the pulse ring animation was being clipped by the bubble's circular boundary, making it barely visible. It now properly expands beyond the bubble as intended.
- New: a toggle to enable/disable the pulsing ring animation around the closed bubble, under Appearance.
- Fix: all dynamic output is now properly escaped at the point of printing (
esc_attr(),esc_url(),esc_html()), resolving everyWordPress.Security.EscapeOutput.OutputNotEscapedwarning reported by the Plugin Check tool.
- Fix: all inline
<style>and<script>tags have been replaced with properly registered/enqueued CSS and JS files (wp_enqueue_style(),wp_enqueue_script(),wp_add_inline_style(),wp_localize_script()), per WordPress.org's plugin review requirements.
- Changed: the entire plugin interface (settings page and default text) has been translated into English.
- Fix: added the "License" and "License URI" headers (GPLv2 or later) to the main plugin file so it passes WordPress.org's automated review.
- Changed: all open/close animations and effects have been removed — the bubble and contact panel now appear/disappear instantly (no fade, scale, or staggered reveal) so the open/close process feels faster.
- Changed: the 3D flip effect on the bubble has been completely removed, both when opening and closing. The contact panel previously appeared/disappeared with a fade & scale animation.
- New: font size and bold (on/off) settings for the panel title.
- New: font size and bold (on/off) settings for each contact's name (including additional/custom contacts).
- New: icon slide speed setting (in seconds) on the Appearance page.
- New: separate position padding settings for desktop and mobile.
- Fix: the 3D flip animation no longer plays in reverse when the close (×) button is clicked.
- Fix: the close (×) button is now perfectly round in every browser.
- Changed: the "Additional Contacts (Custom)" section order was moved above the "Appearance" section.
- New: "Additional Contacts (Custom)" feature — add contacts beyond the 5 built-in platforms, complete with your own icon upload.
- New: widget position padding (spacing from the screen edge) setting.
- Fix: the close (×) button is now more precisely round.
- New: TikTok contact support.
- New: custom icon upload for each platform via the Media Library.
- New: bubble background gradient color setting.
- New: enable/disable toggle per contact platform.
- Initial release: a floating chat widget for WhatsApp, Tokopedia, Shopee, and Email.