# Improved Badges for WooCommerce

Please read the full documentation to use the plugin properly! Thank you!

Visit Mihajlovicnenad.com

### Help us out, let's boost the plugin experience! - Thanks!

Got translation files? Please send those over! Send us an email using the contact form here Mihajlovicnenad.com. Thanks!

### Improved Badges for WooCommerce Change Log

To see last changes in the Improved Badges for WooCommerce plugin click here → Improved Badges for WooCommerce Change Log

## 1. Installation, plugin features and automatic updates?

Introducing the Improved Badges for WooCommerce, installation and registration!

1. Plugin Features
2. Plugin Installation
3. Automatic Updates NEW
4. Theme Specific Installations
   1. Default Settings - Avada, Bridge, Divi, Flatsome, Listify, Salient, The 7, X Theme and all WooThemes, Elegant Themes and Default WordPress Themes
   2. Atelier
   3. BeTheme
   4. Enfold
   5. Legenda
   6. Shopkeeper

Go to section »

## 2. Plugin settings and how to use?

Plugin settings and options, check this section for more information!

1. Using the Improved Badges for WooCommerce
   1. Basic Settings
   2. Installation , Registration and Advanced Settings
2. Single Product Settings Tab
3. Badge Shortcode `[ib_badge]`

Go to section »

## 3. How to and FAQ?

FAQ and a small knowledge base on the issues.

1. How to insert badges manually (programatically) into PHP files?

Go to section »

## 4. Support

If you come across on some installation, or any other problems, here is where to find us!

1. Where to get support?
2. Plugin author and contact / Mihajlovicnenad.com
3. Older Announcements and Change Logs

Go to section »

## 1. Installation, plugin features and automatic updates?

Introducing the Improved Badges for WooCommerce, installation and registration!

## 1.1 Plugin Features

This documentation will help you understand your new plugin, and get the most out of it. Please read full documentation in order to use it properly.

Improved Badges for WooCommerce is a plugin that will add designs for sale, featured, new and similar badges in your WooCommerce shop. Check plugin demo pages here!

- Sale badges with percent and money saved!
- Featured product badges
- New product badges
- Add badges to categories or tags!
- 50+ badge designs
- Easy installation
- Responsive badges
- Timers and counters
- Automatic updates from your WordPress Dashboard
- Works with the Product Filter!
- and a lot more!

## 1.2 Plugin Installation

Provided information in this section covers the plugin installation updates and registration.

To install this plugin you must have a working version of WordPress and WooCommerce plugin already installed. Download the Improved Badges for WooCommerce archive from Codecanyon.net, extract the archive and inside you will find plugins files, documentation and translations. In the archive file containing the installable plugin is named `improved-sale-badges.zip`.
Please Note: You can install the plugin in two ways: inside WordPress, or via FTP. If you have trouble installing the theme inside WordPress, please proceed with installing it via FTP and you will be able to get around the issue

### Installing from WordPress

Follow the steps below to install inside WordPress

- Navigate to `Plugins`
- Click Install `Plugins` and click `Add New`
- Click the `Upload Plugin` button
- Navigate `improved-sale-badges.zip` on your computer and click `Install Now`
- When installation is done please click `Activate` to activate your newly installed Improved Badges plugin

After installation, activate the plugin and check your new Improved Badges for WooCommerce! Navigate to `WooCommerce > Settings > Improved Badges` for the plugin settings page!

### Installing via FTP

Follow the steps below to install via FTP

- Unzip `improved-sale-badges.zip` to a desired location on your HDD. These extracted files will be uploaded later via FTP
- Connect to your server via FTP
- Navigate to `/wp-content/plugins/` server directory
- Locate the local directory where you have unzipped the `improved-sale-badges.zip` archive
- Upload local folder `/improved-sale-badges/` to remote `/wp-content/plugins/`
- To activate the newly installed plugin navigate to `Plugins` and click the `Activate` button

After installation, activate the plugin and check your new Improved Badges for WooCommerce! Navigate to `WooCommerce > Settings > Improved Badges` for the plugin settings page!

## 1.3 Automatic Updates

