wpDiscuz Documentation

wpDiscuz Built-in Settings

Custom Template and Style

wpDiscuz 4 allows you to customize comment list design and overwrite styles.  Template files are:

  • /wpdiscuz/assets/css/wpdiscuz.css (Style / Colors / Backrounds …)
  • /wpdiscuz/templates/comment/class.WpdiscuzWalker.php (Layout, HTML structure)

You can edit these files in an upgrade-safe way using overrides. Just copy the wpdiscuz.css or class.WpdiscuzWalker.php file to a folder within your current active WordPress theme named /wpdiscuz/ and start to customize.
Target location of wpDiscuz template files:

  • /wp-content/themes/mytheme/wpdiscuz/wpdiscuz.css
  • /wp-content/themes/mytheme/wpdiscuz/class.WpdiscuzWalker.php

The copied files will now automatically override the wpDiscuz default template files. All changes in this file will not be lost on plugin update.
Do not edit these files within the core plugin itself as they are overwritten during the upgrade process and any customizations will be lost.


Custom Comment Forms

wpDiscuz 4 comes with custom comment form creating function. Once you updated or installed wpDiscuz 4 it’ll generate default comment form with standard comment form fields. You can see and manage all comment forms in Dashboard > Comments > Forms admin page.

The user interface of custom comment form creator is very easy. You can add cols and rows then add custom fields. Example video: http://wpdiscuz.com/400/wpDiscuz-Custom Comment-Form-Builder.swf


screenshot-3 screenshot-5 screenshot-4 screenshot-6


Social Login

Social Login
You can use one of these most popular Social Login Plugins to allow your visitors login and comment with Facebook, Twitter, Google+, WordPress, VK, OK and lots of other social network service accounts. All social login buttons will be fully integrated with wpDiscuz comment forms.

  • WordPress Social Login
  • Super Socializer
  • Social Connect
  • Social Login

wpDiscuz with Super Socializer - Social Login
wpDiscuz with WP Social Login plugin

Background and Colors

Background and Colors

Email Subscription Settings


Disable subscription confirmation for registered users

wpDiscuz has double opt-in subscription system. A double opt-in means that not only does the visitor have to enter their email and click sign up, they also have to confirm their subscription via a link which send to them in a confirmation email. This is why many people say that the term double opt-in is incorrect, we should be using the term confirmed opt-in instead. However some administrators can say it’s not necessary for registered users, because they have already confirmed their registration so they are owners of their email addresses. In this case we added an option to disable subscription confirmation system by checking this option on.

Show comment subscription bar

This bar provides two subscription options: notify of “new follow-up comments” and “new replies to my comments”.  This option refers to the component shown below:

Show comment subscription bar

Show “Notify of new replies to this comment”

wpDiscuz is the only comment plugin which allows you to subscribe to certain comment replies. This option is located above [Post Comment] button in comment form. You can disable this subscription way by unchecking this option.  This option refers to the component shown below:

Notify of new replies to this comment


Show/Hide Components


Show logged-in user name and logout link on top of main form

This option refers to the component shown below:

Show logged-in user name and logout link on top of main form

Hide Reply button for Guests

This option refers to the component shown below, and it only works for guests:

Hide Reply button for Guests

Hide Reply button for Members

This option refers to the component shown below, and it only works for registered users (except admins):

Hide Reply button for Guests

Hide Commenter Labels

This option refers to the component shown below:


Hide Voting buttons

This option refers to the component shown below:

Hide Voting buttons

Show Share Buttons

Please note, that on settings page you can turn on/off each button separately. It’s turned on if it becomes colored. It’s disabled if you see a grey button. However on front-end the grey view of share buttons comes from style, it doesn’t mean, that button is inactive.  This option refers to the component shown below:

Show Share Buttons

Started from wpDiscuz 4 you need to creat and insert Facebook API key to be able use this share option. Here is an instruction:

  1. Make sure you’re logged in your Facebook account and click on this link: https://developers.facebook.com/apps/
  2. Create a new API
  3. Insert API Key in Dahsbaord > Comments > Settings > Hide/Show page in  Facebook API Key field

