yireo / magento2-salesblock2-by-geo
Block transactions based on geo matching
Fund package maintenance!
yireo
www.paypal.me/yireo
Installs: 652
Dependents: 0
Suggesters: 1
Security: 0
Stars: 1
Watchers: 3
Forks: 2
Open Issues: 1
Type:magento2-module
Requires
- geoip2/geoip2: ~2.0
- magento/module-customer: ^101.0|^102.0|^103.0
- magento/module-quote: ^101.0
- yireo/magento2-salesblock2: ^2.2
This package is auto-updated.
Last update: 2024-10-09 15:14:22 UTC
README
This module is a helper-module for the Yireo_SalesBlock2 extension, that allows you to block orders from being placed, based on specific rules defined in the Magento Admin Panel.
This specific module allows you to match by a specific geo location.
Installation
To install this module, use the following commands. First, install this module using composer. Note that this step will fail if the Yireo_SalesBlock2
is not installed yet.
composer require yireo/magento2-salesblock2-by-geo
Once this module is installed via composer, you can enable it:
bin/magento module:enable Yireo_SalesBlock2ByGeo
bin/magento setup:upgrade
There are no further steps to take. The Yireo_SalesBlock2
module automatically picks up on things.
Usage
When creating a rule within the SalesBlock extension, this submodule adds a new geolocation rule to block sales by geolocation. Within the Match field, you can one or more of the following values:
- A two-letter identifier for a continent (ref)
- A two-letter identifier for a country (ref)
- A three-letter identifier for a country (ref)
Multiple entries are to be separated by commas.
GeoIP support
You either need to install GeoIP support into your PHP installation (usually by installing a PHP extension ext-geoip
) or you need to add GeoIP databases on your system and configure this extension to use them. For installing the PHP extension, refer to your PHP installation. Please note that the GeoIP extension might no longer be available for your PHP version.
As for the Geo databases, register for an account with Maxmind and download the database (*.mmdb
) for either cities or countries or both. Upload them some where on your server and configure this extension in the Magento Admin Panel to point to that path.