=== Novera Smart Chat ===
Contributors: noveramedia
Tags: whatsapp, chat, floating button, analytics, utm tracking
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WhatsApp Floating Chat Button with Analytics, UTM Tracking, GA4 & Conversion Tools

== Description ==

**Novera Smart Chat** is a professional plugin that adds a powerful WhatsApp floating chat button to your website. It's not just a chat button, but also a powerful analytics and marketing tool.

🚀 **Why is this plugin different?**

= Advanced Analytics & Tracking =

* **UTM Parameter Tracking** - Automatically track your Google Ads, Facebook Ads campaigns
* **Traffic Source Analysis** - Where are they coming from? (Google, Facebook, Direct etc.)
* **Custom Conversion Codes** - Add your own Google Ads, Facebook Pixel codes
* **Detailed Statistics** - Hourly, daily, monthly reports
* **CSV Export** - Export all data to Excel

= Smart Features =

* **Automatic URL Sharing** - Automatically adds current page link to WhatsApp message
* **Working Hours System** - "We are currently online" / "We are offline" automatic messages
* **Responsive Design** - Perfect appearance on mobile and desktop
* **4 Position Options** - Place your button in any corner you want

= Marketing & Conversion =

* **Google Ads Integration** - Automatic conversion tracking
* **Facebook Pixel Support** - Easy lead tracking
* **Google Analytics 4** - Built-in event tracking
* **Custom Tracking** - Add any tracking code you want

= Easy Management =

* **User-Friendly Panel** - Tab-based easy interface
* **Live Preview** - See changes instantly
* **Test Feature** - Test your tracking codes
* **Dashboard Widget** - Quick statistics

== Installation ==

= Automatic Installation =
1. WordPress Admin → Plugins → Add New
2. Search for "Novera Smart Chat"
3. Install and activate

= Manual Installation =
1. Download `novera-smart-chat.zip` file
2. WordPress Admin → Plugins → Add Plugin
3. Select ZIP file and upload
4. Activate the plugin

= Initial Setup =
1. Go to Novera Smart Chat menu
2. Enter your WhatsApp number (with country code: 90 555 123 45 67)
3. Set button color and position
4. Set your working hours (optional)
5. Add your custom tracking codes (optional)
6. Save settings

== Frequently Asked Questions ==

= How do I add my WhatsApp number? =

From the "Basic Settings" tab, enter your phone number with country code.
Example: **90 555 123 45 67** (90 prefix for Turkey)

= How does UTM tracking work? =

The plugin automatically captures UTM parameters from the URL:
- utm_source=google → Your Google campaign
- utm_medium=cpc → Cost-per-click
- utm_campaign=summer2024 → Your campaign name

All this data appears in the Statistics section.

= How to set up Google Ads conversion tracking? =

1. Go to "Messages" tab
2. Add this code to "Custom Tracking Code" field:
```
gtag('event', 'conversion', {
    'send_to': 'AW-123456789/XXXXX',
    'value': 1.0,
    'currency': 'USD'
});
```
3. Replace AW-123456789/XXXXX with your own conversion ID

= How to integrate Facebook Pixel? =

Add this code to Custom Tracking field:
```
fbq('track', 'Contact', {
    content_name: 'WhatsApp Chat Button'
});
```

= How to set working hours? =

From "Working Hours" tab:
1. Enable working hours
2. Set start and end times
3. Select working days
4. Write your online/offline messages

= Is it mobile friendly? =

Yes! The plugin has fully responsive design:
- Optimized size for mobile
- Touch-friendly buttons
- Automatic position adjustment

= How to view statistics? =

From Novera Smart Chat → Statistics menu:
- Total click counts
- Device distribution (mobile/desktop)
- Most popular pages
- Traffic sources
- UTM campaign performance
- Hourly trend charts

== Screenshots ==

