Alex Kebbell

For further information on the StarTrack Express plugin for WooCommerce click here.

Installation

1. Upload the plugin folder to the “/wp-content/plugins/” directory.
2. Activate the plugin through the “Plugins” menu in WordPress.
3. That’s it – you can now configure the plugin.

 

Configuration

Registration with StarTrack Express is required to obtain a username, password, account number, and access / API key.

Existing StarTrack customers with an eight digit account number will just need to sign, scan and email Document A and Document B and forward to your StarTrack representative, ensuring you mention eServices API access. For all other registration or account sign-up enquiries, please contact StarTrack directly.

1. Once the plugin has been activated, go to WooCommerce > Settings > Shipping Methods.
2. The method will be listed at the top of the screen, underneath the tabs. Click on “StarTrack Express”.
3. You can now configure the method.

  • Enable/Disable – Choose whether to enable the shipping method of not.
  • Method Availability –  This setting lets you narrow down the countries which can get quotes. Changing the setting to ‘Specific Countries’ and entering ‘Australia’ will ensure the shipping option only shows for Australian customers.
  • StarTrack API Username – Enter as provided by StarTrack Express (see above)
  • StarTrack API Password – Enter as provided by StarTrack Express (see above)
  • StarTrack API Key – Enter as provided by StarTrack Express (see above)
  • StarTrack Account Number – Enter as provided by StarTrack Express (see above)
  • Origin City – This should be set to the city / suburb from which you will ship. It is sent to the StarTrack Express API.
  • Origin State – This should be set to the state from which you will ship. This should be in capitals (e.g. NSW, VIC etc) It is sent to the StarTrack Express API.
  • Origin Postcode – This should be set to the postcode from which you will ship. It is sent to the StarTrack Express API.
  • Risk Warranty – Optional
  • Fuel Surcharge – Optional
  • Handling Charge – Enter a value to be appended to the returned shipping rate.
  • Handle GST Locally – If enabled, GST will be excluded in the returned total. If disabled, GST will be included.

 

4. Ensure your products are in the correct format.  Make sure you have entered Weight (in kg) and Dimensions (in cm).

5. Ensure that in WooCommerce -> Settings -> Shipping you have checked the box next to “Hide shipping cost until an address is entered”. The carrier requires an address, so cannot return a rate without one.

 

Displaying the calculated price on the cart page

Please note that many courier companies require a suburb (city) to perform their cost estimate. By default WooCommerce does not provide this option on the cart page which prevents this calculator from loading until the full address is provided in the checkout. It is possible to disable shipping calculation on the cart page via the WooCommerce Shipping settings. Alternatively, there are a number of workarounds including the snippet below which can be added to your theme’s functions.php file.

add_filter('woocommerce_shipping_calculator_enable_city','EnableCity');
function EnableCity() { return true;}