Skip to main content
MindTouch Success Center

Social discussion

Contact support to enable social discussion on your site.

Social discussion allows your pro members, community members, and even anonymous users to have a discussion about your documentation. Social discussion can be added by leveraging a commenting vendor and adding it to your MindTouch site. For this setup, we recommend using Disqus. 

Before setting this up, understand the following:

  • External commenting vendors will not honor the permissions set in MindTouch. It is best to only use social commenting on sites where all of the content is public.
  • External commenting can be configured to authenticate against SSO providers but is not configured to authenticate with MindTouch out of the box.
  • Notifications will not be triggered in MindTouch when a comment is added, but you can subscribe to notifications through Disqus.

How to set up Disqus

  1. Set up a Disqus account and get the embed code. It will look like the following:
< div id = "disqus_thread" > < /div> <script> 
/ * * * RECOMMENDED CONFIGURATION VARIABLES: EDIT AND UNCOMMENT THE SECTION BELOW TO INSERT DYNAMIC VALUES FROM YOUR 
PLATFORM OR CMS.*LEARN WHY DEFINING THESE VARIABLES IS IMPORTANT: 
https: //disqus.com/admin/universalcode/#configuration-variables
 */ /* var disqus_config = function () { this.page.url = PAGE_URL; // 
 Replace PAGE_URL with your page's canonical URL variable this.page.identifier = PAGE_IDENTIFIER; 
 // Replace PAGE_IDENTIFIER with your page's unique identifier variable }; 
 */ (function() { // DON'T EDIT BELOW THIS LINE var d = document, s = d.createElement('script'); 
 s.src = '//averytestsite.disqus.com/embed.js'; s.setAttribute('data-timestamp', +new Date()); 
 (d.head || d.body).appendChild(s); })(); </script> 
 <noscript>Please enable JavaScript to view the <a href=
 "https://disqus.com/?ref_noscript" rel="nofollow">comments powered by Disqus.</a></noscript>        
  1. From this embed code and add the following line  to a DekiSrcipt block:

<div id="disqus_thread"></div>

  1. Add the rest of the code into  a JavaSript (JEM) block.
  2. In the Javascript (JEM), delete the comments and assign values to variables: 
this.page.url = PAGE_URL;

and 

this.page.identifier = {{page.id}}; 
  1. After the comments are removed and variables are assigned the Javascript (JEM) Block should look like this:
/* var disqus_config = function () { this.page.url = https://averyd.mindtouch.us; this.page.identifier = {{page.id}}; }; 
*/ (function() {  var d = document, s = d.createElement('script'); s.src = '//averytestsite.disqus.com/embed.js'; 
s.setAttribute('data-timestamp', +new Date()); (d.head || d.body).appendChild(s); })(); /*

This ensures that the conversation is associated with the Page ID as opposed to the URL. Since the URL can change, you want to make sure that that the conversation is anchored with the ID (which will not change, regardless of how many times you move it or rename it. )


 

  1. Once you have added the code, click save and then navigate to an article. You should see the following:

From here your users can authenticate with their favorite social networks or even sign up for an account with Disqus.

 

  • Was this article helpful?