Version 1.1.5 - Released: Jan 31, 2018

  • New: support to WordPress 4.9.2
  • New: support to WooCommerce 3.3.0
  • Update: plugin framework 3.0.11
  • Dev: new filter yith_wcdn_url_suborder

Version 1.1.4 - Released: Jan 05, 2018

  • Fix - vendor notification when there it is in the same rule with others roles
  • Fix - vendor notification when there it is in the same rule with others roles
  • Dev - added filter yith_wcdn_name_products
  • Update - Plugin core

Version 1.1.3 - Released: Oct 10, 2017

  • New: Support to WooCommerce 3.2.0 RC2
  • Update: Plugin core

Version 1.1.2 - Released: Jul 27, 2017

  • New - Added low stock notification

Version 1.1.1 - Released: Jul 26, 2017

  • New - Brazilian translation (thanks to Guilherme Tumolo)
  • New - Italian translation (thanks to Antonio Mercurio)
  • fix - display notifications only when a product is sold
  • dev - yith_wcdn_change_protocol filter

Version 1.1.0 - Released: Mar 09, 2017

  • New - support to WooCommerce 2.7.0-RC1
  • Update - YITH Plugin Framework
  • Fix - display notifications for all roles

Version 1.0.1 - Released: Jan 11, 2017

  • New - compatibility with Request a Quote
  • New - compatibility with Title Bar Effects
  • Fix - issue when registering notification and Multi Vendor is activated
  • Fix - issue with "request permission" on IE
  • Fix - issue with undefined notifications
  • Fix - issue with "request permission" on safari

Version 1.0.0 - Released: Nov 02, 2016

  • Initial Release

Manual localization

In this page you can learn how to translate manually language files. This process requires you to translate the .pot file included in the "languages" folder of the plugin and to set the WordPress site with the matching the language.
Let's list now all requested steps to complete process.

Change site language

Firstly, you need to change the language of your WordPress platform in order to display the translated plugin.

Go to the page and select the language in which you want to translate the plugin.

If the translation for the language you have selected si available for the download, click on the button to download the zip file.

Unzip the package you have downloaded and copy all files in the path wp-content/languages inside your WordPress installation.

If no translation is available for the language you have selected, download WordPress in the language you want, go to wp-content/languages, copy all files you find in the "wp-content->languages" folder and paste them in the same folder of the WordPress installation you want to translate.

Now open the administration panel of your theme and go to the "Settings -> General" section. At the bottom of the page, select the new language for your installation and click on "Save changes".

Now all WordPress options will be showed in the selected language.

Language file of the plugin

The original language file of the plugin is yith-desktop-notifications-for-woocommerce.pot and it is included in the "languages" folder of the plugin. In order to create the new language file, follow these steps.

Download Poedit, the software you need to translate the strings of the plugin. Now open the file yith-desktop-notifications-for-woocommerce.pot and click on the "Create new translation" button.

Select the language in which you want to translate the plugin.

Now translate the strings one by one. Once finished, click on the "Save" button and rename the file adding the slug of the plugin to the suggested file name (e.g., yith-desktop-notifications-for-woocommerce-it_IT).

If everything worked fine, the .po and .mo files will be created automatically in the "languages" folder of the plugin.

WPML localization

WPML simplifies the building of multilingual sites and their functioning. It's powerful enough for corporate sites, yet simple for blogs. With WPML, you can translate pages, posts, custom types, taxonomy, menus and even the theme's texts.

This plugin works with the WPML plugin.

Getting started

First of all, you need to purchase the most recent version of the WPML plugin and include the String Translation and Translation Management modules that you can find inside the package you get after the purchase. These two elements are essential for the correct use of the plugin.

WPML is composed of different modules, depending on the purchased version, and every one offers various options about the translation of your site. Once activated, a tab will appear on the dashboard of your installation and from there you will be able to change all the settings you want.

WPML Language Configuration

Choose the languages you want to set for your site and set the content management in the different languages.

If this is the first time that you configure WPML, select the language of the current content. Later, you can add a language selector in your theme to allow users to change it: you can customize its style and the number of languages to show, as you can see.

Theme and plugin localization

WPML lets you localize plugin with the classic .mo file, or translating the text directly from WPML.

