MarketShip

Click here to purchase MarketShip!

Minimum Requirements

MarketShip requires PHP 5.6+, WooCommerce 3.0.0+, and one of the following plugins:

    • Dokan 2.6.0+
    • WC Vendors 2.0.0+ and WC Vendors Pro 1.5.4+
    • WCFM Marketplace 3.4.0+

Installing MarketShip

To install MarketShip:

  1. Log into your WordPress site.
  2. Go to Plugins > Add New.
  3. At the top of the screen, click Upload Plugin.
  4. Select the .zip file sent to you in your Purchase Confirmation email. You have two options:
    1. Click Browse. Find and select the plugin .zip file.
    2. Drag and drop the .zip file onto the Upload Plugin screen.*
  5. Click Install Now.
  6. When the installation completes, click Activate.

* Drag and drop will only work if your browser supports it!

Activating Your License

To benefit from future updates to MarketShip, you must activate your license key. To do so:

  1. Log into your WordPress site.
  2. Go to Plugins.
  3. Find the row for MarketShip.
  4. Click activate license.
  5. Enter your license key, which was delivered along with your download.
  6. Click Activate.

Getting Started

This section describes the initial setup steps for MarketShip. You must complete these steps or vendors won’t be able to connect their Shippo accounts to calculate live shipping rates and print shipping labels.

Step 1: Obtaining a Client ID

MarketShip leverages Shippo’s OAuth Connection Flow to enable vendors to connect their Shippo accounts with the click of a button. In order for this feature to work correctly, you must obtain a Shippo Client ID and Client Secret and enter these values on the MarketShip settings page.

To get started, simply send an email to [email protected] with the following information:

Item Description
Company Name Your company’s name. This is presented to the user when they connect their Shippo account to your marketplace.
Callback URL The URL vendors are redirected to after they connect their Shippo account. This is your WordPress site URL followed by /shippo-oauth-redirect.
Contact Email Your email address.

For your convenience, we’ve created a template you can copy and paste to quickly draft this message:

Hi,

I need OAuth Credentials for my marketplace. I’ve included all requisite information below.

  • Company Name – <your company name>
  • Callback URL – <your website URL>/shippo-oauth-redirect
  • Contact Email – <your email address>

Please let me know if you need anything else.

Thanks,

<your name>

Here’s an example of what the template should look like when complete:

Hi,

I need OAuth Credentials for my marketplace. I’ve included all requisite information below.

  • Company Name – Super Market
  • Callback URL – https://example.com/shippo-oauth-redirect
  • Contact Email[email protected]

Please let me know if you need anything else.

Thanks,

John

Once your email is sent, you should receive a response within 24-48 hours. At that point you can proceed to Step 2.

Step 2: Update MarketShip Settings

Navigate to WooCommerce > Settings > Shipping > MarketShip and paste your Client ID and Client Secret into their respective fields. Click Save changes.

Congrats! Your Shippo partner account is now connected to your store and you’re ready to start configuring MarketShip.

Configuring MarketShip

MarketShip can be tailored to your marketplace’s needs with the options available under WooCommerce > Settings > Shipping > MarketShip. These options are documented below.

Features

The toggle switches under “Features” allow you to easily enable or disable core MarketShip features. Enable Shipping Calculations to let vendors use MarketShip’s shipping methods to calculate shipping rates for their products, and enable Label Printing to allow vendors to purchase and print shipping labels from the vendor dashboard.

Shipping Calculation Settings

When Shipping Calculations is enabled, settings specific to shipping calculations will appear on the screen.

The available settings are:

  • Per-Product Shipping – Enable Per-Product Shipping (PPS) to let your vendors choose a different shipping method for each of their products. Leave it disabled to force vendors to choose a single shipping method for all of their products.
  • Enabled Shipping Methods – The shipping methods selected in this list will be available for vendors to use. For instance, if you select Live Rates and leave all other shipping methods deselected, vendors will only be able to use the Live Rates shipping method. By default all shipping methods are enabled.
  • Use Admin Account for Calculations – Enable to use your Shippo account to calculate live shipping rates during checkout. Vendors will be able to select from the carriers you’ve set up in Shippo on the Live Rates settings page, so if you’ve set up UPS and USPS and a vendor only wants to ship via USPS they can do so. Note that your account will only be used to calculate shipping rates at checkout – vendors will still have to connect their own Shippo account to purchase and print shipping labels.
  • Connect Shippo Account – Use this button to connect or disconnect your Shippo account when Use Admin Account for Calculations is enabled.

