=== Wappend ===
Contributors: armandfederico
Tags: whatsapp, chat, contact, floating button
Requires at least: 6.4
Requires PHP: 8.0
Tested up to: 7.1
Stable tag: 1.2.14
License: GPLv2 or later

A configurable floating WhatsApp button for WordPress.

== Description ==

Wappend adds a configurable floating WhatsApp chat button — a click-to-chat contact widget for customer support and sales — with privacy-friendly aggregate click statistics and automatic analytics events.

Features:

* Large ON/OFF switch.
* Live desktop and smartphone previews.
* Four screen positions and three button sizes.
* Desktop, smartphone, or combined visibility.
* Three predefined distances from the screen edges.
* Optional pre-filled WhatsApp message.
* Optional text label with width, device, and hover controls.
* Configurable display delay, minimum scroll, and z-index.
* Aggregate click totals for all time, 7 days, and 30 days.
* Automatic wappend_click events for gtag or dataLayer when available.
* Translation-ready POT catalog for WordPress.org language packs.
* A compact informational reference to the separate Wappend Pro add-on.
* A dedicated Pro comparison page inside the plugin settings.

== Installation ==

1. Copy the "wappend" folder into "wp-content/plugins".
2. Activate Wappend from the Plugins screen.
3. Open Settings > Wappend.
4. Configure the phone number, message, position, size, and visibility.

== Frequently Asked Questions ==

= Do I need a WhatsApp Business account? =

No. Wappend works with both a personal WhatsApp number and a WhatsApp Business number. Enter the number in international format (for example +393331234567) under Settings > Wappend and turn the switch on.

= What happens when a visitor clicks the button? =

The visitor is taken to WhatsApp (the app on mobile, or web.whatsapp.com/WhatsApp Desktop on a computer) with a chat already open to your number, optionally with the pre-filled message you configured.

= Can I use a different WhatsApp number for different pages, departments, or operators? =

Not in Wappend Free, which uses a single WhatsApp number across the whole site. Assigning multiple numbers or departments to specific pages is available in Wappend Pro.

= Can I hide the button on specific pages or show it only during business hours? =

Wappend Free does not include page exclusions or time-based scheduling; the button follows the same position, delay, and visibility rules everywhere it is enabled. Custom schedules and URL exclusions are available in Wappend Pro.

= Does Wappend track my visitors? =

No. Wappend only stores an aggregate daily click count (total, last 7 days, last 30 days); it never stores IP addresses, visitor identities, phone numbers, or message contents. If gtag or dataLayer are already present on your site, Wappend also emits a "wappend_click" event for your existing Google Analytics or Google Tag Manager setup, without installing any tracking script of its own.

== Screenshots ==

1. General tab: WhatsApp number, pre-filled message, position, size, distance from the edges, visibility, and z-index, with the live desktop and smartphone preview on the right.
2. Label tab: enable an optional text label next to the button and control its text, width, visibility, and whether it is always visible or shown on hover/focus.
3. Analytics tab: aggregate click statistics (total, last 7 days, last 30 days), the Google Analytics/Tag Manager event details, and the statistics reset action.
4. Pro tab: overview of the advanced features available in the separate Wappend Pro add-on (multiple accounts, custom schedules, WooCommerce integration, custom colors, detailed statistics, and URL exclusions).

== Changelog ==

= 1.2.14 =
* Corrected the WordPress.org contributor username.

= 1.2.13 =
* Repackaged the release archive with forward-slash paths so the plugin header is read correctly on all platforms.

= 1.2.12 =
* Added the author and plugin website links to the WordPress Plugins screen.

= 1.2.11 =
* Saved Free and Pro settings in the background without reloading the page.
* Removed settings-saved alerts.
* Disabled the save button after a successful save until the next change.

= 1.2.10 =
* Restored the exact active tab after every settings save.
* Moved settings feedback inside the plugin header.

= 1.2.9 =
* Kept the active tab after saving Free settings.
* Moved save feedback to a global notice area below the plugin header.
* Deduplicated identical settings notices.

= 1.2.8 =
* Kept all settings tabs on one row above the full settings layout.
* Kept the live preview visible on Free and Pro tabs.
* Removed duplicate settings notices and cleared tab-specific notices correctly.

= 1.2.7 =
* Added extension hooks so Wappend Pro uses the same settings page and menu.
* Added an explicit options filter for add-ons.
* Updated the WhatsApp icon markup to support Pro color customization.

= 1.2.6 =
* Removed residual URL exclusion code reserved for Wappend Pro from the Free package.
* Added URL exclusions to the Pro feature overview and moved the Pro link below the feature grid.
* Added a dedicated Pro tab with feature explanations, two calls to action, and a Free/Pro comparison table.
* Aligned Pro panels and WhatsApp visuals with the Wappend landing page using local SVG icons.
* Updated all included translation catalogs.

= 1.2.5 =
* Moved the widget test to a compact link below the main switch.
* Simplified the test close control and restored tab-shaped lower corners.

= 1.2.4 =
* Added a five-second live widget test with manual close control.
* Standardized interface corner radii to 7 pixels.

= 1.2.3 =
* Separated settings, default restoration, and Pro information into independent panels.
* Moved the Pro link into the sixth feature card and reduced its visual prominence.
* Attached the settings tabs visually to the settings panel.
* Reduced desktop and smartphone previews and optimized the mobile header controls.

= 1.2.2 =
* Added a structured Wappend Pro information panel to every settings tab.
* Added automatic plugin selection to the external Pro link using the plugin slug.

= 1.2.1 =
* Removed simulated and disabled Pro controls from the Free interface.
* Replaced Pro feature previews with one compact informational panel.
* Removed the WooCommerce settings tab from the Free plugin.
* Kept all premium functionality and code outside the Free package.

= 1.2.0 =
* Reorganized the settings interface.
* Added a default-settings reset that preserves the primary WhatsApp number.
* Ensured operation feedback is displayed as a single notice.

= 1.1.0 =
* Added a redesigned settings interface with the Wappend logo and tabbed sections.
* Added label controls, display delay, minimum scroll, and custom z-index.
* Added privacy-friendly aggregate click statistics and automatic analytics events.
* Updated all included translations.
* Removed the discouraged manual text-domain loading call.
* Adjusted button sizes to improve the icon-to-background ratio.

= 1.0.1 =
* Improved desktop and smartphone preview proportions.
* Replaced the mobile browser dots with a hamburger menu.
* Added automatic cache busting for admin assets.

= 1.0.0 =
* Initial release.
