Fandoogh WP Tracker

A professional, lightweight, and modern Analytics & Event Tracking plugin for WordPress with real-time data and a dark-mode dashboard.

🌟 Features

Fandoogh WP Tracker is designed to provide you with the most crucial analytics without bloating your WordPress database or slowing down your site.

• Real-Time Analytics: Monitor active visitors in real-time (last 5 minutes) directly from the dashboard.
• Auto Link Tracking: Automatically tracks clicks on Phone numbers (tel:), Emails (mailto:), WhatsApp links (wa.me, api.whatsapp.com), and file downloads (.pdf, .zip, .doc) without any extra code.
• Custom Event Tracking: Easily track custom button clicks and form submissions using a simple HTML data attribute (data-fando-track="true").
• High Performance: Uses custom optimized database tables instead of WordPress wp_posts or wp_postmeta.
• Smart Aggregation: A built-in Cron Job runs nightly to aggregate raw data into lightweight daily stats, automatically cleaning up old raw data (e.g., older than 90 days) to keep your database lean.
• Beautiful Dark Dashboard: A modern, Material Design inspired dark theme dashboard with neon blue accents and dynamic Chart.js integration.
• Detailed Reports: View top visited pages and specific pages where contact buttons (Phone, WhatsApp, Email) were clicked.
• CSV Export: Export your daily aggregated stats to CSV with one click, filtering by date ranges.
• Safe Uninstall: Optionally delete all tracking data automatically upon plugin uninstallation to keep your server clean.

🚀 Installation

1. Download the latest version of the plugin as a .zip file from this repository.
2. Go to your WordPress Admin Panel -> Plugins -> Add New -> Upload Plugin.
3. Upload the .zip file and click Install Now.
4. Activate the plugin.
5. The Fandoogh Analytics dashboard will appear in your WordPress sidebar.

🛠 Usage & Custom Tracking

1. Automatic Tracking

No configuration needed! The plugin automatically detects and tracks clicks on:

• WhatsApp links (wa.me/...)
• Phone numbers (tel:0912...)
• Email links (mailto:...)
• File downloads (.zip, .pdf, etc.)
• Outbound links (links leading away from your domain)

2. Custom Button Tracking

If you want to track a custom button (e.g., "Add to Cart" or "Submit Form"), simply add the data-fando-track="true" attribute to the HTML element.

<button data-fando-track="true">Add to Cart</button>

Advanced Custom Tracking: You can optionally provide a custom event name, category, and action for more detailed reporting.

<a href="#" 
   data-fando-track="true" 
   data-fando-event="add_to_cart" 
   data-fando-category="ecommerce">
   Buy Now
</a>

📊 Database Architecture

To ensure zero performance impact on your WordPress site, Fandoogh Analytics uses 7 custom lightweight tables:

• wp_fando_visitors: Unique visitors (Cookie-based UUID).
• wp_fando_sessions: Session tracking (30 min inactivity timeout).
• wp_fando_pageviews: Raw pageview logs.
• wp_fando_events: Raw event logs (Clicks, conversions).
• wp_fando_daily_stats: Aggregated fast-read daily statistics.
• wp_fando_daily_pages: Aggregated top pages.
• wp_fando_daily_events: Aggregated top events.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

📝 License

This project is licensed under the MIT License.