1. Basic Settings – Configure WhatsApp number, button text, and click tracking.
2. Working Hours – Define working days and hours to display the button only during active times.
3. Messages – Set online and offline message templates, and add an automatic pre-filled message.
4. Advanced Settings – Exclude specific pages, add custom tracking codes (Google Ads, Facebook Pixel, Google Analytics, etc.).
5. Statistics – View detailed reports including daily click trends, device distribution, traffic sources, and campaign performance.

== Changelog ==

= 1.0.1 =
* Fixed internationalization - Default language set to English
* Added Turkish translation support
* Improved text domain implementation
* Enhanced security measures
* Updated admin interface translations
* Fixed chart labels and analytics text
* Improved CSV export functionality

= 1.0.0 =
* Initial release

**Core Features:**
* WhatsApp floating chat button
* Automatic URL sharing
* 4 position options (corners)
* Responsive design

**Analytics & Tracking:**
* UTM parameter tracking
* Traffic source analysis
* Device type statistics
* Detailed reporting system
* CSV export feature

**Advanced Features:**
* Custom tracking code support
* Google Ads conversion tracking
* Facebook Pixel integration
* Google Analytics 4 support
* Working hours system

**Admin Panel:**
* User-friendly tab interface
* Live preview
* Dashboard widget
* Test features

== Upgrade Notice ==

= 1.0.1 =
This version fixes internationalization issues and adds proper English/Turkish language support. Please update for better multilingual compatibility.

= 1.0.0 =
First release of Novera Smart Chat. All basic and advanced features included. Don't forget to add your WhatsApp number after installation!

== Technical Details ==

= System Requirements =
* WordPress 5.0 or higher
* PHP 7.4 or higher
* MySQL 5.6 or higher
* Modern browser support

= Security =
* CSRF protection (WordPress nonce)
* XSS protection (sanitized inputs)
* SQL injection protection
* Secure code execution

= Performance =
* Optimized database queries
* Minimal CSS/JS loading
* Caching friendly code structure
* CDN compatible asset management

= Supported Languages =
* English (primary)
* Turkish
* Translation ready (.pot file included)

== Developer Info ==

**Novera Smart Chat** is developed by **Novera Media**, experts in web development and digital marketing.

🌐 **Website:** [noveramedia.com](https://noveramedia.com)
📧 **Support:** info@noveramedia.com
📱 **LinkedIn:** [Novera Media](https://www.linkedin.com/company/novera-media-agency/)

= Custom Development =
Contact us for your WordPress plugin, theme or web development projects.

= Feedback =
You can send your opinions and suggestions about the plugin to info@noveramedia.com.

== Privacy & Data Collection ==

This plugin collects the following data for analytics purposes:

**Data Collected:**
* Page URLs (which pages the button was clicked on)
* Click timestamps
* Device type (mobile/desktop)
* IP addresses (for geolocation and spam prevention)
* User agent strings
* UTM parameters (campaign tracking)
* Referrer URLs

**Data Storage:**
* All data is stored locally in your WordPress database
* No data is sent to external servers
* No personal information is shared with third parties

**Data Usage:**
* Analytics and reporting purposes only
* Improving user experience
* Campaign performance tracking

**Data Retention:**
* Click data is stored indefinitely unless manually deleted
* You can export or delete data anytime from the admin panel

**User Rights:**
* Users can request data deletion
* Data export available in CSV format
* The plugin itself does not set cookies. Third-party codes you add (e.g., GA4/Pixel) may set cookies.

**GDPR Compliance:**
* Plugin respects user privacy
* No tracking without user interaction
* All data collection is transparent and documented

**Third-Party Services:**
* WhatsApp (when users click the button)
* Google Analytics (if enabled)
* Facebook Pixel (if enabled)
* Custom tracking codes (if added by admin)

== Support ==

For support, documentation, or feature requests:
* Email: info@noveramedia.com
* Website: https://noveramedia.com
* Please include your WordPress version, PHP version, and detailed description of the issue.