-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathreadme.txt
More file actions
122 lines (83 loc) · 5.37 KB
/
readme.txt
File metadata and controls
122 lines (83 loc) · 5.37 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
=== ButtonFlow – Sticky Floating Mobile Button for Call, Messaging & Booking ===
Contributors: gasatrya
Tags: whatsapp, cta, whatsapp-business, click-to-chat, notification-bar
Requires at least: 6.5
Tested up to: 6.9
Stable tag: 1.1.0
Requires PHP: 8.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Boost conversions with a permanent floating CTA button on mobile. One tap to call, message, or book. Zero code required.
== Description ==
65–75% of local business website traffic comes from mobile — yet most WordPress themes bury the phone number in the header and hide the "Book Now" button at the top of the page. Once a visitor scrolls, your most important CTA disappears.
**ButtonFlow** fixes this in minutes.
Install the plugin, set your button label and action, and a beautiful floating button will appear at the bottom of every mobile screen — staying permanently visible as the user scrolls. One tap to call. One tap to book. One tap to start a WhatsApp conversation.
No page builder. No theme editing. No code.
= Who is this for? =
* Aesthetic clinics & medspas
* Restaurants & cafes
* Law firms & consultants
* Real estate agents
* Any local business that gets mobile traffic and wants more leads
= Core Features =
* **Click-to-Call** — Tapping the button instantly dials your phone number.
* **Open URL** — Send visitors directly to your booking page, menu, or any link.
* **WhatsApp Chat** — Opens WhatsApp with a pre-filled message (fully customizable).
* **Smooth Scroll** — Scrolls the page to a specific section using an anchor ID (#contact).
* **Custom Label & Icon** — Set any button text and choose from preset icons (phone, calendar, WhatsApp, message).
* **Appearance Control** — Customize background color, text color, and choose from 3 button sizes (Small, Medium, Large).
* **Live Preview** — See exactly how your button looks in real-time as you edit the settings.
* **Mobile-Only Display** — The button is never shown on tablets or desktops (CSS + JS dual enforcement).
* **Page-Level Hide Rules** — Suppress the button on specific pages (e.g., the contact page itself) using slugs or IDs.
* **Entrance Animation** — Button slides up from the bottom after a configurable delay.
* **Performance Optimized** — Total asset size under 5kb. No jQuery. No React. No bloat.
= Privacy First =
This plugin is built with privacy as a priority. No tracking, no external scripts, and no "Powered by" branding. No personal data is collected, stored, or transmitted. Full GDPR compliance out of the box.
= Coming in Pro (v2) =
* Multi-button dock (Call + WhatsApp + Book fan-out on tap)
* A/B testing — test two CTA labels and auto-promote the winner
* Session frequency control — hide for visitors who already clicked
* Click analytics dashboard — clicks, click rate by page, device breakdown
[Read more detail](https://www.ctaflow.com/plugins/buttonflow/)
== Installation ==
1. Upload the `buttonflow` folder to the `/wp-content/plugins/` directory, or install via **Plugins → Add New** in your WordPress dashboard.
2. Activate the plugin through the **Plugins** menu.
3. Go to **Settings → ButtonFlow** to configure your button.
4. Set your button label, choose an action type, and enter the action value.
5. Customize colors, size, and entrance delay to match your brand.
6. Click **Save Settings** and visit your site on a mobile device to see the button in action.
== Frequently Asked Questions ==
= Will this button show on desktop? =
No. The button is hidden on all screens wider than 767px using both CSS media queries and JavaScript. Desktop visitors will never see it.
= Does it work with Elementor, Divi, or Astra? =
Yes. The plugin injects directly into the page footer and is fully theme-agnostic. It has been tested with Astra, GeneratePress, OceanWP, and Elementor-based themes.
= Can I hide the button on specific pages? =
Yes. In the settings page, you can enter a comma-separated list of page IDs or slugs where the button should be hidden (for example: your contact page or checkout page).
= How do I set up the WhatsApp action? =
Select "WhatsApp" as the action type, then enter your phone number in international format (e.g., `628123456789`). You can also customize the pre-filled message text.
= Is this plugin free? =
Yes. The core plugin is 100% free and always will be. A Pro version with advanced features is planned for a future release.
= Will it slow down my site? =
No. The CSS and JS files combined weigh less than 5kb and are only loaded on the frontend. The plugin uses no external dependencies.
== Screenshots ==
1. The settings page with Live Preview.
2. The floating CTA button as seen by a mobile visitor.
== Changelog ==
= 1.1.0 =
* Fixed version sync across core files.
* Added uninstall.php for proper data cleanup on deletion.
* Improved mobile detection using matchMedia for better consistency.
* Readiness audit and final refinements for WordPress.org submission.
= 1.0.1 =
* Rebranded the plugin to ButtonFlow.
* Minor UI/UX refinements.
* Code cleanup and consistency improvements.
= 1.0.0 =
* Initial release.
* Features: Action types (Phone, URL, WhatsApp, Scroll), Custom Colors, Icons, Button Sizing, and Page Exclusion.
* Includes: Live Preview and Reset to Defaults functionality.
== Upgrade Notice ==
= 1.0.1 =
Rebranded to ButtonFlow. No functionality changes.
= 1.0.0 =
Initial release. No upgrade steps required.