=== ARN Smart Visitor Intent ===
Contributors: arnsmart
Tags: lead generation, visitor analytics, exit intent, customer feedback, whatsapp
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Capture visitor intent, collect leads and feedback, trigger targeted panels, track analytics, and offer Call, Email, or WhatsApp.

== Description ==

ARN Smart Visitor Intent is a WordPress lead-capture, customer-feedback, and visitor-analytics plugin that helps site owners understand why visitors arrived before the first conversation begins.

A lightweight sticky bar opens an intent panel where visitors can select their reason for visiting, leave a message, and optionally share contact information. Flexible display rules and triggers determine when the interaction appears, while local analytics reveal views, opens, responses, dismissals, contact activity, intent distribution, trigger performance, and funnel behavior.

The Free edition also includes privacy and consent controls, CSV export, email notifications, WordPress Mail and optional SMTP delivery, data cleanup tools, and a separate floating contact widget for Call, Email, and WhatsApp.

== 🚀 Core Features ==

* ✅ Sticky visitor-intent bar and expandable panel
* ✅ Editable visitor reasons and response options
* ✅ Optional name, email, phone, and message collection
* ✅ AJAX submission without page reload
* ✅ Homepage, sitewide, include, exclude, and post-type rules
* ✅ Logged-in and logged-out visitor rules
* ✅ Desktop and mobile visibility
* ✅ First-time and returning visitor detection
* ✅ Instant, delay, scroll-depth, and exit-intent triggers
* ✅ Page-view and time-on-site triggers
* ✅ Shortcode and JavaScript activation
* ✅ Views, opens, responses, dismissals, and contact rates
* ✅ Intent distribution and period statistics
* ✅ Call, Email, and WhatsApp action tracking
* ✅ CSV export and response cleanup
* ✅ Consent checkbox and policy-page integration
* ✅ Email notifications and optional SMTP configuration
* ✅ Separate floating contact widget
* ✅ Nonce and honeypot protection

== 🎯 Visitor Intent Capture ==

Ask a short, purposeful question before requesting contact information. Editable response options help visitors identify what they need, while optional fields allow interested people to continue with a message or direct contact.

Good intent choices are clear, mutually understandable, and connected to actions the website team can actually take. Avoid long lists that make the panel feel like a survey.

Recommended workflow:

1. Define the most important visitor reasons.
2. Write a short question and clear response labels.
3. Decide which contact fields are genuinely required.
4. Configure consent and the relevant policy page.
5. Test the panel on desktop and mobile.
6. Review responses and refine choices using real data.

== ⚡ Display Rules and Triggers ==

Control where, when, and for whom the panel appears.

Available targeting includes:

* homepage or sitewide display
* included or excluded pages
* supported public post types
* logged-in or logged-out visitors
* desktop or mobile visitors
* first-time or returning visitors

Available activation methods include instant display, delay by seconds, scroll depth, exit intent, page views, time on site, shortcode placement, and JavaScript activation.

Use the least intrusive trigger that matches the page purpose. A panel shown too early or too frequently can reduce participation rather than improve it.

== 📊 Analytics and Visitor Intelligence ==

The analytics workspace measures supported interaction signals:

* panel views and opens
* responses and dismissals
* response and contact rates
* intent distribution
* weekly and monthly statistics
* contact-widget opens
* Call, Email, and WhatsApp clicks
* trigger and page performance
* basic funnel and abandonment visibility
* first-time and returning visitor comparisons

Analytics represent recorded interactions, not guaranteed unique people, leads, purchases, or business outcomes.

== 🔒 Privacy, Consent, and Data Control ==

* Optional consent checkbox
* Editable consent label and supporting text
* WordPress policy-page selector
* Modal, same-page, or new-tab policy opening
* Optional required consent before submission
* Stored acceptance status
* Manual and automatic response cleanup
* Manual and automatic display-cache reset
* CSV formula-injection protection for visitor-controlled values

