GoalPrevail Floating Button – User Guide

1. What this plugin does

GoalPrevail Floating Button lets you display up to three floating buttons on your WordPress website. Buttons can appear at the bottom left, center or right and perform one of six one-tap actions.

• Six actions — phone, WhatsApp, email, SMS, custom URL or scroll-to-top.
• Up to three buttons — configure the left, center and right positions independently.
• Complete styling — customize colors, icons, typography, spacing, borders, shadows and animations.
• Device rules — display buttons on all devices, mobile only or desktop only.
• Anonymous analytics — track clicks without cookies or third-party services.

The plugin uses lightweight vanilla JavaScript, inline CSS and no external assets. If no valid button is configured, nothing is displayed on the front end.

2. Requirements and installation

2.1 Requirements

• A WordPress website
• Administrator access
• No WooCommerce, page builder or additional plugin required

2.2 Installation

1. Upload the gp-floating-button folder to /wp-content/plugins/, or use Plugins → Add New → Upload Plugin.
2. Activate GoalPrevail Floating Button.
3. Choose a starting button position on the welcome screen.
4. Open GoalPrevail → Floating Button to configure the plugin.

3. Where to configure the plugin

All settings are available under GoalPrevail → Floating Button at:

admin.php?page=gp-floating-button

The settings page contains separate tabs for:

• Left — configure the bottom-left button.
• Center — configure the bottom-center button.
• Right — configure the bottom-right button.
• Shared Style — define the default design inherited by all buttons.
• Analytics — view and manage anonymous click statistics.
• Advanced — add CSS classes, custom CSS and uninstall preferences.

4. Creating a floating button

1. Open the Left, Center or Right tab.
2. Enable the button for that position.
3. Enter the visible button text.
4. Choose an action type.
5. Enter the required phone number, email address or URL.
6. Configure placement, device visibility and styling.
7. Save your changes.

A button must be enabled and contain a valid action value before it appears. The plugin never outputs an empty or inactive link.

5. Action types

For WhatsApp, enter digits with the country code and without a leading 00. Example: 38344123456.

6. Button content and link options

• Button label — the text displayed beside the icon.
• ARIA label — an accessible description for screen readers.
• Action type — determines what happens when the button is clicked.
• Action value — the phone number, email address or URL used by the action.
• Open in a new tab — available for supported links.
• Add nofollow — adds the appropriate relationship attribute to the link.

If the ARIA label is empty, the plugin uses the visible button label as the accessible description.

7. Placement and display rules

7.1 Position and spacing

• Bottom offset — controls the distance from the bottom of the screen.
• Side offset — controls the distance from the left or right edge.
• Z-index — controls whether the button appears above other website elements.

7.2 Scroll visibility

Set the button to display immediately or only after the visitor has scrolled a specified number of pixels.

7.3 Device targeting

• All devices — show on desktop, tablet and mobile.
• Mobile only — show below the 768px breakpoint.
• Desktop only — show at or above the 768px breakpoint.
• Full-width mobile mode — display the button as a full-width bar on phones.
• Icon-only mobile mode — hide the label and display only the icon.

7.4 Page exclusions

To hide a button from specific posts or pages, enter their IDs as a comma-separated list.

Example: 12, 45, 106

8. Styling the buttons

The Shared Style tab controls the default appearance inherited by all enabled buttons.

• Background and text colors
• Hover background and text colors
• 19 built-in inline SVG icons
• Icon position, size and spacing
• Font family, size, weight and text transformation
• Letter spacing
• Horizontal and vertical padding
• Border width, color and radius
• Shadow presets
• Hover lift effects
• Entrance effects
• Attention animations

8.1 Independent styling

Enable custom styling inside a position tab when one button needs a different design. When independent styling is disabled, that button automatically inherits the Shared Style settings.

Animations respect the visitor’s reduced-motion preference and only run when motion has not been disabled at the operating-system or browser level.

9. Anonymous click analytics

Enable Track button clicks from the Analytics tab to record anonymous click totals for each position.

• Today’s clicks
• Clicks from the last 7 days
• Clicks from the last 30 days
• All-time clicks
• Separate totals for the left, center and right buttons
• A 14-day activity chart
• An option to reset all recorded statistics

Daily totals are retained for 90 days. All-time totals are stored separately.

Analytics does not store cookies, IP addresses or personal information. A temporary salted hash is used only to prevent repeated clicks from being counted within three seconds, then expires automatically.

10. Advanced settings and custom CSS

• Extra CSS classes — add your own classes to the floating buttons.
• Custom CSS — add button-specific styling without editing your theme.
• Delete data on uninstall — remove all plugin settings and analytics when the plugin is deleted.

10.1 Available CSS selectors

#gpfb-wrap-left
#gpfb-wrap-center
#gpfb-wrap-right

#gpfb-button-left
#gpfb-button-center
#gpfb-button-right

.gpfb-wrap
.gpfb-btn
.gpfb-btn-left
.gpfb-btn-center
.gpfb-btn-right
.gpfb-label
.gpfb-icon

10.2 Custom CSS example

#gpfb-button-right {
    border: 2px solid #ffffff;
}

#gpfb-button-right:hover {
    transform: translateY(-3px);
}

11. Developer information

11.1 REST endpoint

Anonymous click tracking uses:

POST /wp-json/gpfb/v1/click?position=left|center|right

The endpoint only accepts a valid button position, increments its anonymous counter and returns an HTTP 204 response.

11.2 PHP filters

• gpfb_active_buttons — modify the active buttons immediately before they are rendered.
• goalprevail_plugins — registers the plugin with the shared GoalPrevail dashboard.

11.3 Filter example

add_filter( 'gpfb_active_buttons', function ( $buttons ) {
    return is_user_logged_in() ? array() : $buttons;
} );

This example hides all floating buttons from logged-in users.

11.4 Stored data

No custom database tables, cron jobs or external tracking requests are created.

12. Troubleshooting

• The button is not visible: Confirm the position is enabled and contains a valid action value. Also check device targeting, scroll visibility and page-ID exclusions.
• The button appears behind another element: Increase its z-index under Placement and Behavior.
• WhatsApp opens the wrong number: Enter the number with its country code using digits only and without a leading 00.
• Analytics is not counting: Confirm that click tracking is enabled. Some ad blockers may block the REST request, so totals should be treated as a useful trend rather than an exact measurement.
• The theme overrides the button design: Use the available button IDs inside the Custom CSS field to apply more specific styles.
• The button appears on the wrong device: Check whether the position is set to all devices, mobile only or desktop only.

13. Privacy and security

• No cookies are created.
• No personal information is stored.
• No analytics data is sent to third-party services.
• Administrative actions are nonce-protected and require the manage_options capability.
• All settings are validated and sanitized on the server.
• All front-end output is escaped.
• SVG icons are filtered through a strict allowed-element list.
• The tracking endpoint accepts only left, center or right as valid positions.

14. Uninstalling the plugin

1. Deactivate the plugin to stop all floating-button output while keeping your settings.
2. Delete the plugin from the WordPress Plugins page when it is no longer needed.
3. By default, the plugin keeps its settings so they can be restored after reinstallation.
4. To remove everything, enable Delete all plugin data on uninstall under Advanced before deleting the plugin.

When data removal is enabled, the plugin deletes gpfb_settings, gpfb_clicks and its setup flags during uninstall.

15. Support

For questions, support or feature requests, contact [email protected] or visit goalprevail.com.