Shipping Fees Calculator for Geniki Taxydromiki – Documentation



Setup and Configuration

To set up your store with Shipping Fees Calculator for Geniki Taxydromiki:

  1. Go to: WooCommerce > Settings > Shipping > Geniki Taxydromiki Shipping Fees.
  2. Tick the checkbox to Enable.
  3. Enter Method Title that would be displayed on checkout.
  4. Enter shipping costs for all areas that are enabled (Please for areas that are enabled don’t leave shipping cost fields empty)
  5. Save changes.

Recommended Settings for Autocomplete Address

It is recommended to install & activate a plugin to autocomplete your address on checkout.
In the plugin’s setting page, you can find an admin notice to install the recommended autocomplete plugin.

  1. Download the recommended plugin from the admin notice or someone of your choice.
  2. Insert the Google api key. Instructions how to get, HERE. Includes $300 free credits per month.
  3. Add this line code
    define('GTSF_CHECKOUT_ADDRESS_AUTOFILL_FOR_WOOCOMMERCE_EXTRA_SETTINGS', true);
    in your wp-config.php to enable our recommended extra settings.
    (Extra settings refer to make inactive address 1, required the autocomplete field and non-required the address 1 and city fields)

Add a new zone to the accepted zones

It is possible to add a shipping zone that there isn’t in plugin’s settings yet.
With filter GTSF_register_extra_zones.

Each 1st level value of the array is an array. Each nested array is an array of the zone or country and its attributes (zone_code, zone_name, fixed_cost_weight_point, additional_cost_weight_periodical_point).

Click to see more in the hook documentation
/**
* Register extra zones filter.
*
* By default, this plugin gives the ability to
* sends to and set shipping costs only for GR, CY, BG, RO.
* With this filter, we can register extra country zones or individual countries.
*
* @param array $extra_zones {
* Extra Zones settings. Default empty array.
*
* @type string|int $key {
* Zone key. Key can be anything.
*
* @type string $zone_code Zone code. For countries, use the 2-digit code. Required.
* @type string $zone_name Zone name. Is optional only for countries.
* @type string $fixed_cost_weight_point The fixed cost weight point for this zone. Optional.
* Default is the global fixed_cost_weight_point setting
* $this->settings['fixed_cost_weight_point'].
* @type string $additional_cost_weight_periodical_point The additional cost weight periodical point.
* Optional. Default is the global additional_cost_weight_periodical_point setting
* $this->settings['additional_cost_weight_periodical_point'].
* }
*
* $extra_zones = array(
* array(
* 'zone_code' => 'TR'
* //the zone_name is Turkey
* //the fixed_cost_weight_point of TR is the global fixed_cost_weight_point setting
* //the additional_cost_weight_periodical_point is the global additional_cost_weight_periodical_point setting
* ),
*
* array(
* 'zone_code' => 'RU',
* //the zone_name is Russia
* 'fixed_cost_weight_point' => 1,
* 'additional_cost_weight_periodical_point' => 1
* ),
*
* array(
* 'zone_code' => 'REST',
* 'zone_name' => 'Rest of World',
* 'fixed_cost_weight_point' => 0.5,
* 'additional_cost_weight_periodical_point' => 0.5
* )
* );
* }
*
*
* HOW TO USE FILTER
* add_filter('GTSF_register_extra_zones', function($extra_zones){
* //change the $extra_zones as you want. You can copy the $extra_zones array from above
* return $extra_zones; // return the array
* });
*
*
*
* @param object $this The incomplete object of this class.
*
* @since 1.0.0
*/
$extra_zones = apply_filters('GTSF_register_extra_zones', $extra_zones, $this);

Hooks

You can see the full list of plugin’s hooks in the following link:
Hooks – Shipping Fees Calculator for Geniki Taxydromiki

Usage

After the store owner sets the plugin settings, the plugin will be able to calculate the shipping fees for customer’s destination shipments.

The plugin’s shipping method doesn’t appear on checkout, until customer fill in the destination country to these that plugin accepts.

If customer fill in an accepted country, the plugin’s shipping method appears in the shipping method list with the shipping cost to this destination.

An autocomplete plugin is recommended to help customer fill in exactly the destination details (address_1, city, postcode)

Troubleshooting

For shipping countries/zones that are enabled, don’t leave shipping cost fields empty, may cause an error.

FAQs

Can I change the final shipping cost with code?

Yes, with GTSF_shipping_cost filter.

Is it possible to delete all plugin’s settings upon uninstallation?

Yes, just put the line code
define(‘GENIKI_TAXYDROMIKI_SHIPPING_FEES_COMPLETELY_UNINSTALL’, true);
in your wp-config.php and deactivate & delete the plugin from plugins’ page.
This will delete the table woocommerce_gen_taxidromiki_inaccessible_areas from the DB and the corresponding options from the options’ table.

Does this plugin support Cash on Delivery fees calculation?

Not yet. This plugin is a plugin for calculation shipping costs. Cash on Delivery is a payment method, not a shipping method.
But in the future, this feature may be implemented…