Title: AI Bot for bbPress Author: Chris Huber Published: May 16, 2025 Last modified: August 15, 2025 --- Search plugins ![](https://s.w.org/plugins/geopattern-icon/ai-bot-for-bbpress.svg) # AI Bot for bbPress By [Chris Huber](https://profiles.wordpress.org/extrachill/) [Download](https://downloads.wordpress.org/plugin/ai-bot-for-bbpress.1.0.4.2.zip) * [Details](https://test.wordpress.org/plugins/ai-bot-for-bbpress/#description) * [Reviews](https://test.wordpress.org/plugins/ai-bot-for-bbpress/#reviews) * [Installation](https://test.wordpress.org/plugins/ai-bot-for-bbpress/#installation) * [Development](https://test.wordpress.org/plugins/ai-bot-for-bbpress/#developers) [Support](https://wordpress.org/support/plugin/ai-bot-for-bbpress/) ## Description 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](https://github.com/chubes4/ai-http-client) to provide multi-provider support (OpenAI, Anthropic, Gemini, Grok, OpenRouter) with a unified interface. **Links:** * [Plugin Homepage](https://chubes.net) – Visit the developer’s website* [GitHub Repository](https://github.com/chubes4/ai-bot-for-bbpress) – Source code, issues, and contributions * [Support](https://github.com/chubes4/ai-bot-for-bbpress/issues)– 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](https://openai.com/policies/terms-of-service) * **OpenAI API Privacy Policy:** [https://openai.com/policies/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. ## Installation 1. Upload the `ai-bot-for-bbpress` folder to the `/wp-content/plugins/` directory 2. Activate the plugin through the ‘Plugins’ menu in WordPress 3. Configure the plugin settings under the ‘AI Bot for bbPress’ menu in the WordPress admin panel (Settings > Forum AI Bot). ## FAQ ### What does this plugin do? This plugin allows you to integrate an AI bot into your bbPress forums. The bot can respond to mentions and keywords, providing automated assistance and engaging in discussions. ### How do I configure the bot? You can configure the bot’s behavior and settings under the ‘AI Bot for bbPress’ menu in the WordPress admin panel. ### What is the “Remote REST Endpoint URL” setting? The remote context feature allows the bot to search for relevant information on a separate WordPress installation (like your main website). To enable this, you need to install the companion plugin, **BBP Bot Helper**, on that _other_ WordPress site. This helper plugin creates a secure REST API endpoint. You then enter the URL of this endpoint into the “Remote REST Endpoint URL” setting in _this_ plugin( AI Bot for bbPress). ### What is the BBP Bot Helper plugin? It provides a REST API endpoint for the AI Bot for bbPress plugin to securely query content for context. ### Where do I install the BBP Bot Helper plugin? Install it on the WordPress site whose content you want the AI Bot for bbPress to be able to search. This is often your main website, separate from where the bbPress forum itself is hosted. ### Does the BBP Bot Helper plugin do anything on its own? No. It only provides an API endpoint for use by the AI Bot for bbPress plugin. ### Is the BBP Bot Helper endpoint secure? The endpoint itself is public by default, typical of WordPress REST API endpoints. Security relies on the fact that only the AI Bot for bbPress knows to query it, and it only returns publicly available content (published posts/pages). Access control could be added in future versions if needed. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “AI Bot for bbPress” is open source software. The following people have contributed to this plugin. Contributors * [ Chris Huber ](https://profiles.wordpress.org/extrachill/) * [ Chubes ](https://profiles.wordpress.org/chubes/) [Translate “AI Bot for bbPress” into your language.](https://translate.wordpress.org/projects/wp-plugins/ai-bot-for-bbpress) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/ai-bot-for-bbpress/), check out the [SVN repository](https://plugins.svn.wordpress.org/ai-bot-for-bbpress/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/ai-bot-for-bbpress/) by [RSS](https://plugins.trac.wordpress.org/log/ai-bot-for-bbpress/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.4.2 * CRITICAL FIX: Set explicit 60-second timeout for OpenAI API calls to prevent WordPress 5-second default timeout * Fix: Resolves bot failures in longer conversations due to API timeout #### 1.0.4.1 * HOTFIX: Removed API timeout constraints that caused bot failures in longer conversations * Fix: Bot now handles extended conversations without timing out during API requests * Fix: Explicitly set publish status for bot replies to prevent moderation issues #### 1.0.4 * Fix: Bot replies now properly trigger WordPress hooks (bbp_new_reply) for better integration * Enhancement: Bot replies now work correctly with notification plugins, points systems, and activity feeds * Enhancement: Improved compatibility with bbPress ecosystem plugins that expect standard hooks #### 1.0.3 * NEW FEATURE: Forum Access Control – Bot can now be restricted to specific forums only * NEW: Hierarchical forum selection with proper indentation showing parent/child relationships * MAJOR: Improved conversation memory – Bot now uses proper OpenAI message structure for better context retention * ARCHITECTURE: Complete code refactor with centralized System_Prompt_Builder for all AI instructions * ARCHITECTURE: Eliminated redundant wrapper classes and directories for cleaner, more maintainable code * ARCHITECTURE: New Bot_Trigger_Service centralizes all trigger logic (mentions, keywords, forum restrictions) * Enhancement: Forum restriction enforcement – bot will only respond in selected forums when configured * Enhancement: Bot now posts user-friendly error messages instead of staying silent when API errors occur * Enhancement: Conversation history now uses proper user/assistant message alternation for OpenAI API * Enhancement: All prompt construction logic now centralized in single service following single responsibility principle * Fix: Bot now properly recognizes its own username when mentioned (no longer thinks mentions are about someone else) * Fix: Added proper output escaping for admin form inputs to meet WordPress security standards * Code cleanup: Removed redundant code and directories, improved separation of concerns #### 1.0.2 * Address WordPress.org review feedback: - Added ‘Requires Plugins: bbpress’ header to main plugin file. - Updated readme.txt with detailed ‘External Services’ disclosure for OpenAI API. - Removed unnecessary PHP closing tags (`?>`) from several files. - Commented out `error_log` and `print_r` development debugging statements. - Replaced `strip_tags()` with `wp_strip_all_tags()` in database agent. - Restored `unset()` for a class property in database agent after filter removal. * Enhanced bot response context to more clearly identify the user being replied to. #### 1.0.0 * Major Refactor: Renamed plugin to “AI Bot for bbPress” and updated internal naming conventions. * Feature: Added optional remote context retrieval via BBP Bot Helper companion plugin. * Feature: Added Local and Remote search limit settings. * Feature: Added Trigger Keywords setting. * Feature: Added date/timestamp information to remote context results. * Fix: Resolved issues with local and remote context not being correctly passed to the AI model. * Fix: Improved reliability of cron job scheduling and execution logging. * Update: Added configuration options for temperature and prompts. * Update: Tested compatibility up to WordPress 6.8. ## Meta * Version **1.0.4.2** * Last updated **9 months ago** * Active installations **Fewer than 10** * WordPress version ** 5.0 or higher ** * Tested up to **6.8.5** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/ai-bot-for-bbpress/) * Tags * [AI](https://test.wordpress.org/plugins/tags/ai/)[bbPress](https://test.wordpress.org/plugins/tags/bbpress/) [bot](https://test.wordpress.org/plugins/tags/bot/)[ChatGPT](https://test.wordpress.org/plugins/tags/chatgpt/) [forum](https://test.wordpress.org/plugins/tags/forum/) * [Advanced View](https://test.wordpress.org/plugins/ai-bot-for-bbpress/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/ai-bot-for-bbpress/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/ai-bot-for-bbpress/reviews/) ## Contributors * [ Chris Huber ](https://profiles.wordpress.org/extrachill/) * [ Chubes ](https://profiles.wordpress.org/chubes/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/ai-bot-for-bbpress/)