Login / Status
developer.Resource
Home . Documentation . Document Library . Extension Manuals
Sponsors
hosted by punkt.deTYPO3 and Open Source MagazineMittwald

Chapter 1. Commenting system

Extension Key: comments

Copyright 2000-2002, Dmitry Dulepov, <dmitry@typo3.org>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.com

1.1. Introduction

What does it do?

This extension provides commenting capabilities to TYPO3 pages or to virtually any TYPO3 record available in frontend in a single view (like single news item, single album image, etc).

This extension may replace ve_guestbook extension in timtab or as commenting system for tt_news. Separate extension is available to import all ve_guestbook comments to comments.

Features

Extension has the following features:

  1. Comment pages

  2. Comment records

  3. Comments are displayed in pages

  4. Highly customizable template, for example:

    1. Number of messages per page

    2. Show/hide fields to comments

  5. Available fields (labels can be customized):

    1. First name

    2. Last name

    3. E-mail

    4. Home page

    5. Location (city, for example)

    6. Comment

  6. Set fields as required or optional

  7. E-mail address syntax validation

  8. Fully localizable (including date format through PHP strtoftime() function)

  9. Automatically clear cache for any page(s) when comment is added

  10. Close comments after predefined period

  11. Close comments for individual records immediately or after period (through supplemental comments_ic extension)

  12. Prevent duplicate comments (for example, several subsequent POST requests)

  13. See IP address of the commenter in BE

  14. Import messages from ve_guestbook (* will be available soon!)

  15. Spam control

    1. Filter out typical guestbook spam

    2. Force all messages to pass approval

    3. Automatically decide if message should be approved before it can appear on the web page

    4. Send e-mail to designated e-mail address about suspicious messages

    5. Hook to connect external spam checkers

  16. Full TYPO3 caching supported (USER object!), which highly improves web site performance

  17. Automatic cleanup: removes comments if "parent" record is removed

  18. External CSS stylesheet can be included through the template (no need to modify web site TS setup for this!)

  19. Automatically use FE user data to fill comment form

  20. Extends tt_news to show number of comments in LIST, SEARCH and LATEST views

  21. Integrates ratings from “ratings” extension

  22. Automatically find links in comment text and convert them to clickable links (can be turned on and off)

  23. Lots of hooks to customize comments

Screenshots

There are screenshots also in other sections of this manual. This screenshot shows default template with default styles with ratings enabled. Default template has many CSS classes, which allows very customizable styling.

Acknowledgments

Creation of this extension was sponsored by Netcreators BV – an international TYPO3 company from Netherlands. Special thanks go to ben van 't ende for his continuous supports, reviews and advice during development process.

While developing this extension, XMIND 2008 software was used for collecting ideas and making development plan. Thanks to Mango Software for their exceptional mind mapping product.

Having questions?

Author kindly asks to post all questions to the "English" TYPO3 mailing list. Please, avoid sending e-mails directly to author.