Shelf Search Bar

This component, when placed on your Community page in its header, is expected to be displayed on each page thus enabling your Community users and visitors to search for the needed information on any page. 

The component has both mandatory and optional properties for configuring.

Figure 31. Shelf Search Bar component and its properties (new design and old design)

1. Switch to new design? checkbox (optional): Allows you to switch between the old and new designs of the Search Bar component. Both designs are shown in Figure 31 above. 
2. Gem Page API Name property (mandatory): It shows the API name of the page where the user is expected to be redirected to after choosing the relevant Shelf Gem from the suggestion list.
3. Search Results Page API Name property (optional): This field contains the API name of the page to which the user is expected to be redirected after the search. If this property is not blank, it is assumed that the Shelf Search Result component is located on the same page as the Shelf Search Bar component.
4. Group Gem Page API Name property (mandatory): It shows the API name of the page to which the user is expected to be redirected if the selected Gem belongs to the groupGem category.
5. Max number of suggestions property (optional): This field is for setting the maximum number of suggested Gems. The system-set limit is 5, so you cannot exceed this value.
6. Filter by Knowledge Categories property (optional): This field is used to streamline the search and display of the needed Gems by specific Knowledge Categories such Gems belong to. In order to allow for it, indicate the respective Knowledge Category. You can indicate multiple Knowledge Categories, in which case you need to use a comma (,) as a separator. 
7. Filter by Libraries property (optional): This field is used to streamline the search and display of the needed Gems by specific libraries. In order to allow for it, enter the respective Library ID.

Figure 32. Search Bar component’s autosuggestion and query deletion capabilities

Shelf Search Results

1. fetched as custom preview images via the Gem’s menu on the Shelf side 
2. system default images
3. set via the component properties - for instance, Gem Id for Searchresult thumbnail image file - same as described in paragraph c) of the bullet 4 in the Gem Page section above. 

Figure 33. Shelf Search Result component and its properties (new design and old design)

1. Switch to new design? checkbox (optional): Allows you to switch between the old and new designs of the Search Results component. Both designs are shown in Figure 33 above.
2. Results per page property (optional): Using this property, you can configure how many results your Community users will see on a page after the search. The maximum number is limited to 100.
3. Use List View check box (optional): You can choose how the search results are to be displayed on your Community page - as list items or as tiles. By default, the search results are displayed in the list form.
4. Show gem preview image checkbox (optional): You can choose whether or not you want to see images in the search results block in either view mode: List View or Tile View.
5. Gem Page API Name property (mandatory): It shows the API name of the page where the user is expected to be redirected to after choosing the relevant Shelf Gem from the suggestion list. 
6. Group Gem Page API Name property (mandatory): It shows the API name of the Group Gem Page where the user is expected to be redirected to after choosing the relevant Shelf Gem from the suggestion list.
7. Filter by Knowledge Categories property (optional): This field is used to streamline the search and display of the needed Gems by specific Knowledge Category(-ies) such Gems belong to. In order to allow for it, indicate the respective Knowledge Category(-ies). You can indicate multiple Knowledge Categories, in which case you need to use a comma (,) as a separator. Note that by default this field is empty. If you intentionally leave it blank, no filtering by Knowledge Category is applied and the content returned in the search results block will come from all Knowledge Categories.
8. Filter by Libraries property (optional): This field is used to streamline the search and display of the needed Gems by specific library(-ies). In order to allow for it, enter the respective Library ID(s). Note that by default this field is empty. If you intentionally leave it blank, no filtering by Library is applied and the content returned in the search results block will come from all libraries within your organization.
9. Gem Id for Searchresult thumbnail image file (optional): This field allows you to set a custom thumbnail image for Gems preview. Read Bullet 4, paragraphs a)-c) in the Shelf Gem Page section above for more details.
   
   Tooltips for the Filter by Knowledge Categories and Filter by Libraries properties: these tooltips help you understand what these properties serve for and how their values need to be entered.
