About this plugin
This plugin integrates AI-powered context-aware content moderation with the wpForo forum plugin. It uses OpenRouter API to analyze forum posts and topics in real-time, automatically flagging inappropriate content and muting users who violate your custom forum moderation guidelines.
Base Features
- AI-Powered Moderation: Uses OpenRouter API with configurable AI models (default: deepseek/deepseek-chat-v3.2)
- Real-time Processing: Analyzes posts and topics as they’re submitted, set your OpenRouter query timeout limit
- Context Aware Moderation: Analyzes posts with surrounding context (previous and next posts) for better accuracy
- Private by default: Considerable forum and user privacy by default when sending user data for analysis, and your data lives on your server
- Flexible Flagging System: Customizable flag types (flag, nsfw, spam, etc.) with individual mute durations
- User Management: Automatically moves flagged users to a “Muted” database table, prevents them from posting, and unapproves their penalizing post
- Scheduled Maintenance: Daily cleanup of expired mutes
- Content Cleanup: Automatically handles unapproved content removal
- Flags Only Supported: Enable only for flag metrics, stealthy tag users without applying mute penalty
- Append AI Message: Append custom messages with {TYPE} and {REASON} formatting tags
- Standalone Admin Interface: Accessible to both Administrators, Moderators, and assigned usergroups
- Metrics: Track basic moderation statistics up to 1 year (5 years in premium)
- Notifications: Shortcode for user notifications about moderation and mute status
Requirements
- WordPress 6.0+ (Tested 6.9)
- wpForo plugin active (Tested current: 2.4.16 / final v2, Previous versions tested 2.4.8 – 2.4.16)
- PHP 8.0+ (Tested 8.2)
- MySQL 8.0+ (Tested 8.0)
- OpenRouter API key
Shortcode
This plugin provides shortcodes for displaying moderation-related content on your site.
Base Plugin Shortcode
[colaias_wpforo_ai_notices] – Displays user notifications about moderation and mute status
Usage:
[colaias_wpforo_ai_notices top='30px' right='30%' width='40%']
Parameters:
* top – (Optional) Top position of the notification container. Default: ’20px’
* right – (Optional) Right position of the notification container. Default: ’20px’
* width – (Optional) Width of the notification container. Default: ‘350px’
Placement:
Add this shortcode to the [wpforo] page. The notifications will display information to users:
* When a user is muted hence cannot post
* When a user’s post has been flagged
* Moderation status updates
Check out Premium 🚀
✨ Premium Version ✨
Upgrade to the premium version for advanced features including:
🌟 Enhanced Features:
* 🛠️ Enhanced Moderator Control Panel – Bulk select management for efficient moderation
* 🎨 Easy Prompt Engineering Interface – Visual prompt builder
* 🌊 Forum Flood Control System – User and forum posting limits to prevent spam attacks
* 📊 Comprehensive Premium Metrics – 5-year data retention with detailed analytics
* 📈 Charts & Graphs For Metrics – Comprehensive visualizations with user table for metrics
* 🔎 User Look-Up – Look up individual users flag metrics
* 💎 Lifetime Single Purchase – No subscriptions, one-time payment for lifetime updates
💖 Support Independent Development:
Your purchase helps keep this plugin free and actively maintained! Support innovation in open-source AI moderation tools.
📧 Interested in Premium?
Contact us for early access and pricing:
me/wpforo_ai
External Services
ai/ ) to provide AI-powered content moderation for wpForo forums. When configured with a valid OpenRouter API key, the plugin sends moderation requests to analyze forum posts in real-time.
ai/api/v1/chat/completions’
Data Transmission and Privacy
What Data Is Sent:
– Only the user’s post content is transmitted to OpenRouter
– A moderation prompt configured by the administrator precedes the post content
– No personally identifiable information (name, username, or user ID) is included in the post content
– Each post from non-muted users triggers exactly one API request
Current Implementation:
The plugin now includes Context Aware Moderation, which analyzes posts with surrounding context (previous and next posts) for better accuracy while maintaining user privacy with aliases. Usernames are replaced with aliases to protect user privacy while providing the AI with necessary conversational context.
About OpenRouter
OpenRouter is an AI routing service that provides access to multiple LLM models from various providers. When using this plugin, your data passes through OpenRouter to the selected AI model provider.
Important Links:
ai/privacy
ai/terms
ai/docs/guides/privacy/data-collection
AI Provider Policies:
) has its own data handling policies. ai/docs/guides/privacy/logging
Optional Data Sharing
You may optionally send:
– Your site’s URL (via HTTP-Referer header)
– Application title (via X-Title header)
These optional fields help OpenRouter rank applications and improve service quality.
Technical Implementation
API Request Structure:
ai/api/v1/chat/completions’) with the following JSON payload structure:
1, 'response_format' => ['type' => 'json_object'], ] );
Response Expectation:
The plugin expects OpenRouter to return a JSON object containing moderation results with ‘type’ and ‘reason’ keys as specified in your moderation prompt.
Configuration Options:
– The plugin uses default provider selection parameters. ai/docs/guides/routing/provider-selection, though these cannot be changed from default besides what is already configured above
ai/settings/privacy
– You can configure your key, and set limits and alerts as needed
– With this plugin, you can also set a timeout for the OpenRouter query from 10-300 seconds
Requirements
- A valid OpenRouter API key must be configured in the plugin settings
- Your OpenRouter account must have sufficient credits for API usage
- Your prompt must specifically ask for a JSON format response with ‘type’ key and optionally ‘reason’ key, no other formats are accepted