In the first case, it will suggest the translation of many strings, so you will just have to choose the second option from the localization menu and set the domain of the text of the plugin. On the contrary, if you choose the first option as in the image above, you will start the WPML localization plugin scanning all strings, and getting the texts that can be translated. You can add the translation of the relative text from WordPress itself: for further information go to this page.

String translation

With WPML you can translate the YITH Desktop Notifications for WooCommerce strings in the desired language.
When we talk about strings, we are referring to all those labels and related contents, from option and widget names to all the texts showed to users with the plugin features.

As a first step go to WPML -> Theme and plugins localization, select the plugin and click on "Scan the selected plugins for strings" (we used YITH Plugin as an example)

Click on String Translation, the entry you can find in the WPML sub-menu.

In the top part of the page, WPML lets you select the "context" in which search for the strings, and to specify the string you want to translate.

To translate the string that you search, select the plugin YITH Desktop Notifications for WooCommerce domain. Our sample plugin text-domain is "yith-sample-plugin".

Add the string in the related search field.

Select the entry you want to translate, add the translated string, tick the Translation is complete option and click the Save button.

Now the status will be Translation Complete and the string will be correctly displayed in the selected language.


WPML offers to users its language selector as a drop-down list of languages: if you are searching for something different, you can always go to this page. for further information.
For more information about the WMPL configuration, please read the official documentation.

General notes

It is essential to allow the browser to receive the notifications to show them and let the plugin work in the correct way.

Allow notifications

Each type of notification must be created and configured first since the plugin doesn’t enable any for your shop by default.

The notifications can be enabled for 5 different actions:

  • each purchase made
  • each purchase associated to a specific product
  • a refunded order
  • an order status change
  • a product status turns into “Out of stock”

The system checks possible available notifications every 10 seconds to not undermine the site performance.
This parameter can be edited at any time in the “Check new notifications” entry of the settings dashboard.

Check new notification

Let’s see how to configure a new notification.

Notification creation

Go to YITH Plugins -> Desktop Notifications and click on “Add new notification”.

Add new notification

Select the type of notification and associate a title and description to it.
Through the use of specific placeholders, you can include in the description any information about the product, order and user.

  • {username}: username of the user who made the purchase
  • {order_id}: id of the created order
  • {products_sold}: list of the products sold
  • {order_total}: total amount of the order
  • {product_name}: product name
  • {new_status}: new status associated to the order
  • {old_status}: old order status

The notification is shown for the same duration configured in “Notification length” (in seconds)

To see the notification preview, click on the “Preview notification” button.

Notification preview

Icons and sounds

You can find the complete list of icons and sounds in the “Upload” section. Icon notification

Sound notification

In addition to the available elements, the plugin gives you the possibility to upload new icons (.png -.jpg) and sound (.mp3)

Installation Instructions

Install the plugin in your WordPress platform: add the .zip file you have downloaded in the WordPress plugins directory (wp-content->plugins). You can also achieve the same result using the upload feature of WordPress to upload the Zip file.
Then click on the "Add new" option in you can find in Plugins, anc click on the "Upload Plugin" button.

After completing the upload of the plugin, you can activate it. Go to "Plugins", select the plugin and click on the "Activate" option.

License activation

In order to work correctly, the plugin must be installed following the previous steps. However, if you have purchased the premium version of the plugin and you want to benefit from automatic updates of the development team, or access to the support platform to receive help by our staff, you need to activate the plugin.

Go to your member are on and click on the "License" tab to get your license key for the activation of the plugin.

Now access your WordPress platform, go to the "YITH Plugins" option and add you license key in the License Activation tab.

If the activation process worked fine, you will see a screen like the following one.

Renew license

License can be updated in "License" section in your reserved area of YIThemes, or in YITH Plugins -> License Activation on your site.

License updating occurs by the new purchase of the product related to the plugin. You only need to click "Renew" button: you will be redirected to and the product will be automatically added to cart.

Once updated, new license expiration date will be set to the same day and month of the next year. The only exception concerns those updatings done before the expiration date: in this case validity will be extended to one year from expiration date.

After purchasing, you don't have to do anything else. If in "YITH Plugins -> License Activation" expiration date isn't updated we suggest you to click "Update license information" button.