10. Sort By property (mandatory): This field is used to sort the fetched search results either by title or by relevance. If sorting by title (TITLE) is selected, the sorting order needs to be selected as well - ASC (ascending) or DESC (descending). By default, sorting by relevance (RELEVANCE) applies, in which case the sorting order doesn’t matter.
    

    Figure 34. Selecting the sorting option

11. Sorting Order (mandatory): Using this dropdown field, you can select the sorting order for the fetched search results. There are two options - ASC (ascending) or DESC (descending). If the ASC option is selected, the search result titles will be sorted alphabetically from A to Z. If the DESCoption is picked up, the titles are sorted from Z to A.
    

    Figure 35. Selecting the sorting order option 

    
    

    Figure 36. Sorting search results by title, from A to Z

Figure 37. Sorting search results by title, from Z to A

Figure 38. Sorting search results by relevance

Shelf Group Gem Page

Figure 39. Viewing preview images (default and Gem’s own custom) of the connected Gems 

1. The Gem’s category must be “groupGem” (on the Shelf side).
   

   Figure 40. Setting the Shelf’s category to “groupGem”

2. Some connections must be added to the Gem in order to shape a Product Group (on the Shelf side).
   

   Figure 41. Assigning connections to the needed Shelf Gem

Figure 42. Shelf Group Gem Page component and its properties (new design and old design)

1. Switch to new design? checkbox (optional): allows you to switch between the old and new designs of the Group Gem Page component. Both the new and old designs are shown in Figure 42 above.
2. Gem Page API Name property (mandatory): It shows the API name of the page where the user is expected to be redirected to after choosing the relevant Shelf Gem displayed on the Salesforce Community page. By default and for the page setting simplification purposes, this field is prepopulated with the Shelf_Article_Detail value. If needed, you can replace it with the value that is relevant for your needs.
3. Show Gem description checkbox (optional): It allows choosing whether to display the description added to a Gem when creating that Gem or not.
4. Gem Id for Watermark image file (optional): this property allows you to use customized graphics to label the connected Gems. To set your custom graphics as the preview image(s) for the connected Gem(s) copy the Gem ID of the relevant Image type Gem that contains the needed graphics, and insert it in this field. Read more about it in paragraph c) of the bullet 4 in the Gem Page section above. Refresh the page and check the result.

Figure 43. Viewing preview images for the connected Gems set via the Group Page Gem properties

Figure 44. Viewing the Group Gem Page component with images preconfigured on the Shelf side

1. Go to Shelf NextGen KMS, find and open the needed Gem (with the groupGem and Publiccategories).
   

   Figure 45. Opening and viewing the Gem in Shelf NextGen KMS
2. Click anywhere in the Gem to enter the Editing mode. The editing toolbar will appear. Find and click the image insert icon. 
3. In the popup window, upload any desired image from your computer, wait to see the results and then save the edited Gem. Repeat the step to insert the second image. 
4. Now click the <> button to switch to the Code View/Editing mode.
   

   

   Figure 46. Entering the Gem’s Code View/Editing mode

5. Find the code strings responsible for the inserted images.
   

   

   Figure 47. Viewing the source code for two inserted images in the Gem

6. In the code editor, for the first image which you want to be the main image (image shown on the front) add the new class - hero-image - to its string.
   
   

   <p><img <p><img src="https://s3.amazonaws.com/gemshelf-stag/eb1541e7-ce1a-4d76-865d-f184468b3544%2Fgems%2Fac78ddf3-c47f-46cb-bad9-641345dd09ee%2Fwiki%2Fimages%2F1695996899705-HeroImage.png" style="width:300px;" class="fr-fic fr-dib hero-image"></p>

   <p><br></p>

7. For the second image - the image you want to be the background one - add the new class as well - hero-background - to the string.
   
   <p><img src="https://s3.amazonaws.com/gemshelf-stag/eb1541e7-ce1a-4d76-865d-f184468b3544%2Fgems%2Fac78ddf3-c47f-46cb-bad9-641345dd09ee%2Fwiki%2Fimages%2F1695996886674-Background.jpg" style="width:888px;" class="fr-fic fr-dib hero-background"></p>