Shipping Products

MarketShip includes several flexible shipping methods for your vendors. This section describes how vendors can use these shipping methods to ship their products.

Configuring Shipping Methods

When Shipping Calculations is enabled vendors can configure the shipping methods for their store on the vendor shipping settings page. The settings page is located under Settings > Shipping in the vendor dashboard.

If Per-Product Shipping is enabled, vendors will be able to choose a Default Shipping Method for their products. The default shipping method is used for all products unless a different shipping method is selected for the product on the Edit Product screen. If Per-Product Shipping is disabled, vendors will be able to choose which shipping method is enabled for their store instead. In this case the selected shipping method will be used for all of the vendor’s products.

If a shipping method has store level settings, a Configure button will appear next to the method description. Clicking this button will open the settings page for the selected shipping method.

Please consult the MarketShip Shipping Methods section of this document for a description of the MarketShip shipping methods and their settings.

Choosing the Shipping Method for a Product

When Per-Product Shipping is enabled, vendors can select a single shipping method for each of their products. The product shipping method can be set using the Shipping Method dropdown on the add/edit product screen. For Dokan users this can be found under Shipping and Tax, whereas for WC Vendors and WCFM Marketplace users it is located under the Shipping tab.

Choosing a shipping method for a product (Dokan depicted)

By default, all products use the Default Shipping Method configured at the store level. The shipping method can be changed by unchecking Use Default.

If a shipping method has product level settings, new settings fields will appear when that method is selected. Continue reading to learn about the product level settings for each MarketShip shipping method.

If Per-Product Shipping is disabled, the Shipping Method dropdown and Use Default checkbox will be hidden, but product level settings for the vendor’s enabled shipping method (if any) will still appear.

MarketShip Shipping Methods

This section describes the MarketShip shipping methods and documents their product and store level settings (if any).

Core Shipping Methods

These shipping methods are provided by MarketShip and are always available regardless of which marketplace plugin you’re using.

Live Rates

The Live Rates shipping method calculates live shipping rates from multiple carriers with Shippo. It’s a great option for vendors who want to provide accurate, real time shipping quotes to their customers at checkout.

Store Level Settings

The Live Rates method has a number of store level settings, depicted in the screenshot below.

Live Rates store level settings

The settings are:

Live Rates

Controls whether the Live Rates method is enabled or not.

Shippo Account

Allows vendors to quickly connect or disconnect their Shippo account using Shippo’s OAuth Flow. If “Use Admin Account for Calculations” is enabled this option will not appear.

Carriers

This option appears when “Use Admin Account for Calculations” is enabled and allows vendors to control the shipping carriers used to calculate shipping rates for their products. The carriers that appear in this list are populated from the admin’s connected Shippo account.

When “Use Admin Account for Calculations” is disabled, the carriers configured in the vendor’s connected Shippo account are used to calculate shipping rates and this option does not appear.

Packing Strategy

In order to provide accurate shipping quotes, the Live Rates method must pack the vendor’s items into one or more boxes. This option allows the vendor to control how their items are packed. There are two choices:

  • Pack items individually – Pack each item separately into the smallest box that can fit it.
  • Pack items together – Pack items into one or more boxes using the BoxPacker algorithm.

Pack items together will generally yield the most accurate shipping rates, but Pack items individually may be more appropriate for certain vendors.

Rate Adjustment

This gives vendors the ability to adjust carrier returned shipping rates up or down by a fixed amount or percentage. This can be used, for instance, to account for the cost of packing materials.

Boxes

In order to pack the vendor’s items at checkout, Live Rates needs to know the boxes the vendor will be using for shipping. The vendor can manage their shipping boxes in this section.

