BASICS

ADMINISTRATION

DEVELOPMENT

SUPER ADMIN

  LAST UPDATED
7/3/2013

LDP Comments

LDP

The Live Delivery Platform (LDP) is an add-on module in OU Campus that enables a rich set of Web 2.0 applications and extends the dynamic interactive capabilities of the website. As a platform, LDP offers plug-in application architecture to grow with the institution's needs over time. LDP Comments gives website visitors an opportunity to have their voice heard on the institutional website. Visitors can provide their perspective on a topic, like or dislike a page or another visitor's comment, create comment threads, and much more. Administrators have the tools to monitor all feedback, approve and moderate comments, and have granular control over who can input a comment. Please contact the university′s designated OmniUpdate Sales Director for details. Live Delivery Platform has to be purchased and activated before Comments can be configured. To configure Comments, the following are required: 

  • A Disqus account: LDP simply requires a free account, which is where the comments may be moderated.
  • A site shortname: When creating a site within Disqus, a shortname will be configured. This will be used in the code used in the asset
  • A code-based asset: The asset will be used on the pages on which comments should appear.

The configuration is described here.

Basic Steps

1. Enable the Asset Manager.

2. Create an Account at Disqus.

3. Edit the Discuss Code.

4. Configure a Source Code Asset for Disqus

5. Insert an Asset on a Page.

6. Monitor Comments as Needed.

 

 

Next Page

 

Enabling the Asset Manager

From Setup > Account > under Asset Manager and make sure Enabled is checked.

Asset Manager

This enabled the ability to create and manage assets across sites within an account. Access limits for the use of assets can be enforced with the following actions:

  • From Setup > Sites > Edit icon for a site > Assets section, and select a group. Members of that group are only able to limit assets created in that site.
  • During asset creation select the Lock to Site checkbox to limit the use of that asset to only within that site.

 

Previous PageNext Page

 

Creating an Account at Disqus

Create an account at Disqus for the site. When the Disqus account is first created, a Disqus site should also be created. When registering a site at Disqus, a shortname is created to uniquely identify the site. This shortname is used in the code that is entered on the page at OU Campus.

  1. Go to http://www.disqus.com.
  2. Click on the orange button that says: Get this on your site.

    Disqus.com button

  3. Complete the fields.
    • Site URL: HTTP root to the site. This can be changed after the creation of the site.
    • Site Name: A friendly name to be used within the Disqus account for administration. This can be changed after the creation of the site.
    • Site Shortname: The shortname that will be used in the asset. This cannot be changed once configured.
    • Username: The username to be used when logging into Disqus.
    • Password: The password to be used when logging into Disqus.
    • Email address: The email address for the primary moderator. Additional moderators can be added to the individual site management.

    Disqus Account Setup

  4. Click Continue.
  5. Choose the Universal Code platform.

    Disqus.com platform choices

  6. The code below can be ignored as code for customizing the comments and adding them to pages will be provided by OmniUpdate when LDP is purchased for the institution.
  7. Click on Continue to the moderation dashboard.
    Disqus.com moderation dashboard button

After creating an account and adding a site, there are a variety of actions that can be taken within the Disqus Admin section.

Disqus.com admin tab

Some of the options include:

  • Moderating the comments (Moderate)
  • Modifying the appearance (Settings > General)
  • Updating the site information; name and URL (Settings > General)
  • Defining who can post comments (Settings > General)
  • Changing options for comments; attachments, reactions, and mentions (Settings > General)
  • Adding additional moderators (Settings > Moderators)
  • Adding restricted words (Settings > Filters)
  • Defining blacklists and whitelists (Settings > Filters)

 

Previous PageNext Page

 

Editing the Discuss Code

Disqus provides JavaScript embed code, which can be used within OU Campus. At Disqus, the code can be found by navigating to: Help > Developer's tab > Universal Code.

Here is a usable code snippet for example’s sake:

<div id="disqus_thread"></div>
<script type="text/javascript">
/* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
var disqus_shortname = '[YOUR DISQUS SHORTNAME]'; // required: replace example with your forum shortname

// The following are two highly recommended additional parameters.
var disqus_identifier = 'unique_dynamic_id_1234';
var disqus_url = '[URL TO RESULTANT PAGE]';
/* * * DON'T EDIT BELOW THIS LINE * * */
(function() {
var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
dsq.src = 'http://' + disqus_shortname + '.disqus.com/embed.js';
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
})();
</script>
<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
<a href="http://disqus.com" class="dsq-brlink">blog comments powered by <span class="logo-disqus">Disqus</span></a>

