=== Vigil-CMCC — Content Moderation Command Center ===
Contributors: nikhilranka
Tags: moderation, content moderation, spam detection, AI moderation, spam firewall, queue management, analytics, activity log, webhooks, collaboration
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.1.2
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.txt

A comprehensive content moderation plugin for WordPress with AI-powered spam detection, queue management, analytics, collaboration, and multi-platform support.

== Description ==

Vigil-CMCC (Content Moderation Command Center) provides a unified, powerful moderation system for WordPress that goes far beyond built-in comment moderation. Built for site administrators, editorial teams, and community managers, Vigil-CMCC centralizes every aspect of content review into a single, intuitive interface.

= Key Features =

* **Unified Moderation Queue** – Review, approve, reject, or mark items as spam from a single interface. No more jumping between screens.
* **Spam Firewall** – Configurable rules including link limits, keyword blacklists, duplicate detection, and more to automatically block unwanted content.
* **AI-Powered Moderation** – Integrated with OpenRouter API for automated content classification, spam detection, sentiment analysis, and language detection.
* **Real-time Analytics** – Queue statistics, spam ratios, content type breakdowns, and activity heatmaps to understand moderation patterns at a glance.
* **Activity Log** – Full audit trail of all moderation actions for accountability and compliance.
* **Bulk Actions** – Approve, reject, or export multiple items at once to accelerate your workflow.
* **10 Settings Tabs** – General, Spam Firewall, Notifications, Appearance & Display, Integrations, Advanced Auto Moderation, Moderator Management, Data Retention, API & Webhooks, and Backup & Restore.
* **Multi-Platform Support** – Extensible architecture supporting WordPress, Shopify, Storyblok, Strapi, and Wix.
* **Webhooks** – Real-time notifications for new items, approvals, and spam detection to integrate with your existing tools.
* **Collaboration** – Internal notes, item assignment, activity feed, and history timeline for team-based moderation workflows.

= AI Moderation =

Leverage the OpenRouter API to automatically classify content, detect spam with high accuracy, analyze sentiment, and detect languages. AI rules work alongside your existing spam firewall to reduce manual review workload.

= Multi-Platform Ready =

While built for WordPress, Vigil-CMCC's architecture is extensible across multiple platforms including Shopify, Storyblok, Strapi, and Wix — making it an ideal choice for organizations managing content across a diverse tech stack.

= Webhook Integrations =

Send real-time notifications to Slack, Discord, or any custom endpoint when new items arrive in the queue, when content is approved or rejected, and when spam is detected.

== Installation ==

1. Upload the `vigil-cmcc-content-moderation-command-center` folder to the `/wp-content/plugins/` directory, or install directly via the WordPress plugin repository.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Go to **Vigil-CMCC** in your WordPress admin menu to configure settings.
4. Navigate to the **General** settings tab to connect your OpenRouter API key (optional, for AI-powered features).
5. Configure the Spam Firewall rules, notification preferences, and moderator permissions to match your workflow.

= Minimum Requirements =

* WordPress 5.8 or later
* PHP 8.0 or later

= Recommended =

* WordPress 6.7 or later
* PHP 8.1+
* OpenRouter API key (for AI moderation features)

== Frequently Asked Questions ==

= Do I need an API key for AI moderation? =

AI-powered features require an OpenRouter API key, which you can configure in the **Integrations** settings tab. All other features — including the spam firewall, queue management, analytics, and collaboration — work without any external API.

= Does Vigil-CMCC replace WordPress comment moderation? =

Vigil-CMCC enhances and centralizes it. The plugin integrates with existing WordPress comment data and adds support for custom post types, user registrations, and other content sources. You can continue using native WordPress moderation tools alongside Vigil-CMCC.

= Can I assign items to specific moderators? =

Yes. Vigil-CMCC includes a full collaboration system that lets you assign items to individual moderators, add internal notes, and track the full history of every item through the activity log.

= Does Vigil-CMCC support multi-site WordPress networks? =

Yes. Vigil-CMCC is built with network-level compatibility in mind, allowing you to manage moderation across your entire multisite network from a central location.

= Can I export moderation data? =

Yes. The bulk actions interface supports exporting selected items, and the Analytics tab provides data export options for reporting and compliance purposes.

= What happens to my data if I deactivate the plugin? =

Vigil-CMCC respects your Data Retention settings. When deactivated, no data is automatically deleted. You can use the **Data Retention** settings tab to configure automatic cleanup schedules, or manually purge data from the **Backup & Restore** tab.

== Screenshots ==

1. Unified Moderation Queue — review all pending content in one place.
2. Spam Firewall configuration — set rules for automated blocking and AI filtering.
3. Analytics Dashboard — real-time queue stats, spam ratios, and activity heatmaps.
4. Activity Log — complete audit trail of all moderation actions.
5. Reports & Compliance — automated reporting and regulatory compliance tools.