To add a new box, simply click Add Box. For your convenience, you can either select from a predefined box template or choose to enter a custom box. Please note that when entering a custom box you should enter the box’s outer dimensions. The inner dimensions will be estimated automatically.

Adding a box in MarketShip

To edit or delete a box, click the pencil icon or trash icon, respectively, next to that box in the Boxes table.

Please note that when “Use Admin Account for Calculations” is enabled box templates from carriers the vendor has disabled will not be displayed.

Usable Box Volume

By default, MarketShip will only use 85% of a box’s inner volume for packing. This is to account for extra space occupied by packing materials, instruction manuals, and so on. Developers can increase or decrease the usable box volume with the marketship_usable_box_volume filter.

Carrier Box Templates

When “Use Admin Account for Calculations” is enabled, MarketShip will only display boxes from carriers the vendor has enabled.

Too Large Items

Items that can’t fit into one of the vendor’s configured boxes will be packed into a box the same size as the item. Developers can disable this behavior with the marketship_pack_oversized_items filter.

Product Level Settings

None.

Flat Rate

The Flat Rate method allows vendors to set a flat shipping rate for each geographical region they ship to. Currently shipping rates can be defined for continents, countries, and states. This shipping method is great for vendors who want to offer simple flat shipping rates and reuse those rates across multiple products.

Store Level Settings

Vendors can configure one or more flat rate Shipping Profiles at the store level. Shipping profiles are essentially a set of flat shipping rates with a name, and they provide a way for vendors to easily reuse shipping rates for items with similar shipping requirements. For example, vendors might set up a “Heavy Items” profile with flat rates for items above a certain weight and a “Standard” profile with rates for their other items.

Flat Rate shipping method settings page

Vendors must designate one shipping profile as their default shipping profile. The default shipping profile is used for products where another profile has not been assigned and cannot be deleted.

The default shipping profile can be changed by clicking the “star” button next to the new default profile. There are also buttons to edit, delete, and duplicate a shipping profile.

The Add Profile button opens a modal where vendors can create a new shipping profile.

Adding a new shipping profile called My Shipping Profile

As you might guess, the Name field is where the vendor sets the name for the new shipping profile and shipping rates are entered under Shipping Rates.

Rates can be defined for continents, countries, and individual states. Continental rates can be overridden for individual countries and country rates can be overridden for individual states. There’s also a handy “Everywhere Else” option that can be used when the shipping cost is the same in all but a few places.

To illustrate how flat rates are calculated, the shipping rate for a product configured to use the “My Shipping Profile” profile above would be calculated as $5 for a customer with a shipping address in New York, $10 for a customer elsewhere in the U.S., and $12 for a customer outside of the U.S.

Product Level Settings

The Flat Rate method has a few product level settings as depicted in the screenshot below.

The settings are as follows:

Shipping Profile

Allows the vendor to select the shipping profile to use for the product. The shipping profile marked as the default profile on the Flat Rate shipping settings page will be selected by default.

Calculation Method

Controls how the shipping rates defined in the selected shipping profile are applied to calculate the shipping cost for the product. There are two choices:

  • Apply rate once per product – When selected, the shipping rate applicable for the customer’s location will be applied only once for the product. If the shipping rate is determined to be $5 and the customer purchases 3 of the product, the customer will be charged $5 in shipping for the product.
  • Apply rate once per quantity – When selected, the shipping rate applicable for the customer’s location is applied once per quantity of the product purchased. If the shipping rate is determined to be $5 and the customer purchases 3 of the product, the customer will be charged $15 in shipping for the product.

Maximum Charge

Allows vendors to set a maximum shipping charge for the product. Useful when combined with the “Apply rate once per quantity” calculation method.

Free Shipping

The Free Shipping method is very simple. When selected, shipping will not be charged for the product. It’s perfect for vendors who want to ship their products for free. This shipping method has no store level or vendor level settings.

Dokan Pro Shipping Methods

Product Shipping

This shipping method is available when the old Dokan Shipping method is enabled under WooCommerce > Settings > Shipping > Dokan Shipping. Its functionality and settings are identical to the old Dokan Shipping method.

Please consult the Old Dokan Shipping Method documentation for more information.

