Getting started with free version of the plugin

Once you enable it, the plugin adds a “Add to wishlist” button right inside all product detail pages of your shop.

Wishlist button - Product detail page

All users, registered or not, can add products to their wishlis. About registered users, data will be saved in the database, whereas, for unregistered users, the plugin uses specific cookies.

Wishlist button

By default behaviour, “Add to wishlist” button is shown right next to add to cart button. However, you can change its position from plugin settings dashboard in “Position” field.

Button position

Wishlist page

For a correct functioning, once you enable the plugin, a “Wishlist” page is generated on WordPress: it includes the “[yith_wcwl_wishlist]” shortcode that provides the insertion of the table of all products added to the wishlist.

Wishlist table

You can show the wishlist on any page of your site, different from the one selected by default, and you can choose it in “Wishlist Page” field of plugin settings dashboard.

Select page wishlist

Please note: the page you choose to use as “wishlist” page must necessarily include the “[yith_wcwl_wishlist]” shortcode.

Share wishlist

Users can only share the wishlist for the socials you selected in YIT Plugins -> Wishlist.

Share options

Share buttons - Product detail page

Parameters you can configure in order to share the wishlist on social are:

  • “Social title”: text used as sharing title
  • “Social text”: It will be used by Facebook, Twitter and Pinterest. Use %wishlist_url% where you want to show the URL of your wishlist.
  • “Social image url”: image url that will be used for each whishlist sharing.

Plugin settings

As detailed below, we analyze all the above mentioned options included in plugin settings dashboard, in “YIT Plugins -> Wishlist”.

  • “Default wishlist title”: title in the wishlist page of the theme.
  • “Redirect to cart”: redirect to cart page if “Add to cart” button is clicked in the wishlist page
  • “Remove if added to the cart”: remove the product from the wishlist if it has been added to the cart.
  • “Add to Wishlist” text: text for “Add to wishlist” button or link
  • “Browse wishlist” text: text of shown button for products added to the wishlist
  • “Product added” text: text shown to user after the correct insertion of the product in the wishlist
  • “Add to Cart” text: text for “Add to cart” button in the table included in “Wishlist” page
  • “Show Unit price”: show unit price for each product in wishlist
  • “Show Stock status”: show “In stock” or “Out of stock” label for each product in wishlist
  • “Show date of addition”: show the date when users have added a product to the wishlist
  • “Add second remove button”: adds a specific button to remove the product from the wishlist

Here is an example of wishlist where each product shows: name, price, status (in stock or out of stock), date of addition, add to cart button and remove from wishlist button.

Plugin settings

Style

By default, all HTML included elements (buttons, wishlist table) follow the theme style. However, if you wanted to change the color of these elements you can disable “Use theme style” field from “Colors” section of the settings dashboard and configure new colors the way you prefer.

Style settings

Shortcodes

YITH Add to Wishlist

The shortcode “[yith_wcwl_add_to_wishlist]” loads the content of the “add-to-wishlist.php” template (the file is in the “templates” folder of the plugin), and prints the “Add To Wishlist” button in the front end.
Shortcode attributes are:

  • ‘wishlist_url’: (string) the URL of the page that contains the wishlist; it is showed only if the product is already in the wishlist.
  • ‘exists’: (boolean) it states if the product is already in the wishlist.
  • ‘product_id’: (int) the ID of the product to add to the wishlist with the button.
  • ‘product_type’: (string) it can takes the values simple, variable or grouped depending of the product type (the default value is simple).
  • ‘label’: (string) the label to show inside the button.
  • ‘browse_wishlist_text’: (string) the label of the button that redirects to the wishlist. This is showed when the product is already in the wishlist.
  • ‘already_in_wishslist_text’: (string) the label showed when the product is already in the wishlist.
  • ‘product_added_text’: (string) the “product added” label, which is showed when a product is added to the wishlist.
  • ‘icon’: (string) the icon to show in the button (selected among the ones of font-awesome).
  • ‘link_classes’: (string) possible classes that can be added to the button. If it is a real button, the default class is “add_to_wishlist single_add_to_wishlist button alt”, if on the contrary is plain text, the default class is “add_to_wishlist”.”
  • ‘available_multi_wishlist’: (boolean) it states whether the multiwishlist feature is enabled.

YITH Wishlist Table

Shortcode “[yith_wcwl_wishlist]” loads the content of the “wishlist.php” template (the file is in the “templates” folder of the plugin), to make appear the wishlist in the page.
Shortcode attributes:

  • ‘per_page’: (int) the number of elements per page (the default value is 5).
  • ‘pagination’: (string: yes/no) it sets whether to paginate the wishlist; in case this parameter is set to “no”, the attribute “per page” will not be considered.