== Changelog ==

= 1.1.2 =
* Improved AI moderation response parsing and error handling.
* Fixed display issues on the Analytics dashboard for high-volume queues.
* Enhanced performance of the unified moderation queue for large datasets.
* Updated translation strings and added new language packs.
* Minor UI refinements across settings tabs.

= 1.1.1 =
* Fixed compatibility with WordPress 6.7.
* Resolved edge case in spam firewall duplicate detection.
* Improved webhook delivery reliability with retry logic.
* Added additional filtering options to the activity log.

= 1.1.0 =
* Introduced AI-Powered Moderation with OpenRouter API integration.
* Added Real-time Analytics dashboard with activity heatmaps.
* Launched Collaboration features: notes, assignments, and activity timeline.
* Implemented Webhooks for external service notifications.
* Expanded to 10 settings tabs with Backup & Restore functionality.
* Added multi-platform extensibility architecture.
* Performance optimizations across the entire plugin.

= 1.0.0 =
* Initial release with unified moderation queue.
* Spam Firewall with configurable rules.
* Bulk actions for approve, reject, and export.
* Activity Log for full audit trail.
* Basic analytics and reporting.
* WordPress multisite support.

== External Services ==

This plugin connects to third-party AI services to provide automated content moderation and spam detection. The following external services are used:

### OpenRouter AI
- **Service:** [OpenRouter](https://openrouter.ai/) provides access to various AI models for content classification.
- **Data sent:** Content text, system prompt, and model parameters are sent to OpenRouter's API endpoint (`https://openrouter.ai/api/v1/chat/completions`) when AI moderation is triggered (e.g., when new content enters the moderation queue and AI rules are enabled).
- **Purpose:** To classify content as spam, toxic, phishing, hate speech, or safe; to detect language; and to analyze sentiment.
- **Terms of Service:** [https://openrouter.ai/terms](https://openrouter.ai/terms)
- **Privacy Policy:** [https://openrouter.ai/privacy](https://openrouter.ai/privacy)

### OpenAI
- **Service:** [OpenAI](https://openai.com/) provides GPT-based AI models for content classification.
- **Data sent:** Content text, system prompt, and model parameters are sent to OpenAI's API (`https://api.openai.com/v1`) when the user configures an OpenAI API key directly via the plugin's integration settings.
- **Purpose:** To classify content for spam detection when OpenAI is selected as the AI provider.
- **Terms of Service:** [https://openai.com/policies/terms-of-use/](https://openai.com/policies/terms-of-use/)
- **Privacy Policy:** [https://openai.com/policies/privacy-policy/](https://openai.com/policies/privacy-policy/)

### Anthropic (Claude)
- **Service:** [Anthropic](https://www.anthropic.com/) provides Claude AI models for content classification.
- **Data sent:** Content text, system prompt, and model parameters are sent to Anthropic's API (`https://api.anthropic.com/v1`) when the user configures an Anthropic API key directly via the plugin's integration settings.
- **Purpose:** To classify content for spam detection when Anthropic is selected as the AI provider.
- **Terms of Service:** [https://www.anthropic.com/legal/terms](https://www.anthropic.com/legal/terms)
- **Privacy Policy:** [https://www.anthropic.com/legal/privacy](https://www.anthropic.com/legal/privacy)

### Google Gemini
- **Service:** [Google Gemini](https://deepmind.google/technologies/gemini/) provides AI models for content classification.
- **Data sent:** Content text and model parameters are sent to Google's API (`https://generativelanguage.googleapis.com/v1beta`) when the user configures a Google API key directly via the plugin's integration settings.
- **Purpose:** To classify content for spam detection when Google Gemini is selected as the AI provider.
- **Terms of Service:** [https://ai.google.dev/terms](https://ai.google.dev/terms)
- **Privacy Policy:** [https://policies.google.com/privacy](https://policies.google.com/privacy)

**Important:** AI moderation is optional. All core features — spam firewall, queue management, analytics, activity log, and collaboration — work without any external service. Users must explicitly configure an API key in the plugin's Integrations settings to enable AI-powered features. Content is only sent to external services when AI moderation rules are active and new content is being processed.

== Upgrade Notice ==

= 1.1.2 =
Recommended upgrade for all users. Improves AI moderation reliability and enhances performance for high-volume moderation queues. Includes WordPress 6.7 compatibility fixes.

= 1.1.1 =
Maintenance release with WordPress 6.7 compatibility and webhook delivery improvements. Recommended for all users on 6.7.

= 1.1.0 =
Major feature release. Upgrading is recommended to access AI moderation, real-time analytics, collaboration tools, webhooks, and multi-platform support. Review the new settings tabs after upgrading.

= 1.0.0 =
Initial release.
