When inserting new content element, scroll down to the end of "New content element" wizard and click on the "Commenting system":
This will insert a plugin for commenting system as a new content element. This operation has to be done twice: once for comment list, another for comment form. See next section for details on configuring the plugin.
All comments options can be configured either through TypoScript or through plugin's configuration when it is inserted as content element. TypoScript configuration should be used when plugin is inserted through TypoScript setup (for example, as "TypoScript object path" in TemplaVoila or as a part of flexible content element). For information on TypoScript configuration see "Configuration" section later in this manual.
Plugin configuration consists from several tabs.
Mode defines what the plugin displays: comment listing or form to add comments. Normally, the first instance on the page has "Comment listing", the second has "Comment form".
Triggering prefix defines what parameter in URL triggers displaying of comments. The value depends on another plugin and its paramters. Typically this parameter will be tx_extkey_pi1 but some older plugins have different values (for example, tx_ttnews for tt_news plugin). Special value pages allows to comment on pages instead of records. Note for plugin authors: read Configuration section on information about enabling comments for your extension!
Storage page specifies where records should be stored. If empty, current page is used.
Template file shows template file to be used. It can either a path related to web site root (like fileadmin/templates/comments.tmpl) or relative to extension (for example, EXT:comments/res/pi1_template). Click on the globe icon to select file interactively using TYPO3 file wizard.
Comments per page specifies how many comments per page will be shown.
Close commenting after allows to automatically disable commenting if record is older than specified time period. Time period is a number followed by suffix. Suffix can be h (hour), m (month), y (year) or d (day). Comments extension takes care to change page caching time so that page cache expires when comments should be closed.
Enable ratings enables ratings for comment items. This option is only available if “ratings” extension is installed. Notice that users may rate comments only if comments are not closed for the item. If comments are closed, users will see ratings but will not be able to rate comments further. The option to close comments must be set not only on form but also on listing plugin instance!
Show last comments first reverses sorting order for comment listing. Normally comments are display from first to last. Checking this option reverses the order and last comments are show first.
Require approval of each comment puts comments on hold and sends e-mail to the e-mail address in Send notification to this e-mail with comment information (submitted form fields) and links to approve, delete or kill (i.e. completely remove from database). Approving comment also clears cache for the page and approved comment appears on the page.
Check referer forces extension to check that request comes from the same web site. This option may have undesired results because many firewalls block referrer information and some browsers do not send this fields reliably. It is recommended not to use this option unless you are really paranoid.
Use captcha allows to select one of two captcha extensions (captcha or sr_freecap) to use while submitting comments. Corresponding extension must be installed. Comments extension has good spam catching capabilities, so you may wish to try without any captcha first (captchas usually annoy users very much).
Send notification to this e-mail specifies e-mail address where to send messages with links to approve or delete comments.
Send e-mail from this address contains "from" e-mail address for notifications about new comments.
Template file for e-mails contains template file for e-mails. See Template file on Basic tab for information on how to specify path to template.
If comment is set to disapproved state because it may be spam or Require approval of each comment option is set, comments will not be visible on the page. Administrator will receive e-mail with links to approve or delete comments. Alternatively it can be done through Web>List module. Disapproved comments have different icon in the List module:
The first item on the screenshot above is disapproved comment. When opened for editing, the following flag will define if comment is approved:
If check is set, comment is approved.
