=== Purralytics - Where Data Meets Compassion ===
Contributors: clawsorganization
Tags: cat rescue, colony management, TNR, animal welfare, volunteer management
Requires at least: 5.0
Tested up to: 6.4
Requires PHP: 7.4
Stable tag: 2.0.21
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Advanced cat colony management and analytics system with user authentication, colony tracking, volunteer management, and comprehensive data analytics.

== Description ==

Purralytics is a comprehensive colony analysis and tracking system (CATS) designed specifically for cat rescue organizations, TNR programs, and animal welfare groups. Manage your cat colonies, track intakes and discharges, coordinate volunteers, and gain powerful insights into your rescue operations.

= Key Features =

**Colony Management**
* Track multiple cat colonies with GPS location mapping
* Record detailed colony information (population, TNR status, feeding schedules)
* Monitor colony health and population changes over time
* Assign caregivers and manage colony access

**Intake & Discharge Tracking**
* Comprehensive intake forms for rescued cats
* Track medical information, age, gender, and condition
* Record discharge outcomes (adoption, TNR return, medical outcomes)
* Generate reports on rescue statistics

**NeoNate Care**
* Specialized feeding schedules for neonatal kittens
* Weight tracking and growth monitoring
* Feeding logs with timestamps
* Care reminders and alerts

**Volunteer Management (Deluxe Plan)**
* Time tracking for volunteer hours
* Event organization and management
* Team coordination and assignments
* Statistics and goal tracking
* Communications platform
* Administrative controls and approvals

**Analytics & Reporting**
* Visual dashboards with charts and graphs
* Export data in CSV format
* Historical data analysis
* Colony population trends
* Intake/discharge statistics

**User Roles & Permissions**
* Contributor: Can add and edit own data
* Author: Can view all data, manage own entries
* Administrator: Full access to all features and settings

= Premium Plans =

**Basic Plan**
* Colony Tracking
* Intake & Discharge Forms
* NeoNate Feeding & Weight Tracking
* Basic Analytics

**Deluxe Plan** (All Basic features plus)
* Volunteer Management Suite
  - My Time tracking
  - Events management
  - Teams coordination
  - Stats & Goals
  - Communications
  - Admin controls

**Free Trial**
* 7-day trial with full access to all Deluxe features
* Test all premium functionality before purchasing
* No commitment required

= Perfect For =

* Cat rescue organizations
* TNR (Trap-Neuter-Return) programs
* Animal welfare groups
* Community cat programs
* Foster networks
* Shelter colony management
* Volunteer coordinator teams

= Why Choose Purralytics? =

* **Designed by rescuers, for rescuers** - Built with real-world rescue experience
* **Comprehensive data** - Track every aspect of your rescue operations
* **User-friendly interface** - Intuitive design that your whole team can use
* **Secure & private** - Role-based access controls protect sensitive data
* **Mobile responsive** - Manage colonies from anywhere
* **Regular updates** - Continuous improvements and new features
* **Dedicated support** - We're here to help your rescue succeed

== Installation ==

= Manual Installation =

1. Download the plugin ZIP file
2. Log in to your WordPress admin panel
3. Navigate to Plugins > Add New > Upload Plugin
4. Choose the downloaded ZIP file and click "Install Now"
5. Activate the plugin
6. Navigate to Purralytics in your admin menu to complete setup

= After Activation =

1. Go to Purralytics > Settings in your WordPress admin
2. Configure your organization details (name, logo, tagline)
3. Set up user roles and permissions
4. Create a page with the `[claws_app]` shortcode to display the app
5. Start adding colonies and tracking your rescue data!

== Frequently Asked Questions ==

= Is there a free trial? =

Yes! We offer a 7-day free trial with full access to all Deluxe plan features. This lets you test the complete volunteer management suite before committing to a plan.

= What's the difference between Basic and Deluxe plans? =

**Basic Plan** includes colony tracking, intake/discharge forms, and NeoNate care features - everything you need for core colony management.

**Deluxe Plan** adds our complete volunteer management suite with time tracking, event organization, team coordination, statistics, communications, and admin controls.

= Can multiple users access the same data? =

Yes! Purralytics is built for team collaboration. Administrators can see all data, Authors can view all colonies and manage their own entries, and Contributors can add and edit their own records. Each user has secure login credentials.

= Is my data secure? =

Absolutely. Purralytics uses WordPress's built-in user authentication and role-based permissions. All data is stored securely in your WordPress database, and you have complete control over who can access what information.

