With Community Everywhere, you can embed discussion threads directly into existing news articles, blog posts or other content that would benefit from comments or discussions.
Instead of forcing users to leave your content to create a comment or view a discussion thread, you use Community Everywhere to enable users to log in or create an account and participate in discussions while on the page that contains your content.
This topic describes community everywhere, describing how you can set it up via the admin console and generate the script you'll use to embed access to discussions into your other content.
Community Everywhere embeds your Clearspace discussion threads using JavaScript: first you enable Community Everywhere via the admin console, then you create a generate a unique key for each one of the articles you want to embed discussions on and finally you insert a JavaScript <script> tag into the pages that you want discussions to be shown.
You must first enable Community Everywhere via the admin console. In the console, go to Spaces/Communities > Settings > Community Everywhere.
You can optionally choose to limit the sites that embed discussions by entering a comma-delimited list of referrers that should be allowed to embed discussions. Each of the referrer values must begin with http:// or https://. You can also specify a user who will be used as the author of the threads that are generated by your content (note that users of your application will only be able to create replies / messages to threads which are generated automatically by Community Everywhere).
If you choose not to enable the Community Everywhere feature, the feature will display an error message stating that "Comments have been disabled by the system administrator." If a user attempts to use the Community Everywhere feature from a web site that you haven't explicitly allowed in the referrer list, the Community Everywhere feature will display an error message stating that "This site is not authorized to access the Community Everywhere feature."
Once you have enabled the Community Everywhere feature, you use the Script Generator to create URLs that you can embed in your site. There are options for the amount of content you can show:
The Script Generator gives you four display options for the content generated from the choice you made about the content to display:
The Script Generator requires you to choose the space/community that you want the thread to be generated in and provides a button that gives you the ability to generate a unique key for each piece of content. After you've settled on all the options, you can copy and paste the text in the Code section of the admin console page into the HTML of the content that you want the Community Everywhere feature to be embedded in. See the Usage section below for more information.
Finally, the Community Everywhere feature gives you the ability to choose a custom title and description for the thread that is automatically generated by the system. You can do this by including two meta tags in the <head> of your document:
<meta name="jiveTitle" content="A discussion about Widget Foo"/> <meta name="jiveDescription" content="Add your thoughts about the Widget Foo article below."/>
or by including a snippet of JavaScript code in your document:
<script language="JavaScript" type="text/javascript"> var jiveTitle = "A discussion about Widget Foo"; var jiveDescription = "Add your thoughts about the Widget Foo article below."; </script>
After you've completed the configuration steps mentioned above, you're ready to embed the Community Everywhere feature into your content. As described above, you can simply cut and paste the <script> tag in the text box into your page. As an example, let's say you had an article extoling the virtues of Widget Foo on your site:
<p> Widget Foo is the greatest tool on the planet. You should buy one now. </p>
and you wanted to include a discussion form and replies below your content. You would go the admin console, enable Community Everywhere, choose the content and display options you wanted and click the "Generate New Key" button. You would then copy and paste the <script> tag into your content so that the end result would look something like this:
<p> Widget Foo is the greatest tool on the planet. You should buy one now. </p> <script language="JavaScript" type="text/javascript" src="http://example.com/clearspace/everywhere/777?community=2000&key=xzA8g6"> </script>
