This reference lists every setting in Conditional Payment Methods for WooCommerce, with its label, option ID, default and Free/Pro status. All settings live at WPFactory > Conditional Payment Gateways (also reachable at WooCommerce > Settings > Conditional Payment Gateways), split into a General section and one section per condition.
General section #
| Label | Option ID | Default | Free/Pro |
|---|---|---|---|
| Conditional Payment Gateways: Enable plugin | alg_wc_cpg_plugin_enabled |
Yes | Free |
| Debug: Enable (writes a log to WooCommerce > Status > Logs) | alg_wc_cpg_debug_enabled |
No | Free |
| Leave at least one gateway: Enable (never hides the last remaining gateway) | alg_wc_cpg_leave_at_least_one_gateway |
No | Free |
| Notice styling (Notice, Error or Success) | alg_wc_cpg_notice_type |
Notice | Free |
| Available Conditions: Conditions (one checkbox per Require, Exclude, Minimum or Maximum rule) | alg_wc_cpg_{condition}_{rule}_enabled |
No | Free |
Settings in every condition section #
Each condition has two rule blocks (Require and Exclude, or Minimum and Maximum for Cart Total). Every block contains the settings below. {condition} and {rule} are the IDs from the next table.
| Label | Option ID | Default | Free/Pro |
|---|---|---|---|
| Enable/disable: Enable section (same setting as the checkbox on the General section) | alg_wc_cpg_{condition}_{rule}_enabled |
No | Free |
| One field per payment gateway, labeled with the gateway title (the tooltip shows the gateway key) | alg_wc_cpg_{condition}_{rule}[{gateway_key}] |
Empty (no restriction) | Free for bacs, cheque, cod and paypal; Pro for all other gateways (read-only or disabled in the free version) |
| Additional notice: Enable | alg_wc_cpg_{condition}_{rule}_notice_enabled |
Yes | Free |
| Notice text (HTML and shortcodes allowed) | alg_wc_cpg_{condition}_{rule}_notice |
Condition-specific message | Free |
| Reset section settings: Reset | alg_wc_cpg_{section}_reset |
No | Free |
Conditions and their IDs #
| Section | Condition ID | Rules | Field type | Notice placeholders |
|---|---|---|---|---|
| Date/Time | date_time |
incl, excl |
Text area, one from-to range per line |
%gateway_title% |
| Customer IP | ip |
incl, excl |
Text area, one IP or CIDR range per line | %gateway_title% |
| User | user |
incl, excl |
Text area, one user ID per line (0 = guests) |
%gateway_title% |
| User Role | user_role |
incl, excl |
Multiselect of roles | %gateway_title% |
| Cart Total | cart_total |
min, max |
Text, amount (0 = ignored) |
%gateway_title%, %value%, %result% |
| Currency | currency |
incl, excl |
Multiselect of currencies | %gateway_title% |
| Country | country |
incl, excl |
Multiselect of countries | %gateway_title% |
| Product | product |
incl, excl |
Product and variation search | %gateway_title% |
| Product Category | product_cat |
incl, excl |
Multiselect of categories | %gateway_title% |
| Product Tag | product_tag |
incl, excl |
Multiselect of tags | %gateway_title% |
| Product Shipping Class | product_shipping_class |
incl, excl |
Multiselect of shipping classes | %gateway_title% |
| Product Taxonomy | product_taxonomy |
incl, excl |
Multiselect of terms | %gateway_title% |
| Product Title | product_title |
incl, excl |
Text area, one string per line | %gateway_title% |
| Language | language |
incl, excl |
Multiselect of WPML or Polylang languages | %gateway_title% |
In the admin, incl is labeled Require, excl Exclude, min Minimum and max Maximum. For example, the option that turns on Exclude Country is alg_wc_cpg_country_excl_enabled.
Extra settings in some sections #
| Section | Label | Option ID | Default | Free/Pro |
|---|---|---|---|---|
| Cart Total | Cart Total Calculation: Cart total | alg_wc_cpg_cart_total_calc |
[alg_wc_cpg_cart_total exclude_taxes="yes" exclude_shipping="no" exclude_discounts="no"] |
Free |
| Country | Country Detection: Country detection (Country by IP (geolocation), Billing country, Shipping country) | alg_wc_cpg_country_source |
Country by IP (geolocation) | Free |
| Product Taxonomy | Settings: Taxonomy slug | alg_wc_cpg_product_taxonomy_slug |
Empty | Free |
| Product Title | Settings: Product data (Product title, Product description, Product short description) | alg_wc_cpg_product_title_source |
Product title | Free |
| Product Title | Settings: Comparison function (Case-sensitive, Case-insensitive) | alg_wc_cpg_product_title_func |
Case-sensitive | Free |
Related articles #
Ready to set this up? #
Every setting above is included in the free version for the four built-in WooCommerce gateways. Get Conditional Payment Methods Pro to use them with any payment gateway.
Need a hand? Our team answers every ticket on the Conditional Payment Methods support forum.