Document! X 2017
Including Community Features / Using Disqus for Community Features
In This Topic
    Using Disqus for Community Features
    In This Topic

    Disqus is an increasingly popular choice for adding discussion and community features to web content.

    Setting up Disqus for Community Features

    To enable Community Features using Disqus, you must first register a "Site" with Disqus that uniquely identifies the content you will be using Disqus Community Features in and then configure the settings on the Community Features page in the Build Profile Editor.

    Register a Site on Disqus

    Open the Build Profile Editor and select the Community Features page.

    Tick the Include Community Features option.

    Select Disqus from the Community Provider drop down.

    Under the Settings heading, click the Create New button (or visit https://disqus.com/admin/signup/). This will take you to the Add Disqus to your site page:

    Add Disqus to your site page

    Add Disqus to your site page

    If you already have a Disqus account you wish to use, click Log in, otherwise sign up for a Disqus account by completing the fields on this page.

    Once you are logged in, you will be taken to the Site Profile page:

    Disqus Site Profile Page

    Disqus Site Profile Page

    Choose a Site Name to identify your documentation project. This should be a descriptive name, e.g. "Fabrikam Documentation".

    Complete the Disqus URL field. This must be a unique name across sites using Disqus so you may wish to prefix with your company name, e.g. "fabrikam-documentation". Make a note of the value you choose here, as you will need it when configuring your project later.

    Click Finish Registration to complete your Disqus Site Registration. You will now be taken to a Choose your platform page:

    Disqus Choose your Platform Page

    Disqus Choose your Platform Page

    Click the Universal Code option. This will take you to the setup instructions page but these are not needed as the integration is managed automatically once you have configured your project to use Disqus for Community Features.

     

    Configure the Build Profile to use Disqus for Community Features

    1. Open the Build Profile Editor and select the Community Features page.
    2. Ensure that the Include Community Features option is ticked.
    3. Ensure that Disqus is selected from the Community Provider drop down.
    4. Under the Content Publishing Url section, identify the location to which your content will be published. If you are using Publishing features you can select from an existing Publishing Target, otherwise type the Url into the Use this specific Url\Content Url field.
    5. Type or paste your Disqus Site URL into the Disqus URL field (see Register a Site on Disqus section above).

     

    Managing Community Content

    Once your project has been configured for Community Features you will find the Moderate Content and Manage Settings are enabled on the Community Features page in the Build Profile Editor. Those butons will launch a browser that will take you to the correct page on your chosen Community Provider's website.

    Once you have Built and Published your project after configuring the Community Features page, you will also be able to view and manage community content directly within the Topic Editor and Content File Editor and of course directly in the generated output.

     

    See Also