9.10. mollom.addBlacklistText
mollom.addBlacklistText |
|||
| 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 | text |
string | Up to 100 characters of text to be blacklisted on your site, in lowercase, with all leading and trailing spaces trimmed |
| required | context |
string | The information to search for the text, either "everything" for the entire post, "links" for link URLs and link titles only or "author" for all author related information |
| required | reason |
string | One of the following reasons the text is blacklisted: "spam", "profanity", "low-quality", "unwanted" |
| optional | match |
string | One of the following ways to match the blacklisted text: "exact", "contains". The default value is "contains". |
| returns | boolean | Always returns "true" |
|
Mollom automatically maintains whitelists and blacklists based on statistical analysis, reputation models and feedback sent by users. However, as a Mollom end-user, you may provide custom text blacklists using the Mollom Blacklist API. Mollom will store the blacklisted text on the server-side, and use the lists in mollom.checkContent() calls.
The mollom.addBlacklistText call provides a way to add text to your site's custom blacklist. Note that the text can contain spaces, so entire phrases (up to 100 characters for each call) can be added to your custom blacklist.
