Product Tags Module

Features

• Ability for merchants define tags for products
• Support for tag based search both in merchant admin as well as retail store
• Tag clouds emphasizing and highlighting the popular tags
• You can define multiple tags for one product
• You can also assign multiple products to one tag
• Add/Assign tags to products from product admin section
• Tags can be searched and sorted based on their tag name and creation date
• Tags for a product can be viewed on product page
• Ability to quickly assign tags using coma separated list of tags
• Fully integrated with AbleCommerce merchant admin

Installation

• Step-1
  Before starting installation take a backup of following files in your store
  • Admin/menu.sitemap
  • Admin/breadcrumbs.sitemap
  • Admin/Products/ProductMenu.ascx
  • Admin/Products/ProductMenu.ascx.cs
  
  
• Step-2
  Copy all files from Website folder to your store where AbleCommerce is installed. Copy all files to the corresponding directories in your store. For example copy everything from Website/ConLib/ folder to ConLib folder of your store and so on.
  Note : If your 'scriplets' folder is inside 'App_Theme\Current_Theme\' folder then follow these instructions
  
• Step-3
  If you previously customized Admin/menu.sitemap and Admin/breadcrumbs.sitemap files you will have to manually update these files. Otherwise you can simply replace these files with the files provided in the ProductTags installation. To manually update these files follow these steps
  
  Here is the code that you will have to add to menu.sitemap file. You can add this code anywhere in the main <siteMap> node.

  <siteMapNode title="Add-Ons" LookId="TopItemLook" roles="*">
      <siteMapNode title="Product Tags" url="~/Admin/ProductTags/Default.aspx" />
   </siteMapNode>

  
  If a node named 'Add-Ons' already exists you should just add the sub nodes code as follows

  <siteMapNode title="Product Tags" url="~/Admin/ProductTags/Default.aspx" />

  
  

  Here is the code that you will have to add to breadcrumbs.sitemap file. You can add this code anywhere in the main <siteMap> node

  <siteMapNode title="Add-Ons ">
      <siteMapNode url="~/Admin/ProductTags/Default.aspx" title="Product Tags">
      <siteMapNode url="~/Admin/ProductTags/AssignedProducts.aspx" title="Assigned Products" />
  </siteMapNode>

  
  If a node named 'Add-Ons' already exists you should just add the sub nodes code as follows

      <siteMapNode url="~/Admin/ProductTags/Default.aspx" title="Product Tags">
      <siteMapNode url="~/Admin/ProductTags/AssignedProducts.aspx" title="Assigned Products" />

  
  Similarly if you have also customized Admin/Prodcuts/ProductMenu.ascx and Admin/Prodcuts/ProductMenu.ascx.cs files then you will need to merge changes. Please read ReadMe.pdf file available in download package for more information.
  
• Step-4
  

  Run the SQL scripts on your database from InstallScripts/DB/ folder. As a precaution always take a backup of your database before running SQL scripts.
  

Installation of ProductTags is complete. You can start using ProductTags by going to the 'Add-Ons->ProductTags' menu in merchant amdin.

ConLib Configuration

Displaying Tag Cloud

To display tag couds you can use the [[ConLib:ProductTags\TagCloud]] control in your scriptlets.

[[ConLib:ProductTags\TagCloud Caption="Tag Cloud" MaxTags="100" Sorting="DESC"]]

• Caption property is used to show the a caption header for Tag Cloud. The default caption is 'Tag Cloud'.
• MaxTags property controls the maximum number of tags displayed in tag cloud. The default value is 50.
• Sorting property is used to sort the tags in Tag Cloud. By default the tags in Tag Cloud are shown in ascending order. You can set its property to DESC to show tags in Descending order. The default value is ASC

NOTE: Tags are shown only in tag cloud if they are assigned to atleast one product. More products a tag is assigned to more bigger it displays.

Displaying Tags for a Product

To display tags assigned to a perticular product use the [[ConLib:ProductTags\ProductTags]] control in your scriptlets.

[[ConLib:ProductTags\ProductTags]]

NOTE: his control requires ProductId, so it will work only on pages where ProductId will be available.

Tag Search

You can use [[ConLib:ProductTags\SearchTags]] control to show a search box that allows you to search products based on their tags.

[[ConLib:ProductTags\SearchTags Caption="Search Tags"]]

• Caption property is used to control the a caption header for search tags control. The default caption is 'Search Tags'.