8. Once done, go to your Community site and the page where you placed the Group Gem Page Component. Clear Local storage cache and Session storage cache. Refresh the page and check the result. The Gem should display both images as shown in Figure 44.

Shelf Folder List

1. Create a library in Shelf and copy its ID.
   

   Figure 48. Creating your library in Shelf

   

   Figure 49. Locating and copying your new library ID
    
2. Add folder(s) and assign custom preview image(s) for the folder(s). Each folder will contain product Gems.
   

   Figure 50. Creating folder(s) and assigning custom preview image(s)

3. If needed, you can rename any folder you have created. This option enables you to not only change the name of the created folder but also to translate it to any supported language for any needed geography. To do it, select the needed folder in the left-side tree and right-click it.
   

   Figure 51. Starting folder renaming/translation

4. In the dialog that appears, fill in fields pertaining to the needed languages and then click the SAVE button.
   
   

   Figure 52. Renaming/translating folder
5. When the folder name translations are saved, you can now choose for which localization you want to see the folder. For this purpose, on the Shelf Main Page, go to the left-side tree and select the needed library. On the library page that opens, navigate to the language field and click it. In the dropdown list that opens, select the needed language.
   

   Figure 53. Switching the language

   Once done, you will see that names of the folder(s) you have renamed/translated are displayed in the selected language.
   

   Figure 54. Viewing the translated folders 

1. On the Shelf Main Page, go to the left-side tree and select the needed library. On the library page that opens, find and navigate to the needed folder.
2. Right-click on the folder and select the View folderoption from the menu that opens.
   

   Figure 55. Opening folder

3. On the folder page that appears, find and navigate to the DETAILSpanel in the right part of the window.
   

   Figure 56. Finding the folder category settings

4. Make sure that the category of the folder is set to Public. If it is not, click the Edit button and then, in the Manage Category window that opens, select the Public category’s checkbox and click the SAVEbutton.
   

   Figure 57. Setting folder category

   Once no error messages are displayed, you have successfully set your folder’s category to Public and so enabled it to be properly operational on your Salesforce Community page.

Figure 58. Configuring the Shelf Folder List component properties (new and old design)

1. Switch to new design? checkbox (optional): allows you to switch between the old and new designs of the Folder List component. Both the new and old designs are shown in Figure 58 above.
2. Search Result Page API Name (mandatory): It shows the API name of the Search Result page where the user is expected to be redirected to when selecting the displayed category. By default and for the page setting simplification purposes, this field is prepopulated with the Support_Center_Search value. If needed, you can replace it with the value that is relevant for your needs.
3. Filter by Knowledge Categories property (optional): This field is used to streamline the search and display of the needed Gems by specific Knowledge Categories such Gems belong to. In order to allow for it, indicate the respective Knowledge Category. You can indicate multiple Knowledge Categories, in which case you need to use a comma (,) as a separator. 
4. Filter by Libraries property (optional): This field is used to streamline the search and display of the needed Gems by specific libraries. In order to allow for it, enter the respective Library ID.
5. Sort By property (mandatory): This field is used to sort the displayed folders either by title or by relevance. By default, sorting by title (TITLE) applies. If sorting by title (TITLE) is selected, the sorting order needs to be selected as well - ASC (ascending) or DESC (descending). If sorting by relevance (RELEVANCE) is selected, the sorting order doesn’t matter.
   

   Figure 59. Selecting the sorting option

6. Sorting Order (mandatory): Using this dropdown field, you can select the sorting order for the displayed folders. There are two options - ASC (ascending) or DESC (descending). If the ASC option is selected, the folder titles will be sorted alphabetically from A to Z. If the DESCoption is picked up, the titles are sorted from Z to A.
   

   Figure 60. Selecting the sorting order option

Figure 61. Sorting folders by title in alphabetical order, from Z to A (old design)

Figure 62. Sorting folders by title in alphabetical order, from A to Z (old design)

