AI Bot for bbPress vs LLM Moderator For wpForo

AI Bot for bbPress integrates seamlessly with your bbPress forums, allowing a configurable AI bot user to participate in discussions. The bot can be triggered by direct mentions (@YourBotUsername) or specific keywords within forum posts, leveraging context from the forum and optionally a remote WordPress site. Currently uses OpenAI’s ChatGPT API. Future versions will migrate to our AI HTTP Client library to provide multi-provider support (OpenAI, Anthropic, Gemini, Grok, OpenRouter) with a unified interface. Links: * Plugin Homepage – Visit the developer’s website * GitHub Repository – Source code, issues, and contributions * Support – Report bugs or request features Configuration After activation, navigate to Settings > Forum AI Bot in your WordPress admin area to configure the following options: OpenAI API Key: Your secret API key from OpenAI. Bot User ID: The WordPress user ID of the account the bot will use to post replies. System Prompt: Instructions defining the bot’s personality, role, and general behavior (e.g., “You are a helpful assistant for the Example Community forum.”). Custom Prompt: Additional instructions appended to every API request, useful for guiding specific response formats or context usage. Temperature: Controls the creativity/randomness of the AI’s responses (0 = deterministic, 1 = max creativity). Default is 0.5. Trigger Keywords: A comma-separated list of keywords (in addition to mentions) that will trigger the bot to respond. Local Search Limit: Maximum number of relevant posts/topics to retrieve from the local forum database for context. Default is 3. Remote REST Endpoint URL: The full URL to the search endpoint provided by the BBP Bot Helper plugin installed on your remote site (e.g., https://your-main-site.com/wp-json/bbp-bot-helper/v1/search). Leave blank to disable remote context. Remote Search Limit: Maximum number of relevant posts to retrieve from the remote endpoint for context. Default is 3. Forum Access Control: Choose whether the bot responds in all forums or only selected ones. When set to “Selected Forums Only”, you can choose specific forums where the bot will be active. External Services This plugin connects to the OpenAI API to generate responses for the AI bot. This is essential for the plugin’s core functionality of providing AI-driven replies in bbPress forums. Service: OpenAI API (specifically the Chat Completions endpoint). Purpose: To generate intelligent and contextually relevant responses based on forum discussions and configured prompts. Data Sent: When the bot is triggered (by a mention or keyword), the following types of data are sent to the OpenAI API: The content of the post that triggered the bot. Relevant conversation history from the current topic (including post content and author usernames/slugs). Contextual information retrieved from the local WordPress database (titles, snippets, and URLs of relevant posts/pages based on keyword matching). If configured, contextual information retrieved from a remote WordPress site via the BBP Bot Helper plugin (titles, snippets, and URLs of relevant posts/pages). The system prompt, custom prompt, and temperature settings configured in the plugin’s admin page. The structure of your bbPress forums (forum names, topic names, and their hierarchy). The current date and time. When Data is Sent: Data is sent only when the bot is triggered to generate a response. This occurs after a user posts a new reply or topic that meets the trigger conditions (mentioning the bot or containing a specified keyword). OpenAI API Terms of Service: https://openai.com/policies/terms-of-service OpenAI API Privacy Policy: https://openai.com/policies/privacy-policy It is important to have an active OpenAI API key with sufficient credits for the bot to function. Please review OpenAI’s policies to understand how they handle the data sent to their API. If the “Remote REST Endpoint URL” is configured, the plugin will also send search queries (derived from the conversation) to that endpoint to fetch additional context. This endpoint is typically on another WordPress site you control and that runs the companion “BBP Bot Helper” plugin. No user-specific data is sent to this remote endpoint beyond the search terms. The data received from this endpoint is then included in the information sent to the OpenAI API as described above.

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: * Telegram: https://t.me/wpforo_ai External Services This plugin integrates with the OpenRouter API (https://openrouter.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. The query is made to this url: ‘https://openrouter.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: – OpenRouter Privacy Policy: https://openrouter.ai/privacy – OpenRouter Terms of Service: https://openrouter.ai/terms – OpenRouter Data Collection Policy: https://openrouter.ai/docs/guides/privacy/data-collection 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: https://openrouter.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: The plugin sends POST requests to OpenRouter (‘https://openrouter.ai/api/v1/chat/completions’) with the following JSON payload structure: $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'], ] ); 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: https://openrouter.ai/docs/guides/routing/provider-selection, 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: https://openrouter.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