My favorites | Sign in
Project Home Wiki Issues Source
Search
for
GhoCommentTools  
Some tools for a better commenting experience in TXP
Updated Oct 11, 2010 by pkollitsch

ATTENTION: I am restructuring the documentation. Entries containing this message are not reviewed yet and can contain errors or links that end up in nirvana.

gho_comment_tools

Note

This Plugin combines the earlier published plugin gho_comments_invite with newer tools for better commenting in Textpattern. You need to disable and delete all previous installed gho_comment-plugins prior ro installing this one to get the tags running.

Known problems

Right now it can happen, that antispam plugins are executed AFTER gho_commabo sent out the comment email. This happens e.g. with a plugin called nko_antispam and has its reason in the alphabetical sorting of the plugins prior to their execution. This problem will be fixed with the new release of TXP 4.0.7 where gho_commabo will be set to a very late execution time.

Usage

gho_commabo_checkbox

  • enhances the comment form with a checkbox
    • wraptag (default "span")
    • class (default "ghocommabo")
    • labelclass (default "ghocommabolabel")
    • prefix (default empty)
    • suffix (default empty)
    • subphrase (default "Kommentare abonnieren")
    • unsubphrase (default " Abonnement abbestellen")
    • The Plugin creates (if not yet done) a table called txp_commabo in your database. Please do not delete this table, it contains all data needed for the plugin to work. The DB-user of the Textpattern installation needs to have rights to create this table to get this working.
    • The plugin creates a form gho_commabo which is the template for the email that will be sent to the users subscribed to the entries. All article-related tags should be able to be parsed in this form (someone really should test this and tell me if I am right.

gho_commabo_unsubscribe

  • prints the URL needed to delete the abo of the receipient. for use in the mailtemplate (gho_commabo).

gho_comments_invite

  • showcount - show the count of existing comments before the invitation (yes|no)? default is set to yes.
  • wraptag - like in other tags. default is empty (inline).
  • class - the comment-invite is wrapped in a span. what classname should this span (not the wraptag, which is around the span) have? default is ?comm-invite?
  • zero - if the article has zero comments, what should the invitation state? default is the comment-invitation given in the articleform. if this value is set, it will override the comment-invitation of the article. (remember to set spaces in front of the string if you want a space between the count and the invitation)
  • one - if the article has one comments, what should the invitation state? default is " comment". (remember to set spaces in front of the string if you want a space between the count and the invitation)
  • more - if the article has more than one comments, what should the invitation state? default is " comments". (remember to set spaces in front of the string if you want a space between the count and the invitation)
  • nocomment - if the article has comments disabled, what should the invitation state? default is the comment-invitation given in the articleform. if this value is set, it will override the comment-invitation of the article. if it should state nothing, it has to be set but empty.
  • format - per default gho_comments_invite prints a link to the entry. if you only want a text to appear set format to "text".
  • popup - if popup is set to 1 the link will open a popup instead of loading the commentpage in the actual tab.

gho_last_commentator

(shows a line like "(last comented by brian)")

  • separator - what text should separate the commentators (if there are more than one to be shown). default is ", ".
  • limit - how many commentators should maximal be shwon. defaults is 1.
  • linknames - set to true if you want the names linked to the comments they gave. defaults to false. please note that the link to the comment is realized via the anchor c000000 where 000000 is the commentnumber. there has to be a id defined within the comment-form which is named like said. the anchor has to lead somewhere. if you dont know how to insert the comment-id, maybe this plugin will help.
  • pretext - which text should be put before the commentators list? defaults to "(last commented by ".
  • posttext - which text should be put after the commentators list? defaults to ")".
  • wraptag - like in other tags. default is empty (inline).

gho_comment_num

give back a comment-counter if you don't use the 'Present comments as a numbered list"-setting of TXP

Download

History

2008-06-02 2008.2

  • first release of gho_comment_tools including gho_comment_abo and gho_comments_invite
  • documentation of the features
  • added label-tag, prefix, suffix and labelclass to gho_commabo_checkbox

2008-04-27 gho_comment_abo 2008.1

  • first public release
  • tag gho_commabo_unsubscribe
  • commentator does not get a mail of his own (following) comments
  • solved: mailform had no type, not editable
2008-04-19 gho_comment_abo v0.2c
  • another bug that put the last subscriber into the database
2008-04-17 gho_comment_abo v0.2b
  • rework, nasty bugs and features that were breakers
  • added a cashhash to the unsublink (no really need for this but it broke debugging)
2008-04-12 gho_comment_abo v0.1
  • checkbox for subscribing /unsubscribing to articles comments
  • inserting subscriber and sending mail on new comments
  • creating form with notificationmail
2007-06-22 gho_comment_invites v.2007.1
  • re-release (revised for Textpattern 4.0.4)

2006-05-26 gho_comment_invites v.2006.2

  • better documentation
  • gho_commentnum gives back a counter for your comments, if you don't use the "Present comments as a numbered list?"-setting of TXP

2006-01-11 gho_comment_invites v.2006.1

  • re-release (revised for Textpattern 4.0.3)
  • new documentation
  • attribute format for the gho_comments_invite-tag
  • attribute popup for the gho_comments_invite-tag

2005-08-16 gho_comment_invites v.4.0

  • revised for TXP4.0
  • messed up documentation fixed

2005-08-14 gho_comment_invites v.1.0

  • revised for TXP1.0

2005-05-03 gho_comment_invites v.0.4

  • linknames-attribut for gho_last_commentator (name of the commentator will be linked to his comment)

2005-05-02 gho_comment_invites v.0.3

  • new tag gho_last_commentator for the name(s) of the last commentators

2005-04-22 gho_comment_invites v.0.2

  • bugfix for the zero-text
  • bugfix: wraptag is applied to the nocomment-invitation
  • bugfix/feature (?): if comments disabled and there are yet comments the nocomment-text will be linked to the comments
  • feature: changes in the handling of the nocomment-attribute
  • feature: class-attribute

2005-04-21 gho_comment_invites v.0.1

  • initial version


Sign in to add a comment
Powered by Google Project Hosting