9.3. mollom.sendFeedback
mollom.sendFeedback |
|||
| Required | Name | Type | Description |
| required | public_key |
string | Site public key |
| required | time |
string | Site server time in this format: yyyy-MM-dd'T'HH:mm:ss-.SSSZ |
| required | hash |
string | HMAC-SHA1 digest |
| required | nonce |
string | One time nonce |
| required | session_id |
string | Session ID associated with the feedback |
| required | feedback |
string | Feedback: "spam", "profanity", "low-quality" or "unwanted" |
| returns | boolean | Always returns "true" |
|
The mollom.sendFeedback call can be used to provide feedback to Mollom. It tells Mollom that the specified message was spam or otherwise inappropriate for the reporting website.
This mechanism allows Mollom to learn from its mistakes. For example, if a spam message was erroneously classified as ham, Mollom will use that information to fine-tune its spam detection mechanisms. The more feedback provided to Mollom, the more effective it becomes. If possible, this feedback mechanism should be built into all Mollom applications.
Mollom will not blindly trust mollom.sendFeedback requests. It has a built-in reputation-management system that separates valid mollom.sendFeedback requests from invalid mollom.sendFeedback requests. Developers should be careful when testing this functionality. It might negatively affect the reputation associated with a particular set of credentials. See Section 10 for more information about testing your Mollom client.
The remote procedure call mollom.sendFeedback takes the parameters required for authentication, the session ID of the message that is being reported on, plus the actual feedback being provided.
There are four possible string values for feedback:
spam— Spam or unsolicited advertising.profanity— Obscene, violent or profane content.low-quality— Low-quality content or writing.unwanted— Unwanted, flaming, trolling or off-topic content.
These options not only help Mollom to learn spam patterns, but also get metrics on obscene and poor-quality content. This is used for improving the assessment of the quality score returned by mollom.checkContent.
The method mollom.sendFeedback always returns the Boolean value "true" if the function call succeeded. If not, an XML-RPC error is returned.