Figure 63. Sorting folders by relevance (old design)

Figure 64. Carousel and its control buttons in the new design of the Folder List component

Figure 65. Viewing folder labels in the Folder List component on a mobile device

Shelf Most Popular Articles

This Shelf component serves as a tool that displays articles (Gems) with most views in the respective Shelf library (or category). The articles are displayed in the list form.

Figure 66. Shelf Most Popular Articles component and its properties (new and old design)

As in the case of other Shelf components, the Most Popular Articles component has properties that need to be configured after you have dragged the component to a needed location on your Salesforce Community page. Jump below to see these properties and their details.

1. Switch to new design? checkbox (optional): allows you to switch between the old and new designs of the Folder List component. Both the new and old designs are shown in Figure 66 above
2. Gem Id for placeholder image (optional): this property allows you to either use the default image to identify the displayed Gems or set your own image for this purpose. Details on how to set your own image can be found in paragraph c) of the bullet 4 in the Gem Page section above.
3. Max number of articles value (mandatory): This is the field where you can specify how many articles need to be displayed by this Shelf component. 
4. Gem Page API Name property (mandatory): It shows the API name of the page where the user is expected to be redirected to after choosing the relevant article (Shelf Gem) by this Shelf Component. 
5. Group Gem Page API Name property (mandatory): This field contains the API name of the page where the user is expected to be redirected to after selecting the relevant article (Gem) if this page is a group page.
6. Filter by Knowledge Categories property (optional): This field is used to streamline the search and display of the needed Gems by specific Knowledge Categories such Gems belong to. In order to allow for it, indicate the respective Knowledge Category. You can indicate multiple Knowledge Categories, in which case you need to use a comma (,) as a separator. 
7. Filter by Libraries property (optional): This field is used to streamline the search and display of the needed Gems by specific libraries. In order to allow for it, enter the respective Library ID.

Note:

As in case of the Shelf Search Bar component properties, Gem Page API Name and Group Gem Page API Name fields are prepopulated with Shelf_Article_Detail and Shelf_Product_Group values, respectively, by default, but you can replace these values with the relevant ones.

Shelf Group List

This component is generated and configured on the Shelf side as part of the content management process. 

In order to allow for the Shelf Group List component’s operation on Salesforce, you need to create a Gem whose type is Wiki and set its category to groupGem. To do so, perform the following steps.

1. When logged in to Shelf, find, navigate, and click the ADD button in the upper part of the window. Once the dropdown list appears, select the Create Content option.
   
   

   Figure 67. Starting content creation in Shelf

2. On the page that appears, locate and select the Wiki Page card to start creating the appropriate Gem.
   
   

   Figure 68. Selecting the Wiki Page type

    
3. On the Gem page that opens, enter the relevant title for your new Gem. You can use standard text editing tools to add the needed content to the Gem, add links, insert pictures, etc.
   
   

   Figure 69. Adding content to Gem

4. Once done, you can navigate to the right-side panel and set the needed category - groupGem in our case - for the Gem you are creating. To do so, click the Edit button in the Category block of the panel.
   
   

   Figure 70. Accessing Gem category settings

5. In the Manage Categories window that appears, find and select the groupGem category by selecting the respective checkbox. Then click the SAVE button to confirm the category setting.
   
   

   Figure 71. Confirming the category setting

6. Once the window is closed, you get back to the Gem page and, unless any other changes to the Gem content are needed, can finish its creation by clicking the CREATE button
   
   

   Figure 72. Finishing the Gem creation

7. Once you have set this Gem’s category to groupGem, or to any other category additionally, you can verify it by refreshing the Gem page and navigating to the DETAILS panel.
   
   

   Figure 73. Verifying Gem’s category

After finishing the required preconfigurations, you can now add the Shelf Group List component to your Salesforce Community page by dragging it to the needed location on the page. Once done, configure the component properties as shown in the figure below.

Figure 74. Shelf Group List component and its properties

