nystudio107 / disqus
Integrates the Disqus commenting system into Craft CMS websites, including Single Sign On (SSO) and custom login/logout URLs.
Fund package maintenance!
khalwat
Installs: 492
Dependents: 0
Suggesters: 0
Security: 0
Stars: 26
Watchers: 4
Forks: 10
Open Issues: 0
Type:craft-plugin
Requires
- composer/installers: ~1.0
This package is auto-updated.
Last update: 2024-10-29 04:58:53 UTC
README
DEPRECATED
This Craft CMS 2.x plugin is no longer supported, but it is fully functional, and you may continue to use it as you see fit. The license also allows you to fork it and make changes as needed for legacy support reasons.
The Craft CMS 3.x version of this plugin can be found here: craft-disqus and can also be installed via the Craft Plugin Store in the Craft CP.
Disqus plugin for Craft CMS
Integrate the Disqus commenting system into Craft CMS websites, including Single Sign On (SSO) and custom login/logout URLs.
Related: Disqus for Craft 3.x
Installation
- Download & unzip the file and place the
disqus
directory into yourcraft/plugins
directory - -OR- do a
git clone https://github.com/nystudio107/disqus.git
directly into yourcraft/plugins
folder. You can then update it withgit pull
- -OR- install with Composer via
composer require nystudio107/disqus
- Install plugin in the Craft Control Panel under Settings > Plugins
- The plugin folder should be named
disqus
for Craft to see it. GitHub recently started appending-master
(the branch name) to the name of the folder for zip file downloads.
Configuring Disqus
First, make sure you have set up a Disqus account.
Next in the Craft Admin CP, go to Settings->Plugins->Disqus and enter the Short Name for your Disqus site. This is the only required setting for the Disqus plugin.
All settings are also configurable via the config.php
file, which is a multi-environment friendly way to store the default settings. Don't edit this file, instead copy it to craft/config
as disqus.php
and make your changes there.
Single Sign On (SSO)
The real usefulness of the Disqus plugin is that it takes care of the Single Sign On (SSO) integration with your Craft site.
Before you can use this, you'll need to set up the Disqus SSO API as described on the Integrating Single Sign-On web page.
Then copy and paste the API Key and API Secret into the Disqus plugin settings, and turn on the "User Single Sign On" lightswitch.
Custom Login/Logout URLs
The Disqus plugin will also take care of the custom login/logout URLs, should you wish to use them. Please see Adding your own SSO login and logout links for details.
You only need this is you want to have a custom login button displayed in the Disqus UI itself.
url
should be the address of your login page. The page will be opened in a new window and it must close itself after authentication is done. That is how we know when it is done and reload the page.
logout
should be set to http://example.com/actions/disqus/logoutRedirect
to hit the Disqus controller that handles the logout and redirect.
Using the Disqus plugin in your templates
All of these methods accomplish the same thing:
{# Output the Disqus embed code using the 'disqusEmbed' function #}
{{ disqusEmbed( DISQUS_IDENTIFIER, DISQUS_TITLE, DISQUS_URL, DISQUS_CATEGORY_ID, DISQUS_LANGUAGE) }}
{# Output the Disqus embed code using the 'disqusEmbed' filter #}
{{ DISQUS_IDENTIFIER | disqusEmbed(DISQUS_TITLE, DISQUS_URL, DISQUS_CATEGORY_ID, DISQUS_LANGUAGE) }}
{# Output the Disqus embed code using the 'disqusEmbed' variable #}
{{ craft.disqus.disqusEmbed( DISQUS_IDENTIFIER, DISQUS_TITLE, DISQUS_URL, DISQUS_CATEGORY_ID, DISQUS_LANGUAGE) }}
All of the parameters except for DISQUS_IDENTIFIER
are optional. For more information on what these parameters are, please see Javascript configuration variables
Disqus ignores any settings that are empty strings, e.g.: ''
The typical Twig tag you'll use would look like this:
{{ disqusEmbed(entry.slug, entry.title, entry.url) }}
...which will result in comments that are unique on a per-entry basis.
In its most basic case, this will result in output to your Craft template that looks like this:
<div id="disqus_thread"></div>
<script data-cfasync="false" type="text/javascript">
/**
* RECOMMENDED CONFIGURATION VARIABLES: EDIT AND UNCOMMENT THE SECTION BELOW TO INSERT DYNAMIC VALUES FROM YOUR PLATFORM OR CMS.
* LEARN WHY DEFINING THESE VARIABLES IS IMPORTANT: https://disqus.com/admin/universalcode/#configuration-variables
*/
if (typeof disqus_config !== 'undefined') {
var _old_disqus_config = disqus_config;
}
var disqus_config = function() {
if (typeof _old_disqus_config !== 'undefined') {
_old_disqus_config.apply(this);
}
this.page.url = 'DISQUS_URL';
this.page.identifier = 'DISQUS_IDENTIFIER';
this.page.title = 'DISQUS_TITLE';
this.page.category_id = 'DISQUS_CATEGORY_ID';
this.language = 'DISQUS_LANGUAGE';
};
(function() { // REQUIRED CONFIGURATION VARIABLE: EDIT THE SHORTNAME BELOW
var d = document, s = d.createElement('script');
s.src = '//DISQUS_SHORTNAME.disqus.com/embed.js'; // IMPORTANT: Replace EXAMPLE with your forum shortname!
s.setAttribute('data-timestamp', +new Date());
(d.head || d.body).appendChild(s);
})();
</script>
<noscript>Please enable JavaScript to view the <a href="https://disqus.com/?ref_noscript" rel="nofollow">comments powered by Disqus.</a></noscript>
The DISQUS_SHORTNAME
setting is taken from the Admin CP or config.php
settings, and the rest of the DISQUS_*
settings are passed in as variables from the disqusEmbed
Twig filter/function.
If you have turned on "User Single Sign On" it will also output something like this inside the above tag:
this.page.remote_auth_s3 = "eyJpZCI6IjEiLCJ1c2VybmFtZSI6IkFkbWluIiwiZW1haWwiOiJhbmRyZXdAbWVnYWxvbWFuaWFjLmNvbSJ9 c0e4b8f2eca3c0e995cdd64ba2dedd720820ab5b 1431214361";
this.page.api_key = "GTX1r1JBbiJah3hzZkBO06hI71VxjyWxgdurckHYBWLiELkHDidVmnDkBW0XeROe";
Which, assuming you've set up the Disqus SSO properly, will allow your Craft users to be logged into Disqus using your Craft website credentials.
If you have "Use Custom Login/Logout URLs" turned on, it will also generate the this.sso
settings for you, as described here
Disqus Multi-lingual websites
By default, Disqus will use the language you have set in Disqus Admin > Setup > Appearance
, however you can use it on Multi-lingual websites as well.
The DISQUS_LANGUAGE
parameter you can provide to {{ disqusEmbed() }}
allows you to control the language that the Disqus embed is displayed in. The comments, however, will still be the same for all languages.
If you wish to have the comments themselves be different per-language, you can do something like:
{{ disqusEmbed(entry.slug ~ "_" ~ entry.locale, entry.title, entry.url, '', entry.locale ) }}
This will result in comments that are different for each language, and the Disqus embed will be displayed in the same language as the comments.
Brought to you by nystudio107