Plugin automatic updates are available! Just use Envato Market (https://envato.com/market-plugin/) plugin!

To get automatic updates within your website WordPress Dashboard use the Envato Market (https://envato.com/market-plugin/) plugin. This plugin, once installed, will allow you to update all plugins and themes purchased on CodeCanyon or Themeforest, so feel free to use this standardized solution! To get this to work, you need to navigate here → Envato Market (https://envato.com/market-plugin/) and install and activate this plugin. Once done, plugin will connect to the Envato platform and acquire your purchase information. Then you can update all plugins and themes directly in your WordPress Dashboard! Sounds awesome!

## 1.4 Theme Specific Installations

Some themes require a bit of attention!

Templates that do not show the sale badges automatically are not standard WooCommerce themes and need some modification in order to work as expected. These problems are caused mainly by not following WooCommerce best coding practices when designing themes. However, we have provided these specific theme installations that are known to be troubling. If your theme is in the list just follow the installtion instuctions.

## 1.4.1 Default Settings - Avada, Bridge, Divi, Flatsome, Listify, Salient, The 7, X Theme and all WooThemes, Elegant Themes and Default WordPress Themes

These themes work as expected with the default settings: Avada, Bridge, Divi, Flatsome, Listify, Salient, The 7, X Theme and all WooThemes, Elegant Themes and Default WordPress Themes.. The default settings follow, if the specified option is empty, just leave it empty.

- USE TEMPALTE OVERRIDES: `Checked`
- SHOP INIT ACTION:
- SINGLE PRODUCT INIT ACTION:

NOTE: In Avada, you'll need to add following snippet to your custom CSS.

    .isb_sale_badge {z-index:51;}

## 1.4.2 Atelier

To install Improved Badges properly on Atelier theme, navigate to `WooCommerce > Settings > Improved Badges` and set the `Installation, Registration and Advanced Settings` accordingly to the following settings.

- USE TEMPALTE OVERRIDES: `Unchecked`
- SHOP INIT ACTION: `woocommerce_before_shop_loop_item`
- SINGLE PRODUCT INIT ACTION: `woocommerce_before_single_product_summary:15`

Also, you can hide the default badge with this custom CSS code.

    .woocommerce .badge-wrap {display:none!important;}

## 1.4.3 BeTheme

To install Improved Badges properly on BeTheme theme, navigate to `WooCommerce > Settings > Improved Badges` and set the `Installation, Registration and Advanced Settings` accordingly to the following settings.

- USE TEMPALTE OVERRIDES: `Checked`
- SHOP INIT ACTION: `woocommerce_before_shop_loop_item`
- SINGLE PRODUCT INIT ACTION:

Also, you can hide the default badge with this custom CSS code.

    .woocommerce .onsale {display:none!important;}

## 1.4.4 Enfold

To install Improved Badges properly on Enfold theme, navigate to `WooCommerce > Settings > Improved Badges` and set the `Installation, Registration and Advanced Settings` accordingly to the following settings.

- USE TEMPALTE OVERRIDES: `Checked`
- SHOP INIT ACTION: `woocommerce_before_shop_loop_item`
- SINGLE PRODUCT INIT ACTION:

Also, you can hide the default badge with this custom CSS code.

    .woocommerce .onsale {display:none!important;}

## 1.4.5 Legenda

To install Improved Badges properly on Legenda theme, navigate to `WooCommerce > Settings > Improved Badges` and set the `Installation, Registration and Advanced Settings` accordingly to the following settings.

- USE TEMPALTE OVERRIDES: `Unchecked`
- SHOP INIT ACTION: `woocommerce_before_shop_loop_item:10`
- SINGLE PRODUCT INIT ACTION: `woocommerce_before_single_product_summary:15`

Also, you can hide the default badge with this custom CSS code.

    .label-icon.sale-label {display:none!important;}

## 1.4.5 Shopkeeper

To install Improved Badges properly on Shopkeeper theme, navigate to `WooCommerce > Settings > Improved Badges` and set the `Installation, Registration and Advanced Settings` accordingly to the following settings.

- USE TEMPALTE OVERRIDES: `Unchecked`
- SHOP INIT ACTION: `woocommerce_before_shop_loop_item:10`
- SINGLE PRODUCT INIT ACTION: `woocommerce_before_single_product_summary:15`

## 2. Plugin settings and how to use?

Plugin settings and options, check this section for more information!

## 2.1 Plugin Settings

Using the plugin is very easy! Read more here!

Improved Badges for WooCommerce is a simple plugin that will automatically add new badges to your Shop. If you do not see any change, please check the `Theme Specific Installations` section. Navigate to `WooCommerce > Settings > Improved Badges` to configure the plugin.

To setup the default badge click the `Default Badge` tab.

## 2.1.1 Default Badge

Setup default badge in this section!

## Select Style

Use this select box to cycle thru styles. Styles will be added as the plugin gets updated.

## Select Color

Select color to use. If you want to use custom colors I suggest you to edit the `colors.css` in the `/improved-sale-badges/assets/css/` folder as this is the best practice for these kind of small plugins.

## Select Position

Position can be either on the left or on the right. The position on the single product pages is always on left. If you want to alter these settings once again you should edit the styles.css in the `/improved-sale-badges/assets/css/` folder.

## Special Badge

Special badges are not reserved only for sale products. Use these in presets for badge overrides, as setting a Special Badge as default will make a badge appear on all products.

## Special Badge Text

Special badges can have lables. Enter a label to see the result. This option is only used with Special Badge.

## 2.1.2 Badge Presets

Make badge presets here!

Click Add Item + to create a new custom badge! IMPORTANT

## 2.1.3 Badge Manager

Assign badges to fetarued, new, categories or tags!

This is the Badge Manager! Assign badges to different criteria here! IMPORTANT

## New Badge Period

Set new product expire in period (days).

## New Badge Preset

Set new product badge preset.

## Featured Badge

Set featured products badge.

## Tag Badges

Add tag badge presets.

## Category Badges

Add category badge presets.

## 2.1.4 Timer/Countdowns

Options realted to countdowns and timers are here!

## Disable Timers

Select sale timers to disable.

## Adjust Timer

Adjust sale timer countdown clock. Option is set in minutes.

## 2.1.5 Installation

Installation and registratoin! Read more here!

## Single Product Badges

Enable custom badge override for each product.

## Use Tempalte Overrides

This is the default installation when checked, sale-flash.php template will be replaced with the plugin badge. If you enter a custom action below, the entered action will be used to output the plugin badge in the appropriate place in your theme.

## Shop Init Action

Use custom initialization action for Shop/Product Archive Pages. Use actions initiated in your content-single-product.php template. Please enter action name in following format action_name:priority ( default: woocommerce_before_shop_loop_item:10 )

## Single Product Init Action

Use custom initialization action for Single Product Pages. Use actions initiated in your content-single-product.php template. Please enter action name in following format action_name:priority ( default: woocommerce_before_single_product_summary:15 )

## Plugin Scripts

Check this option to enable plugin scripts in all pages. This option fixes issues in Quick Views.

## 2.2 Single Product Sale Badges Panel

Any product can have a custom badge! Find out how!

Default sale badges can be set for each product separetly. If you want to use this option, you'll need to activate the `Single Product Badges` in the `Installation` tab. This is mainly due to the optimization of the plugin. The options for setting the badges are in the edit screen of your product under the Sale Badges panel tab. When using custom badges for your products you can use `Special Badges` too. For these special badges you do not need to have products on sale, any product can have a `Special Badge`.

If Single Product Badges option is used, this tab will be shown! IMPORTANT

## 2.3 Badge Shortcode `[ib_badge]` NEW

Use the shortcode to insert badges anywhere! Even in not product related places!

To output a badge anywhere in your pages use the Improved Badges shortcode!

    [ib_badge]

The [ib_badge] shortcode accepts parameters which can be set in this way:

    [ib_badge preset="my-cool-preset" class="my-badge-class"]

Supported parameters that can be used with the badge shortcode are listed in the following table.

Parameters | Settings
--- | ---
preset="" | Badge preset to use. ( e.g. `my-new-preset` ).
style="" | Set badge style. Available options are `style_arrow`, `style_arrow_alt`, `style_basic`, `style_basic_alt`, `style_inline`, `style_plain`, `style_pop`, `style_pop_round`, `style_fresh`, `style_round`, `style_tag`, `style_xmas_1`, `style_xmas_2`, `style_ribbon`, `style_vintage`, `style_pure`, `style_modern`, `style_transparent`, `style_transparent_2`, `style_random_squares`, `style_fresh_2`, `style_valentine`, `style_cool`, `style_triangle`, `style_eu`, `style_eu_2`, `style_eu_3`, `style_candy`, `style_candy_arrow`, `style_cloud`, `style_shopkit`, `style_responsive_1`, `style_responsive_2`, `style_responsive_3`, `style_responsive_4`, `style_responsive_5`, `style_responsive_6`, `style_responsive_7`, `style_responsive_8`, `style_responsive_9`, `style_responsive_10`
color="" | Set badge color. Available options are `avada_green`, `green`, `orange`, `pink`, `red`, `yellow`, `tirq`, `brown`, `plumb`, `marine`, `dark_orange`, `fuschia`, `sky`, `ocean`, `regular_gray`, `summer_1`, `summer_2`, `summer_3`, `summer_4`, `summer_5`, `trending_1`, `trending_2`, `trending_3`, `trending_4`, `trending_5`, `trending_6`, `trending_7`, `trending_8`, `trending_9`, `sk_material`, `sk_flat`, `sk_creative`
position="" | Set badge position. Available options are `left`, `right`
special="" | Set badge special badge. Available options are `special_plain`, `special_arrow`, `special_bigbadge`, `special_ribbon`
special_text="" | Set special badge text.
price="" | Regular price. ( e.g. `price="10"` )
sale_price="" | Sale price. ( e.g. `sale_price="5"` )
type="" | Type sets the badge CSS positioning. Default position (when parameter is not used) will be set to block with float properties. More options are available like `inline` and `absolute`
shortcode_id="" | Add ID to your shortcode ( e.g. `class="my-id-1"` )
class="" | Add classes to your shortcode ( e.g. `class="my-class my-class-2"` )

## 3. How to and FAQ?

This is the FAQ and How to section? If you are having issues check these guides!

## Q: How to insert badges manually (programatically) into PHP files?

Loop Template Sale Badge Action - `do_action('isb_get_loop_badge');` This action is for triggering the loop template sale badge. WooCommerce template file where this action should be triggered is located in your template folder `wp-content/themes/your-theme/woocommerce/content-product.php`. In this file you should add the action for triggering the loop sale badge template.

    <?php do_action('isb_get_loop_badge'); ?>

Single Product Template Sale Badge Action - `do_action('isb_get_single_badge');` This action is for triggering sale badges on the single product pages. WooCommerce template file where this action should be triggered is located in your template folder `wp-content/themes/your-theme/woocommerce/content-single-product.php`. In this file you should add the action for triggering the single sale badge template.

    <?php do_action('isb_get_single_badge'); ?>

These actions output the product page or the shop badge. They can be inserted into any file, make sure `$product` variable is available!

## 4. Support?

If something goes wrong check this section. Contact the support and we will help!

## 4.1 Where to get support?

If everything else fails you can surely get support!

If you need help, navigate here → Support Pages (https://mihajlovicnenad.com/support/). With every purchase, 6 months of Premium Support is included. To login to Premium Support click the Connect with Envato button. If you need to discuss something with the community use the Community Forum. Using these channels you can open tickets or topics, report problems with plugins, bugs and track important inofrmation too. Be a part of this community and join today! Thanks!

## 4.2 Plugin author and contact / Mihajlovicnenad.com

Hard work and dedication stand behind the Improved Badges for WooCommerce!

Improved Badges for WooCommerce was developed by Mihajlovicnenad.com!

## 4.3 Older Announcements and Change Logs

If you have missed some of these, please check now as it might be useful!

### Improved Badges for WooCommerce Change Log

To see last changes in the Improved Badges for WooCommerce plugin click here → Improved Badges for WooCommerce Change Log