WooCommerce DYMO Print Product Add-on

The following documentation is for WooCommerce DYMO Print Product add-on version 3.0 which is released in January 2017.

WooCommerce DYMO Print Product add-on is an extension to our popular WooCommerce DYMO Print plugin. WooCommerce DYMO Print Product add-on needs to be purchased separately.

This plugin let’s you print product labels on your DYMO LabelWriter. It will not work without WooCommerce DYMO Print.

Installation

WooCommerce DYMO print - menuMake sure WooCommerce and WooCommerce DYMO Print are installed.

  1. Download the .zip file from your account
  2. Upload the entire ‘woocommerce-dymo-print-product’ directory into the ‘/wp-content/plugins/’ directory
  3. Activate the plugin through the ‘Plugins’ menu in WordPress
  4. Configure the plugin by going to WooCommerce -> DYMO Print
  5. Enter the license key for this plugin in our WP Fortune plugin to get support and updates

Settings overview

This plugin is an extension for WooCommerce DYMO Print. It will add a new tab called “Product label” to the settings page.

Before you can print product labels it’s important to configure the plugin correctly.

Click here for more information about the plugin settings.

1. Create labels

You can create your own labels in DYMO Label Software. You can do this in the same way as you create order labels. For a step-by-step instruction read the following article about creating labels.

2. Configurating your label

After creating your label with the DYMO Label Software (DLS) you need to upload it in the plugin. After you have choosen your label, you need to configure it. You need to assign WooCommerce product data to label-objects (fields). Read more about label configuration in this article.

Available product data

WooCommerce DYMO Print Product add-on will add the following WooCommerce data to each object selectbox:

Product data

  • Product name
  • SKU
  • Product short description
  • Product URL
  • Stock level
  • Dimensions
  • Weight
  • Categories
  • Tags

Attributes & Variations

  • All attributes with label: shows all attributes with it’s label (attribute name)
  • All attributes without label: shows all attributes without attribute name
  • Only variations with label: shows only variations with attribute name
  • Only variations without label: shows only variations without attribute name
  • Attributes with label, skip variations: shows only attributes (no variations) with attribute name
  • Attributes without label, skip variations: shows only attributes (no variations) with attribute name

Product prices

  • Display price incl. tax: Shows price range if is variable product (added in version 3.0.4)
  • Display price excl. tax: Shows price range if is variable product (added in version 3.0.4)
  • Regular price incl. tax: Shows price range if is variable product
  • Regular price excl. tax: Shows price range if is variable product
  • Sales price incl. tax: Shows discounted price if available, Shows price range if is variable product
  • Sales price excl. tax: Shows discounted price if available, Shows price range if is variable product

Only for variable prodcuts

  • Variation SKU: Shows variation SKU only for variable products (if available)
  • Variation description: Shows variation description if avaiable
  • Parent Product display price range incl. tax (added in version 3.0.4)
  • Parent Product display price range excl. tax (added in version 3.0.4)
  • Parent Product regular price range incl. tax: For variable products, shows min and max price
  • Parent Product regular price range excl. tax: For variable products, shows min and max price
  • Parent Product sales price range incl. tax: For variable products, shows min and max sales price if available
  • Parent Product sales price range excl. tax: For variable prodcuts, shows min and max sales price if available

Product metadata

  • Shows all product metadata. There must be at least one product to show product metadata.
  • Shows all product variation metadata (since version 3.0.6) when available.

Note: If a product variation has specific product variation metadata this will be printed. If the object returns empty for product variation metadata it will try to receive product metadata for that variation.

Print labels based on stock

There is also a new setting added called “Print labels based on stock”. By changing this setting you can define if the product stock is used to print labels.

This setting has two options:

  1. Yes: Use the stock quantity to print labels. For example: if your stock quanity is 6, print 6 labels.
  2. No: Ignore stock quantity. Print one label for each product.

Bulk print variable products

You can bulk print labels from the product overview. With this setting you can define how product variables will be printed. This setting has 3 options:

  1. Yes – Product parent label: Print label for the parent product. Variations will be ignored.
  2. Yes – Variations labels: Print label for each variation. If a product contains 6 variations, print 6 labels.
  3. No: Skip all variable products during bulk printing.

Change label settings for products

The following animation shows how we select WooCommerce product data for product labels. The label file in the animation is available from the Sample label page.

DYMO - Change product label settings

3. How to print labels

Once you’re all set you can start printing labels from the product overview page and product detail page. First you need to select a printer for product labels.

3a. Bulk print product labels

A pop-up window is opened to print labels. Please disable any pop-up blockers.

From the product overview page you’re able to select multiple products and print labels for them in bulk.

Please note: The number of labels is depending of the setting “Print labels based on stock” and of the setting “Bulk print variable products” (see above at step 2) .

DYMO - print product labels in bulk

Step-by-step instructions

Follow these steps to print products in bulk.

  1. Go to Products (Product overview page)
  2. Select one or more products, by clicking on the checkbox before the product
  3. Go to Bulk Actions and select the label you want to print
  4. Click on the Apply button
  5. The page is reloaded and a pop-up window opens
  6. Printing is started for each label
  7. After printing is finished the pop-up window will close automatically

3b. Detail page – Simple products

A pop-up window is opened to print labels. Please disable any pop-up blockers.

From the product detail page you can print labels.

DYMO - print labels of simple product

Step-by-step instructions

  1. Go to Products
  2. Click to view / edit a product
  3. Find the metabox called “DYMO Print Product
  4. Select the label you want to print
  5. Define the amount of labels
  6. Click the Print label(s) button
  7. A pop-up is opened to print labels
  8. After printing is finished the pop-up window will close automatically

3c. Detail page – variable products

A pop-up window is opened to print labels. Please disable any pop-up blockers.

From the product detail page you can also print labels for variable products.

DYMO - print labels for variable products and product variations

Extra options for variable products

If you print labels for variable products you’ll see an extra setting called “Variable product”. This setting has 3 options:

  • Parent product: Print all product data from the parent product
  • All variations: This will print a label for each variation
  • Available varations: Select the variation you want to print a label for

Add new product labels

If you need more different labels for products you can add them with the wpf_woocommerce_dymo_labels filter. For more information about this filter see: Extra options – code samples.

Back-up first! If you do something wrong, adding code to your functions.php can break your site!
Filters are for advanced users only.

Basic example to add product label

Add the following code to your theme functions.php or a custom plugin to add a new product label.

What do you need to change in the code?

The key of the label. In the example: new-product-label (line 2).
The key must be unique and may not contain any spaces, numbers or special characters.

The name of the label. In the example: New label (line 3).
The name is shown in the DYMO settings and on print buttons. Change it to whatever you want.

The color of the label icon. In the xample: #ff3300 (line 4).
The color makes you recognize the label a lot easier. Use any HTML color. Don’t forget the hashtag (#).

The type of the label. In the example: product (line 5).
Use “product” for product labels. Also allowed: order (for order labels) & order_item (for order item labels).

Do not alter the filter name “wpf_woocommerce_dymo_labels“, otherwise the filter becomes quite useless.

Sample labels

We’ve created some sample product labels which you can download and upload to the plugin.

More information?

If you want to read more information go to WooCommerce DYMO Print documentation. There you’ll find more about debugging, FAQ and extra options.