WooCommerce Collections

“WooCommerce Collections” Documentation by “WPWeb”

Introduction

WooCommerce Collections gives your customers the ability to gather and share products they like, want or recommend. It allows you to show buyers what you have for sale or share and organize your favorite products.

Features:

  • Customers
    • Quickly add a product to a collection, and create new collections without leaving the product's page
    • Create an unlimited number of collections. Guest users can store a Collection for 30 days (or until cookies are cleared). Registered users can store collections indefinitely
    • Privacy controls. Users can either create a public or private Collection. Public collections can be shared and are viewable by anyone. Private collections are only viewable to the user.
    • Share collections to various social networks via a unique short url. Facebook, Twitter, Google + and LinkedIn.
    • Share collections via email to your friends and family.
  • Shop Managers
    • View and manage your customer's collections from the WordPress admin.
    • Show a plain text link or button.
    • Choose from 5 different icons (works with both plain text link or button) or have no icon at all.
    • Disable guests from creating collections.
    • Ability to set any collection as featured collection.
    • Easily modify the text for the "add to collection" link.
    • Enable only the social sharing services that your customers can share to.
    • Supports both pretty/non pretty permalinks.
    • Manage sort order of collections and collection items via drag & drop interface from the WordPress admin.NEW
  • Developers
    • Extremely flexible layout. Use any page on your website to display a user's collections, display individual collections, to edit collections, or to create new collection.
    • Collection, Light Box, Watch List, Wish List or Want List. Easily change the terminology.
    • Fully localized/translation-ready. Easily translate and use the plugin in your native language.
    • Super flexible links. Create your own add to collection buttons with a simple function call and arguments.
    • Easily customize the different pages by copying the templates into your child theme's woocommerce/woocommerce-collections folder.
    • Easily customize the CSS and/or fonts by copying into your child theme's woocommerce/woocommerce-collections folder.
    • Easily change the various messages displayed throughout the plugin from 1 simple filter.
    • Easily move the icon to the right of the add to collection text by using 1 simple filter.
    • Easily change the size of all add to collection links (plain or button) by using 1 simple filter, or by creating your own link and passing in a size.

Support for Follow My Blog Post

Collections extension is fully integrated with Follow My Blog Post plugin. Users can be automatically set to receive emails when new items added under their followed collection.

Installing the Plugin

  1. The installation of the plugin is just like any other plugin installation for WordPress. Login to your WordPress site and go to Plugins > Add New.
  2. At the Install Plugins Page click on Upload from the top navigation and then click on browse.
  3. Go to the location on your computer where you saved the downloaded plugin zip file and upload this zipped file. You need to unzip the file first to get the plugin zip file.
  4. Now click on Install Now.
  5. Wait until WordPress has uploaded the file. If it's done click on Activate Plugin.
  6. Now you should see a message 'Plugin activated' at the top of the window.

After installing the extension, a Collections section will be added to the WooCommerce settings page.

Plugin Settings

The Plugin Settings

General Options

Delete Options
If you don't want to use the Collections Plugin on your site anymore, you can check that box. This makes sure, that all the settings and tables are being deleted from the database when you deactivate the plugin.

My Collections
Select the page where users will view their collections. This page should include the [woo_cl_collections] shortcode.

Collection Privacy
Select privacy for newly created Collections, Default is : Public.

Enable Guest Collection
Check this box if you want to allow Guest customers to create their own Collections.

Disable Infinite Scroll
Check this box if you want to display "Load More" button after 10 items per page.

Items per page
Enter number of collections / collection items you want to display per page.

No. of My Collections Items
Enter number of collections you want to display on My Account page in "My Collections" section.

Maximum collections per user
Enter the maximum collections allowed per user, leave blank for unlimited.

Maximum products per collection
Enter the maximum products allowed per collection, leave blank for unlimited.

Button / Link Text
Here you can give the Add to collection button custom text. Default is: Add to Collections.

Button / Link Type
Here you can select a add to collection button type.

Button Type:

Collection Product With Button

Link Type:

Collection Product With Link

Icon
The icon to show next to the add to collection links.

Collection Icon None Link Collection Icon None Button
Collection Icon Star Link Collection Icon Star Button
Collection Icon Present Link Collection Icon Present Button
Collection Icon Add Link Collection Icon Add Button
Collection Icon Bookmark Link Collection Icon Bookmark Button
Collection Icon Heart Link Collection Icon Heart Button

Collections Endpoints

Endpoints are appended to your page URLs to handle specific actions during the collection process. They should be unique.
Learn more about endpoints in WooCommerce here.

