This reference lists every setting in Conditional Payment Methods by Location for WooCommerce, with its label, option ID, default and Free/Pro status. Settings are at WPFactory > Payment Gateways by Customer Location (also reachable at WooCommerce > Settings > Payment Gateways by Customer Location) in five sections.
General section #
| Label | Option ID | Default | Free/Pro |
|---|---|---|---|
| Detect country by (Billing country, Shipping country, Country by IP) | alg_wc_gateways_by_location_country_type |
Billing country | Free |
| Detect state by (Billing state, Shipping state) | alg_wc_gateways_by_location_state_type |
Billing state | Free |
| Detect city by (Billing city, Shipping city) | alg_wc_gateways_by_location_cities_type |
Billing city | Free |
| Detect postcode by (Billing postcode, Shipping postcode) | alg_wc_gateways_by_location_postcodes_type |
Billing postcode | Free |
| Advanced Options: Force JavaScript checkout update (Billing/Shipping state, city, postcode) | alg_wc_gateways_by_location_force_js_checkout_update |
None selected | Free |
Location sections #
Each location section has an on/off switch plus an Include and an Exclude field for every payment gateway, listed by the gateway’s admin name. Per-gateway values are stored in one option per field, keyed by gateway ID, for example alg_wc_gateways_by_location_country_include[cod].
| Section | Label | Option ID | Default | Free/Pro |
|---|---|---|---|---|
| Countries | Gateways by country: Enable section | alg_wc_gateways_by_location_country_section_enabled |
Yes | Free |
| Countries | Include countries / Exclude countries (multiselect, includes European Union and Netherlands Antilles) | alg_wc_gateways_by_location_country_include, alg_wc_gateways_by_location_country_exclude |
Empty | Free |
| States | Gateways by state: Enable section | alg_wc_gateways_by_location_state_section_enabled |
Yes | Free |
| States | Include states / Exclude states (multiselect, base country states only) | alg_wc_gateways_by_location_state_include, alg_wc_gateways_by_location_state_exclude |
Empty | Free |
| Cities | Gateways by city: Enable section | alg_wc_gateways_by_location_city_section_enabled |
Yes | Free |
| Cities | Include cities / Exclude cities (text area, one city per line) | alg_wc_gateways_by_location_city_include, alg_wc_gateways_by_location_city_exclude |
Empty | Free |
| Postcodes | Gateways by postcode: Enable section | alg_wc_gateways_by_location_postcode_section_enabled |
Yes | Free |
| Postcodes | Include postcodes / Exclude postcodes (text area, one per line, wildcards and numeric ranges) | alg_wc_gateways_by_location_postcode_include, alg_wc_gateways_by_location_postcode_exclude |
Empty | Free |
| Every section | Reset Settings: Reset section settings | alg_wc_gateways_by_location_{section}_reset |
No | Free |
An empty Include or Exclude field is ignored. Turning a section off with Enable section skips that location type entirely, even if values are saved.
Free and Pro #
In version 1.8.0 the free and Pro builds contain the same settings, and the free version works with any payment gateway. Every setting above is available in both.
Related articles #
Need a hand? Our team answers every ticket on the Payment Methods by Location support forum.