=== ARN Smart Visitor Intent ===
Contributors: arnsmart
Tags: visitor intent, lead capture, feedback, survey, analytics
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Understand visitor intent, collect responses, track analytics, and offer direct Call, Email, and WhatsApp contact options.

== Description ==

ARN Smart Visitor Intent helps WordPress site owners understand why visitors came before the first conversation begins.

A lightweight sticky bar opens into an intent panel where visitors can select their reason for visiting and optionally share contact information. Built-in display rules and triggers control when the panel appears, while analytics reveal views, opens, responses, dismissals, contact activity, and intent distribution.

The plugin also includes privacy and consent tools, CSV export, email notifications, WordPress Mail and SMTP delivery options, plus a separate contact widget for Call, Email, and WhatsApp.

= Visitor Intent Capture =

* Sticky bottom bar and expandable panel
* Editable visitor intent choices
* Optional contact form
* Editable labels, placeholders, and messages
* AJAX submission without page reload
* Spam honeypot and nonce protection

= Display Rules =

* Homepage or sitewide display
* Include or exclude selected pages
* Filter by public post type
* Logged-in and logged-out visitors
* Desktop and mobile visibility
* First-time and returning visitors

= Trigger System =

* Instant display
* Delay by seconds
* Scroll-depth trigger
* Exit-intent trigger
* Page-view trigger
* Time-on-site trigger
* Shortcode trigger
* JavaScript API trigger

= Analytics and Data =

* Views and panel opens
* Response, dismissal, and contact rates
* Intent distribution
* Weekly and monthly statistics
* Contact widget opens
* Call, Email, and WhatsApp clicks
* CSV export
* Manual and automatic response cleanup
* Manual and automatic display-cache reset

= Privacy and Consent =

* Optional consent checkbox
* Fully editable consent label and text
* WordPress policy page selector
* Modal, same-page, or new-tab policy opening
* Optional required consent before submission
* Only the acceptance status is stored

= Notifications and SMTP =

* Email notifications
* Optional notifications only when contact details are provided
* WordPress Mail delivery
* Existing SMTP plugin mode
* Detection for common SMTP plugins
* Internal SMTP configuration
* SMTP connection test

= Contact Widget =

* Separate floating contact widget
* Call action
* Email action
* WhatsApp action
* Editable title, description, and labels
* Desktop and mobile visibility
* Left or right positioning

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/arn-smart-visitor-intent`, or install the ZIP through **Plugins > Add New > Upload Plugin**.
2. Activate **ARN Smart Visitor Intent**.
3. Open **Visitor Intent > Settings**.
4. Configure the intent panel, display rules, triggers, privacy, notifications, and contact widget.
5. Review collected responses and analytics under the Visitor Intent admin menu.

== Frequently Asked Questions ==

= Is this a contact form plugin? =

Not primarily. The plugin is designed to capture visitor intent first and optionally collect contact information afterward.

= Can I display the panel only on selected pages? =

Yes. You can use homepage, sitewide, include, exclude, and post-type display rules.

= Can I control when the panel appears? =

Yes. Instant, delay, scroll, exit intent, page views, time on site, shortcode, and JavaScript triggers are available.

= Does it support GDPR or KVKK consent? =

The plugin provides configurable consent and policy-display tools. Site owners remain responsible for configuring them according to their legal requirements.

= Does it include WhatsApp? =

Yes. The Contact Widget supports Call, Email, and WhatsApp actions without requiring another floating contact plugin.

= Does internal SMTP replace my existing SMTP plugin? =

No. You can continue using WordPress Mail or an existing SMTP plugin. Internal SMTP is optional.

= Where are responses stored? =

Responses are stored in WordPress and can be reviewed, exported as CSV, cleaned manually, or removed automatically according to your settings.

== Screenshots ==

1. Visitor intent sticky bar and expanded response panel.
2. Floating Call, Email, and WhatsApp contact widget on the website.
3. Analytics dashboard with impressions, responses, contact actions, and visitor intent distribution.
4. Content settings for the sticky bar, expanded panel, and success message.
5. Trigger settings for time delay, scroll depth, exit intent, page views, and time on site.
6. Privacy and consent settings with configurable policy content and submission requirements.
7. Email notification settings with WordPress Mail, external SMTP, and internal SMTP delivery options.
8. Contact widget settings for Call, Email, WhatsApp, position, labels, and device visibility.

== Changelog ==

= 1.0.0 =
* First stable release.
* Added visitor intent capture and optional contact fields.
* Added display rules for pages, post types, devices, login state, and visitor type.
* Added instant, delay, scroll, exit-intent, page-view, time-on-site, shortcode, and JavaScript triggers.
* Added analytics, intent distribution, weekly and monthly statistics, and CSV export.
* Added response retention, cleanup, and display-cache controls.
* Added privacy consent, policy page selection, and required-consent validation.
* Added WordPress Mail, external SMTP plugin, and internal SMTP delivery methods.
* Added SMTP testing and common SMTP plugin detection.
* Added floating Contact Widget with Call, Email, and WhatsApp actions.
* Added contact-action analytics.

== Upgrade Notice ==

= 1.0.0 =
First stable release of ARN Smart Visitor Intent.
