QuipReply

Last updated Mar 6th, 2021 | Page history | Improve this page | Report an issue

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$306 per month—let's make that $500!

Learn more

The QuipReply Snippet¶

Displays a reply form for a given thread.

Usage¶

Place anywhere you would like a reply form for a thread.

[[!QuipReply? &thread=`myThread`]]

Not specifying a thread will make the QuipReply snippet look for the 'quip_thread' GET parameter. This is useful for threaded comments.

Available Properties¶

Name	Description	Default Value
requireAuth	If set to true, only logged in users will be able to comment on the thread.	0
closed	If set to 1, the thread will not accept new comments.	0
closeAfter	The number of days at which the thread will automatically close after it was created. Set to 0 to leave open indefinitely.	14
moderate	If set to true, all new posts to the thread will be moderated.	0
moderateAnonymousOnly	If set to 0, only anonymous (non-logged-in users) will be moderated.	0
moderateFirstPostOnly	If set to 0, only the first post of the user will be moderated. All subsequent posts will be auto-approved. This only applies to logged-in users.	1
moderators	A comma-separated list of moderator usernames for this thread.
moderatorGroup	Any Users in this User Group will have moderator access.	Administrator
dontModerateManagerUsers	Never moderate users logged into the manager.	1
dateFormat	The format of the date to show for a comment's post date. The syntax is in PHP strftime format.	%b %d, %Y at %I:%M %p
notifyEmails	A comma-separated list of email addresses to send a notification email to when a new post is made on this thread.
recaptcha	If true, will enable reCaptcha in the add comment form.	0
disableRecaptchaWhenLoggedIn	Disable reCaptcha validation for logged in users.	1
autoConvertLinks	If true, will automatically convert URLs to links.	1
useGravatar	Whether or not to show Gravatar icons in comments.	1
gravatarIcon	The type of Gravatar icon to use for a user without a Gravatar.	identicon
gravatarSize	The size in pixels of the Gravatar.	50
postAction	The name of the submit field to initiate a comment post.	quip-post
previewAction	The name of the submit field to preview a comment post.	quip-preview
tplAddComment	The add comment form. Can either be a chunk name or value. If set to a value, will override the chunk. See tplAddComment for the default form used. It lives on the filesystem: core/components/quip/elements/chunks/quipaddcomment.chunk.tpl
tplLoginToComment	The portion to show when the user is not logged in. Can either be a chunk name or value. If set to a value, will override the chunk. The default chunk lives on the filesystem: core/components/quip/elements/chunks/quipaddcomment.chunk.tpl
tplPreview	The preview view. Can either be a chunk name or value. If set to a value, will override the chunk.
idPrefix	If you want to use multiple Quip instances on a page, change this ID prefix.	qcom
requirePreview	If set to 1, will require a user to preview their comment before posting.	0

QuipReply Chunks¶

There are 3 chunks that are processed. Their corresponding parameters are:

tplAddComment - The Chunk to use for the add comment form.
tplLoginToComment - Will display when requireAuth is set to 1 and the user is not logged in.
tplPreview - The preview view for an about-to-be-posted comment.

Examples¶

Display a reply form for the thread 'myThread', with the moderators in the User Group 'Moderators':

[[!QuipReply? &thread=`myThread` &moderatorGroup=`Moderators`]]