View Collection
Endpoint for the Collection -> View page, Default is: view-collection.

Edit Collection
Endpoint for the Collection -> Edit page, Default is: edit-collection.

Collection Author
Endpoint for the Collection -> Author page, Default is: collection-author.

Collections Sharing Options

Social Options
Check each of the sharing options for which you want to enable.

Collections Style Options

Custom CSS
Here you can enter your custom css for the woocommerce collections. The css will automatically added to the header, when you save it.

Follow Email Options

Note : This section will only be displayed if you have Follow My Blog Post plugin activated.

Follow My Blog Post Email Option

Email Subject
This is the subject of the email that will be sent to the followers of the Collection when new product added for that Collection. Available template tags for subject fields are :

  • {collection_name} - displays the Collection name
  • {collection_item_name} - displays the Collection item name

Email Body
This is the body, main content of the email that will be sent to the followers of the Collection when new product added for that Collection. The available tags are:

  • {collection_name} - displays the Collection name
  • {collection_item_name} - displays the Collection item name
  • {collection_item_description} - displays the Collection item description

User Settings

Few new settings are added to the user edit page ( Users -> All Users -> Edit ) as mentioned in the image below :

User Settings

Disable Add to Collection Button
Select the user roles for whom you wanted to disable add to collection button.

Maximum collections per user
Enter the maximum collections allowed per user, Leave it empty to use this from the settings page.

Maximum products per collection
Enter the maximum products allowed per collection, Leave it empty to use this from the settings page.


Adding a Shortcode

To integrate collections into any page or post at any position you can use the shortcodes. You will see a Collection icon within the WordPress editor, just as shown in the image below:

Shortcode Icon

Click on the icon and a new window with the custom settings will pop up as mentioned below.

Add To Collection Shortcode

The [woo_cl_add_to_collection] shortcode can be used on any post, page or product. It provides a quick and easy way to allow customers to add any product to a collection.

add to collection Shortcode Settings


Product ID
Here you can select product which you want to add to collection.

Button Text
Here you can give the Add to Collection button custom text. Default is: Add to Collection.

Button / Link Type
Here you can select a add to Collection button type.

Icon
The icon to show next to the add to Collection links.

Insert Shortcode
After you entered all the information you want, click on the "Insert Shortcode" button and the shortcode will be entered in to the normal WordPress editor with all you custom settings. Now you only need to save/update your post and the "add to collection" Button is done and ready.

Add to collection button Frontend
After inserted shortcode it will look something like the one shown in the image below on frontend.

Add To Collection button



Featured Collections Shortcode Settings


Featured Collection Title
Here you can enter Featured Collection Title.

Number of Collections
Here you can Enter a number of Collection you want to display.

Show Private
Check this box if you want to display private Collections.

Insert Shortcode
After you entered all the information you want, click on the "Insert Shortcode" button and the shortcode will be entered in to the normal WordPress editor with all you custom settings. Now you only need to save/update your post and the Featured Collection is done and ready.

Featured Collections On Frontend
After inserted shortcode it will look something like the one shown in the image below on frontend.

Featured Collections


My Collections Shortcode


My Collections Shortcode Settings


My Collections Title
Here you can enter My Collection Title.

Show Collections Count
Check this box if you want to display total number of Collections.

Show See All Collections Link
Check this box if you want to display link for See All Collections.

Insert Shortcode
After you entered all the information you want, click on the "Insert Shortcode" button and the shortcode will be entered in to the normal WordPress editor with all you custom settings. Now you only need to save/update your post and the My Collection is done and ready.

My Collections On Frontend
After inserted shortcode it will look something like the one shown in the image below on frontend.

My Collections


Collection End User Documentation / Overview

This section of the guide provides an overview of the features provided by the WooCommerce Collections extension to users using your site.

Creating a collection

Customers can always create a collection on the fly while adding a product to their collection.

Private collections are only viewable to the user that created it, and public collections are viewable by anyone. Public collections also include sharing buttons and a sharing link.

Adding Items to a Collection

By default, an "Add to collections" link will appear on product page, shop page and archive pages. When this link is clicked, a modal window will appear. Your customers will be able to add a Item to one of their collections, or create a new collection, all without leaving the current page.

Where variable product is shown, customers can simply select the variation option they are interested in, and click the "add to collection" button.

Manage your collections

You can view and manage your collections from two different sections of the site.

1) If you are logged into your account on the site you will see the collections available from your "My Account" page as mentioned in the image below:

2) From the user's WordPress profile page. Hovering over your username in the WordPress toolbar will show you "My Collections" Link:

Admin My Collections

Editing a collection

