Black Friday All Access $999 $399 lifetime or 30% off any plugin with Ends in -- See deals
View Categories

Conditional Payment Methods Settings Reference

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
wpf conditional payment gateways for woocommerce Icon

Conditional Payment Methods for WooCommerce

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.