This document introduces the Community Everywhere feature of Jive Forums.
Community Everywhere is a tool that gives you the ability to embed Jive Forums discussion threads directly into your existing news articles, blog posts or other content that would benefit from comments or discussions. Instead of forcing users to go to leave the content to create a comment or view a discussion thread, Community Everywhere enables your users to login or create an account and participate in discussions while on the page that contains your content. Community Everywhere embeds your Jive Forums 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. Read the 'Setup & Configuration' steps below for a more in-depth look at the steps you'll need to take to enable Community Everywhere and then read the 'Usage' section for information on how you embed the <script> tag in your content.
Community Everywhere must first be enabled via the Jive Forums Admin Console. You may optionally choose to limit the sites that may embed discussions by entering a comma delimited list of referers that should be allowed to embed discussions. Each of the referer values must begin with http:// or https://. Additionally, you may choose to specify a user that 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 Community Everywhere 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 website that you haven't explicitly allowed in the referer 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 URL's that you can embed in your site. There are choices for the amount of content you can show:
The Script Generator requires you to choose the forum 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 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 Jive Forums Admin Console, enable
Community Everywhere, choose the content and display options you wanted and
click the 'Generate New Key' button and 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/forums/communityjs/777?forum=1&key=51f8qO"></script>