9.3. mollom.sendFeedback


The Mollom XML-RPC API interface has been deprecated, and is included here for archival purposes.

To develop clients and services that connect to Mollom, use the Mollom REST API.

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:

  1. spam — Spam or unsolicited advertising.
  2. profanity — Obscene, violent or profane content.
  3. low-quality — Low-quality content or writing.
  4. 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.