Shipping Zones

This shipping method is available when Dokan Pro is installed and the Vendor Shipping shipping method has been added to one or more WooCommerce Shipping Zones. Its functionality and settings are identical to those provided by Dokan Zone Wise Shipping.

Please consult the Dokan Zone Wise Shipping documentation for more information.

Note for Established Dokan Pro Marketplaces

MarketShip will set the Default Shipping Method for all vendors to either Product Shipping or Shipping Zones based on whether the vendor has the Old Dokan Shipping method enabled or not. This measure ensures that your checkout continues to function normally as vendors adopt the new shipping system.

WC Vendors Pro Shipping Methods

Seller Shipping

This is simply a MarketShip compatible version of the WC Vendors Pro Shipping System. Please refer to the WC Vendors Pro documentation for details.

WCFM Marketplace Shipping Methods

Store Shipping by Zone

This is a MarketShip compatible version of the Shipping by zone shipping method from WCFM Marketplace. It is available when at least one WooCommerce shipping zone has the WCFM Store Shipping shipping method added to it.

Store Shipping by Weight

This is a MarketShip compatible version of the Shipping by weight shipping method from WCFM Marketplace. It is available when the Marketplace Shipping by Weight shipping method is enabled under WooCommerce > Settings > Shipping > Marketplace Shipping by Weight.

Store Shipping by Country

This is a MarketShip compatible version of the Shipping by country shipping method from WCFM Marketplace. It is available when the Marketplace Shipping by Country shipping method is enabled under WooCommerce > Settings > Shipping > Marketplace Shipping by Country.

Store Shipping by Distance

This is a MarketShip compatible version of the Shipping by distance shipping method from WCFM Marketplace. It is available when the Marketplace Shipping by Distance shipping method is enabled under WooCommerce > Settings > Shipping > Marketplace Shipping by Distance.

The WCFM Marketplace shipping methods are not compatible with Per-Product Shipping. You must disable Per-Product Shipping on the MarketShip settings page in order to use these shipping methods.

Table Rate Shipping

If you are also running our Table Rate Shipping plugin, TRS will appear as a shipping option to your vendors.

Printing Labels

When the Label Printing feature is enabled vendors can print shipping labels in multiple formats straight from the vendor dashboard. Here’s how that process works:

  1. Go to the Orders page in the vendor dashboard. Either select an order (Dokan and WCFM Marketplace) or hover over an order row and click the Shipping Labels link that appears (WC Vendors Pro). You will now see a list of shipping labels similar to this:

  1. To print a shipping label for your order:
    • Click Create new label
    • If this is your first time attempting to print a label you will be prompted to create or connect a Shippo account. Click “Create or connect account” and follow the on-screen instructions to complete this process.
    • Enter the full address you’re shipping from, if it’s the first time printing a shipping label.
    • Verify the destination address.
    • Enter the weight and dimensions of the box you’re shipping. If you’re using the Live Rates shipping method you can either select from one of the boxes that was computed at checkout or enter a custom box.
    • Optionally add extras like shipping insurance.
    • Select the desired shipping service/rate.
    • Select label format (optional).
    • Buy & Print
  2. After clicking Buy & Print, label(s) are automatically opened in a print dialog.

Some browsers, like Firefox, don’t support automatic label printing. If you’re using one of these browsers, the label(s) will open in a new tab instead.

The Shipping Labels box will display the label(s) you purchased, and contains the tracking number for your shipment. The tracking number(s) will be included in the email sent to your customer when the order is marked “completed.”

You can also reprint your label or request a refund, if necessary. Click the three ellipsis menu for the label to reveal these options.

Shortcodes

MarketShip comes with a [marketship_tracking_numbers] shortcode for displaying a table of tracking numbers for an order. The shortcode has two attributes:

  • order_id – Order ID (required)
  • table_class – Optional CSS class for the tracking numbers table. Default: marketship-table.

For example, you could use the following shortcode to output a table of tracking numbers for order 123:

[marketship_tracking_numbers order_id="123"]

Click here to purchase MarketShip!

Updated on July 12, 2020

Was this article helpful?

Related Articles