BBA WooCommerce Extension
Quick Start Guide

















Introduction
Built for WordPress: WooCommerce is built to integrate seamlessly with WordPress, making it the obvious e-commerce choice for existing WordPress users and connecting you to the fast-growing WordPress ecosystem.
Sell anything, anywhere: From real products and digital downloads to subscriptions, content and even your time, you'll be able to set up a WooCommerce store to sell worldwide (or by country, as you wish).
Mobile friendly: WooCommerce is designed to ensure your store and products look as good on a desktop computer as they do on your customer's mobile phones. You can even turn your existing WooCommerce store into a mobile app with no custom coding by using a few third party tools/services.
Scalability: WooCommerce can scale with you as you grow your business. From selling one product to thousands, and from your first order to your millionth, WooCommerce will be able to scale and ride the wave with you.
The BBA Plugin for WooCommerce allows the Store owner to seamlessly integrate and retrieve and send information to the BBA System
Getting Started
Installing the Extension

Automatic Plugin Installation

WordPress Plugins Screen

To add a WordPress Plugin using the built-in plugin installer:

1. Go to Plugins > Add New.
2. Type in the name of the WordPress Plugin or descriptive keyword, author, or tag in Search Plugins (BBA WooCommerce Plugin) box or click a tag link below the screen.
3. Find the WordPress Plugin you wish to install.
   1. Click Details for more information about the Plugin and instructions you may wish to print or save to help setup the Plugin.
   2. Click Install Now to install the WordPress Plugin.
4. The resulting installation screen will list the installation as successful or note any problems during the install.
5. If successful, click Activate Plugin to activate it, or Return to Plugin Installer for further actions.

Some WordPress Plugins require more steps to customize them. The Details ReadMe file should contain step-by-step instructions. After installation, this information is available on the Plugins Screen for each Plugin. If you are having problems with a WordPress Plugin, see the Troubleshooting section.
Manual Plugin Installation
There are a few cases when manually installing a WordPress Plugin is appropriate.

1. If you wish to control the placement and the process of installing a WordPress Plugin.
2. If your server does not permit automatic installation of a WordPress Plugin.
3. The WordPress Plugin is not in the WordPress Plugins Directory.

Installation of a WordPress Plugin manually requires thethe awareness that you may put your site at risk if you install a WordPress Plugin incompatible with the current version or from an unreliable source.
Backup your site completely before proceeding.
To install a WordPress Plugin manually:

1. Download your WordPress Plugin to your desktop.
2. If downloaded as a zip archive, extract the Plugin folder to your desktop.
3. Read through the "readme" file thoroughly to ensure you follow the installation instructions.
4. With your FTP program, upload the Plugin folder to the wp-content/plugins folder in your WordPress directory online.
5. Go to Plugins screen and find the newly uploaded Plugin in the list.
6. Click Activate to activate it.

Check the Details readme file for customization and further instructions.
Basic Configuration
Admin Login
To access the WordPress dashboard, you simply need to add /wp-admin to the end of the URL where you installed WordPress like the below example:
"https://example.com/wp-admin"
Note! If you installed WordPress to the document root of the url it would be example.com/wp-admin. If you installed WordPress on a folder called "blog" on your domain, you would go to example.com/blog/wp-admin .

When you visit the login page for WordPress you will see the login screen.
Type the username and password you used when you installed your WordPress.
Note! Your WordPress login is a different login than your cPanel and your AMP. If you cannot remember your Username or Password, please see our article on Resetting your WordPress Admin Password.
After you login to the dashboard successfully you will see the WordPress dashboard.

BBA API Configuration
The BBA API Configuration section allows the user to set the API credentials required to connect to the BBA System. This will allow the WooCommerce installation to integrate and receive data seamlessly from BBA.
To connect to BBA:

1. Go to the admin panel.
2. From the side bar at the top of the page select Woocommerce > Settings.
3. On the Settings page click on the "Shipping" tab then select "BBA Logistics" from the choices below.
4. Configure the BBA Logistics - API Credentials fields as follows:

   Field	Description
   API URL	BBA System API
   Auth API URL	BBA System Authentication API
   Enable API	Set this configuration to Yes to set BBA API Credentials.
   Username	Enter your BBA account username.
   Password	Enter your BBA account password.
   Channel	Enter the Unique Marketplace Name to be used on the BBA System

5. After configuring all the fields, you must save the changes by clicking on the Save Config button to apply the changes.

BBA API Configuration –diagram 1

Note: Additional settings need to be configured on the BBA interface to be able to import data to the BBA system.

BBA Shipping Methods Settings

This section enables the user to set default values and determine the behavior of the BBA Shipping Methods.

To set the plugin's behaviors:

1. Go to the admin panel.
2. From the side bar at the top of the page select Woocommerce > Settings.
3. On the Settings page click on the "Shipping" tab then select "BBA Logistics" from the choices below.
4. Configure the BBA Logistics fields as follows:

   Field	Description
   Show Shipping Calculator in Product Page	Set value to Yes to turn this feature on.
   Default Package Height	Specify the Default Package Height. Default value is 1. During an API call, it will be sent to BBA if BBA options by product are empty.
   Default Package Length	Specify the Default Package Length. Default value is 1. During an API call, it will be sent to BBA if BBA options by product are empty.
   Default Package Width	Specify the Default Package Length. Default value is 1. During an API call, it will be sent to BBA if BBA options by product are empty.
   Default Package Weight	Specify the Default Package Weight. Default value is 1. During an API call, it will be sent to BBA if BBA options by product are empty.
   Warehouse Country	Enter Shipment Origin Country
   Warehouse Postcode	Enter Shipment Origin Postcode
   Warehouse City	Enter Shipment Origin City

   
    
   
5. After configuring all the fields, you must save them by clicking on the Save Config button.

BBA Shipping method settings –diagram 2
Order Handling
As soon as an order has been placed it gets imported into the BBA System and added to the Pending Shipments List ready to be processed. In WooCommerce, the confirmed order is found in the orders section and contains the shipping information and the tracking details as soon as the Shipment has been booked on the BBA side.
To find an order:

1. Go to the admin panel.
2. From the Side bar at the top of the page select WooCommerce > Orders
3. Select the desired order and Click on "View" to show the order details.

Store Front
Location Widget & Shipping Calculator
The Location widget is a feature that validates a buyer's address and searches it within the BBA Logistics' database. To get a list of state, postcode, or city, the widget sends a request to the BBA System to check if the location provided is serviceable. If it is, the Shipping calculator logic gets all relevant shipping rates and includes all additional costs then outputs them as shipping methods.


Product Page
In the WooCommerce product page, the location widget and shipping calculator provides a way to determine the best method and rate to ship the specific product taking into consideration the item's location, destination, price, weight and other variables.
To get available shipping methods:

1. Go to the Store Front.
2. Select the product we want to inspect by clicking on it.
3. Select a Country from the location widget.
4. Select a Postcode from the location widget.
5. Click on "Estimate" link.
6. To add the product to Cart, click on "ADD TO CART" button.

Product Page
Shopping Cart
In the WooCommerce shopping cart, the location widget and shipping calculator provides a way to determine the best method and rate to ship the all the products in the cart taking into consideration the items' location, destination, total price, total weight and other variables.
To get available shipping methods:

1. Go to the Store Front.
2. Select the products to add to cart.
3. Click on the "Cart" link on the top left had corner then click on "View Cart".
4. Click on "Calculate Shipping"
5. Select a Country from the location widget.
6. Select a Postcode from the location widget.
7. Click on the "Update Totals" button.

Shopping Cart Page



Checkout
In the checkout page, the location widget and shipping calculator provides a way to determine the best method and rate to ship the all the products in the cart taking into consideration the items' location, destination, total price, total weight and other variables.
All BBA shipping methods are retrieved from the BBA System in real time.
To get available shipping methods during checkout:

1. After Clicking on the "Proceed to Checkout" button on the Shopping Cart page, it will redirect you to checkout.
2. Fill out all required information including the country and postcode fields. Alternatively, you can login with your account and it will auto-populate all the fields.
3. Under "Shipping Methods" WooCommerce will show the available shipping methods according to the information you entered previously.

Checkout Page

Order Details
Technically a default feature of WooCommerce, the Order Details page displays the shipment information and as well as the tracking specifics from the BBA system when the order has successfully been booked.
To view the order details:

1. Login to your account on the Store Front.
2. Click on the "My Account" link on the top right corner of the page.
3. Select an order to view and then click "VIEW"

Order Details Page


BBA Marketplace Module
Connect from BBA to Woocommerce
Marketplace module, is the way we connect from BBA to Marketplaces (Woocommerce).
To connect BBA to Woocommer:

1. Login to BBA System
2. Click on the "Configuration" then click "Marketplace".
3. Click "Add" or "Edit" on Woocommerce

Instruction for use:

1. Copy & Paste your Sync URL, API Key & API Secret into the "Your Sync URL", "Your API Key" & "Your API Secret" fields, respectively.
2. Click on the "Connect" button, then click "Enable" to start importing your products and orders.

How to obtain Sync URL, API Key & API Secret:

1. Login to your WooCommerce admin panel.
2. Install "BBA Logistics" and "WooCommerce" plugins.
3. Click on "Settings" menu item under "WooCommerce" in left sidebar.
4. Click on "BBA Logistics Order Sync" tab.
5. Go to API -> Keys/Apps.
6. Click on "Add Key" button.
7. Select "Read/Write" in "Permissions" drop-down and fill "Description" field with preferred name and click on Generate button.
8. Copy & Paste "WooCommerce" website URL into the "Your Sync URL" field, i.e. http://wordpress.myshop.com/
9. Copy "Consumer Key" and "Consumer Secret" and paste into "Your API Key" and "Your API Secret" fields.

BBA Marketplace Module

Additional Support
Please go to https://bbalogistics.com.au/contact/tech-support/ and fill out the form provided or email us at: itsupport@bbalogistics.com.au.