Development:Comments 2.0: Difference between revisions
mNo edit summary |
|||
Line 112: | Line 112: | ||
Can be found in lib/comment.js | Can be found in lib/comment.js | ||
=== | ===post_cmt(client_id)=== | ||
Submit a comment | Submit a comment | ||
=== | ===display_cmt(event, contextid, comment_area, itemid, page, client_id)=== | ||
Display comments, will call get_cmt to load comments. | Display comments, will call get_cmt to load comments. | ||
Line 125: | Line 125: | ||
===Permission control=== | ===Permission control=== | ||
Modules can implement a function named ''' | Modules can implement a function named '''modname_comment_permissions''' to control post and view permission. | ||
This function will return an array: array('post'=>true, 'view'=>true) | This function will return an array: array('post'=>true, 'view'=>true) | ||
Line 132: | Line 132: | ||
=== Filter/format comments === | === Filter/format comments === | ||
Modules can implement a function named ''' | Modules can implement a function named '''modname_comment_display''', which allow modules check/format comments when user request to display comments. | ||
=== Define a comment template === | === Define a comment template === |
Revision as of 06:37, 10 July 2009
Objectives
The goals of comments 2.0:
- Manage comments centrally
- Use a consistent approach for all comments throughout Moodle
- Easily integrate comments 2.0 with existing modules
Overview
The comments 2.0 provides APIs to:
- Add comments
- Update comments
And provides an ajax interface to allow adding comments on a floating DIV.
Comments database table
Field | Type | Default | Info |
---|---|---|---|
id | int(10) | auto-incrementing | The unique ID for this comment. |
userid | int(10) | who wrote this comment | |
contextid | int(10) | The context id defined in context table - identifies the instance of plugin owning the comment. | |
itemid | int(10) | Some plugin specific item id (eg. forum post, blog entry or assignment submission) | |
commentarea | int(10) | for example, in user profile, you can comment user's description or interests, but they share the same itemid(==userid), we need comment_area to separate them | |
timecreated | int(10) | ||
timemodified | int(10) | ||
content | text | content of comment |
Comments API
lib/weblib.php
Add an option to format_text function
Using this format_text function will add a comment icon automatically at the end of the text:
For example, using the following code in the forum module will add a comment icon to every post:
$cmt = new stdclass;
$cmt->contextid = $modcontext->id;
$cmt->area = 'format_post';
$cmt->itemid = $post->id;
$options->comments = $cmt;
echo format_text($post->message, $post->messageformat, $options, $course->id)."
";
lib/commentlib.php
class comment()
__construct($contextid, $comment_area, $itemid))
Initialize class members
js()
Print Javascript required by commenting API, this is a static function, which must be called before html head printed</head>
init($return = false)
Will print the html snippet for commenting UI, will be called inside format_text
print_comments($params = array())
print comments
add($content)
Add comment to database
delete($id)
delete a comment
edit($id, $content)
Edit a comment
Javascript API
Can be found in lib/comment.js
post_cmt(client_id)
Submit a comment
display_cmt(event, contextid, comment_area, itemid, page, client_id)
Display comments, will call get_cmt to load comments.
get_cmt(ctx, area, itemid, page, client_id)
Load comments by AJAX
Moodle modules callback
Comments API needs to allow modules controlling comments
Permission control
Modules can implement a function named modname_comment_permissions to control post and view permission. This function will return an array: array('post'=>true, 'view'=>true)
Check new added/edited comment
Modules can implement a function named modname_comment_add, comments API will pass the comment to this function which allow modules check/modify comments content, or reject this comment.
Filter/format comments
Modules can implement a function named modname_comment_display, which allow modules check/format comments when user request to display comments.
Define a comment template
Modules can implement a function named modname_comment_template, which allow modules define a comment template. The template must have 4 embedding variables, ___id___, ___content___, ___time___, ___name___, they will be replaced with html id, comments content, comment time and commenter name
Interface
Popup UI
Inline UI
See also
- MDL-19118 - Comments 2.0 issue