Comments assets are not their own asset type but a source code asset with specially configured code that connects to the third-party platform Disqus. Use the comments asset to add a Disqus-powered comments section to any page that the asset is inserted on.
As part of the Live Delivery Platform (LDP) module, comments assets require LDP to be purchased and activated before they can be used in your site.
Set up a comments asset and use it on multiple pages and each page will have its own unique comments. If you have multiple Disqus accounts, to segment moderation to different administrators, set up an asset for each Disqus account.
Set UpLink to this section
Once LDP has been purchased, the Omni CMS implementation team provides you with code for the comments asset and add the necessary code to your web pages for it to work. As an administrator, you are required to create an account with Disqus and connect that account to the premade asset.
- Go to the Disqus website and create an account.
- When instructed, follow the steps to install Disqus on a site.
- Write down the shortname for your site, as you will use this to link Disqus to Omni CMS.
- When asked to choose a platform, use "Universal Code." Ignore the code they give you, since you will be using our preconfigured code for the asset. This asset should have already been created during your implementation, but if not (or if you accidentally delete the original), the code can be found below these steps.
- Return to Omni CMS and locate the comments asset in Content > Assets.
- Wherever the code says
EXAMPLE, replace it with your site shortname.
- Optionally, uncomment and configure one or both of the two configuration variables,
this.page.identifier. Read more about these two variables on this page from Disqus. These variables are meant to enhance the reporting capabilities of Disqus, and their values will change on a per-page basis.
- Save and publish the asset. It is now ready to be placed on pages.
Use the Disqus dashboard to moderate comments and other administrator tasks. For ease of access, consider linking to Disqus in the add-ons menu.
- Comments Asset Code
In addition to the source code asset, a small script is placed in the
<head>of each page on the site, which allows the same comments asset to be used on multiple pages. The script indicates on which page the comment came from, and works in conjunction with the
this.page.urlvariable located in the asset. Make sure this variable is uncommented in order to use this functionality.
This code is typically placed during the implementation process. Should it need to be re-added, place it in the
common.xsl(or similar, like
default.xsl). It looks like this:
Comments assets are inserted onto pages like normal assets. However, the comments forum displays at the bottom of the page, regardless of where in the page content the asset is placed. We recommend placing the asset at the end of the page, so as not to get in the way of writing content. Save and publish the page for comments to appear.
Edit an existing comments asset, as follows:
- Navigate to Content > Assets.
- Click on the name of the asset you want to edit.
- Check out the asset.
- Click Edit in the page actions toolbar.
- Edit the asset content.
- Click Save.
- Publish the asset for your changes to appear on the live website.