eKerner Logo

Doco for Joomla Virtuemart plugin plg_vmshipment_auspostpac1 by ekerner.com

Joomla Virtuemart Shipment Plugin for Australia Post Services.

Employs the AusPost Postage Assessment Calculation API - Tested in PAC 1.3 and PAC 1.4 (latest at 21/04/2013).
Supports: Domestic|International, Parcel|Letter, Regular|Express, Registered, Confirmed, and Insured Post.
For multiple cart products: Calculates parcel sizes and splits into multiple parcels where required as per AuPost parcel limits.
Tested in Joomla 2.5 with VirtueMart 2.0 so far, if you get her running in J3 please let me know :)
The AusPost PAC spec was impressive also and is available via the AusPost Developer Center.
To configure: First enable the plugin in "Administrator -> Extensions -> Plugin Manager", then add a new shipment method in "Administrator -> Components -> Virtuemart -> Shop -> Shipment Methods".

Developed by eKerner.com.au - Technical Solutions.

1. Plugin Installation

  1. Download plg_vmshipment_auspostpac1.zip from the Joomla extensions dir
  2. Go to your Joomla Site Administrator
  3. Click main menu item: Extensions -> Extension Manager
  4. Use the "Upload Package File" feature to install plg_vmshipment_auspostpac1.zip

2. Plugin Enablement

  1. Find your newly installed plugin via your Extensions -> Extension Manager -> Manage tab, or via your Extensions -> Plugin Manager (You may need to search for auspostpac1).
  2. Select the AusPostPAC1 item and "Enable" it either via the Enable button in the top right menu, or using the link in the adjacent Status column.

3. VM Shipment Method Configuration

  1. Visit the AusPost Developer Centre to obtain your API Key. The latest AusPost Postal Assessment Calculator API (version 1.3 and 1.4) requires it and so you will need it for your AusPostPAC1 plugin configuration.
  2. Go to your Joomla Site Administrator
  3. Click main menu item: Components -> Virtuemart
  4. Click left menu item: Shop -> Shipment Methods
  5. Click the top-right menu item: New
  6. Choose which AusPost payment method you are currently configuring from the below section titled "VM Shipment Method Possible Configurations"
  7. View - where available - the image below that relates to your chosen configuration option for help with settings.
  8. Give your shipment method an appropriate title (like "AusPost - Parcel - Express") and description, then click Save in the top right menu.
  9. Click the Configuration Tab to reveal your settings, and apply the appropriate settings. Click Save & Close in the top right menu.
  10. Repeat these steps for as many shipment methods as you require.

VM Shipment Method Possible Configurations

Note that the config settings dont align with the AusPost product names, its the same in the AusPost spec too. For example: "Express - Registered" aligns with the "Express Courier" product.

You can make this many AusPost VM Shipment methods ...

AusPost Screenshot Images

Virtuemart Shipment Methods Screen

Virtuemart Shipment Methods Screen

menu | top

Virtuemart Orders Screen

Virtuemart Orders Screen

menu | top

VM Shipment Configuration Images

Au Domestic - Parcel - Standard

Au Domestic - Parcel - Standard

menu | top

Au Domestic - Parcel - Standard - Registered

Au Domestic - Parcel - Standard - Registered

menu | top

Au Domestic - Parcel - Standard - Registered - Insured

Au Domestic - Parcel - Standard - Registered - Insured

menu | top

Au Domestic - Parcel - Express

Au Domestic - Parcel - Express

menu | top

International - Parcel - Standard

International - Parcel - Standard

menu | top

International - Parcel - Standard - Registered

International - Parcel - Standard - Registered

menu | top

International - Parcel - Express

International - Parcel - Express

menu | top

Have fun,
Eugene Kerner.

http://www.ekerner.com.au/


Valid XHTML 1.0 Strict