Checkout – Aramex

WordPress Shopping Cart plugin: Aramex

Requirements

The Aramex extension plugin has the following requirements:

• WordPress Shopping Cart plugin
• Aramex extension
• Aramex account

Installation

1. Make sure that you have the WordPress Shopping Cart plugin installed and that you have purchased the Aramex Extension Plugin.

2. Download the Aramex Extension Plugin from the downloads management section in a ZIP archive (you may need to login to your Tribulant Software account in order to access your download).

3. Extract the ZIP archive named checkout-aramex.zip in order to be presented with a single folder named checkout-aramex.

4. Upload the checkout-aramex folder to the wp-content/plugins/ directory of your WordPress installation, like seen in the example image below.

Activation

Once you have installed the Aramex extension plugin via FTP you need to activate it.

To activate it you need to go to the normal Plugins > Installed Plugins section via your admin sidebar. There you will see the extension as a plugin listed amongst other plugins, look at the screenshot below.

Once you activate the plugin, then in “Checkout > Extensions” section, the Aramex Shipping Method is now available to be activated. When you hover over it a red “Activate” will appear, once activated the red message on the right becomes green text stating “Installed and Activated“.

Configuration

To configure the Aramex Shipping Method to work on your site and serve as a shipping method for the WordPress Shopping Cart plugin you need to visit the “Checkout > Shipping Methods”, “Save a Shipping Method”

1. Name
Enter a name that represents the Aramex shipping method (it will be displayed on your website in the checkout process).

2. Fixed Price
Leave this as 0 (zero) since the Aramex API will be used.

3. Status
Select “Active” or “Inactive”, depending on whether the shipping method should currently be active on the site or not.

4. Countries
Enter the countries to which this shipping method should be available. (optional)

5. Zip/Postal Codes
Enter the zip codes to which this shipping method should be available. (optional)

6. Use API

Select the “Aramex” API for this shipping method.

1. Mode
Select the type of Aramex account- live/test mode

2. EXP Product Type
Enter the international product type, you want to use for shipping. International Express product types available: PPX, DPX, DDX, GPX etc.

3. Account Country Code
Enter your account country code eg. ZA, JO, US, UK etc.

4. Account Entity
Enter the branch or entity provided by Aramex. eg. JNB

5. Account Number
Enter the account number provided by Aramex.

6. Account Pin
Enter your account pin provided by Aramex.

Aramex Account Credentials

This is usually the username/password you use to login with at Aramex.com website.

Aramex can now optionally be set as the default shipping method for the WordPress Shopping Cart plugin, under “Checkout > Configuration > Calculations> Global Shipping Configuration”

Test Credentials:

Use these test credentials for test mode:

Account Country Code =JO
Account Entity = AMM
Account Number= XXXXX
Account Pin = XXXXXX
User Name = testingapi@aramex.com
Password = R123456789$r
Version = v1.0

For the account number and account pin above, please contact Aramex and request testing credentials from their technical support for the Aramex API.

Usage

The plugin will send a request through to Aramex on the shipping step of the checkout procedure to calculate shipping for the order. Included in the request is the origin address, destination address, order weight/dimensions and other data.

Aramex will respond to the plugin request with a shipping rate based on the values of the order.

Release Notes