# WordPress Integration – Guide
### [Plugin Download](https://wordpress.org/plugins/transdirect-shipping/)
### [Github](https://github.com/Transdirect/woocommerce)
## **Application Description**
Transdirect Shipping Plugin for Woocommerce gives you access to Australia’s largest courier and freight companies, and allows your clients a seamless checkout process.
## **Main Features**
* Free to use
* Simple configuration
* Great shipping rates from Fastway, Couriers Please, Toll Priority, Northline and more
* Seamless checkout process for your clients
* Box Sizing
* Order Sync Functionality
## **Requirements**
* PHP version off at least 5.6
* WordPress 4.x
* WordPress WooCommerce Plugin
* An active Transdirect Member account. You can sign up for an account at [www.Transdirect.com.au](http://www.Transdirect.com.au)
## **Installation**
1. Download the latest version of the plugin from here. Then simply log in to your WordPress Admin Panel and under Plugins select “Add New” and search for “Transdirect” and then click install.
2. Remember, you must have installed Woocomerce before using this plugin, for more information on installing Woocomerce please see:
3. Once installed, please make sure you have activated the plugin in the plugins list
4\. Login to Transdirect using your Member Account, then click the API Modules link on the left side menu’s list.
5\. On the dropdown, select wordpress and click “ADD NEW”
6\. Enter your site domain or name then click “ADD”.
7\. You will be redirected to the module page, copy the API Key generated.
8.Login to your wordpress store site as admin.
9\. Go to Woocommerce -> Settings -> Shipping -> Transdirect Shipping.
10\. Enter the API Key and click Save.
11\. You can also test the API through the “Test API” button, which will alert you if your API is valid or not.
## **Module Setup**
### **Rules Section**
Rules enable you to add conditions to quotes based on the Rule type selected such as Postcode, State, Weight, Cost, or Product SKU;
#### **Rule Types**
* **Postcode**
A List or a Range of postcodes can be set on Postcode Rule;
* **State**
Set the State rule by selecting from the drop down list(ACT, NSW, NT, QLD, SA, TAS, VIC, or WA);
* **Weight**
A weight rule can be added by selecting a condition from the Action drop down list: Equals, Less than, Greater than, Less than or equals, Greater than or equals to the Total Weight set on the text box;
* **Cost**
A fixed amount, free shipping, or an additional fee can be added or deducted to a quote as you set the condition for the Total Cost on the cost rule;
* **Product SKU**
A rule can also be set on a specific product by entering the Product SKU and the action to be applied;
* **Quantity**
By selecting Quantity Rule, you can set the number of items on text box and select its corresponding condition whether it is Equals, Less than, Greater than, Less than or equals, Greater than or equals to the item quantity;
In **Couriers** column, you can manage couriers by ticking or selecting specific couriers where rules will be applied. If no couriers are selected the rule will be apply to all couriers.
**Priority** column is being used in cases where multiple rules were created on the same Rule Type and Triggers. Our system will execute the rule which was created first. The priority sequence can be arranged through the up and down (arrow) buttons.
### Click the **Question mark** icon  to read instructions on how to add/create a rule**.**
**There are three sections you will need to fill out to create a rule:**
* **Rule Type**
* Single rule application
* Multiple rules application
* **Trigger**
* **Action**
**Single Rule Type Application**
* Start with selecting a rule type by ticking the box on the left side.
* Set the Trigger conditions.
* Create an action.
* Click "Create Rule".
**Multiple Rule Type Application**
* Start with selecting one rule type, set the trigger for it.
* Tick another rule type and set the trigger after (multiple rule type and trigger).
* When you are done selecting rule types and its specific trigger, you can now set the action for the multiple selections created.
* Click "Create Rule".
### **Import Bulk Rules**
Import bulk rules by selecting ‘*Upload your rules in bulk using import*’ link.
Download CSV template and read bulk Import Rule from here:
### **Show on Cart**
You can customize the Shipping Calculator Title and set the default delivery address type (Residential or Commercial) to be displayed on cart.
### **Default Item Size**
Enter in default package dimensions. Default package dimensions will be used if you do not input custom package dimension for a specific product.
### **Insurance**
**If enabled, the Transdirect plugin will add insurance value in quotes calculations.**
### **Order Sync Setup**
If enabled, the Transdirect plugin will upload order information to your transdirect members area as your customers checkout, allowing for easy booking of your orders.
If the first checkbox is selected then only orders with Transdirect as shipping method are synced and if the second checkbox is checked, then all orders will be synced.
### **Module Display Mode**
* If Full Calculator Mode is selected then the calculator will appear on your checkout page.
* If Simplified Mode is selected then the calculator will be hidden and the quotes will automatically be generated depending on the buyers address.
* If No Display Mode is selected then no quotes will be generated but your orders will still be synced to your Transdirect account.
### **Quote Display**
Select type of Quote to display, These options will control what quotes are displayed to your clients:
* Display All Quotes – This will display all quotes sorted by cheapest to most expensive;
* Display Cheapest – This will only show a single quote which is the cheapest;
* Display Cheapest & Fastest – This will display two quotes, the cheapest quote, and the fastest quote;
Note: Please keep in mind that all of these options are applied after more advanced options available below are applied.
### **Tailift**
Items that exceed 25kgs must be securely packaged on a forklift able Skid, Pallet or Crate.Select checkbox if Tail lift is required at the **Pickup** location or at the **Delivery** location. A surcharge will be included in the quote.
### **Apply General Surcharge**
This adds a fixed $ amount or a % into the final quotes that displayed, this can be used to cover handling expenses.
### **Disabling Couriers**
If you would like to disable quotes from a particular courier service, then you can uncheck the box on the left of the row, if not selected**,** quotes for this courier will not be calculated.
### **Rename / Group Couriers**
The rename feature allows for you to hide the name of the courier, and allow something more user friendly to be displayed in the front end, eg. “Air Express” or “Road Courier”
You can also use this option to Group couriers, if you call multiple services by the same name, then only the cheapest option will be used and displayed. For example, you could call all the same day services “Same Day” and all road services “Road Express”, and your client would get presented with only 2 options during the checkout process.
### **Surcharge/Fixed Price on a courier**
You can add a $ amount or a % surcharge on a particular courier. Or you can set a fixed price on every enabled courier on the list.
### Multipickup Options
Multipickup Tiers allows bookings to be booked via batches.
Each batch is picked up from a given location and you can have distinct batches to be picked up from distinct locations.
Each batch will also be booked on a given date and you will able to complete the booking once you have assigned the minimums shipments amounts for each batch.
Multipickup bookings gives you access to cheaper Courier rates since this process reduces the operational costs for Couriers, which will be able to pickup multiple shipments from a given location on a given day.
#### Set Up
* You can setup in the Module Setting to always return the Multipickup Tier price instead of the Everday Price.
* When you enable a Tier Price option, the quotes returned by the API will always be from Tier prices.
Please note that currently, only Couriers Please and Fastway offer Multipickup.
### **Order Boxing**
You can add up to 5 boxes to be used for packing your items -The system will calculate the most efficient and cheapest boxes for the items
This feature is intended for customers who might have a large number of small items to be boxed before dispatching and want to achieve better rates.
Multiple packages will be consolidated in boxes and computed based on the total dimension and volumetric weight. Afterwards, these items will be placed in the smallest box size capable of supporting the amount of items.
Note: This is an advanced functionality - do not enable this if you do not fully understand the implications that this will have on quoting.
* **Minimum fill**: allows you to individually quote items outside boxes if they don’t fill a given last box (if multiple boxes in a shipment) by a certain percentage;
* **Box dimension fields**: You may input a maximum of 5 boxes that can be used. Order Boxing functions will select the best combination of boxes to fit your items;
Note: This request is generated as part of a Quote request.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://transdirect-1.gitbook.io/transdirect/master.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.