Contributors: disqus, alexkingorg, crowdfavorite, zeeg, tail, thetylerhayes, ryanv12, iamfrancisyo, brevityness
Tags: comments, threaded, email, notification, spam, avatars, community, profile, widget, disqus
Requires at least: 4.4
Tested up to: 5.1
Stable tag: 3.0.17
Requires PHP: 5.4
Disqus is the web's most popular comment system. Use Disqus to increase engagement, retain readers, and grow your audience.
== Description ==
[Disqus](https://disqus.com/) is the web’s most popular commenting system trusted by millions of publishers to increase reader engagement, grow audience and traffic, and monetize content. Disqus helps publishers of all sizes engage directly with their audiences to build loyalty, retain readers, and foster thriving communities.
The Disqus for WordPress plugin lets site owners and developers easily add Disqus to their sites, replacing the default WordPress comment system. Disqus installs in minutes and automatically imports your existing comments.
= Why Disqus? =
* Simple one-click installation that seamlessly integrates with WordPress without ever needing to edit a single line of code or losing any of your existing comments
* Keep users engaged on your site longer with a commenting experience readers love
* Bring users back to your site with web and email notifications and personalized digests
* Improve SEO ranking with user generated content
* Keep spam out with our best-in-class anti-spam filter powered by Akismet
* Single profile for commenting on over 4 million sites including social login support for Facebook, Twitter, and Google accounts
* Trusted by sites like Wired, CBS, and Entertainment Weekly
= Disqus Features =
* Syncs comments automatically to WordPress for backup and flexibility if you ever decide to switch to a different platform
* Loads asynchronously with advanced caching so that Disqus doesn’t affect your site’s performance
* Monetization options to grow revenue
* Export comments to WordPress-compatible XML to backup or migrate to another system
* Analytics dashboard for measuring overall engagement on your site
* Mobile responsive design
= Engagement Features =
* Realtime comments system with fun discussion interactions: voting, photo and video upload, rich media embed (Youtube, Twitter, Vimeo, and more), spoiler tags, mentions
* Comment text formatting (e.g. bold, link, italics, quote) using HTML tags as well as code syntax highlighting
* Threaded comment display (nested 3 levels) with ability to collapse individual threads
* Sort discussion by oldest, newest, and best comments
* Flexible login options - Social login with Facebook, Twitter, and Google, SSO, and guest commenting support
* Instant activity notifications, email notifications, and digests pull readers back in
* User profiles that show you recent comment history and frequented communities
* Discovery widget that shows active discussions happening elsewhere on your site
= Moderation Features =
* Automatic anti-spam filter powered by Akismet
* Automated pre-moderation controls to flag comments based on links, user reputation
* Moderate directly in the discussion, via email, or moderation panel
* Email notifications for newly posted comments, replies
* Moderation Panel that lets you search, filter, sort, and manage your comments
* Self-moderation tools like user blocking, comment flagging
== Support ==
* Search our [Knowledge Base](https://help.disqus.com/customer/portal/articles/472005) for solutions to common troubleshooting questions
* Check out our support community, [Discuss Disqus](https://disqus.com/home/channel/discussdisqus/), to see if your question has been answered
* Talk to our Support team at [disqus.com/support](disqus.com/support)
* Visit our [Getting Started](https://help.disqus.com/customer/en/portal/articles/1264625-getting-started) page to learn the basics of Disqus
== Frequently Asked Questions ==
= Is Disqus free to use on my site? =
Yes! Disqus is free to use. We also provide [subscription plans](https://help.disqus.com/customer/en/portal/articles/2759918-disqus-pricing-and-plans) for larger, commercial sites that want access to more powerful moderation and audience tools and customization.
= How do I customize the look-and-feel of Disqus? =
Disqus automatically checks your site's font and background color and adapts to either a light or dark color scheme, along with a serif or sans-serif font. If these are detected incorrectly, you can [override them](https://help.disqus.com/customer/en/portal/articles/545277-disqus-appearance-tweaks) in your Settings.
= Will I lose comments if I deactivate Disqus? =
The Disqus for WordPress plugin automatically syncs comments back to WordPress. These comments will remain in WordPress should Disqus be deactivated or removed. You can also [export your comments](https://help.disqus.com/customer/en/portal/articles/1104797-importing-exporting#exporting) from Disqus at any time.
= Can I import my existing WordPress comments into Disqus? =
Yes, you can import your existing WordPress comments into Disqus during installation.
= How do I set up Single Sign-On (SSO)? =
SSO allows users in your database to comment without requiring them to register with Disqus. Access to SSO is currently available as an add-on for users with a [Pro subscription](https://help.disqus.com/customer/en/portal/articles/2759918-disqus-pricing-and-plans#pro-plan). If you would like to enable this feature, [contact our Support team](https://disqus.com/support/?article=contact_SSO). Also check out our guide for [setting up SSO on WordPress](https://help.disqus.com/customer/portal/articles/1148635).
= I’m experiencing an issue with my installation of Disqus. =
Check out our [WordPress Troubleshooting guide](https://help.disqus.com/customer/portal/articles/472005-wordpress-troubleshooting) with specific solutions for potential problems you might be experiencing.
== Installation ==
1. Go to **"Plugins"** > **"Add Plugin"**
2. Search for **"Disqus Comment System"** by Disqus
3. Click **"Install Now"**
4. Activate the plugin
5. (**Automatic: easiest**) From the Install page of the Disqus plugin settings, follow the Automatic Installation steps to set up Disqus on your site. During this process, you will need to [create a Disqus account](https://disqus.com/profile/signup/) and register your site. This also creates the API application required for enabling Comment Syncing.
6. (**Manual: fastest**) Enter your site's [Disqus shortname](https://help.disqus.com/customer/en/portal/articles/466208) in **Site Configuration**. This requires you to have [created a Disqus account](https://disqus.com/profile/signup/) and registered your site.
**NOTE: It is recommended that you [backup your database](http://codex.wordpress.org/Backing_Up_Your_Database) before installing the plugin.**
= Syncing comments to WordPress =
Comment Syncing copies comments made in Disqus to your WordPress installation as backup in case you ever decide to switch back to native WordPress comments. Syncing is not enabled by default. To enable syncing, you'll need to set it up either by creating an API application (follow [instructions here](https://help.disqus.com/customer/portal/articles/960360)) or via Automatic Installation in the plugin.
For more information, go to [https://help.disqus.com/customer/portal/articles/960360](https://help.disqus.com/customer/portal/articles/960360)
= Installation trouble? =
Go to [https://disqus.com/help/wordpress](https://disqus.com/help/wordpress)
== Screenshots ==
1. Disqus Comments
2. Comment Reply
3. Disqus Audience Platform
4. Featured Comment
5. Discovery Box (part of Disqus Comments)
7. Real-time Comments
8. Commenter User Profile
9. Moderation Panel
10. Moderation Panel Comments
11. Moderate by Email Notifications
== Changelog ==
= 3.0.17 =
* Bumping version for WP 5.1 version bump. (Changes to README versions and main php file's version)
* Fixed Undefined index bug where HTTP_HOST could not find web server
= 3.0.16 =
* Add a manual syncing option that allows retroactive syncing within a selected date range
* Fixed bug where SSO avatar URLs were malformed (Thanks to [klaufel](https://github.com/disqus/disqus-wordpress-plugin/pull/49))
= 3.0.15 =
* Fixed bug preventing sites from importing WordPress comments to Disqus
= 3.0.14 =
* Add a prompt to create a secret key if missing. Fixes issue preventing some sites from using automatic installation and enabling syncing
* Made it easier to reinstall the same site without having to select a new one
* Bug fix for some browsers from autofilling site configuration forms
* Bug fix for sites whose admin URL was different than their public site URL
* Prevent Disqus from loading on pending and scheduled posts
= 3.0.13 =
* Fixed warning that stated "cannot access private method Disqus_Rest_Api::dsq_get_settings_schema()"
* A few small copy changes in plugin's admin UI
= 3.0.12 =
* Disabled browser autocomplete for site configuration form
* Implemented a dsq_can_load filter for custom control of when Disqus loads
= 3.0.11 =
* Improved UX on updating the site configuration manually
* Fixed an issue causing a site crash with PHP version 5.2
* Added additional information to support diagnostics
= 3.0.10 =
* Lowered minimum-supported version of PHP to 5.4
* Fixed a syntax issue in PHP version 5.3
= 3.0.9 =
* Added a check to deactivate plugin if PHP version is earlier than the minimum-supported version 5.6.
= 3.0.8 =
* Fixed a bug that prevented automatic installation when upgrading from version 2.86 or earlier.
= 3.0.7 =
* Plugin has been completely rewritten to support modern and secure WordPress features.
* Added new Automatic Installation for installing Disqus on your site. This also creates the API application required for enabling comment syncing.
* Completely redesigned plugin settings page. Disqus replaces the Comments menu link in your WordPress admin and includes shortcut links to popular settings.
= 2.86 =
* Don't attempt to use cURL on IIS servers
* Check is dsq_sync_forum is scheduled before scheduling
* Add updates for Travis CI
* Fixes a bug in the upgrade process
= 2.85 =
* Fixes deprecation warnings on sites running PHP7
= 2.84 =
* Fixes a bug where the comment count won't work on some themes
= 2.83 =
= 2.82 =
* Fix PHP errors when there are no comments to sync
= 2.81 =
* Fix for automatic comment syncing
* Make sure all markup validates for HTML5
= 2.80 =
* Move all scripts to separate files instead of rendering them in php
* Fixed exporting bug introduced in 2.78 (Thanks to mkilian)
* Numerous small compatibility and security enhancements
= 2.79 =
* Reinstate changes removed by 2.78
= 2.78 =
* Security fixes
* Compatibility for Wordpress version 4.0
= 2.77 =
* Fixes login by email issue
* Make sure Disqus is enabled after installation
* Additional security fixes
= 2.76 =
* Security fixes (Thanks to Nik Cubrilovic, Alexander Concha and Marc-Alexandre Montpas)
* Bump tested Wordpress version to 3.9.1
* Remove obsolete SSO button uploader
* Fix for 'Reset' function not completely working the first time
= 2.75 =
* Bump supported WordPress version to 3.8.
* Properly encode site name for SSO login button.
* Increased timeout for comment exporter to 60 seconds.
* Use https: for admin pages
* Miscellaneous bug fixes and improvements.
= 2.74 =
* Updated settings UI
* Add filter hook for setting custom Disqus language
* For WP >= 3.5, use new media uploader
* Disable internal Wordpress commenting if Disqus is enabled (thanks Artem Russakovskii)
* Cleaned up installation and configuration flow
* Added link to WP backup guide in README
* Fix admin bar comments link
* Added a check to avoid a missing key notice when WP_DEBUG=TRUE (thanks Jason Lengstorf)
* Prevent 404 errors for embed.js from being reported by Google Webmaster Tools (missed in 2.73 README)
= 2.73 =
* Apply CDATA patch from Wordpress 3.4 to dsq_export_wxr_cdata() (thanks Artem
Russakovskii for the patch).
* Added Single Sign-On log-in button and icon to options (only for sites using SSO)
* Output user website if set in SSO payload
* Added plugin activation statuses to debug info
* Bump supported WordPress version to 3.4.1
* Fixed issue where disqus_dupecheck won't properly uninstall
* Load second count.js (output-in-footer version) reference via SSL too
* Added screenshots
= 2.72 =
* Load count.js via SSL when page is accessed via HTTPS
* Fixed styling issue with Disqus admin.
= 2.71 =
* Fixed issue where embed wasn't using SSL if page was loaded via HTTPS
* Fixed issue with syncing where to user's without a display_name would
revert back to Anonymous (really this time).
* Fixed issue where Google Webmaster Tools would incorrectly report 404s.
* Fixed issue with Disqus admin display issues.
= 2.70 =
* Properly uninstall disqus_dupecheck index when uninstalling plugin.
* Fixed issue with syncing where to user's without a display_name would
revert back to Anonymous.
* Fixed issue where IP addresses weren't being synced properly.
* Allow non-Administrators (e.g., editors) to see Disqus Moderate panel
inline (fixes GH-3)
= 2.69 =
* Bumped version number.
= 2.68 =
* Removed debugging information from web requests in CLI scripts (thanks
Ryan Dewhurst for the report).
* Reduced sync lock time to 1 hour.
* Fixed an issue which was not allowing pending posts (for sync) to clear.
* Fixed an issue with CLI scripts when used with certain caching plugins.
= 2.67 =
* Bumped synchronization timer delays to 5 minutes.
* wp-cli.php now requires php_sapi_name to be set to 'cli' for execution.
* Fixed a bug with imported comments not storing the correct relative date.
* Added a lock for dsq_sync_forum, which can be overriden in the command line script
with the --force tag.
* dsq_sync_forum will now handle all pending post metadata updates (formerly a separate
cron task, dsq_sync_post).
= 2.66 =
* Fixed issue with jQuery usage which conflicted with updated jQuery version.
= 2.65 =
* Corrected a bug that was causing posts to not appear due to invalid references.
= 2.64 =
* Added an option to disable Disqus without deactivating the plugin.
* Added a second check for comment sync to prevent stampede race conditions in WP cron.
= 2.63 =
* Added command line script to import comments from DISQUS (scripts/import-comments.php).
* Added command line script to export comments to DISQUS (scripts/export-comments.php).
* The exporter will now only do one post at a time.
* The exporter now only sends required attributes to DISQUS.
* Moved media into its own directory.
= 2.62 =
* Changed legacy query to use = operator instead of LIKE so it can be indexed.
= 2.61 =
* Fixed an issue which was causing invalid information to be presented in RSS feeds.
= 2.60 =
* Added support for new Single Sign-On (API version 3.0).
* Improved support for legacy Single Sign-On.
= 2.55 =
* Added support for get_comments_number in templates.
= 2.54 =
* Updated URL to forum moderation.
= 2.53 =
* Fixed an issue with fsockopen and GET requests (only affects certain users).
= 2.52 =
* Fixed issue with Disqus-API package not getting updated (only affecting PHP4).
= 2.51 =
* Syncing comments will now restore missing thread information from old imports.
* Install and uninstall processes have been improved.
* Fixed an issue in PHP4 with importing comments.
* Fixed an issue that could cause duplicate comments in some places.
* Added an option to remove existing imported comments when importing.
= 2.50 =
* Added missing file.
= 2.49 =
* Database usage has been optimized for storing comment meta data.
You can perform this migration automatically by visiting Comments -> Disqus, or if
you have a large database, you may do this by hand:
CREATE INDEX disqus_dupecheck ON `wp_commentmeta` (meta_key, meta_value(11));
INSERT INTO `wp_options` (blog_id, option_name, option_value, autoload) VALUES (0, 'disqus_version', '2.49', 'yes') ON DUPLICATE KEY UPDATE option_value = VALUES(option_value);
= 2.48 =
* Comment synchronization has been optimized to be a single call per-site.
* disqus.css will now only load when displaying comments
= 2.47 =
* Fixed a security hole with comment importing.
* Reverted ability to use default template comments design.
* Comments will now store which version they were imported under.
* Added an option to disable server side rendering.
= 2.46 =
* Better debugging information for export errors.
* Added the ability to manual import Disqus comments into Wordpress.
* Added thread_identifier support to exports.
* Cleaned up API error messages.
* Fixed a bug which was causing the import process to not grab only the latest set of comments.
* Added an option to disable automated synchronization with Disqus.
= 2.45 =
* Comments should now store thread information as well as certain other meta data.
* Optimize get_thread polling to only pull comments which aren't stored properly.
= 2.44 =
* Comments are now marked as closed while showing the embed (fixes showing default respond form).
= 2.43 =
* Correct an issue that was causing comments.php to throw a syntax error under some configurations.
= 2.42 =
* Correct a bug with saving disqus_user_api_key (non-critical).
* Added settings to Debug Information.
* Adjusting all includes to use absolute paths.
* Adjusted JSON usage to solve a problem for some clients.
= 2.41 =
* Correct a bug with double urlencoding titles.
= 2.40 =
* Comments are now synced with Disqus as a delayed asynchronous cron event.
* Comment count code has been updated to use the new widget. (Comment counts
must be linked to get tracked within "the loop" now).
* API bindings have been migrated to the generic 1.1 Disqus API.
* Pages will now properly update their permalink with Disqus when it changes. This is
done within the sync event above.
* There is now a Debug Information pane under Advanced to assist with support requests.
* When Disqus is unreachable it will fallback to the theme's built-in comment display.
* Legacy mode is no longer available.
* The plugin management interface can now be localized.
* The plugin is now valid HTML5.
This simple plugin permanently redirects all 404's to the main blog URL.
Add an SVG image captcha and honeypot to your contact form 7 form.
A light-weight plugin which will remove the advertisement HTML comments co...
Let we say that you have been told to add some custom code (HTML, JavaScrip...
The right marketing strategies can fuel your growth and profit. Learn how t...
Why do you need to manage customer information and customer interactions, a...
One method used by WordPress hackers is mass login attempts, learn how you ...