This document explains how to create the MindTouch Touchpoint for Salesforce Community Cloud when using the Napili (non-Lightning based) template.
- The Salesforce base package must be installed.
- A Salesforce Community using the Napili template (required) built with the Site.com Studio.
- An existing MindTouch site configured with a Subject Alternate Name (SAN) SSL.
How do I determine if my community is Lightning based?
When managing your community via the Community Builder, click the Page Editor. If you see a list of Lightning components, you are using a Lightning-based Salesforce community:
► See a list of Lightning components? Navigate to our documentation for your Salesforce environment.
► Don't see a list of Lightning components? You're in the right place; keep reading below!
How to set up your Touchpoint for Salesforce Community Cloud
Step 1: Install the package
Install the MindTouch Touchpoint for Salesforce Community Cloud package. Select the users to grant access to and click Install to proceed.
Step 2: Create a search widget in Site.com Studio
- As an admin, visit your community management screen and click Launch Community Builder.
- In the Community Builder, select the drop-down menu next to your community name and click Go to Site.com Studio.
- In Site.com Studio, click Widgets, then New Widget.
- Name your search tool (here: MindTouch Search Widget) and make it available in the Page Elements pane and to contributors.
- Click the widget name to open it in the Site.com editor.
- In the Page Elements pane, insert a single Content Block. In the properties, set the ID to "mtsearch":
- Select the content block in the hierarchy view (the rightmost icon). Hover over the content block and click Edit HTML:
- Paste the contents of this attached file into the widget.
- Edit the settings on line 15 and line 38 to point to your MindTouch site.
- You may also enable or disable contextual help overlays for search results by setting MindTouch.F1 to
MindTouch.SITE_URL = "https://success.mindtouch.com"; // Your site here MindTouch.F1 = true; // Enable or disable F1 overlay
- The default search box inside the MindTouch Search widget has been hidden on line 18. This can be enabled if you remove
display: nonefrom the following section:
<form id="mt-search-form" style="display:none;"> <input id="mt-solution-finder-input" name="search" placeholder="Enter your search query here" type="text" /> </form>
- When satisfied with your changes (you may preview the widget), save it and return to the main page of the Site.com Studio.
Step 3: Create the MindTouch search integration
- Edit the template for your current template (likely "main") and click Edit.
- Find the template that should have the search widget (such as "Napili Search"). Hover over this item and click Edit.
- Inside the template editor, click the Page Structure view.
- On the div.headlinePanel folder, click on the gear icon and choose Add Row and Column Panels > Outside the panel > Insert Row Below.
- Your structure should now look like the following:
- On the newly created div folder, click the gear a second time and choose Add Row and Column Panels > Inside the panel > Add Row and Column Panels to add a second panel to the right.
- Here add an additional column to the right for the search tool:
- You should now see the following structure:
- Drag the Results List into the first sub-div folder.
- Highlight the secondary div folder and add the MindTouch search tool into this panel.
Step 4: Publish your changes
Click Publish Changes to publish changes to your community.
Step 5: Verify your integration
You should now see the Touchpoint search tool on your search results page:
Clicking a result will open a new window or a contextual help dialog depending on your configuration settings.