How To: Trib Manual Mapping of Attributes for Category Pages

How to: VibeTRIB Manual Mapping of Attributes within ASPDotNetStorefront.

Applies to:
all versions of Trib (screen shots using ASPDotNetStorefront V9.2.0.0)

Procedure: Setup and configure custom Trib filter attributes in entity pages. 

This is a birds eye view of the mappings process after Trib has been installed.

The end result of this article will show the following in the filtering section of your site (the "X" at the end of the line will be the number of products that match that criteria):

Price
$10.00-$19.99 (X)
$20.00-$29.99 (X)
$30.00-$39.99 (X)


Size
Small (X)
Medium (X)
Large (X)


CONFIGURING TRIB TO WORK WITH THE CORRECT ENTITY

For this tutorial we will be setting up Vibe Trib to work with Section (Department) entity.

I. Check your AppConfig parameters and make sure you have selected the correct entity:

  1. Navigate to Configuration > Advanced > AppConfig Parameters
  2. Search for "Vibe.TRIB.Entity"
  3. Update "Vibe.TRIB.Entity" value to "2" which will assign Trib to use Section (departments)
SETTING UP TRIB FILTERS

The next step is to setup the filters in the store. The setting up of the filters under Section (departments) is very much like the steps outline in the AspDotNetStoreFront manual (http://manual.aspdotnetstorefront.com/p-1002-adding-entities-to-your-store.aspx)

I. Setting up the Price filter

The price filtering setup is a bit different that any other Trib filter setup. You do not need to map products to the Price attributes, they will be auto calculated. We just need to configure Trib to point to the correct department ID. In order to do so, follow the steps below:

Set up your Departments - Price Filtering:
  1. Navigate to Organization > Manage Departments
  2. Click green plus (+) sign located at the bottom of the selector column to add a new department. Assign the following values:
          Name: "Price"
          Published: "Yes"
          Show in Product Browser: "Yes"
          Parent: "--ROOT LEVEL--"
          Display Format XmlPackage: "entity.grid.xml.config"
          Quantity Discount Table: "None"
          Page Size: "20"
          Column Width: "4"
          Order Products By Looks: "Yes"
  3. The tabs Images, Summary, Description, Extension Data, Search Engine, Products and Display Order do not need to be used.
  4. Click "Save and Close"
  5. Next, click the plus sign at the bottom again to create another entity
  6. Assign the following values:
          Name: "0.00-19.99" - NOTE: there are no spaces or currency identifiers
          Published: "No"
          Show in Product Browser: "Yes"
          Parent: "Price"
          Display Format XmlPackage: "entity.grid.xml.config"
          Quantity Discount Table: "None"
          Page Size: "20"
          Column Width: "4"
          Order Products By Looks: "Yes"
  7. Repeat the step above for the "20.00-29.99" and "30.00-39.99" entities.
  8. The last Attribute Value should look something like this 200.00-MAX, where 200.00 is the last number you want to show before including all products at or above that price.
  9. Make a note of the ID of the "Price" entity you just created, you will need it in the following steps
  10. Click "Save and Close"
Your Price filter will look similar to:

Image: Trib Price Filter Setup

   
    11. Almost done, now we need to point the Price entity created to Trib.
    12. Go back to your AppConfig settings by navigating to Configuration > Advanced > AppConfig Parameters and search for "Vibe.TRIB.PriceRangeEntityID"
  1. Click the edit button and assign the value of the Price entity you just created
  2. NOTE: You do not need to map products to the Price attributes, they will be auto calculated. Trib knows that these entities are the price entities and will filter automatically.
II. Setting Up Custom Filters

For this tutorial, we are going to show how to setup the Department for "Size" filtering
  1. Navigate to Organization > Manage Departments
  2. At the bottom of the selector column there is a green plus ("+") sign, click that to add a new department, and assign the following values:
          Name: "Size"
          Published: "Yes"
          Show in Product Browser: "Yes"
          Parent: "--ROOT LEVEL--"
          Display Format XmlPackage: "entity.grid.xml.config"
          Quantity Discount Table: "None"
          Page Size: "20"
          Column Width: "4"
          Order Products By Looks: "Yes"
  3. The tabs Images, Summary, Description, Extension Data, Search Engine, Products and Display Order do not need to be used.
  4. Click the plus sign at the bottom again to create another entity
  5. Assign the following values:
          Name: "Small"
          Published: "No"
          Show in Product Browser: "Yes"
          Parent: "Size"
          Display Format XmlPackage: "entity.grid.xml.config">
          Quantity Discount Table: "None"
          Page Size: "20"
          Column Width: "4"
          Order Products By Looks: "Yes"
  6. Repeat the step above for the "Medium" and "Large" entities

Your Size filter will look similar to:

Trib Size Custom Filter

MAP PRODUCTS TO TRIB FILTERS

Now for the magic: Telling Trib which products map to which entities.
  1. Navigate to the Trib Mappings page: "Vibe Trib > Manage Mappings"
  2. Select a product from the list and scroll down the page to where you see "Set and Store Attribute Configurations"
  3. Click the checkbox for the size (for this example) you want to be associated with this product.
    NOTE: you can map a product to multiple entities but do not map to any parent entities (the will not be links in the filtering menu).  The parent entities are bold in this section.
  4. Click the "Update" button at the bottom of the page
You are now good to go; any of the category pages that use the "entity.vibe.trib.xml.config" XML Package will display the filtering you set up.

SAMPLE TRIB SETUP

Trib Filters Setup

Add Feedback