AI-powered context-aware moderation for wpForo using OpenRouter with standalone Moderator/Admin interface.

Ruben Garcia

Irene Berna

GamiPress

tsunoa

GamiPress – wpForo integration

colaiasq Ali

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.
<h4>Base Features</h4>
<ul>
<li>AI-Powered Moderation: Uses OpenRouter API with configurable AI models (default: deepseek/deepseek-chat-v3.2)</li>
<li>Real-time Processing: Analyzes posts and topics as they’re submitted, set your OpenRouter query timeout limit</li>
<li>Context Aware Moderation: Analyzes posts with surrounding context (previous and next posts) for better accuracy</li>
<li>Private by default: Considerable forum and user privacy by default when sending user data for analysis, and your data lives on your server</li>
<li>Flexible Flagging System: Customizable flag types (flag, nsfw, spam, etc.) with individual mute durations</li>
<li>User Management: Automatically moves flagged users to a “Muted” database table, prevents them from posting, and unapproves their penalizing post </li>
<li>Scheduled Maintenance: Daily cleanup of expired mutes</li>
<li>Content Cleanup: Automatically handles unapproved content removal</li>
<li>Flags Only Supported: Enable only for flag metrics, stealthy tag users without applying mute penalty</li>
<li>Append AI Message: Append custom messages with {TYPE} and {REASON} formatting tags</li>
<li>Standalone Admin Interface: Accessible to both Administrators, Moderators, and assigned usergroups</li>
<li>Metrics: Track basic moderation statistics up to 1 year (5 years in premium)</li>
<li>Notifications: Shortcode for user notifications about moderation and mute status</li>
</ul>
<h4>Requirements</h4>
<ul>
<li>WordPress 6.0+ (Tested 6.9)</li>
<li>wpForo plugin active (Tested current: 2.4.16 / final v2, Previous versions tested 2.4.8 – 2.4.16)</li>
<li>PHP 8.0+ (Tested 8.2)</li>
<li>MySQL 8.0+ (Tested 8.0)</li>
<li>OpenRouter API key</li>
</ul>
<h3>Shortcode</h3>
This plugin provides shortcodes for displaying moderation-related content on your site.
<h3>Base Plugin Shortcode</h3>
<code>[colaias_wpforo_ai_notices]</code> – Displays user notifications about moderation and mute status
Usage:
<pre><code>[colaias_wpforo_ai_notices top='30px' right='30%' width='40%']
</code></pre>
Parameters: 
* <code>top</code> – (Optional) Top position of the notification container. Default: ’20px’ 
* <code>right</code> – (Optional) Right position of the notification container. Default: ’20px’ 
* <code>width</code> – (Optional) Width of the notification container. Default: ‘350px’
Placement: 
Add this shortcode to the <code>[wpforo]</code> 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
<h3>Check out Premium 🚀</h3>
<a href="https://comingofflais.com/product/premium-llm-moderator-for-wpforo/" rel="nofollow ugc">✨ Premium Version ✨</a>
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: 
* Telegram: <a href="https://t.me/wpforo_ai" rel="nofollow ugc">https://t.me/wpforo_ai</a>
<h3>External Services</h3>
This plugin integrates with the OpenRouter API (<a href="https://openrouter.ai/" rel="nofollow ugc">https://openrouter.ai/</a>) 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.
The query is made to this url: ‘https://openrouter.ai/api/v1/chat/completions’
<h3>Data Transmission and Privacy</h3>
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.
<h3>About OpenRouter</h3>
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: 
– OpenRouter Privacy Policy: <a href="https://openrouter.ai/privacy" rel="nofollow ugc">https://openrouter.ai/privacy</a> 
– OpenRouter Terms of Service: <a href="https://openrouter.ai/terms" rel="nofollow ugc">https://openrouter.ai/terms</a> 
– OpenRouter Data Collection Policy: <a href="https://openrouter.ai/docs/guides/privacy/data-collection" rel="nofollow ugc">https://openrouter.ai/docs/guides/privacy/data-collection</a>
AI Provider Policies: 
Each LLM provider (such as OpenAI, Anthropic, DeepSeek, etc.) has its own data handling policies. For information on how different providers process data, see OpenRouter’s provider logging documentation: <a href="https://openrouter.ai/docs/guides/privacy/logging" rel="nofollow ugc">https://openrouter.ai/docs/guides/privacy/logging</a>
<h3>Optional Data Sharing</h3>
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.
<h3>Technical Implementation</h3>
API Request Structure: 
The plugin sends POST requests to OpenRouter (‘https://openrouter.ai/api/v1/chat/completions’) with the following JSON payload structure:
<pre><code>$body = json_encode( [
 'model' => $model,
 'messages' => [
 ['role' => 'user', 'content' => $json_prompt],
 ],
 'max_tokens' => 1000, // Maximum tokens in response (50-80 is typically sufficient)
 'temperature' => 0.1,
 'response_format' => ['type' => 'json_object'],
] );
</code></pre>
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. For advanced routing configuration, see: <a href="https://openrouter.ai/docs/guides/routing/provider-selection" rel="nofollow ugc">https://openrouter.ai/docs/guides/routing/provider-selection</a>, though these cannot be changed from default besides what is already configured above 
– You can customize request processing through the OpenRouter dashboard, including model selection and privacy policies on a per-key basis: <a href="https://openrouter.ai/settings/privacy" rel="nofollow ugc">https://openrouter.ai/settings/privacy</a> 
– 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
<h3>Requirements</h3>
<ul>
<li>A valid OpenRouter API key must be configured in the plugin settings</li>
<li>Your OpenRouter account must have sufficient credits for API usage</li>
<li>Your prompt must specifically ask for a JSON format response with ‘type’ key and optionally ‘reason’ key, no other formats are accepted</li>
</ul>

Alternatives to LLM Moderator For wpForo

Top alternatives