= Can I export my data? =

Yes! You can export your colony, intake, and discharge data in CSV format for use in spreadsheets or other applications.

= Do I need coding knowledge to use Purralytics? =

No! Purralytics is designed to be user-friendly with an intuitive interface. Simply install the plugin, add the shortcode to a page, and you're ready to start tracking your rescue data.

= Does it work on mobile devices? =

Yes! Purralytics is fully responsive and works great on phones and tablets, so you can update colony information from the field.

= Can I customize the colors and branding? =

Yes! In the Settings page, you can upload your organization's logo, set custom colors, and customize the tagline to match your branding.

= What if I need help? =

We provide support through our help desk. Premium plan users receive priority support. We also maintain comprehensive documentation to help you get the most out of Purralytics.

= Can I upgrade or downgrade my plan? =

Yes! You can upgrade from Basic to Deluxe at any time. Your data will remain intact when changing plans.

= What happens if I cancel my subscription? =

Your data remains in your WordPress database. If you cancel, you'll lose access to premium features but your colony, intake, and discharge records will be preserved.

== Screenshots ==

1. Main Dashboard - Track all your colonies at a glance with visual stats and quick actions
2. Colony Tracking - Detailed colony information with GPS mapping and population data
3. Intake Forms - Comprehensive cat intake forms with medical history and photos
4. Discharge Management - Track outcomes and generate adoption/TNR statistics
5. NeoNate Care - Specialized feeding schedules and weight tracking for kittens
6. Volunteer Management (Deluxe) - Coordinate your volunteer team with time tracking and events
7. Analytics Dashboard - Visual charts showing rescue trends and statistics
8. Mobile Responsive - Manage colonies from anywhere on any device

== Changelog ==

= 2.0.21 - 2024-12-04 =
* Added: Freemius integration with Basic and Deluxe plan tiers
* Added: 7-day free trial with full feature access
* Added: Trial countdown banner for trial users
* Added: Upgrade prompts and teasers for Basic plan users
* Added: Plan badge in WordPress admin dashboard
* Added: Feature usage analytics and tracking
* Added: JavaScript protection for plan-restricted features
* Added: Professional animations and UI polish
* Improved: User experience with clear plan differentiation
* Fixed: Minor UI inconsistencies

= 2.0.20 - 2024-11-15 =
* Enhanced: Colony history tracking with timeline view
* Added: Bulk export functionality for discharge data
* Improved: Mobile responsiveness across all screens
* Fixed: Date picker issues in Safari browser

= 2.0.19 - 2024-11-01 =
* Added: NeoNate feeding schedule templates
* Enhanced: Weight tracking with growth charts
* Improved: User role permissions system
* Fixed: Colony map marker clustering on zoom

= 2.0.18 - 2024-10-15 =
* Added: Custom fields for colony data
* Enhanced: Search and filter capabilities
* Improved: Performance optimization for large datasets
* Fixed: CSV export formatting issues

= 2.0.17 - 2024-10-01 =
* Initial public release
* Core features: Colony tracking, Intake/Discharge forms, NeoNate care
* User authentication and role-based permissions
* Basic analytics and reporting

== Upgrade Notice ==

= 2.0.21 =
Major update! Adds Freemius integration with tiered plans, free trial, and extensive UX improvements. Backup before upgrading.

= 2.0.20 =
Adds colony history timeline and bulk export features. Recommended update for all users.

== Additional Information ==

= Requirements =
* WordPress 5.0 or higher
* PHP 7.4 or higher
* MySQL 5.6 or higher
* Modern web browser (Chrome, Firefox, Safari, Edge)

= Translations =
* English (US) - Default
* Translations welcome! Contact us to contribute

= Privacy =
Purralytics stores all data locally in your WordPress database. We do not collect or transmit any rescue data to external servers. The only external connection is to Freemius for license management and payments.

= Support =
* Documentation: Included in plugin
* Support:  Available at clawsva@gmail.com
* Premium Support: Available for Deluxe plan subscribers
* Email: Contact through Freemius dashboard

= Links =
* Website: https://clawsva.org
* Documentation: Included in plugin
* Support: https://freemius.com/

== Credits ==

Purralytics is developed by the CLAWS Organization team with support from cat rescue volunteers and TNR coordinators across the country. Special thanks to all the rescuers who provided feedback and feature requests during development.

Built with love for cats and the people who save them. 