Steps Screenshots:

facebook-api-key-1 facebook-api-key-2 facebook-api-key


Hide the CAPTCHA field for guests

This option refers to the component shown below, and it only works for guests:

Hide the CAPTCHA field for guests

Show the CAPTCHA field for logged in users

This option refers to the component shown below, and it only works for registered users:

Show the CAPTCHA field for logged in users

Show the Website URL field

This option refers to the component shown below:

Show the Website URL field

Hide header text

This option refers to the component shown below:

Hide header text

Show sorting buttons

This option refers to the component shown below:

Show sorting buttons

Live Update Settings


Live update options

With turning on wpDiscuz live update you should choose either “Always check for new comments and show update buttons” or “Always check for new comments and update automatically” type of comment list updating. If you choose the one with “update buttons” it’ll notify update comment list until you click on [x new replies on your comment] or [x new comments] buttons, like it shown on this screenshot:


The wpDiscuz 3 has a big advantage over wpDiscuz 1 and 2. Its live update is very smart and doesn’t overload your server even if you’re on Shared hosting plan and even your website is very active. However we recommend to monitor your server resources if you’re on a Shared hosting plan. There are some very weak hosting plans which may not be able to perform very frequently live update requests. If you found some issue you can set the option below 30 seconds or more.

Update comment list every

This option allows you control wpDiscuz Live Update requests frequency. It depends on your server resources. If its powerful you can set the maximum: per 10 seconds.

General Settings

Display comment form for post types

Allows you to turn on/off wpDiscuz comment form on all available content types. Please note, that wpDiscuz doesn’t work on Archive, Category, Tag, Author and Search pages. It requires singular post ID to be able attach comment to certain post/page… Please do not turn on wpDiscuz for WooCommerce Product content type. There is WooDiscuz plugin, which designed for this purpose.


  • Comment author must fill out name: no description
  • Comment author must fill out email: no description
  • Comment text min length: no description
  • Comment text max length: no description
  • Comment text size in pixels: no description
  • Allow comment editing for: no description
  • Redirect first commenter to: no description
  • Allow guests to vote on comments: no description

Load rest of all comments on clicking the [Load More Comments] button

wpDiscuz allows you to display three different pagination types. Except of the native [1][2][3] pagination you also can choose [Load More Comments]  or [Load rest of all comments]  AJAX comment pagination buttons:

comment pagination
If you activate this option the default [Load More] button will be changed to [Load rest of all comments] and it’ll load all comments by one click. If you have a large amount of comments (>10,000) per post you should make sure your server can support such request. If you want to display the native WordPress comment pagination you should got to WordPress Settings > Discussions page and activate “Break comments into pages with [X]…” option.

Use WordPress Date/Time format

wpDiscuz shows Human Readable date format. If you check this option it’ll show the date/time format set in WordPress General Settings.

Use Plugin .PO/.MO files

wpDiscuz phrase system allows you to translate all front-end phrases. However if you have a multi-language website it’ll not allow you to add more than one language translation. The only way to get it is the plugin translation files (.PO / .MO). If wpDiscuz has the languages you need you should check this option to disable phrase system and it’ll automatically translate all phrases based on language files according to current language.

wpDiscuz native comment settings

Comment Moderation


In the Comment Moderation section you specify these options to help you deal with Comment Spam.

Hold a comment in the queue if it contains [X] or more links (A common characteristic of comment spam is a large number of hyperlinks.)

Not too long ago, comment spammers would have five, ten, or more hyperlinks in their comment spam. This made it very easy for bloggers to quickly screen comments but spammers recognized that and commonly use only one or two hyperlinks. You can enter a number in this box to tell WordPress how many links you allow in a comment before holding it for moderation.

When a comment contains any of these words in its content, name, URL, e-mail, or IP, it will be held in the moderation queue. One word or IP per line. It will match inside words, so “press” will match “WordPress”

In this text box you can add your own spam words which will filter the comments when posted. For an extensive and updated list of frequently used spam words and phrases click the link to the article on Spam Words; consider adding these to your own list.

Before a comment appears


These settings provide you even more control over the instances of when and how comments are posted.

An administrator must always approve the comment

Select this option to force comments to be approved by a blog user or owner having the proper Role to approve comments, even if the comments appear to be spam . See the Comment Moderation options below regarding spam.

Comment author must have a previously approved comment

Check the box to insure comments are only posted if the comment author’s email address matches the address of a previously approved comment, otherwise, the comment is held for moderation. Comments from blacklisted email addresses (those listed in the Local Spam Words Text Box) are held for moderation regardless of white-list status.

Comment Subscription Settings

These two settings give you control of when authors and administrators receive notification that comments have been made, or that comments are held for moderation. Please note that the use of “me” refers to either a post author or the administrator (person whose email address is used for admin purposes).

Anyone posts a comment

Check this box so that every single comment posted will generate an email to the author of that post. Be warned that if your posts receive a large number of comments, post authors may find a very full email Inbox. The email you’ll receive looks like this:
If this option is unchecked you’ll only get an email for new comment moderation (if you account role has appropriate permission). Please read the next option description.

A comment is held for moderation

Check this box if you want WordPress to send notification that a comment is being held for moderation. The email notification is sent to the E-mail address listed in the Administration > Settings > General Screen. This is useful if your blog has multiple authors and each author is authorized to allow or decline comments. That way, you, the owner of the site, can review what comments are being allowed or denied. The email you’ll receive looks like this:


Please note, if this option is also unchecked you’ll not get any notification about new comments. Unless you’ve subscribed to certain post comments using wpDiscuz front-end options:

wpDiscuz Comment SubscriptionwpDiscuz_Comment_Subscription_uniq

Comment Display Settings


Comment author must fill out name and e-mail

Check this box as a way to force spammers to do a bit of extra work. In reality, the name and e-mail address are not verified in any way prior to the comment being submitted. Most legitimate commenters are more than willing to fill out a name and e-mail address. However this option overwritten by wpDiscuz similar options, please see screenshot below:


Users must be registered and logged in to comment

If this checkbox is checked, only logged in registered users will be able to write comments on your site.

Automatically close comments on articles older than [X] days

Check the box and enter the number of days (e.g. 14 days) after which WordPress will automatically flag eligible posts so that no more comments are accepted.

Enable threaded (nested) comments [X] levels deep

Check this box to enable threaded comments, then from the drop-down box, select the number of levels deep (maximum of 10 levels) you will allow for nested comments. Note that themes need to be specially coded to properly display threaded comments.

Break comments into pages with [X] top level comments per page the [last/first] page displayed by default.

Check this box to cause comments to display in a paginated format with the specified number of comments per page. This will show the default [1][2]..[>] comment pagination buttons. I you want to change those to wpDiscuz AJAX [Load More Comments] button you should keep this option unchecked.


Comments should be displayed with the [older/newer] comments at the top of each page

Whether the oldest, or newest, comment is to be displayed first. By default WordPress comes with “oldest” option so you’ll see wpDiscuz sorting buttons like this:






Default Article Setting

These settings may be overridden for individual articles.

Discussion Settings Attempt to notify any blogs linked to from the article

If you check this box, WordPress will send out a ping to a site or article you have linked to in your post. Your mention of their site or article will show up in the comment section of their site, if that site allows pingbacks. The notification occurs during the process of publishing your article to the internet. An article with many hyperlinks will slow the posting process as WordPress contacts all of the sites before the post is published.

Allow link notifications from other blogs (pingbacks and trackbacks)

Check this box so WordPress to accepts or declines the pings from other sites which may reference your site or an article on your site. If this box is checked, pingbacks and trackbacks will appear in the comments section of your posts.

Allow people to post comments on new articles

Check this box if you wish to allow comments to your posts. Remember that this can be overridden for individual articles. Comments can also be controlled by making an article PRIVATE, which requires the appropriate password before a comment is allowed. If you don’t wish to allow comments uncheck this setting.


  • 1
  • 1