=== User Registration Stats ===
Contributors: AlixZarei
Donate link: https://alixzarei.ir/
Tags: users, statistics, analytics, registration, chart
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.2
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Track and visualize your WordPress user registration statistics with daily, monthly, and yearly insights, including graphical charts and CSV export.

== Description ==

User Registration Stats is a comprehensive plugin designed to provide WordPress site administrators with clear and actionable insights into their user acquisition trends. It automatically tracks new user sign-ups and presents this data in an intuitive dashboard within the WordPress admin area. This plugin helps you understand your user growth, identify registration patterns, and make data-driven decisions for your website.

**Key Features:**

* Daily Registration Tracking.
* Data Aggregation & Filtering by day, month, or year.
* Graphical Charts for 30-day registration trends (using bundled Chart.js).
* Basic Registration Source Tracking (Direct, Referral, UTM parameters).
* Detailed Registration Log with pagination and sorting.
* CSV Export of all registration data (handles large datasets).
* Secure Data Clearing option.
* Full Uninstallation routine for complete data removal.
* Lightweight, Optimized, and Translation Ready.

== Installation ==

1.  **Automatic Installation (Recommended):**
    * In your WordPress dashboard, navigate to `Plugins` > `Add New`.
    * Search for "User Registration Stats".
    * Click `Install Now` and then `Activate`.

2.  **Manual Installation:**
    * Download the plugin's ZIP file from its WordPress.org page.
    * In your WordPress dashboard, navigate to `Plugins` > `Add New`.
    * Click `Upload Plugin`.
    * Choose the downloaded ZIP file and click `Install Now`.
    * Activate the plugin.

3.  Once activated, a "User Stats" menu item will appear in your WordPress admin sidebar.

== Frequently Asked Questions ==

= Does this plugin track users added manually by an admin? =
Yes, it tracks all new user registrations, including those added manually, by hooking into the standard `user_register` action.

= How are registration sources tracked? =
The plugin attempts to identify sources from HTTP referrers and UTM parameters (`utm_source`, `utm_medium`, `utm_campaign`) present at registration.

= Can I clear the statistics collected by this plugin? =
Yes, the "Clear All Registration Statistics" button in the "Registration Data Management" section will remove all recorded statistics but keep the plugin functional.

= What happens when I uninstall (delete) the plugin? =
The `uninstall.php` script will run, permanently removing the plugin's custom database table and all its options.

== Screenshots ==



== Changelog ==

= 1.0.4 - 2025-06-30 =
 * [FIXED] Retrieves data formatted for the 30-day registration trend chart.

= 1.0.3 - 2025-06-28 =
* Initial public release.