1. Group Gem Page API Name property (mandatory): It shows the API name of the page where the user is expected to be redirected to after choosing the relevant Shelf Gem displayed on the Salesforce Community page. By default and for the page setting simplification purposes, this field is prepopulated with the Shelf_Product_Group value. If needed, you can replace it with the value that is relevant for your needs.
2. Group Gem Category Name property (mandatory): It contains a value configured for a set of group Gems (Gems that have the groupGem category) and is used to create different sets of group Gems for different products. The default value is groupGem.
3. Max items limit (Max 100) property (optional). This value shows the number of items to be displayed in the component. The maximum allowed number is 100.
4. Sort By property (mandatory): This field is used to sort the displayed Gems either by title or by relevance. By default, sorting by relevance (RELEVANCE) applies, in which case the sorting order doesn’t matter. If sorting by title (TITLE) is selected, the sorting order needs to be selected as well - ASC (ascending) or DESC (descending).
   
   

   Figure 75. Selecting the sorting option

5. Sorting Order (mandatory): Using this dropdown field, you can select the sorting order for the displayed Gems. There are two options - ASC (ascending) or DESC (descending). If the ASC option is selected, the Gem titles will be sorted alphabetically from A to Z. If the DESC option is picked up, the titles are sorted from Z to A.
   
   

   Figure 76. Selecting the sorting order option

Figure 77. Sorting Gems by relevance

Figure 78. Sorting Gems by title in alphabetical order, from A to Z

Figure 79. Sorting Gems by title in alphabetical order, from Z to A

It is also recommended to set custom preview images for Gems and folders in Shelf, in order to ensure an appealing look of your content on Salesforce.

For this purpose, when on the Gem or Folder page in Shelf, click the More Actions menu button and select the Custom preview image option from the dropdown list.

Figure 80. Setting custom preview image for Gem and Folder in Shelf

In the window that opens, upload the needed graphic from your computer and click the SAVE button.

Figure 81. Uploading custom preview image

Once the custom preview image is added to the Gem, you can refresh your respective Salesforce Community page and check whether the image is displayed there.

Figure 82. Checking Gem’s custom preview image on Salesforce

Checking Community Page Properties

You can check the name, URL address, and API name of your Community page in the Properties dialog which you can access by clicking the menu icon.

Figure 83. Viewing the Community page properties

 

Localization Feature for Shelf Components with Static Text Labels

For expanding the outreach of potential users of your Salesforce Community page where the Shelf components are installed and used, Shelf has implemented the localization for those Shelf components that have static text labels. These components are Search Bar, Search Results, Most Popular Articles and Group List

As of now, the localization feature supports two languages - English and Spanish. Additional languages, if needed, can be requested via the Shelf Customer Support. It should be noted that any additional language when added to the localization feature requires a new package version installation.

The selection of the needed localization is executed via the language parameter in the URL address. If no localization parameter is indicated in the URL address of your Community page, all static text labels of the Shelf components mentioned above are displayed in the default language - English.

Component localization example

If no localization parameter is indicated in the URL address, your Community page with the installed Shelf components looks as follows:

Figure 84. Viewing the Community page in the default localization

As we see, no localization parameter is indicated in the URL address.

To change the localization of the static text labels of the Shelf components on your Community page, place the localization parameter that details the needed language value in the URL address field. In our case, we want to see those static text labels localized in the Spanish language for the Mexican region. It means that we need to add ?language=es_MX to our Community page’s URL address. Once added, refresh the page to see whether the localization of the static text labels has changed as expected.

Figure 85. Checking your Community page localization change

If the localization has changed, you can perform a search via the Shelf Search Bar component to see whether other static text labels have changed their localization.

Figure 86. Checking other static text labels localization

If you see that other static text labels are in Spanish, it means that the localization feature works properly.

Another great feature is editing text (headings etc.) in your Shelf components. Using this feature you can create and add any text to your component(s) and also add different versions of such text for different languages. 

To make use of this feature, perform the following steps.

