What is Quip?
Quip is a simple commenting Snippet for MODx Revolution. It allows you to quickly and easily put up comments on your website, including threaded support, moderation, url to link conversion, automatic thread closing, and more. It also allows for full comment management via the backend system in the Revolution manager.
- MODx Revolution 2.0.0-RC-2 or later
- PHP5 or later
Quip was written by Shaun McCormick as a simple commenting component, and first released on May 7th, 2009.
API Documentation for Quip can also be found here: http://api.modx.com/quip/
Quip has 2 modes, threaded and non-threaded comments.
The Quip snippet can be called like so in the page you want comments to display:
[[!Quip? &thread=`threadNameHere` &threading=`0`]] <br /> [[!QuipReply? &thread=`threadNameHere`]]
If you have threading turned on, you'll need to first do a couple things. One is to add a "Reply to Thread" page with these snippet calls:
<h2>Reply to Thread</h2> [[!Quip]] <br /> [[!QuipReply]]
And then you'll need to add the 'replyResourceId' property to your original Quip snippet call in your page where the comments will load (such as a blog post), so it will look like this with a Resource of ID 123:
[[!Quip? &thread=`threadNameHere` &replyResourceId=`123`]] <br /> [[!QuipReply? &thread=`threadNameHere`]]
Also, Quip provides users with an assistance snippet called QuipCount, which can be used to find thread comment totals or user comment totals.
Quip comes with 4 separate snippets:
- Quip - Displays comments for a thread.
- QuipReply - Displays the reply form for a thread.
- QuipCount - Returns the number of comments on a thread.
- QuipLatestComments - Displays a list of the latest comments for all threads, a user, or specific thread.
Quip comes pre-packaged with some site-wide settings as well.
|quip.emailsFrom||The email address to send system and moderation emails from.|
|quip.emailsTo||The email address to send system and moderation emails to.|
|quip.emailsReplyTo||The email address to set the reply-to to. Defaults to emailFrom.|
|quip.allowedTags||The tags allowed by users in comment posting. See php.net/strip_tags for a list of acceptable values.|
Also, there are 3 settings for reCaptcha support, in the recaptcha namespace:
|recaptcha.public_key||Your public key for reCaptcha.|
|recaptcha.private_key||Your private key for reCaptcha.|
|recaptcha.use_ssl||If true, will use SSL for reCaptcha connectivity.|
A sample code line for a blog post that's on a Resource with no threading:
[[Quip? &thread=`blogpost[[*id]]` &threading=`0`]]
Display comments for thread `post45`, but only allow logged-in users to comment, and have the "Reply to Thread" resource be ID 123:
[[!Quip? &thread=`post45` &replyResourceId=`123`]] <br /> [[!QuipReply? &thread=`post45` &requireAuth=`1`]]
Display comments for thread `spamproof123`, with no threading, with reCaptcha support.
[[!Quip? &thread=`spamproof123` &threaded=`0`]] <br /> [[!QuipReply? &thread=`spamproof123` &recaptcha=`1`]]