This is a blog post in the series “How to set up a product-centric website in SharePoint Server 2013”. In this series, I'll use data from a fictitious company called "Contoso" to show you how to use search features to set up a website based on product catalog data.Note: Most of the features described in this series are not available in SharePoint 2013 Online.
For an overview of the blog posts in this series, go to How to set up a product-centric website in SharePoint Server 2013.
As described in previous steps, we created a Publishing Portal Site Collection called Contoso, and also enabled the Products list as a catalog.
We’re now going to connect the publishing site to our catalog. In this blog post, I'll describe how to:
Throughout this stage, we won’t have much clicking to do because a lot of the settings have already been preconfigured with what we specified in Stage 3, How to enable a list as a catalog. However, I’ll be introducing a lot of new concepts throughout this post. Exciting, eh? I’ll be explaining these features as we go along, so, if you haven’t already gotten a cup of your favorite beverage, grab one now!
To help you along, for this blog post, I'll be using these icons.
Start stage 5
Getting to the Catalog Source Settings page
The Catalog Source Settings page is an important page, because this is where you specify how your publishing site should be connected to your catalog. If you have several catalogs on your farm, each catalog will have its own Catalog Source Settings page.
In our scenario, we only have one catalog, the Products catalog, so we want to go to the Catalog Source Settings page for the Products catalog.
Remember, in Stage3, we learned how to enable a list as a catalog, and we set a check box called Enable this library as a catalog? Well, in this step, SharePoint will search for libraries or lists where this check box has been selected.
Our Products list displays as an available catalog. To connect to it, simply click Connect.
Tip: If you click Connect to a catalog and there aren’t any available catalogs, this could be because you haven’t yet crawled the catalog.
Now that we have successfully navigated to the Catalog Source Settings page for our Products catalog, it's time to specify how the catalog should be integrated into our Contoso site.
Specify the settings on the Catalog Source Settings page
This table gives an overview of the settings that we have to specify on the Catalog Source Settings page. If you want to go straight to a subsection, use the "Go to" links.
Specify Catalog Integration
For this setting, you specify how the catalog content should be integrated in your publishing site. Your selection will impact if you have to specify further settings on the Catalog Settings Page.
In the Connection Integration section, keep the setting Integrate the catalog into my site as it is -- selected.
The reason why we're keeping this setting selected, is because we want to use the terms from the Product Hierarchy term set (from our Product Catalog Site Collection) in the navigation of our Contoso site.
By keeping this setting selected, this will also enable us to define user friendly URLs, and have a category page and an item page automatically created for us (I'll describe what a category page and an item page is in more detail later).
Specify the full site navigation
A site that has been created by using the Publishing Portal Site Collection template (which is what we used when we created this site), will by default have Managed navigation selected as its navigation method. Managed navigation is a new navigation method introduced in SharePoint Server 2013, which lets you define and maintain the navigation on your site by using term sets.
To view how the navigation of your site has been set up:
We are now going to build the full site navigation by integrating terms from the Product Hierarchy term set (from the Product Catalog Site Collection) into the Site Navigation term set.
In our scenario, the navigation structure of our Contoso site will be quite simple, as it'll be made up of the terms from the Product Hierarchy term set only.
To specify the full site navigation, we have to specify:
You'll notice that one of the settings, Select the column that categorizes items for navigation, already contains information. Do you remember how in Stage 3 we specified Item Category for the Navigation Hierarchy setting, when we enabled a list as a catalog? That setting is automatically carried over to this page, so we will keep the selected Item Category as is.
And, do you remember in Stage 2: Import list content into the Product Catalog Site Collection, that I showed you how the Item Category column is tied to the Product Hierarchy term set? I'm reminding you about this because we're now going to specify from where in the Product Hierarchy term set the catalog navigation should start. Here goes!
Our final Navigation Hierarchy settings will look like this:
Navigation Position defines where, in the current site navigation, the catalog navigation should be integrated. In other words, where, in the Site Navigation term set, the Product Hierarchy term set should be integrated. As the Contoso site will only contain catalog pages, I keep the setting Add to navigation root selected.
Navigation Pinning determines whether or not changes that are made to the Product Hierarchy term set in the Product Catalog Site Collection should be reflected on your site navigation.
If we decide to make changes to our Product Hierarchy term set, for example by changing the name of a term from “Printers, scanners and fax” to “Printers, scanners & fax”, we want this to be reflected on our site navigation. For this to happen, the Pin terms to site navigation check box should remain selected.
Specify URL details for a product page
When specifying URL details for a product page, you first have to decide which page you want your visitors to land on when they're browsing to a specific product. To do this, you've two options:
We're building a customer-facing website for Contoso, with colorful, attractive pages to showcase our products. We similarly want our pages to have friendly URLs. Therefore, we'll choose the first option.
If we were building an internal company website, where we wanted employees to view the actual list items in our catalog, we'd have chosen the second option.
Important note: When specifying URL settings for a product page, your security settings and site access settings remain the same. Visitors will only see what you've granted them permissions to see.
To specify the URL details for a product page, you have to specify:
Catalog Item URL Behavior
To specify Catalog Item URL Behavior, keep the Make URLs relative to this site setting selected.
By keeping this setting selected, when our Contoso visitors browse for a specific product, they'll be taken directly to a page in the publishing site collection.
Catalog Item URL Format
Catalog Item URL Format defines how to build a friendly URL to the product page. We already specified this in Stage 3, How to enable a list as a catalog, when we selected Catalog Item URL Fields.
In our Contoso scenario, we'll keep the setting Use the default URL format provided by the catalog source selected. This means that the URL to the product page will contain values from the managed properties ProductCatalogGroupNumberOWSTEXT, and ProductCatalogItemNumberOWSTEXT.
(If the manage property names are confusing, take a look at a previous blog where I show you how automatically created properties are named)
Specify a Category Page and an Item Page
When you display information in a catalog format, the layout and structure should be consistent across the catalog. For example, you want to display the image of a product in the top left corner, followed by a table of product specifications, such as the height and color of the product. The same applies to category pages. For example, you want the page for all TVs to have the same layout as the page for all cameras.
To avoid having to create several pages for each product, and several pages for each category, you can use one template page for each. In SharePoint, an Item Page and a Category Page serve this purpose.
In our Contoso website scenario, we'll neither create an Item Page, nor shall we create a Category Page as SharePoint will do this for us automatically.
Here's what our final Catalog Source Settings page will look like:
Click OK, and watch some cool things happen!
What happens when I click the OK button to connect to a catalog
Our Contoso site navigation now includes terms from the Product Hierarchy term set.
If you browse to the “Audio” page, you'll see three MP3 products displayed.
If you browse to the “Computers” page, you'll see three laptop products displayed.
In a later blog post, I'll explain why the correct categorized products “magically” appear when we browse through the different categories.
However, for now, let’s take a look at a specific product.
As you can see, at the moment, it's not exactly pretty to look at, but information about the product is displayed on the page, and there's also a friendly URL.
Also, the terms from the Product Hierarchy term set have been integrated into the Site Navigation term set. If you want to see this in more detail, go to Site settings --> Term store management.
And two new pages have been added to the Pages library. If you want to see this in more detail, go to Site contents --> Pages.
So, a lot of cool things have just happened on our Contoso website. Now it is time to start improving the appearance of our pages.
Next blog article in this seriesStage 6: Upload and apply a new master page to a publishing site