=== Maximum Products per User for WooCommerce Pro ===
Contributors: wpcodefactory
Tags: woocommerce, product quantity, woo commerce
Requires at least: 4.4
Tested up to: 5.6
Stable tag: 3.5.0
License: GNU General Public License v3.0
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Limit number of items your WooCommerce customers can buy (lifetime or in selected date range).

== Description ==

**Maximum Products per User for WooCommerce** plugin lets you limit number of items your WooCommerce customers can buy (lifetime or in selected date range).

= Main Features =

* Set **maximum products** number **per user**.
* Select plugin mode: product **quantities**, product **orders**, product **prices** (including or excluding taxes), product **weights**, or product **volumes**.
* Set **date range** (for example: lifetime, this month, this year, last 30 days, last 365 days, or custom date range).
* Set on which **order statuses** product data should be updated.
* Set different maximum product limits for different **user roles**.
* Enable variable products **variations** usage.
* Customize **customer message** on frontend.
* **Block checkout page** on exceeded limits.
* **Exclude products** from plugin scope.
* **Edit** and **export** each user's **sales data**.
* Choose which **payment gateways** should update product data.
* **Display** remaining amount, maximum limits, etc. to the users in cart, checkout, single product page, "My account", or with shortcode anywhere on your site.
* **Identify guests by IP address** or **block guests** from buying products in your shop.
* **Hide products** with exceeded limits for the current user.
* Enable **multi-language** support (WPML, Polylang).
* And more...

= Premium Version =