1. Go to the Setup page of your Salesforce Community instance, the search field enter Custom Metadata Types and hit search.
   
   

   Figure 87. Searching and selecting the Custom Metadata Types option in Setup

2. Select the Custom Metadata Types option found in the tree menu and open it.
   
   

   Figure 88. Opening Shelf Custom Label Localization option
3. In the form that appears, find and select Manage Shelf Custom Label Localization.
   
   

   Figure 89. Starting to work with the label localization feature
4. From the list that appears, select the needed component label you want to edit (change/replace/or localize). For example, we want to edit the label for the Most Popular Articles component.
   
   

   Figure 90. Viewing the list of available labels

5. In the new window, make sure this is the label you want to edit, and click the Edit button.
   
   

   Figure 91. Starting the Shelf Most Popular Articles component  label editing

6. Before editing the label, let’s first check how it looks in the component before editing.
   Figure 92. Viewing the component label before editing

7. Now, go back to the label editing window and change the label text as needed.
    
   
   
   en;Absolutely awesome questions and answers
   es;Preguntas y respuestas más útiles
   All new localization label texts you add should follow the above pattern - identification of language (ISO format), semicolon, label text. New localization label text (for another language) must start from the new line. For example, if you want to add the German localization label to the existing two labels (English and Spanish), the setup for all three labels is expected to be as follows:
   
   
   en;Absolutely awesome questions and answers
   es;Preguntas y respuestas más útiles
   ge;Absolut geniale Fragen und Antworten
   
   Once done, click Save to finish editing and save changes.
   

   

   Figure 93. Editing and saving the label

8. Now, go to your Community page and check whether the label text has changed on the Most Popular Articles component.
   

   

   Figure 94. Viewing the component with the edited label 

   The same applies to all labels of all Shelf components - you can edit them as needed for your business purposes.

---

Heading Content Filtering

In order to allow for precise filtering of the content to be displayed on the Salesforce Community page for different categories, Shelf has implemented a simple but effective in-URL filtering feature. 

This feature covers the following Shelf components:

• Shelf Search Bar, 
• Shelf Search Results, 
• Shelf Most Popular Articles, 
• Shelf Group List

Note: 

Shelf components operate based on parameters that are specified in the URL. At the same time, Shelf components are in no case intended to or operate for storing and/or maintaining these parameters in the URL string.

Prerequisites

To enable the proper operation of the Heading Content Filtering, some actions need to be taken on the Shelf side.

Enabling, creating, and assigning multiple categories for Gems

1. To enable the possibility to assign multiple categories to Gems, go to the main page of Shelf, open the Admin Panel and get to the Category Settings submenu there. Then locate and select the relevant Multiple checkbox in the Category Settings window.
   
   
   

   Figure 95. Enabling multiple categories for Gems
2. In order to create new categories for future assignment to Gems, in the Category Settings window, select the Categories tab and follow the steps in the below figure to create and save a new category. Repeat as many times as needed.
   
   

   Figure 96. Creating new categories

Note:

You need to create as many categories as there are audiences using your content. In our case, it is DS (for distribution specialists), PM (for preferred members), and Public for all customers and visitors.

Once the categories are created, you need to assign one of them to the needed Gem. For this purpose, open the Gem and navigate to its DETAILS panel. Then click the Edit button to open the Manage Categories window where you need to select the needed categories and click the SAVE button.

Figure 97. Assigning categories to Gem

How the Heading Content Filtering Works 

After you have placed all the needed Shelf components on your Salesforce Community page and pressed the Build button, an email message with the link to the built page is sent to your email. You need to click the link to open your page. The link usually is as follows:

https://salesforce.com/showcase/

Where /showcase is the name of your page on the Salesforce Community Cloud.

Once you have followed the link, you are redirected to your Salesforce Community page. 

In order to filter the displayed content, you need to enter a respective filtering parameter into your Community page’s URL address after the name of your page. 

Available filtering parameters are: 

• dsType - filters the content for a specific audience
• knowledgeCategory - filters the content by catalog (in Shelf’s terminology - by category)
• language - filters the content by language and language variant.(eg. en_US, es_US, es_MX)

