In this Article

Prerequisites

  • Telligent Community 7.1
  • Sitecore 6.4.1 or Sitecore 6.5
  • Microsoft .NET Framework 4.0 (for both Telligent Community and Sitecore)

Install Telligent plugin

For Sitecore to communicate with your Telligent Community site, you must install a plugin that enables this communication to take place.

You should always back up your Web installation and database before installing components on your Telligent Community installation.

  1. Locate the Telligent Evolution folder in the installation package.

  2. Copy the contents of this folder to your Telligent Community Web installation. If you are using multiple Web servers, this should be repeated for each Web server.

Configure Telligent

Once you have installed the files, there are a few changes you need to make inside your community to complete the installation process.

Enable the plugin

  1. As an administrator, navigate to the Control Panel.

  2. Navigate to System Administration > Site Administration > Manage Plugins.

  3. Select the Remote Studio Widget Support check box.

  4. Click Save.

Modify global account settings

Sitecore uses a Domain\Username pattern for their username to ensure uniqueness. Telligent, by default, does not allow you to add a slash ("\") in a username. To change this restriction, do the following:

  1. As an administrator, navigate to the Control Panel.

  2. Navigate to System Administration > Membership Administration > Configuration > Account Settings.

  3. In the Username regular expression pattern, modify the entry by adding \\ right before the final ].  Example: ^[a-zA-Z0-9_\- @\.\\]+$

  4. Save your changes.

  5. Optional: If you have a username that contains "admin", it will be blocked by Telligent. If you wish to have this account automatically created, you must go to System Administration > Site Administration > Content/Site Security > Username filters and remove "admin" from the list of disallowed names and save.

It is important to note that in order for Telligent Connect for Sitecore to create a user, the following conditions must be met:

  1. The username must meet the username regular expression restriction (see above).
  2. The user must have an email address in Sitecore and that email address cannot be already in use on your community.
  3. The Sitecore username must not already be in use in your community.

Install into Sitecore

Telligent Connect for Sitecore is installed into your Sitecore installation using the Package Installation Wizard.

Change your Sitecore IIS Settings: In order for Telligent Connect for Sitecore to work with your community, you must run your Sitecore site under .NET 4.0. Change your application pool settings for your Sitecore site to use .NET 4.0 in integrated mode.

Back up your Web files and databases before continuing.

  1. Log into the Sitecore Desktop as an administrator.

  2. From the Sitecore button, select Development Tools > Installation Wizard.

  3. You will need to upload the Sitecore package from the installation package. The Sitecore package is located in the installation package in the Sitecore folder. It is a zip file that should be labeled "Telligent Connect for Sitecore" with a version number.

  4. Once it is uploaded, if it did not pre-populate the package you uploaded, click browse and select it.

  5. Click Next and verify the version information matches what is on the package name.

    Click Install. This process will take several minutes to complete.

  6. When prompted, restart both the Sitecore client and server.

Configure Sitecore

  1. Make sure you are connected to the master database and open the Content Editor.

  2. In the tree, navigate to the following item: /sitecore/System/Modules/TelligentEvolution/Configuration.

  3. Fill in the configuration data fields according to the following table:

    Field Required? Description
    Service Account Yes A Telligent user that facilitates communications between Sitecore and your community. This account should at minimum possess Site - Impersonate User and Site - Manage Membership rights.
    API Key Yes A generated API key for the user assigned to be the service account. You should create an API key specific to Sitecore if you are reusing an account previously used as a service account for other applications.
    API Key Name Yes The case-sensitive name you had to give to the API key you created for the service account.
    User Name (Http Authentication) No The user name of a Windows account that can satisfy a windows challenge (if your community
    utilizes one).
    Password (Http Authentication) No The password associated with the Http authentication user name.
    Domain (Http Authentication) No The domain associated with the Http authentication user name if applicable.
    Base Url Yes The base URL of your community site (e.g., http://your-community.com)
    Theme Url No A path to a CSS file rendered by the Telligent component to apply basic styling to the widgets. You can modify this path to one of your own, or remove it entirely for no styles at all.
    Modal Theme Url No A path to a CSS file rendered by the Telligent component's modal windows to apply basic styling to the modal. You can modify this path to one of your own or remove it entirely for no styles at all.
    Remote Callback Url Yes The path to the HTTP handler the community sends information to within Sitecore. It is set to a default location and should not be altered.

  4. Save the item.

  5. You now need to publish everything. You can do this by selecting publish from the Content Editor menu and selecting the arrow under the globe labeled publish. Choose Publish Site.

  6. You can choose to do a Smart Publish; however, if that doesn't initially work, do a full republish.

  7. Recycle the Sitecore Web server application pools to clear all the caches.

To continue on by adding Telligent components to your Sitecore site (required for adding Telligent widgets), see this article.