With [Maximum Products per User for WooCommerce Pro](https://wpfactory.com/item/maximum-products-per-user-for-woocommerce/) plugin you can set maximum products per user:

* Per product **category**.
* Per product **tag**.
* Per **individual** product.
* By **formula**, for example: per **user ID**, per **membership** plan, per **payment method**, etc.

= More =

* We are open to your suggestions and feedback. Thank you for using or trying out one of our plugins!
* [Visit plugin site](https://wpfactory.com/item/maximum-products-per-user-for-woocommerce/).

== Installation ==

1. Upload the entire plugin folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Start by visiting plugin settings at "WooCommerce > Settings > Maximum Products per User".

== Changelog ==

= 3.5.0 - 15/12/2020 =
* Fix - Mode - Product prices (incl. tax) - Validate on add to cart - Always including taxes in product price now.
* Dev - General - "Multi-language" option added ("WPML", "Polylang").
* Dev - General - Mode - "Product prices (excl. tax)" option added (and "Product prices" option renamed to "Product prices (incl. tax)").
* Dev - General - Mode - "Product orders" option added.
* Dev - General - Mode - "Product volumes" option added.
* Dev - General - User roles - "Enabled user roles" option added.
* Dev - General - "Count by current payment method" option added.
* Dev - Placeholders - `%payment_method_title%` placeholder added.
* Dev - Data - Saving order payment method in product in product/term sales data now.
* Dev - Formula - `payment_method` shortcode attribute added.
* Dev - Advanced - "Lifetime from totals" option added (defaults to `no`). This changes the previous behaviour in plugin, where lifetime data was always retrieved from totals.
* Dev - Developers - `alg_wc_mppu_data_product_or_term_id` filter added.
* Dev - Developers - `alg_wc_mppu_get_cart_item_amount_by_term` filter added.
* Dev - Developers - `alg_wc_mppu_get_cart_item_amount_by_parent` filter added.
* Dev - Developers - `alg_wc_mppu_cart_item_amount` filter added.
* Dev - Developers - `alg_wc_mppu_user_already_bought_do_count_order` filter added.
* Dev - Developers - `alg_wc_mppu_user_already_bought` filter added.
* Dev - Developers - `alg_wc_mppu_get_max_qty` - Filter applied to empty (i.e. zero) result as well now.
* Dev - Admin settings descriptions updated.
* Dev - Code refactoring.
* WC tested up to: 4.8.
* Tested up to: 5.6.

= 3.4.0 - 01/12/2020 =
* Fix - Formula - `product_sku` attribute - Product variable is now correctly reset for each new product check.
* Dev - General - Guests - "Identify guests by IP address" option added ("Block guests" option renamed to "Guests", option type changed from `checkbox` to `radio`).
* Dev - General - "Hide products" option added.
* Dev - General - Date range - "Custom date range unit" option added.
* Dev - Frontend - Cart notice - "Cart notice type" option added.
* Dev - Frontend - Cart notice - "As text" value added (option type changed from `checkbox` to `select`).
* Dev - Frontend - My Account - "Tab content" option added.
* Dev - Admin - "Export" section added, including "export sales data for all users" link and "export sales data" link (for "Editable sales data").
* Dev - Advanced - "Time function" defaults to "Local (WordPress) time" now (was defaulting to "Coordinated Universal Time (UTC)").
* Dev - Developers - `alg_wc_mppu_get_notice_placeholders` filter added.
* Dev - Localization - `load_plugin_textdomain` moved to the `init` hook.
* Dev - Admin settings descriptions updated.
* Dev - Code refactoring.
* Plugin author updated.
* WC tested up to: 4.7.

= 3.3.2 - 18/10/2020 =
* Fix - Shortcodes - `[alg_wc_mppu_user_product_limits]` - Negative values replaced with zero in "Remaining" and "Max" columns.
* Dev - Frontend - My Account - "Tab icon" option added.
* Dev - Frontend - My Account - Admin settings restyled.
* Dev - Minor code refactoring.
* WC tested up to: 4.6.

= 3.3.1 - 14/10/2020 =
* Dev - Frontend - My Account - Shortcodes are now processed in tab title.

= 3.3.0 - 08/10/2020 =
* Fix - Allowing negative value (i.e. `-1`) in all limits settings now.
* Fix - Variable products - If "Use variations" option is disabled, plugin was incorrectly counting variation's quantity for the initial order. This is fixed now.
* Dev - Formula - Math expressions are now evaluated in formulas.
* Dev - Formula - `[alg_wc_mppu_user_bought]` shortcode added.
* Dev - Frontend - Single product page (and `[alg_wc_mppu_current_product_limit]` shortcode) - Placeholders added: `%in_cart%`, `%bought_plus_in_cart%`, `%remaining_minus_in_cart%`; also (for consistency): `%adding%`, `%in_cart_plus_adding%`, `%bought_plus_in_cart_plus_adding%`, `%remaining_minus_in_cart_minus_adding%`.
* Dev - General - "Order statuses: Delete" option added.
* Dev - "Use variations" added to **per product** settings.
* Dev - Admin settings descriptions updated.
* Dev - Core - `alg_wc_mppu_get_first_order_date_exp` filter added.
* Dev - Code refactoring.
* Tested up to: 5.5.
* WC tested up to: 4.5.

= 3.2.5 - 23/07/2020 =
* Fix - Formula - "All products" limit value was used as a fallback for the formula even if "All products" option was disabled. This is fixed now.
* Dev - Frontend - "Multiple notices" option added.

= 3.2.4 - 21/07/2020 =
* Fix - Taxonomy filters fixed.
* Dev - Code refactoring.

= 3.2.3 - 11/07/2020 =
* Fix - Converting order date according to "Advanced > Time function" option now.
* Dev - Advanced - Time function - Options renamed ("Server time" to "Coordinated Universal Time (UTC)", and "WordPress time" to "Local (WordPress) time").
* Dev - Formula - `product_sku` attribute added to the `[alg_wc_mppu]` shortcode.
* Dev - Code refactoring.
* WC tested up to: 4.3.

= 3.2.2 - 03/07/2020 =
* Dev - Shortcodes - `[alg_wc_mppu_placeholder]` shortcode added.

= 3.2.1 - 22/06/2020 =
* Dev - Frontend - Placeholders - `%first_order_date_exp%`, `%first_order_date%` - Getting date and time format from WordPress settings now (i.e. instead of hard-coded `Y-m-d H:i:s`).

= 3.2.0 - 18/06/2020 =
* Dev - Frontend - Customer message (and `[alg_wc_mppu_current_product_limit]`, `[alg_wc_mppu_term_limit]` shortcodes) - `%first_order_date%`, `%first_order_amount%`, `%first_order_date_exp%`, `%first_order_date_exp_timeleft%` placeholders added.
* Dev - Frontend - Single product page - "Text in product description" option added.
* Dev - Formula - `[alg_wc_mppu]` - Getting time for `start_date` and `end_date` shortcode attributes according to "Advanced > Time function" option now.
* WC tested up to: 4.2.

= 3.1.1 - 22/05/2020 =
* Dev - General - Block guests - Outputting message on AJAX add to cart now.
* Dev - Frontend - Customer message - `%in_cart%`, `%bought_plus_in_cart%`, `%remaining_minus_in_cart%`, `%adding%`, `%in_cart_plus_adding%`, `%bought_plus_in_cart_plus_adding%`, `%remaining_minus_in_cart_minus_adding%`, `%term_name%` placeholders added.

= 3.1.0 - 08/05/2020 =
* Dev - Formula - `is_downloadable`, `is_virtual` attributes added to the `[alg_wc_mppu]` shortcode.
* Dev - Formula - `start_date`, `end_date`, `not_date_limit` attributes added to the `[alg_wc_mppu]` shortcode.
* Dev - Formula - Admin settings descriptions updated.
* Dev - `[alg_wc_mppu_term_limit]` shortcode added.
* Dev - `alg_wc_mppu_date_to_check` filter - `product_or_term_id`, `current_user_id` and `is_product` params added.
* Dev - Code refactoring.
* WC tested up to: 4.1.

= 3.0.1 - 29/04/2020 =
* Fix - Formula - Shortcode bug (`limit` attribute vs deprecated `max_qty` attribute) fixed.
* Dev - Frontend - Single product page - Default message updated (from "The remaining quantity for..." to "The remaining amount for...").
* Dev - Reports - Sales Data - Column title updated (from "Qty" to "Bought").

= 3.0.0 - 14/04/2020 =
* Dev - General - "Mode" option added (with possible options: "Product quantities" (default), "Product prices" and "Product weights").
* Dev - Frontend - Default values for the "Customer message" and "Single product page" messages updated (`pcs.` removed; placeholders changed (`%max_qty%` to `%limit`, `%qty_already_bought%` to `%bought%`, `%remaining_qty%` to `%remaining%`)).
* Dev - Frontend - My Account - "Tab id" option added (defaults to `product-limits`).
* Dev - Frontend - My Account - "Tab title" option added (defaults to `Product limits`).
* Dev - Frontend - My Account - Default tab title changed from "Quantities" to "Product limits".
* Dev - Formula - Shortcode renamed (from `[alg_wc_mppu_max_qty]` to `[alg_wc_mppu]`); `max_qty` attribute renamed to `limit`.
* Dev - `[alg_wc_mppu_user_product_quantities]` shortcode renamed to `[alg_wc_mppu_user_product_limits]`.
* Dev - `[alg_wc_mppu_current_product_quantity]` shortcode renamed to `[alg_wc_mppu_current_product_limit]`.
* Dev - Admin settings descriptions updated ("... quantities..." changed to "... limits..." etc.). "Quantities" section renamed to "Limits".
* Dev - "Reset settings" admin notice updated.
* Tested up to: 5.4.

= 2.6.0 - 23/03/2020 =
* Dev - General - "Block guests" options added.
* Dev - Admin settings restyled and descriptions updated.
* Dev - Minor code refactoring.

= 2.5.2 - 13/03/2020 =
* Dev - Advanced - "Duplicate product" option added (defaults to `no`).
* WC tested up to: 4.0.

= 2.5.1 - 05/03/2020 =
* Fix - General - Payment gateways - Now checking chosen payment gateway when validating quantities (in `Alg_WC_MPPU_Core::check_quantities()`).
* Dev - Frontend - "Cart notice" option added.
* Dev - Frontend - Single product page - "Text" option added (and option renamed from "Permanent notice").
* Dev - Frontend - Single product page - Now replacing negative max qty with zero.
* Dev - `[alg_wc_mppu_current_product_quantity]` shortcode added.

= 2.5.0 - 28/02/2020 =
* Fix - Core - `get_user_already_bought_qty()` - Making sure that the returned value is always numeric (i.e. returning zero instead of empty).
* Fix - Core - `alg_wc_mppu_check_quantities_for_product` filter - Now applying filter to `false` results also.
* Dev - Frontend - "My Account" options added.
* Dev - Frontend - "Permanent notice" option added.
* Dev - `[alg_wc_mppu_user_product_quantities]` shortcode added.
* Dev - General - Custom date range - Default value changed to `3600` (was `1`).
* Dev - Data - `alg_wc_mppu_save_quantities` filter added.
* Dev - Data - `alg_wc_mppu_calculate_data_wc_get_orders_args` filter added.
* Dev - Code refactoring.

= 2.4.3 - 18/02/2020 =
* Fix - Formula - It's no longer required to have at least one of the "Quantities" section checkboxes to be enabled for "Formula" to be active.
* Fix - Notices - Now always using the correct product ID (i.e. variation vs main variable product ID).
* Dev - General - "Payment gateways" option added.
* Dev - `alg_wc_mppu_check_quantities_for_product` filter added.

= 2.4.2 - 05/02/2020 =
* Dev - Formula - `membership_plan` shortcode attribute added.
* Dev - `alg_wc_mppu_get_cart_item_quantities` filter added.
* Dev - `alg_wc_mppu_validate_on_add_to_cart_quantity` filter added.
* Dev - `alg_wc_mppu_save_quantities_item_qty` filter added.
* WC tested up to: 3.9.

= 2.4.1 - 20/01/2020 =
* Dev - Replacing negative max qty with zero in notice now.
* Dev - Code refactoring.

= 2.4.0 - 28/12/2019 =
* Dev - Tools - "Delete sales data" tool added.
* Dev - Tools - Advanced - "Orders date range" option added.
* Dev - Tools - Advanced - "Query block size" option added.
* Dev - Tools - Advanced - "Time limit" option added.
* Dev - Tools - Advanced - "Loop function" option added.
* Dev - Tools - Advanced - "Debug" option added.
* Dev - Settings - General - Section split into two separate sections ("General" and "Frontend").
* Dev - Settings - Admin & Tools - Section split into two separate sections.
* Dev - Code refactoring.

= 2.3.1 - 25/12/2019 =
* Dev - General Options - Date range - "Custom" date range options added.
* Dev - "Advanced" options section added.

= 2.3.0 - 13/12/2019 =
* Fix - User roles - "Guest" user role removed from the lists.
* Dev - "Formula" (i.e. "Max Quantity by Formula") section added.
* Dev - Code refactoring.
* Tested up to: 5.3.

= 2.2.0 - 10/11/2019 =
* Dev - General Options - "Order statuses" option added.
* Dev - General Options - "User roles" option added.
* Dev - Admin Options - "Editable sales data" options added (sales data can now be edited in backend on user's edit page).
* Dev - `alg_wc_mppu_get_max_qty` filter added.
* Dev - Admin settings restyled and split into sections.
* Dev - Code refactoring.
* WC tested up to: 3.8.

= 2.1.0 - 01/10/2019 =
* Dev - General Options - Date range - "This hour", "This day", "This week", "Last hour", "Last 24 hours", "Last 7 days" ranges added.
* Dev - General Options - "Time function" option added.
* Dev - `alg_wc_mppu_date_range` filter added.
* Dev - `alg_wc_mppu_date_to_check` filter added.
* WC tested up to: 3.7.

= 2.0.0 - 28/07/2019 =
* Dev - Per Product Taxonomy - "Per product tag" option added.
* Dev - Per Product Taxonomy - "Per product category" option added.
* Dev - General Options - "Use variations" option added.
* Dev - General Options - "Validate on add to cart" option added.
* Dev - General Options - "Date range" option added.
* Dev - General Options - "Exclude products" option added.
* Dev - Tools - "Delete & recalculate sales data" tool added.
* Dev - Tools - Recalculate sales data - Button replaced with checkbox.
* Dev - `[alg_wc_mppu_translate]` shortcode added (for "Customer message").
* Dev - Major code refactoring.
* Tested up to: 5.2.

= 1.1.2 - 20/04/2019 =
* Dev - Admin settings descriptions updated.
* Dev - "WC tested up to" updated.

= 1.1.1 - 08/04/2019 =
* Dev - Code refactoring.
* Dev - Data sanitized and escaped.

= 1.1.0 - 22/10/2018 =
* Dev - Admin settings descriptions updated.
* Dev - Code refactoring.

= 1.0.0 - 18/06/2018 =
* Initial Release.

== Upgrade Notice ==

= 1.0.0 =
This is the first release of the plugin.