Solid Wall of Code: MT::XMLRPC::getCommentRange

Method mt.getCommentRange
Arguments

user

A user name for an author associated with the weblog.

password

The password for the author

terms

The search terms for locating the range of comments. The available terms are

blogid: The ID of weblog to search for commments.
postid: The ID of the post to search for comments.
visible: Whether the post is visible. The value should be either ‘0’ (not visible) or ‘1’ (visible). If no author is specified, this term is forced to ‘1’ so that only visible comments are available anonymously.
count: The maximum number of posts in the range.
before: Include only comments that were created before the time specified.
after: Include only comments that were created after the time specified.
reverse: If count is specified, then the posts are counted from latest to earliest. If this term is specified and true then the posts are counted in the reverse direction.

fields

The fields to return.

commentid: The ID of the comment.
postid: The ID of the post to which the comment is attached.
blogid: The ID of the weblog in which the post appears. By request only.
dateCreated: Timestamp of when the comment was created.
text: The text of the comment.
text_length: The length of the text in the post. By request only.
visible: The visibility of the comment.
author: The author of the comment.
email: The e-mail address of the author.
url: The URL for the home page of the author.
ip: The IP address of the machine from which the comment was posted.

If no fields are supplied, then all fields not marked “by request only” are returned.

If the name and password are specified as empty strings then the call still succeeds. Currently, although the name and password (if not blank) are verified, no permissions checks are done because comments are always public. The arguments are present mainly for forwards compatibility in case it becomes necessary to check permissions in the future (most likely because a flag is added to the MT config file to control whether authorization is required to use this method).