Before installation

Download

In MODX manager use Package Management to download package from repository (search "modxTalks") and install it.

Source code can be found on github.com

Set modxTalks on your site

You can set modxTalks on your site in 2 ways.

Create resource with comments

To create resource with comments - right click on resouce in the resource tree and then "Create":

After resource creation you will have this tab - Comments and icon before resource title which means that comments have been installed. Open resently created resouce in front-end and you'll see form for adding comments right after content field.

Insert snippet in any place in your site

You can call modxTalks in any place you like

[[!modxTalks]]

Be asured that snippet call is uncached

Basic Settings

modxTalks settings can be found in System Settings, in "modxtalks" folder.

All hints are described in comments for each setting.

Set modxTalks in the resource

After resource with comments creation you'll have tab with comments settings

1

number of unapproved comments for the resource

2

number of deleted comments for the resource

3

general number of comments for the resource

4

max number of comments on the page for listing (pagination)

5

moderator group comma separated, which can moderate comments

6

template for comments output. Leave blank for defaults

7

template for output deleted comments. Leave blank for defaults

8

template for output editable comments. Leave blank for defaults

9

template for output authourization of comments. Leave blank for defaults

Call modxTalks as a snippet

You can make modxTalks call as a simple snippet call in any place you like [[!modxTalks]]

Basic parameters for snippet call:

To display the latest comments on your site. sufficient to establish the call Snippets [[!modxTalksLatestComments]]

Parameters snippet // Parameters snippet modxTalksLatestComments

Connection example scripts // on the page with the call of the latest comments

<script src="[[++assets_url]]components/modxtalks/js/web/lib/jquery-1.9.min.js" type="text/javascript"></script>
<script src="[[++assets_url]]components/modxtalks/js/web/lib/timeago.js" type="text/javascript"></script>
<script src="[[++assets_url]]components/modxtalks/js/web/lib/timeago/en.js" type="text/javascript"></script>

You can make your own template, examples of available templates can be found on github.com or in chunks/ folder in modxTalks installment: core/ components/modxtalks/elements/chunks

commentTpl // Comment row template

deletedCommentTpl // Template for deleted comment row

commentAddFormTpl // Template for form for comment adding

commentEditFormTpl // Template for form edit of the comment

comment_auth_tpl // Authorization form template

Output template for anonimous users. You can create link to the authorizaiton page or authorization form.

mt_send_mail // Letter and notification template

You can change design or its elements as you want

comment_latest // Template for a separate comment block.

Template separate comment for the block. Maybe chunk name. If the set value, it will replace the original template.

comments_latest_out // Shell pattern for blog comments.

Shell pattern for the block comment. Maybe chunk name. If the set value, it will replace the original template.

Parameters

Event OnModxTalksCommentAfterAdd there is a call for adding a comment.

Probably one wonders on the withdrawal in the news for example, the number of comments on the resource.

Let's consider an example of the output of the resource through getPage or getResources. Open your Chunk O resource and fix it in place display of comment tag {%mtr_[[+id]]%}

Example chunk

For example chunk getResources.

... ...
<div class="comments"><i class="icon-eye-open">comments {%mtr_[[+id]]%}</i></div>
... ...

If you call a snippet comments and have your own structure binding to the resource, the call shall consist of such-like the name you put in, or formed in the snippet call.

Calling a tag in this case is the following: {%mtc_myBlog-2%} - myBlog-2, this is the very name conversation