The Delivery radius pro module allows you to either offer specific carriers during checkout or change shipping costs based on delivery radius and carrier as well as other conditions such as cart total, products in cart, and day and time.<\/p>\n\n\n\n
Installation<\/h2>\n\n\n\n
The installation procedure is very much similar to most other Prestashop modules. No core changes required therefore installation is straight forward, be sure to follow the instructions below to ensure a successful installation.<\/p>\n\n\n\n
\n
Upload the module folder to your stores {root}\/modules<\/code> folder<\/li>\n\n\n\n
Once uploaded, login to your Prestashop Back Office and head over to the Modules<\/strong> section<\/li>\n\n\n\n
Search for the module and click Install<\/li>\n\n\n\n
After a successful installation, the module configuration screen is presented to you. More details on this in the next section.<\/li>\n<\/ol>\n\n\n\n
Configuration<\/h2>\n\n\n\n
Lets begin by taking a look at the global module configuration before we look at configuring individual products. Open the global module configuration from the module panel below:<\/p>\n\n\n\n<\/figure>\n\n\n\n
After opening the module configuration you should see the initial configuration screen with 3 tabs; Rules, Carrier setup and Configuration. Let\u2019s take a loot at each tab.<\/p>\n\n\n\n
Rules<\/h2>\n\n\n\n
The rules tab allows you to create delivery radius rules. Each rule allows you to either hide or change the price of a shipping option in your store based on multiple conditions, which include delivery distance, products, day and time of the week and also cart total.<\/p>\n\n\n\n
You can create multiple rules for more sophisticated configurations, but in most cases creating just one rule should be adequate.<\/p>\n\n\n\n
We\u2019ll look at creating rules and the various conditions and configurations available for a rule later in this document.<\/p>\n\n\n\n
Carrier Setup<\/h2>\n\n\n\n
Before the module can determine distances between a carrier and the customer we must let the module know the address of each carrier. Open Carrier Setup tab and edit a carrier to see the form below.<\/p>\n\n\n\n
[Post code]<\/strong> The postcode of the carrier.<\/p>\n\n\n\n
[Country]<\/strong> The country of the carrier.<\/p>\n\n\n\n
Configuration<\/h2>\n\n\n\n
Under the configuration tab enter your Google Distance Matrix Api key. You\u2019ll need to sign up for this The link below should help you get started in creating and obtaining your key:<\/p>\n\n\n\n
Now that we\u2019ve taken care of the basic module configuration we can start creating our first rule. Under the rules tab click the create rule<\/strong> button.<\/p>\n\n\n\n
You should see the form below:<\/p>\n\n\n\n
[Rule Enabled]<\/strong> Choose if this rule is active or not.<\/p>\n\n\n\n
[Name]<\/strong> Choose name for the rule to help you identify it.<\/p>\n\n\n\n
[Radius from (km)]<\/strong> This rule will be triggered for distances starting from this distance from the carrier to the customer.<\/p>\n\n\n\n
[Radius to (km)]<\/strong> This rule will be triggered for distances to this distance from the carrier to the customer.<\/p>\n\n\n\n
[Action]<\/strong> This action will take place when the above conditions are satisfied. The following actions are available:<\/p>\n\n\n\n
Hide Carrier<\/em>: The carriers (which we will select under the carriers tab next) will be hidden when this rule is satisfied.<\/p>\n\n\n\n
Custom Price<\/em>: A custom price will be applied to the carriers associated with this rule when the conditions of this rule are satisfied.<\/p>\n\n\n\n
Now save the form. After saving the form, the following additional tabs will appear: Carriers, Categories\/Suppliers, Specific Products, Weekdays\/Timeslots, Cart Total<\/strong>. These all allow you to specific additional conditions which need to be met for the rule to get triggered.<\/p>\n\n\n\n
Lets take a look at each of the tabs.<\/p>\n\n\n\n
Carriers<\/h3>\n\n\n\n
Select the carriers in your store this rule will act on when the rule is satisfied.<\/p>\n\n\n\n
Categories \/ Suppliers<\/h3>\n\n\n\n
If you select any categories or suppliers under this tab, then the rule will only be triggered if the cart contains products from any of the selected categories or suppliers<\/p>\n\n\n\n
Specific Products<\/h3>\n\n\n\n
Under this tab you can define a list of specific products which will trigger the rule if they are present in the cart. Click the Add product button to add a product. This will present a form which allows you to search for a product and add it the list of specific products. Additionally you can restrict to the products in the cart containing only certain attributes.<\/p>\n\n\n\n<\/figure>\n\n\n\n
Weekdays \/ Timeslots<\/h3>\n\n\n\n
Under this tab you should see something similar to the form below:<\/p>\n\n\n\n<\/figure>\n\n\n\n
To limit to the rule to only certain days of the week, Enable the Limit radius rule on this weekday<\/strong> option for the desired weekday(s) and the rule will only be triggered if the current day of the week matches one of the enabled weekdays.<\/p>\n\n\n\n
Furthermore for each weekday you can define timeslots. If timeslots are defined then the rule will only be triggered if both the day of the week and the timeslot match the available timeslots you have setup for the weekday in question.<\/p>\n\n\n\n
Cart Total<\/h3>\n\n\n\n
This tab allows you set a condition for the rule to only be triggered if the cart total is between a certain range.<\/p>\n\n\n\n
These various conditions allow you to create flexible rules. For example: Charge an additional 10.00\u20ac for the carrier \u201cMy Carrier\u201d if the customer cart contains any product from Category X and the cart total is under 100\u20ac and the radius is over 20km.<\/p>\n\n\n\n
You can also multiple rules to target different sets of conditions. For example, we could create an additional condition which hides \u201cMy Carrier\u201d if the delivery radius is over 50km.<\/p>\n\n\n\n
Now that you have set up a rule, you can create additional rules if you need to.<\/p>\n\n\n\n
Front End<\/h2>\n\n\n\n
Depending on your setup, when the customer is placing an order during checkout, certain carriers may or may not be available to them, or the shipping cost may change depending on the various conditions we have created in our rules.<\/p>\n\n\n\n
This concludes the user guide for the module.<\/p>\n\n\n\n
![\"Installing](\"\/blog\/wp-content\/uploads\/documentation-images\/deliveryradiuspro\/installation.webp\")
<\/figure>\n\n\n\n![\"Delivery](\"\/blog\/wp-content\/uploads\/documentation-images\/deliveryradiuspro\/configuration-rule-specific-product.webp\")
<\/figure>\n\n\n\n![\"Delivery](\"\/blog\/wp-content\/uploads\/documentation-images\/deliveryradiuspro\/configuration-rule-specific-weekday-timeslot.webp.webp\")
<\/figure>\n\n\n\n