=== Deo Payment Rules for WooCommerce ===
Contributors: deoworkz
Tags: woocommerce, payment gateways, checkout, ecommerce, conditional logic
Requires at least: 6.5
Tested up to: 7.1
Stable tag: 1.2.0
Requires PHP: 8.0
Requires Plugins: woocommerce
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Conditionally hide WooCommerce payment methods using flexible checkout rules.

== Description ==

Deo Payment Rules for WooCommerce lets store owners conditionally hide
WooCommerce payment methods using rules based on cart, product,
shipping, billing, and customer context.

The Free plugin includes:

-   Cart Total, Cart Subtotal, Cart Quantity, Product, Product Quantity,
    Product Category, Coupon, Shipping Method, Shipping Country, Billing
    Country, and User Role conditions.
-   Hide Payment Gateway.
-   Flat ALL and ANY condition logic.
-   Execution Order for predictable rule precedence.
-   A Safety Guard that never adds a gateway WooCommerce did not make
    available.
-   A Basic Simulator for testing rule outcomes without changing the
    live cart.
-   Basic diagnostics, Classic Checkout support, and the validated
    Checkout Blocks foundation.

Deo Payment Rules for WooCommerce is independent software and is not
affiliated with or endorsed by Automattic or WooCommerce.

== Installation ==

1.  Install and activate WooCommerce.
2.  Upload the deo-payment-rules-for-woocommerce directory to
    /wp-content/plugins/, or install the ZIP from Plugins → Add New →
    Upload Plugin.
3.  Activate Deo Payment Rules for WooCommerce from Plugins.
4.  Open WooCommerce → Payment Rules.
5.  Create a rule, choose Enabled or Disabled, set its Execution Order,
    select conditions, choose Hide Payment Gateway, and save.

== Frequently Asked Questions ==

= Does it work with Cash on Delivery (COD)? =

Yes. Select Cash on Delivery in a Hide Payment Gateway rule. WooCommerce
must already consider the gateway available for the rule to affect it.

= Can I hide payment methods by cart total? =

Yes. Add Cart Total or Cart Subtotal, select an operator, and enter the
amount used by your rule.

= Can I use OR logic? =

Yes. Choose ANY for a flat rule when at least one valid condition should
match. Choose ALL when every condition must match.

= Can I hide payment methods by country? =

Yes. Shipping Country and Billing Country are included in Free.

= Can I hide payment methods by product or category? =

Yes. Product, Product Quantity, and Product Category conditions are
included in Free.

= What is Execution Order? =

Rules run from the lowest number to the highest number. If rules
conflict, later matching rules can determine the final gateway state.
Different numbers are recommended when precedence matters.

= What is the Safety Guard? =

When enabled, the guard preserves a configured fallback gateway, or
WooCommerce’s first originally available gateway, if rules would
otherwise remove every available gateway. It never adds an unavailable
gateway.

= What is the Basic Simulator? =

The Basic Simulator evaluates Free rules against synthetic cart and
checkout values. It does not modify the live cart, customer session,
order, rules, or settings.

= Why does a rule say Requires Pro or Not evaluated? =

The rule contains a component supplied by a separate compatible
extension. Its stored configuration and enabled/disabled status are
preserved, but it is not evaluated until the compatible extension is
active.

= Does deactivation delete my rules? =

No. Deactivation does not delete rule data or settings.

= Does uninstall delete my rules? =

By default, no. An administrator can explicitly enable Delete plugin
data on uninstall in the plugin settings. Shared data is preserved when
a compatible extension using that data is still installed or active.

= Does it support Checkout Blocks? =

Free provides the validated server-side Checkout Blocks foundation for
gateway visibility. A third-party gateway must participate in
WooCommerce’s supported payment-method extension APIs.

= Does it support HPOS? =

The plugin declares compatibility with WooCommerce High-Performance
Order Storage and does not store order data in a custom order table.

= Does it send data externally? =

No. Free has no telemetry, license service, remote runtime requests,
external API client, or remotely loaded code. Rule evaluation uses the
current site and WooCommerce context.

== Data and privacy ==

Deo Payment Rules for WooCommerce does not transmit data to external
services and does not collect telemetry. Rules and settings are stored
in the local WordPress database. During checkout, rules may read the
WooCommerce context needed for a configured condition, such as cart,
address, user role, or billing email domain, but this plugin does not
send that context externally. Optional debug logging should be enabled
only while troubleshooting and is managed through WooCommerce’s logger.

== Compatibility ==

-   WordPress 6.5 or newer.
-   PHP 8.0 or newer.
-   WooCommerce 8.0 or newer.
-   Classic Checkout: tested in the project validation environment.
-   Checkout Blocks: tested in the project validation environment for
    gateway visibility and server-calculated behavior.
-   HPOS: declared compatible and tested in the project validation
    environment.
-   Multisite: not tested and not advertised as supported.

WooCommerce is a trademark of Automattic Inc. This plugin is not
affiliated with or endorsed by Automattic.

== Screenshots ==

1.  Rules dashboard showing payment rules, status, and execution order.
2.  Create a payment rule using conditions to hide selected payment
    gateways.
3.  Combine multiple conditions using ALL or ANY logic to control
    payment gateway availability.
4.  Basic Rule Simulator for testing payment rules without affecting the
    live checkout.
5.  Settings and Safety Guard options for protecting checkout payment
    availability.
6.  WooCommerce checkout with payment gateway availability controlled by
    an active rule.

== Changelog ==

= 1.2.0 =

-   Added flexible payment gateway conditions for cart, product,
    shipping, billing, and customer context.
-   Added flat ALL/ANY condition matching and Execution Order.
-   Added Payment Safety Guard and Basic Rule Simulator.
-   Added Checkout Blocks and HPOS compatibility.
-   Improved diagnostics, privacy handling, and uninstall behavior.
-   Preserved compatible stored rule data and extension
    interoperability.

== Upgrade Notice ==

= 1.2.0 =

Adds flexible payment gateway rules, Safety Guard, Basic Simulator, and
WooCommerce compatibility improvements.