In the code, make the following changes:

  • Replace the highlighted code above with your actual shortname. For example:
var disqus_shortname = 'my_site_shortname';

The example code above includes two additional configuration variables, not provided in the Universal Code, but highly recommended and documented at Disqus on the JavaScript configuration variables page. Both variables are added on a per page basis as they are unique identifiers.

Replace the term, unique_dynamic_id_1234 as shown in the example code with a unique identifier for the current page. For example:

var disqus_identifier = 'my_unique_dynamic_id_4321';
  • Replace the bracketed code [URL TO THE RESULTANT PAGE] shown in the above code with the actual URL for the current page. For example:
var disqus_url = 'http://example.com/page.html';

Save the edited code in a text format. It will be added to an asset during set up in the next step.

Directories or pages can be specified for tracking purposes. A unique asset needs to be created for each one.

 

Previous PageNext Page

 

Setting Up a Source Code Asset for Disqus

To begin configuring Comments in OU Campus, a simple script is added to the <head> code of the site. This script allows one Disqus site to be used on multiple pages. The script indicates on which page the comment was originated.

<script type="text/javascript">
var page_id="<xsl:value-of select="concat(string-join(remove(tokenize(substring($ou:httproot, 1), '/'), count(tokenize(substring($ou:httproot, 1), '/'))), '/'),$ou:path)"/>";
</script>

It is still possible to have multiple Disqus sites in order to allow multiple moderators access to moderate only comments that pertain to their portion of the site.

After configuring the <head> script in the appropriate XSL, the code for the asset is added to a Source Code asset.

  1. Within OU Campus, navigate to Content > Assets.
  2. Click on New.
  3. Select Source Codeasset.

    Creating a Source Code Asset
  4. Name the asset. If configuring multiple assets for comments, make sure the name is clear enough to distinguish between them.
  5. Add an optional Description if desired.
  6. It is advisable to check the box next to Lock this site. This prevents the asset from accidentally being used on another site with a different HTTP root or that may not be using the <script> described above.
  7. Add Tags and separate them with a comma. A minimum of two tags is suggested. Thi will help filter the assets later in order to find the desired asset to add to the page.
  8. Add the code for the Comments.
  9. Update the shortname to the one corresponding to the site in the Disqus account. Change [YOUR DISCUS SHORTNAME] to the shortname configured.

    /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */

    var disqus_shortname = '[YOUR DISQUS SHORTNAME]'; // required: replace example with your forum shortname


    Disqus.com code
  10. Save and publish the asset.

At this point once the Comment asset is saved and published, comments are active and viewable on that particular asset page.

Comments Asset

 

Previous PageNext Page

 

Using Comments in OU Campus

After the asset is configured, insert the asset on the pages in which comments are desired.

1. Create or edit a page.

2. Click the Insert Asset icon from within the WYSIWYG Editor or the full page's source code.

3. Locate the appropriate asset from the Asset Browser and insert it on the page. Tags can be used to filter the assets, and it is advised to add it as the last piece of content on the page.
Asset Browser

4. Save and Publish the page.

Comments will now appear on the page. The comment count refers to the number of comments on that page, even if the same asset is being used on multiple pages.

View of Disqus comments as asset

 

Previous PageNext Page

 

Moderating Comments

Changes for the Comments settings, such as moderation, can be accomplished through the links to the Disqus Dashboard or quick links for the account, or even through email.

Comments can be moderated from within the Disqus account. All comments added to the same Disqus site (asset using the same shortname) will appear on the same moderation page, but the page name relating to the location of the comment will be shown with each comment. Comments can be marked as spam or deleted. If pre-moderation is on, that will be completed from the moderation screen under Pending.

Moderation pending page for Disqus.com

 

It is helpful to configure an Add-On in the Account settings (Settings > Account > Add-Ons) that points to the Disqus Dashboard and marked for Admin Only in order to easily moderate the comments.

Add-Ons for Disqus.com

Disqus Dashboard as an OU Campus Add-On

Disqus as an Add-On

 

Comments can now be used and moderated!

 

Previous Page

 

 

 


Was this page helpful?

Additional Comments:


(Include your email address if you would like a reply)