=== Paxmod Content Moderation ===
Contributors: paxmod
Tags: comments, moderation, spam, content moderation, ai
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Moderate WordPress comments in real time with the Paxmod AI moderation API. Flag hate, harassment, sexual content, spam, PII and more.

== Description ==

Paxmod Content Moderation checks every new comment against your Paxmod project's policy in real time and routes flagged comments to review, spam, or trash based on your settings.

It runs alongside Akismet: Akismet handles spam, Paxmod handles toxicity, harassment, sexual content, self-harm, PII, and any custom policy you configure in the Paxmod console.

**Features**

* Real-time moderation of new comments via the Paxmod API.
* Choose what happens to flagged comments: hold for review (default), mark as spam, or move to trash.
* Skips previously-approved ("trusted") commenters to save API calls.
* Shows the flag reason and category in the WordPress comments list.
* Fails open: if Paxmod is unreachable, comments follow WordPress's normal rules, so moderation never breaks your site.

You control the categories, thresholds, and custom policy in the Paxmod console; the plugin simply applies them.

== External services ==

This plugin sends comment content to the Paxmod API (https://www.paxmod.com) for moderation. For each new comment being moderated, the comment text, the commenter's email (as an identifier), and the post ID are sent to `https://www.paxmod.com/api/v1/text` using the API key you provide. This happens only when moderation is enabled and a valid API key is set.

* Terms of Service: https://www.paxmod.com/terms-of-service
* Privacy Policy: https://www.paxmod.com/privacy-policy

By using this plugin you agree to Paxmod's terms and privacy policy.

== Installation ==

1. Upload the plugin to `/wp-content/plugins/` or install it through the Plugins screen.
2. Activate it through the "Plugins" screen in WordPress.
3. Go to Settings -> Paxmod and paste your Paxmod API key (get a free one at https://www.paxmod.com/signup).
4. Click "Test connection" to confirm the key works, then choose your flag action.

== Frequently Asked Questions ==

= Do I need a Paxmod account? =

Yes, a free Paxmod account and API key. There is a free tier with no credit card.

= What happens if Paxmod is down? =

The plugin fails open: comments follow WordPress's normal rules, so your comment flow never breaks.

= Does it replace Akismet? =

No. Akismet handles spam; Paxmod handles toxicity, harassment, and custom policy. They complement each other, and Paxmod runs after Akismet.

= Where do I set which categories to block? =

In the Paxmod console. The plugin applies your project's categories, thresholds, and custom policy.

== Changelog ==

= 0.1.0 =
* Initial release: real-time comment moderation via the Paxmod API, configurable flag action, trusted-commenter skip, reason column, fail-open behavior.
