Newer Version Available

This content describes an older version of this product. View Latest

Create a CMS Connection

Create a connection between your content management system and your community so you can render headers, footers, banners, blogs, and other content on your community pages.

Read Before Using CMS Connect to make sure you’re ready to connect to your CMS.

  1. Go to Community Workspaces.
  2. Click CMS Connect.
  3. Click New CMS Connection (if no connections have been created yet in your community) or New.
  4. For Name, enter a friendly name for the connection. The name shows up in your CMS workspace and other internal areas. (An API name is created for the connection behind the scenes, based on the name you enter.)
  5. Select your CMS source: AEM, Drupal, SDL, Sitecore, Wordpress, or Other.

    The “Other” option isn’t fully supported. However, if your CMS server isn’t listed, CMS Connect works if you set it up properly. CMS Connect works with the HTML, CSS, and HTTP standards and isn’t provider-specific.

    Note

  6. For your server URL, enter the full path to your CMS server, such as: https://www.example.com.
  7. For Root Path, enter the path to the directory that your CMS content is in. You can include placeholders for language and component. For example, a root path to content in AEM might look like this:

    content/mywebsite/{language}/{component}

    The {language} placeholder isn’t required, but if you include it in your root path, enable language mapping and add at least one language. See Build a CMS Connect Root Path and Component Paths for details on root paths and how they work with component paths.

    Note

  8. If your CMS source is AEM and your HTML content is set up with personalization, you can use that personalized content in your community. To do that, enable Use Personalization. See Personalize Your CMS Content for details on setting up personalization.

    To use personalization, enable it for the components you want to personalize. Do that in Builder Settings for header and footer, and in Community Builder for banners or other components.

    Note

  9. To include CSS, click Add CSS to add one or more URLs to your CSS files. If your CSS is scoped, you can specify it in the Scope field. Stylesheets load in the order listed. Use the up and down arrows to change the order.
  10. To include JavaScript, click Add Script to add one or more URLs to your JavaScript files. Scripts load in the order listed. Use the up and down arrows to change the order.
  11. To connect JSON content such as blogs, click Add JSON and enter a name, type, and path for each JSON component you want to add. See Set Up JSON in Your CMS Connection (Beta) for details.
  12. If your content has multiple languages, select Enable language mapping. See Set Up Language Mapping in Your CMS Connection for more information on setting up language mapping.

    In the Salesforce Language dropdown, English is selected by default. To map English, for CMS Language, enter the directory name of your English language folder from AEM. For example, enter en.

    To add more languages, click Add Language. For each language that you add from your CMS, make sure it’s enabled in your Builder Settings.

    If you want to map languages from your community that you don’t have in your CMS, you can define what language the CMS content should display in. For example, if your community has French and French Canadian enabled, you can set it up like this, so the French Canadian community displays French content:

    CMS Connect Language Mapping
  13. Click Save.