To make changes to a collection, click Edit. You can change the title, add or edit a description, make it private, or delete it. When deleting a collection, the user is asked for confirmation.


Template Structure + Overriding templates via a theme

The template files of WooCommerce Collections contain the markup and template structure for the front-end of your site. If you open these files you'll notice they all contain many hooks which will allow you to add / move content without having to edit the template files themselves. This method protects even further against any upgrade issues as the template files can be left completely untouched.

Alternatively, you can edit these files in an upgrade safe way through overrides. Simply copy it into a directory within your theme named /woocommerce/woocommerce-collections, keeping the same file structure.

Example: To override the collection listing design, copy : woocommerce-collections/includes/templates/collection-listing/collection-listing.php to yourtheme/woocommerce/woocommerce-collections/collection-listing/collection-listing.php

The copied file will now override the WooCommerce Collections default template file. Do not edit these files within the core plugin itself as they are overwritten during the upgrade process and any customizations will be lost.

The following template files can be found within the /woocommerce-collections/includes/templates/ directory:

Templates
  • add-to-collection/
    • add-to-collection-content.php
    • add-to-collection-footer.php
    • add-to-collection-header.php
    • add-to-collection.php
    • success-message/
      • add-to-collection-success.php
  • collection-button/
    • collection-button.php
  • collection-edit/
    • collection-edit-content.php
    • collection-edit.php
    • popups/
      • collection-delete.php
      • cover-image.php
      • item-details.php
      • status.php
  • collection-item-listing/
    • collection-item-image-listing-content.php
    • collection-item-listing-content.php
    • collection-item-listing-loop-content.php
    • collection-item-listing.php
  • collection-listing
    • collection-listing-content.php
    • collection-listing-loop-content.php
    • collection-listing.php
  • css/
    • woo-cl-coll-dropdown.css
    • woo-cl-collection-edit.css
    • woo-cl-collection-listing.css
    • woo-cl-email-share.css
    • woo-cl-featured-collections.css
    • woo-cl-item-listing.css
    • woo-cl-popup.css
    • font-awesome/
      • css/
        • font-awesome.min.css
      • fonts/
        • fontawesome-webfont.eot
        • fontawesome-webfont.svg
        • fontawesome-webfont.ttf
        • fontawesome-webfont.woff
        • fontawesome-webfont.woff2
        • FontAwesome.otf
    • fonts/
      • Roboto-Light.ttf
    • images/
      • close_icon.png
      • deleteicon.png
      • icon.png
      • lock.png
      • present.png
      • round.png
      • smallicon.png
      • woocl_read_more.png
  • emails/
    • collection-share.php
    • plain/
      • collection-share.php
  • featured-collection-listing/
    • featured-collection-listing-content.php
    • featured-collection-listing.php
  • social-buttons/
    • email.php
    • facebook.php
    • google.php
    • linkedin.php
    • social-button.php
    • twitter.php
    • popup/
      • email-share-success.php
      • email-share.php

These files contain the markup and template structure for the front-end (and HTML emails) of your store. If you want to edit one of these templates simply copy it into a directory within theme named /woocommerce/woocommerce-collections, keeping the same file structure, e.g. move "/templates/collection-listing/collection-listing.php" to "yourtheme/woocommerce/woocommerce-collections/collection-listing/collection-listing.php". The copied file will now override the WooCommerce Collections default template file. Do not edit these files within the core plugin itself as they are overwritten during the upgrade process and any customisations will be lost.


Screenshots

Shows integration with the default WordPress 2012 theme


Frequently Asked Questions

How do I make a Collection for someone else?

There are times you will want to make a Collection for a customer. To accomplish this, follow the instructions below:
  • Download the User Switching plugin.
  • Install the plugin on your WordPress site.
  • Activate the plugin.
  • Go to WordPress Dashboard > Users > All Users
  • Select the Account you would like to create the Collection on and select "Switch To".

Wordpress User Switching

You can now go to your store and create a Collection through the storefront like a normal customer. When you are done creating the Collection and have saved it, to switch back to your admin account, go to the top right corner of your browser and select "Switch back to [Your Account Name Here]".

Wordpress User Panel

The next time they log in, the Collection will be there waiting for them at http://www.YourURL.com/collections/.


Collections Demo

You can view a demo of the Collections plugin here: WooCommerce Collections Demo

Need Support
 
Created: August 26, 2015
By: WPWeb
Email: wpweb101@gmail.com
If you have any questions that are beyond the scope of this help file, please feel free to email me on wpweb101@gmail.com . If you are purchased user then please use our support system http://support.wpweb.co.in for any support. Thanks so much!