Setting Up Community Everywhere

Before you can use Community Everywhere, you must first enable it via the admin console.

Fastpath: Admin Console > Spaces > 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."

Script Generator

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:

Display "Discuss This" Link: Choosing this option will result in only a link back to your community to a thread created from this piece of content. If a user posts a reply message, the reply and any other messages will not be displayed with the content.
Display "Discuss This" Link and Recent Posts: Choosing this option will show a link to your community to a thread created from this piece of content and will show the messages (if any) in the thread.
Display "Discuss This" Link, Recent Posts, and Comment Box: Choosing this option will show a link to your community to a thread created from this piece of content, will show the messages (if any) in the thread and will show a comment box giving users the ability to create comments on the piece of content.

The Script Generator gives you four display options for the content generated from the choice you made about the content to display:

View Threaded: Select this option to have messages displayed as threaded (indented hierarchically), rather than flat.
Show Discussion Statistics: Select this option to have Community Everywhere display the total number of replies and the date and time of the last reply. Sample: 2 message(s). Last at: Feb 28, 2007 12:48:36 PM
Open Link in New Window: Select this option to have Community Everywhere force the opening of a new window when the user clicks on the "Discuss This" link.
Include Default Style (CSS): Select this option to have Community Everywhere include style markup (via CSS) in the list of replies and comment box.

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>