The plugin provides configuration tools; it does not guarantee legal compliance. Site owners remain responsible for determining what data they collect, writing appropriate notices, choosing retention periods, and meeting applicable GDPR, KVKK, or other requirements.

== ✉️ Notifications and SMTP ==

Choose WordPress Mail, an existing SMTP plugin, or the optional internal SMTP configuration. Notifications can be limited to responses containing contact information, and the SMTP test helps verify delivery settings.

Internal SMTP does not need to replace a working external SMTP plugin. Use one deliberate delivery path and test it before relying on notifications.

== 📞 Floating Contact Widget ==

The separate contact widget provides direct Call, Email, and WhatsApp actions with editable titles, descriptions, labels, desktop/mobile visibility, and left/right positioning.

The intent panel and contact widget can serve different needs: the intent panel captures structured reasons and optional details, while the contact widget gives visitors an immediate communication path.

== ⭐ Upgrade to ARN Smart Visioix Pro ==

[ARN Smart Visioix](https://arnsmart.com/visioix/) is the professional visitor and website intelligence system for teams that need advanced forms, conditional journeys, lead scoring, connected website data, strategy, testing, automation, forecasting, and reporting.

Visioix Pro expands the Free workflow with capabilities such as:

* ⚡ **Visual Form Builder** — create multi-step forms with unlimited questions, sections, repeatable fields, progress indicators, previews, and reusable structures.
* ⚡ **Conditional Logic** — build IF/ELSE, AND/OR, nested, intent-based, and answer-based journeys with dynamic fields, contact methods, messages, and redirects.
* ⚡ **Advanced Visitor Intelligence** — analyze intent by page, content, device, visitor type, time, trigger, contact channel, segment, value, and abandonment.
* ⚡ **Funnel and Lead Intelligence** — track step-by-step drop-off, diagnose friction, score leads, detect purchase intent, and prioritize follow-up.
* ⚡ **Website Intelligence** — connect supported Google Site Kit, Analytics, and Search Console data to traffic, engagement, visibility, page, product, and query diagnosis.
* ⚡ **PMI, SWOT, and Action Planning** — turn evidence into prioritized This Week, This Month, and Next Month plans with impact, effort, risk, and review criteria.
* ⚡ **Trends and Forecasting** — compare periods, detect breaks and anomalies, forecast traffic, visibility, leads, and conversions, and show confidence ranges.
* ⚡ **A/B Testing** — test questions, headlines, CTAs, colors, designs, layouts, triggers, and form steps with scheduled traffic distribution and segment results.
* ⚡ **Automation and Integrations** — connect email, CRM, Zapier, Make, REST API, webhooks, Slack, Discord, field mappings, logs, and retries.
* ⚡ **Custom Reporting** — create executive and intelligence reports, export CSV/PDF, schedule delivery, preserve insight history, and measure expected versus actual impact.

Learn more: [Explore ARN Smart Visioix](https://arnsmart.com/visioix/)

== 🆓 Free vs ARN Smart Visioix Pro ==

The Free edition provides the essential visitor-intent workflow:

* ✅ intent questions and response options
* ✅ optional contact and message collection
* ✅ display rules and advanced triggers
* ✅ essential visitor analytics
* ✅ consent, privacy, cleanup, and CSV export
* ✅ email notifications and SMTP options
* ✅ Call, Email, and WhatsApp contact widget

Visioix Pro is designed for deeper intelligence and action:

* ⭐ multi-form and multi-step visual building
* ⭐ conditional visitor journeys
* ⭐ segmentation, funnels, lead scoring, and AI-supported interpretation
* ⭐ website performance and search intelligence
* ⭐ PMI, SWOT, priorities, and action plans
* ⭐ forecasting and early warnings
* ⭐ visitor and website A/B testing
* ⭐ automations, integrations, and professional reporting

== 🔗 Other ARN Smart Products ==

* **ARN Smart Image Optimizer / [ARN WebPix](https://arnsmart.com/webpix/)** — local image optimization in Free; advanced discovery, coverage, queues, delivery, and diagnostics in Pro.
* **ARN Smart Content Toolkit / [ARN Clonex](https://arnsmart.com/clonex/)** — controlled draft preparation in Free; structured duplication, datasets, bulk production, and builder-aware workflows in Pro.
* **ARN Smart URL Manager / [ARN Linkix](https://arnsmart.com/linkix/)** — short links, redirects, QR codes, and local analytics in Free; campaigns, advanced QR, analytics, and maintenance in Pro.
* **ARN Smart Elementor Site Utilities / [ARN Smart Vendix](https://arnsmart.com/vendix/)** — essential Elementor widgets and site utilities in Free; advanced widgets, design systems, protection, and website operations in Pro.

Explore all products at [ARN Smart](https://arnsmart.com/).

== Installation ==

1. Install the plugin through the WordPress Plugins screen or upload it to `/wp-content/plugins/arn-smart-visitor-intent/`.
2. Activate ARN Smart Visitor Intent.
3. Open Visitor Intent > Settings.
4. Configure content, response choices, optional contact fields, and consent.
5. Set display rules and triggers.
6. Configure notifications and the optional contact widget.
7. Test the complete visitor journey on desktop and mobile.
8. Review responses and analytics from the Visitor Intent administration menu.

== Frequently Asked Questions ==

= Is this primarily a contact form plugin? =

No. It captures visitor intent first and can optionally collect contact information afterward.

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

Yes. Use homepage, sitewide, include, exclude, and supported post-type rules.

= Can I control when it appears? =

Yes. Available triggers include instant, delay, scroll, exit intent, page views, time on site, shortcode, and JavaScript activation.

= Does it support GDPR or KVKK consent? =

It provides configurable consent and policy-display tools. Site owners remain responsible for their legal configuration and obligations.

= Does it include WhatsApp? =

Yes. The floating contact widget supports Call, Email, and WhatsApp actions.

= Does internal SMTP replace my existing SMTP plugin? =

No. Continue using WordPress Mail or an existing SMTP plugin when appropriate. Internal SMTP is optional.

= Where are responses stored? =

Responses are stored in WordPress and can be reviewed, exported, or removed according to configured retention controls.

= What does Visioix Pro add? =

Visioix adds advanced forms and logic, visitor and funnel intelligence, lead scoring, connected website data, PMI/SWOT planning, forecasts, tests, automations, integrations, reports, licensed updates, and priority support.

== Screenshots ==

1. Visitor-intent sticky bar and expandable panel.
2. Editable intent content and response options.
3. Display rules and trigger configuration.
4. Analytics dashboard and intent distribution.
5. Visitor Intelligence and funnel visibility.
6. Privacy and consent settings.
7. Notifications and SMTP settings.
8. Floating Call, Email, and WhatsApp contact widget.

== External Services ==

The Free edition stores responses and supported analytics in WordPress. It may send administrator-configured email notifications through WordPress Mail, an active SMTP plugin, or the optional SMTP server entered by the site owner. No ARN Smart license connection is required.

== Changelog ==

= 2.0.3 =

* Added WordPress 7.1 compatibility.
* Batched large response exports and deletion operations.
* Preserved CSV formula-injection protection.
* Standardized ARN Smart product discovery.

= 2.0.2 =

* Removed obsolete and duplicate admin styling without changing rendered behavior.

= 2.0.1 =

* Added the shared Visioix administration measurement and layout system.

= 2.0.0 =

* Added Visitor and Website Intelligence foundations, period comparisons, highlights, response intelligence, funnels, AI-assisted insight workflows, privacy controls, notifications, SMTP, contact actions, advanced triggers, cleanup, export, credential protection, and broad stability improvements.

= 1.0.0 =

* Initial stable visitor-intent, analytics, consent, notification, trigger, export, and contact-widget release.

== Upgrade Notice ==

= 2.0.3 =

Adds WordPress 7.1 compatibility and safer processing for large response histories.
