JoCo (Jot Comments tool)
Last version : Module:
0.9.2 , Snippet:
0.9.1.4On : 2009/01/21
I re-wrote and upgraded JoCo. In new version
- You can moderate your comments
- You can moderate comments from your last login
- You can moderate comments of documents which you have created or published or edited
- Search in comments by string and highlighting, by webgroups, users, guests, docgroups, documents, between two dates and etc
- All important elements need permissions to see and managers can set permission, add or remove a user and etc
- There is summary part for see list of documents which have comments, subscriptions, last comment date and ...
- JoCo users do not see comments in documents that they have not enough permissions to access them
- Another view added for manage more comments in a page
- Manage and modify all Jot calls in TVs, Chunks and document Content (in module). NEW in 0.9.2
- And... .
By JoCo snippet you have module in a frontend page, you can set trusted webusers to access to this page and moderate comments. There are some parameters to set permissions for each webuser and set a certain permission for all webusers for example no webuser can edit a comment or access to permission part and ....
To see snippet parameters see snippets codes.
Put JoCo snippet call in a documents with
BLANK template.
Also you can see logs of webusers actions in JoCo module
other descriptions,
Hint :
- JoCo gets value of jot custom fields ONLY from "jot_fields" table. if it find a custom field, search the language file for a string which it's KEY is the custom field label and prints the value of language variables else prints the label of field. you can see some default custom fields below:
$JoCo_lang['name'] = "Name";
$JoCo_lang['email'] = "Email";
$JoCo_lang['website'] = "Website";
$JoCo_lang['title'] = "Subject";
so you can add yours easily; for example if you have set userGender custom field in Jot, you can add variable below and see "Gender" instead "userGender":
$JoCo_lang['userGender'] = "Gender";
all found custom fields prints automatically.
- JoCo codes are clear but there is another way to custimize output without modify modules codes directly:
There is customactions.php in joco/inculdes folder. you can add your custom codes in this file to modify output. it is useful for set some data that needs to more codes for example insering FULL NAME of comment owner or update another table on delete a comment and etc.
It contains 5 functions that each one runs in a LOOP:
*
onBeforeSetOutputRow($row,$tpl) : It runs after comments data collected from "jot_content" and "jot_fields" tables. $row is comment data which is an associative array, KEY is column name and VALUE is column value from "jot_content". $row['label] is another associative array, KEY is "label" column and VALUE is "content" column value from "jot_fields". This function MUST return an array with 2 items, first is associative array that is merged to $row (VALUE of $row['customKey'] is replaced with [+customKey+] in indv.tpl.html) and second is new row tpl which is replaced with current tpl.
*
onBeforeCheckRow($row) : It runs right before parse comment output and decides to accept (and parse) comment or reject comment. If it returns TRUE comment data will parse and if it returns FALSE current comment will reject.
functions below run right before UPDATE database and return void :
*
onBeforePublish($comment_id) *
onBeforeUnpublish($comment_id) *
onBeforeDelete($comment_id) *
onBeforeEdit($comment_id)*
JoCo is NOT compatible with Internet Explorer YET - Module works in IE7 - but problems still exit and i need your help to fix it!
--------------------------------------
2008/11/16 :
0.8, German language file added.
2008/11/17 :
0.8.1, Some PHP errors solved; date() function replaced with strftime().
2008/11/21 :
0.8.5, Some styles added to module and a bug fixed.
2009/01/01 :
0.9, Rewrote, fix bugs and add new features + snippet.
2009/01/15 :
0.9.1, Fix PHP4 compatibility and add new event.
2009/01/21 :
0.9.1.3, Fix
this error, add possibility to search by webusers, use FURL in snippet (need testing) and... .
2009/03/30 :
- Module: 0.9.2, <BR> problem and URL hacking solved. Jot Call feature added.
- Snippet: 0.9.1.4, <BR> problem and URL hacking solved.
Goodluck
