- Upload the plugin folder to the '/wp-content/plugins/' directory.
- Activate the plugin through the 'Plugins' menu in WordPress.
- You will be prompted to install the Extensionworks Framework click on the link and install it.
- Activate the Extensionworks Framework
- That's it - you can now configure the plugin.
ACTIVATE THE EXTENSION WORKS LICENCE KEY
To activate the ExtensionWorks Licence go to: Dashboard > ExtensionWorks Licences
Canada Post requires you to be using Canadian Dollars and Canada as your base country.
Once activated, go to WooCommerce > Settings > Shipping Methods.
Choose the method from the list at the top of the screen.
Configure the shipping.
All products require Dimension and Weight units to be set up, it works best if you set these up as CM and KG.
Each order is automatically divided into packages of 30kg or less. The plugin will calculate how many packages need to be sent, calculate the cost of shipping each package and display the total cost to the customer on the cart and checkout.
Products require weight and dimensions.
Canada Post requires you to be using Canadian dollars and Canada as your base country.
Canada Post uses weight unit kg and dimensions unit cm and this works best for our extension.
Enable/ Disable: Tick to enable to function.
Method Title: This displays the name of the shipping carrier.
Origin Postcode: This is where your shipping will start from. Format: Please remove the space A1C1A1.
Method Availability: You can select specific Countries, or all Countries.
Debug mode: Used for testing the product.
Handling Fee or Discount fee: You can add or subtract an amount form your shipping rate. Enter amount +2.50 or -2.50, you can also add +2% or -2%
Letter Mail Setting
Packing letter Mail together with Parcel- this will allow you to pack the products that have been selected to ship as a letter into the boxes for parcel mail.
Packing letter mail Separately-this will allow the letter to be packed individually and not combined into the parcel mail boxes.
Un-packable Products Setting
Send un-packable products directly: Products that do not fit into any custom boxes, the product dimensions will be sent to the Shipping Carrier (API) to determine a rate.
Remove un-packable products: The products that do not fit into any custom boxes will not have a shipping rate returned from the shipping carrier.
Terminate calculate Process: There are no custom boxes (set up in the admin area) to calculate a shipping rate, the API request will be terminated. No rate will be returned from the Shipping Carrier.
Parcel Packing Method
To use a certain custom box for your shipping you will need to Tick the option: Select Box for the custom box you would like to use.
If your shipping Companies offers Predefined boxes they will already be pre-populated in the custom box area. You will need to Select the predefined boxes you would like to use.
Adding a custom box please enter the following:
- Outer Length, Outer Width, Outer Height
- Inner Length, Inner Width, Inner Height
- Box Weight
- Maximum Weight
- Weight ( tick if only shipping with weight only)
- Letter ( tick if you would like to use as a letter option)
Save you settings. Very Important.
Then go and Select the custom boxes you would like to use. Tick the selected options.
Save your Settings
Shipping Method Services
Enable customize shipping methods / this needs to be ticked to enable the Services.
Parcel / Letter Shipping Method Services: Tick to enable you to select the Shipping Services you wish to offer on your Website.
Select shipping rate to display: All, Cheapest Rate, Highest Rate.
Select shipping order to display: None, From low to high or From high to low.
Fallback Name: The Label for the Fallback Price offered.
Fallback: If the shipping method returns no matching rates, offer this amount for the shipping so the customer can still checkout. Leave blank to disable.
Test Environment: Tick this option to test for development rates. You need to add in your: Canada Post Development API Key.
Shipping by Commercial Account: Tick this option to use your product Canada Post Production account credentials. You need to add in your Canada Post Production API Key. This will provide Commercial rates.
Contract ID: Add in your Canada Post Contract ID
API Key: Add in your Canada Post API Key. ( Use the applicable key for development or production )
Customer Number: Add in your Canada Post customer number.
More information in regards to the Canada Post Account credentials can be found here:
( Where you can find the Canada Post account information )
Adding Multiple Origin Zip Codes/ Post Codes
The default ( global ) origin Zip Code/ Post code is set up in the Canada Post admin area.
To use multiple Post codes option go to: Products ( individual product area) /Product Data/ Shipping.
Here you can add the specific information:
WooCommerce Canada Post only requires you to enter to Post code.
EXAMPLE - A1C 1A1
No rates are being calculated
First check your products have sizes and weights set - without this the calculation cannot be performed.
Secondly, check your store's base country is Canada and that your using Canadian Dollars (from WooCommerce > Settings > General).
Finally, the plugin needs to be able to talk to Canada Post's API. For this it uses wp_remote_post which makes use of fsockopen/CURL.
If your server does not support this you will have problems. Canada Post's API is called via port 30000 - you must ensure your server does not block outgoing traffic on port 30000 or the requests will fail.
The box packer is volume based. This will in most cases provide good results, but will never be as accurate as a real person packing a box (see BIN Packing Problem) therefore it is important you understand that packing results are as accurate as they can be and any anomalies should be accepted.