=== Donation Amount Tracker === Contributors: typecta Donate link: https://typecta.com/plugins/donation-amount-tracker Tags: donations, woocommerce, tracking, progress bar Requires at least: 5.2 Tested up to: 6.7 Stable tag: 1.3.0 Requires PHP: 7.2 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html WC requires at least: 3.0 WC tested up to: 8.0 Track and display donation amounts from WooCommerce orders with a customizable display and progress bar. == Description == Donation Amount Tracker is a WordPress plugin that helps you track and display donation amounts from your WooCommerce orders. It provides flexible options for calculating donations based on orders or products and offers multiple display styles including a customizable progress bar. **Key Features:** * Calculate donations per order or per product * Display total donations with customizable text * Progress bar with goal tracking * Campaign mode with date range filtering * Customizable colors and styling * Shortcode support for easy integration * Initial amount and multiplier options * Live AJAX updates * Object-oriented architecture * Secure and optimized code * Compatible with WooCommerce HPOS == Installation == 1. Upload the plugin files to the `/wp-content/plugins/donation-amount-tracker` directory, or install the plugin through the WordPress plugins screen directly. 2. Activate the plugin through the 'Plugins' screen in WordPress. 3. Go to the Donation Amount menu in your admin panel to configure the plugin. 4. Place the shortcode `[donamt_donation_amount]` in your posts, pages, or widgets to display the donation amount. == Frequently Asked Questions == = How are donations calculated? = Donations can be calculated in two ways: 1. Per Order: Each completed order counts as one donation. 2. Per Product: Each product in completed orders counts as one donation. You can set a donation value (e.g., $1 per order/product) and apply a multiplier if needed (e.g., for matching donations). = How can I customize the display? = You can choose from three display types: 1. Simple Text: Basic text display of the donation amount. 2. Styled Text: Text with custom styling. 3. Progress Bar: Shows progress toward a goal amount. You can also customize the prefix and suffix text, and add custom CSS. = Does this require WooCommerce? = Yes, this plugin requires WooCommerce to be installed and activated as it uses WooCommerce orders to calculate donation amounts. = Can I set an initial amount? = Yes, you can set an initial amount to account for existing donations or to start your campaign with a specific amount. = How do I use the shortcode? = Use the `[donamt_donation_amount]` shortcode to display the donation amount on any post, page, or widget. You can customize the display with attributes: `[donamt_donation_amount display_type="progress" prefix="We've raised " suffix=" so far!"]` Available attributes: - display_type: "text", "styled", or "progress" - prefix: Text to display before the amount - suffix: Text to display after the amount = Can I limit donations to a specific time period? = Yes, the campaign mode feature allows you to track donations for all time or within a specific date range that you define. == Screenshots == 1. Settings page with calculation options 2. Display settings with customization options 3. Progress bar display example 4. Shortcode usage example == Changelog == = 1.3.0 = * Added: Proper object-oriented architecture following WordPress plugin standards * Added: Class-based structure for better organization and maintainability * Added: Dedicated calculator class for donation calculations * Added: Campaign mode with date range filtering for donations * Added: Support for WooCommerce High-Performance Order Storage (HPOS) * Added: Detailed order breakdown in calculation results * Added: Automatic version checking and upgrade routines * Changed: Completely refactored codebase into proper class structure * Changed: Improved code organization with separate files for each responsibility * Changed: Enhanced plugin structure with proper directory organization * Changed: Removed all translation functions for simplified codebase * Changed: Removed text domain references throughout the plugin * Changed: Enhanced progress bar display with customizable colors and goal tracking * Fixed: Uninstall process now properly removes all plugin options * Fixed: Consistent naming conventions throughout the codebase * Fixed: Proper sanitization and validation for all user inputs * Fixed: Compatibility issues with latest WordPress and WooCommerce versions * Fixed: Display formatting issues in various themes = 1.2.5 = * Added: Compatibility with WooCommerce High-Performance Order Storage (HPOS) * Changed: Updated version number and documentation = 1.2.4 = * Security: Added nonce verification for all form submissions * Security: Improved data sanitization and validation * Security: Enhanced output escaping * Changed: Updated function prefixes for uniqueness * Changed: Improved code organization * Fixed: Text domain consistency * Fixed: Asset loading * Fixed: Function naming conventions = 1.2.3 = * Added: Progress bar display option * Added: Custom CSS support * Added: AJAX live updates * Changed: Improved settings page layout * Changed: Enhanced calculation accuracy = 1.2.2 = * Fixed: WooCommerce compatibility issues * Fixed: Display formatting issues * Fixed: Minor bug fixes = 1.2.1 = * Added: Display customization options * Added: Prefix and suffix text settings * Added: Multiple display types * Changed: Improved admin interface * Changed: Enhanced performance = 1.1.0 = * Added: Initial amount setting * Added: Multiplier option * Added: Per-product calculation option * Changed: Improved calculation methods * Changed: Better WooCommerce integration = 1.0.0 = * Initial release == Upgrade Notice == = 1.3.0 = Major update with improved code organization, new campaign mode with date filtering, enhanced progress bar, and better WooCommerce compatibility. Translation functions removed for simplified codebase. = 1.2.5 = This update adds compatibility with WooCommerce High-Performance Order Storage (HPOS). = 1.2.4 = This update includes important security improvements and code organization enhancements.