Content Filtering by Audience

Currently, there are two types of Salesforce Communities supported: 

• Shared - for authorized audience, such as distributors (DS) or preferred members (PM)
• Public - for all customers.

In order to display certain content only for the needed Shared audience, you need to use the dsType parameter. For example, you want only the content that is designated to your distributors be shown on the page. For this purpose, you need to enter in the URL address of your Community page ?dsType=DS, where DS means “Distribution Specialists”. In case of the preferred members, the parameter needs to be ?dsType=PM, respectively. If the content audience is public, no ?dsType parameter is used.

As a result, after hitting the Enter button on the keyboard, you will see only the needed content on the page.

     

Content Filtering by Category

In order to filter the displayed content by category, you need to enter a respective filtering parameter into your Community page’s URL address after the name of your page. In this case, this parameter is knowledgeCategory which can assume different values. 

For example, we want to show the content, i.e. Gems, to which the category named “first” was assigned. To do that we need to enter the following filtering parameter -  ?knowledgeCategory=first. 

As a result, we will see on your Community page only those Gems that have the specified, that is - first, category assigned to them.

Figure 98. Filtering content by category

Note:

Category in this filtering parameter means a Shelf’s category and not a folder, library or any other entity.

It can accept more than one category, separated by ",". For example, we have two more categories "second" and "third" and want to show the content. In this case the filtering parameter will be the following - ?knowledgeCategory=first,second,third

      

Content Filtering by Language and Area 

In order to filter the displayed content by language and geographic area, you need to enter a respective filtering parameter into your Community page’s URL address after the name of your page. In this case, this parameter is language= which can assume different values.  For example, we want to show the content, i.e. Gems, whose language is American English. 

Tip:

To check the Gem’s language, go to the Details panel of the Gem. Locate the Language option there to see which language the Gem has. For selecting the language variant, assign the respective Shelf category - US - to this Gem as shown in Figure 97. Assigning categories to Gem.

Figure 99. Checking Gem’s language

To display only those Gems whose language is English, enter the following filtering parameter -  ?language=en_US, where “en” means language and “US” means geographical area, in our case - the United States. Note that the default value for this parameter is language=en.

As a result, we will see on your Community page only those Gems whose language is American English.

Figure 100. Filtering content by language and locale

---

Salesforce Community Page Preview and Publishing

Once you have completed the setup and positioning of the needed Shelf components on your Community page and checked how they look like by clicking the Preview button, you can now publish them to the page by clicking the Publish button in the upper right corner of the toolbar.

Figure 101. Previewing and publishing the Salesforce Community page with Shelf components

Once your Community page is published, you can follow the link you receive on your email and check how your page looks. However, if you send this link to someone outside of your organization, that is, who has no account on Salesforce Community Cloud, they will see the following page. 

Figure 102. Viewing the published Community page if not logged in

To enable guest views of your published Salesforce Community site, perform the following steps.

1. In your Community page builder, go to your site settings. In the General tab, find and select the Public Access checkbox: it allows guest users to interact with your published site without login.
   

   Figure 103. Enabling public access to your Community site

   
   

2. Then, go to the Salesforce Community Cloud homepage and search for Profiles. When found, select the needed profile and on its page that opens, click View Users.
   

   

   Figure 104. Selecting the profile and viewing its users

3. In the profile window, select the Site Guest User option to edit it.
   

   

   Figure 105. Finding and opening the Site Guest User settings

4. In the Site Guest User window, find and click Edit Assignments.
   

   

   Figure 106. Editing Site Guest User’s permission assignments

5. In the next window, find in the left list the Shelf Community Components Access permission set and select it. Then click the Add button (>) to move it to the Enabled Permission Sets list. Click Save to finish and save changes.
   
6. Once done, republish your site and wait for the link to be sent to your email address. This link you can share with outside people who now are able to view the site without logging in.
   

   

   Figure 108. Checking the published Salesforce Communities page as a guest user