com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro ' display' is unknown.

BBA Mastro WooCommerce Plugin Getting Started Guide

Owned by Albert Hufana (Unlicensed)
Last updated: Apr 25, 2018 by joey ga-as
7 min read

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 Mastro" from the choices below.

  4. Configure the BBA Mastro - 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 Mastro" from the choices below.

  4. Configure the BBA Mastro 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

Product Page

The WooCommerce product page, is where you can add items to your cart. You can add products by following the steps below.

To add products to your cart:

            1.Go to the Store Front.

             2.Select the product we want to inspect by clicking on it.

             3.Click on “ADD TO CART” button.




Product Page
Shopping Cart

The WooCommerce shopping cart is where you can view all the items that you want to purchase. It also automatically determines the best method and rate to ship 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 product to add to cart.
  3.  Click on the "Cart" link on the top left-hand corner then click on "View Cart".
  4. Select a county from the location widget.
  5. Select a state from the location widget.
  6. Enter a suburb in the location widget.
  7. Enter a postcode in the location widget.
  8. Click on "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 Mastro" and "WooCommerce" plugins.
  3. Click on "Settings" menu item under "WooCommerce" in left sidebar.
  4. Click on "BBA Mastro 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://bbamastro.com/contact/tech-support/ and fill out the form provided or email us at: itsupport@bbalogistics.com.au.




Download File: