Keep commenting open for all and still have full control over which comments that get posted.
|General plugin info|
|Support:||Plugin comments or forum thread|
|Compability:||Nucleus CMS 3.60, NP_LMReplacementVars 1.1.0|
The NP_LMCommentModerstor plugin is for comment moderation. It will let you keep commenting open for all, while you will still have full control over which comments that get posted to the blog. Unregistered commenters will have the possibility to edit their comments for one hour.
The plugin includes a simple spam filter which let you whitelist or blacklist on member, ip, email address or website. In addition to that it have a spam filter API, that supports additional plugins for spam check.
The current skin and template variables in the Nucleus core for showing comments does not have the possibility to have plugins filter the comments shown. Because of this the NP_LMCommentModerstor plugin uses a helper plugin for handling comment filtering. This plugin is called NP_LMReplacementVars and gives alternative implementations of some key Nucleus core skin variables. It must be installed before the NP_LMCommentModerstor plugin can be installed. The NP_LMReplacementVars plugin can be downloaded from the NP_LMReplacementVars plugin page.
NP_LMCommentModerstor.phpfile and the
lmcommentmoderatordirectory from the zip file to the Nucleus CMS plugins directory (
nucleus/plugins) on your web server.
The NP_LMCommentModerstor plugin has the following options on the blog level:
Hamis in the comment body, will the comment be categorized as Ham. If the word
Spamis in the comment body, will the comment be categorized as Spam.
After the plugin is installed and configured you need to change your skin to use the the NP_LMReplacementVars skin and template variables as described in the "NP_LMReplacementVars" section of this help document.
Usually you should be able to use the default comment form templates provided by the NP_LMCommentModerator plugin. If you want to use customized version see the "Comment form templates" section of this help document.
The NP_LMCommentModerator plugin have some comment related template variables. These are "ModCategory", "CommentActions" and "CookieWarning". Each of these are described in individual sections in the help document. You should update the template used on your item page to include these template variables.
The plugin admin page will show any comments waiting for manual moderation. Blog admins are comment moderators, and can moderate comments on the blog they are admin for.
A guide describing how to set up the skin and templates of a Nucleus CMS installation to use the NP_LMCommentModerator plugin can be found here.
The NP_LMCommentModerator plugin will add a moderation category property to comments. The available moderation categories are:
Hamby either a spam filter of by a comment moderator.
Hamcomments will be shown to all. When a comment moderator categorizes a comment as
Hamwill spam filters that supports updating be updated.
Spamby either a spam filter of by a comment moderator.
Spamcomments will only be shown to the comment author. When a comment moderator categorizes a comment as
Spamwill spam filters that supports updating be updated.
Showby a comment moderator. The comment will be shown to all. When the NP_LMCommentModerator plugin is installed will all existing comments be but in this category.
Hideby a comment moderator. The comment will only be shown to the comment author.
Spamis categorized as
Manual Moderationcomments will be shown to the comment author and the comment moderators.
Members Onlyby a comment moderator. The comment will only be shown to logged in members.
When a comment moderator edit a comment can the moderation category of the comment be updated.
The comment sections of the Nucleus CMS admin area will show all comments regardless of moderation category. Plugins that handle comments and that not explicitly support the will NP_LMCommentModerator plugin will disregard moderation category. These plugins will need an update to support moderation category.
The NP_LMCommentModerator plugin implements a modified subset of the Nucleus CMS SpamCheck API. A description of the NP_LMCommentModerator SpamCheck API is linked from the the NP_LMCommentModerator plugin admin page or it can be found here.
A simple whitelist/blacklist spam filter for IP, member, email and website comment attributes is included in the NP_LMCommentModerator plugin.
This spam filter is administered from the NP_LMCommentModerator plugin admin page.
If a comment attribute matches the filter value, will the comment get the filter category value.
The spam filter is automatically updated when a comment moderator sets the moderation category of a comment to
In addition to the built in spam filter are two additional spam check plugins implementing the NP_LMCommentModerator SpamCheck API released by the NP_LMCommentModerator plugin author. These spam check plugins are NP_LMStopForumSpam and NP_LMSpamBotBehavior.
The order of the spam check plugins in the Nucleus CMS admin plugin list is the order the spam checks are executed. It is recommended to keep any spam check plugins bellow the NP_LMCommentModerator plugin in the Nucleus CMS admin plugin list.
The NP_LMCommentModerator plugin administration page has two main sections. One section for handling comments, and one section for administration of the built in spam filter.
In the show comments section you can list all comments with moderation category
Actions can be performed single comments or on all comments in the list.
Available actions are:
Hammoderation category, and update spam filters.
Spammoderation category, and update spam filters.
In the show filter section you can list the content of the member, email, website or IP filter. Actions can be performed on single filters in the list. Available actions are:
Ham. Spam checked comments matching the filter value will have its moderation category set to
Spam. Spam checked comments matching the filter value will have its moderation category set to
Manual Moderation. Spam checked comments matching the filter value will have its moderation category set to
Hamfor a matching comment.
Hamfor a matching comment.
The NP_LMCommentModerator plugin adds some new comment form templates and uses modified versions of existing ones. These comment form templates are "Comment Loggedin Form", "Comment Not Loggedin Form", "Comment Loggedin Edit Form", "Comment Not Loggedin Edit Form" and "Comment Can Not Edit Form". The default contents of these templates can be displayed from the plugin admin page.
Do not edit the comment form template files provided in the NP_LMCommentModerator plugin directory.
These files will be overwritten when you upgrade the plugin.
If you need to override the default comment form template provided by the plugin this should be
done in the NP_LMCommentModerator section of a Nucleus template.
To utilize a comment form template in a Nucleus template,
add the Nucleus template name to the CommentForm skin variable like this
Template variable used to insert the text associated with the moderation category of a comment. It is used in the comment part of a nucleus template. The text associated with each moderation category can be set in the ModCategory fields in the nucleus template given as parameter. If the template field for an moderation category is empty will the default value for the moderation category be used instead. The default value for each moderation category can be displayed from the plugin admin page.
The parameters are:
Template variable used to insert the available comment actions for a comment. It is used in the comment part of a nucleus template.
Template variable used to insert the cookie warning for a comment. It is used in the comment part of a nucleus template. The cookie warning will be shown to non-members on the latest comment they made, if the comment can be edited. The text for the cookie warning can be set in the Cookie Warning field in the nucleus template given as parameter. If the template field for the cookie warning is empty will the default value be used insted. The default value for the cookie warning can be displayed from the plugin admin page.
The parameters are:
The replacement skin and template variables for
in the NP_LMReplacementVars plugin must be used by your blog if you want this plugin to function.
See the documentation for the NP_LMReplacementVars plugin for further information on how to use the comments and comment form replacement skin variables.
This version of the NP_LMCommentModerstor plugin is tested against version 3.66 of LMNucleus CMS. The minimum version of Nucleus CMS needed for using this plugin is 3.60.
The minimum version of the NP_LMReplacementVars plugin needed by this plugin is version 1.1.0.
The latest version of the NP_LMReplacementVars plugin can be downloaded from the NP_LMReplacementVars plugin page.
Spam and off topic comments will be deleted.