WP Manifestindependent plugin directory
manifest / analytics / fandoogh-wp-tracker

Fandoogh Analytics

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

by Fando · github.com/altafishahram/fandoogh-wp-tracker · website

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/altafishahram/fandoogh-wp-tracker/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/altafishahram/fandoogh-wp-tracker ↗
Fandoogh WP Tracker

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.