PageComment3

Documentation

Here is the documentation from the source code (with my little additions).

Usage: [[PageComment3]]



Features:



    - Simple usage, just put [[PageComment3]] on any page.

    - Lets anonymous users post a new comment with an input form.

    - Shows a list of the posted comments.

    - Show a captcha from recaptcha to avoid spamming.

    - (removed this option) Support for comment deletion by given password, admin and users can still delete.

    - Support for administrative action, e.g.,

        - to delete a comment without entering a given password



RECAPTCHA_PUB_KEY and RECAPTCHA_PRIV_KEY must be defined in the global Wiki-configuration.



Parameters:



    - pagename: the page name which the comments are retrieved for. by default the page itself.

        If the user has no 'read' ACL for that page, it does not allow to insert/view comments.

        e.g., pagename=AnotherPage



    - section: the section name of the page. The comments in different sections are managed in separated sub pages.

        Section name should be alphanumeric format ([a-zA-Z0-9] in regular expression).

        If not, all the non-alphanumric characters are removed.

        e.g., section=1, section=News, section=Opinion



    - inputonly: shows input form only. list of the comments are shown to admin users only.

        - inputonly=0; default, all list is shown to all users including anonymous users

        - inputonly=1; shown to admin users only (who has the page delete privilege)



    - commentonly: shows the list of comments only.

        - commentonly=0; default, both of the list and input form will be shown

        - commentonly=1; only the list of comments will be shown



    - countonly: returns the number of the comments posted to this page

        - countonly=0; default, normal form (input form; list of comments)

        - countonly=1; just return the number of comments.

            e.g., 'There are [[PageComments(countonly=1)]] comments here'



    - rows: the # of rows of the textarea. default 4. e.g., rows=4



    - cols: the # of columns of the textarea. default 60. e.g., cols=60



    - maxlength: limitation on # of characters for comment text. default 0 (no limit). e.g., maxlength=500



    - newerfirst: order of the list of comments.

        - newerfirst=0: default, newer ones are listed at the end

        - newerfirst=1: newer ones are listed at the top



    - commentfirst: shows comment list before the input form.

        - commentfirst=0: default, the input form first

        - commentfirst=1: comment list first



    - articleview: shows comment list in an article view.

        - articleview=0: default, list in table view

        - articleview=1: list in article view



    - tablewidth: the width of the table format for PageComment3, default '' (none).

        e.g., tablewidth=600, tablewidth=100%



    - smileylist: shows smiley options with drop-down list box

        - smileylist=0: default, a part of the smiley in radio button

        - smileylist=1: smiley in drop-down list box



    - nosmiley: shows no smiley

        - nosmiley=0: default, shows smiley selection

        - nosmiley=1: no smiley selection



    - notify: notifies to the subscribers of the page which includes the macro when a comment is added

        - notify=0: default, notification disabled

        - notify=1: notification enabled



    - markup: enables wiki markup in the comment text except some specified macros.

        - markup=0: default, use of wiki markup in the text is disabled

        - markup=1: use of wiki markup in the text is enabled and preview button is activated



- captcha: enables the captcha and anonymous comments

    - captcha=0: Switch off anonymous posts and captcha

    - captcha=1: Allow anonymous posts and display captcha if not authenticated

Code

• My code (for MoinMoin 1.5) is here: PageComment3.py.

• Wenglian's code is here: PageComment3_18.py