=== AdamBox === Contributors: jackofall1232 Donate link: Tags: chatbox, live chat, ai moderation, content moderation, chat moderation Requires at least: 6.0 Tested up to: 6.9 Requires PHP: 7.4 Stable tag: 1.1.4 License: GPLv3 License URI: https://www.gnu.org/licenses/gpl-3.0.html Lightweight live chat chatbox with AI-powered moderation for WordPress — calm, neutral oversight with no tracking or data storage. == Description == AdamBox is a **lightweight live chat chatbox with AI moderation** for WordPress. It provides calm, neutral AI oversight for on-page conversations — without tracking users, storing messages, or profiling visitors. AdamBox is an **AI moderator**, not a chatbot and not a participant. ### Core Principles - Clean and lean architecture - WordPress coding standards compliant - Privacy-first by design - No user tracking or profiling - No persistent message storage - No custom database tables - No external JavaScript frameworks - Community-first and fully open source ### What AdamBox Does - Renders a live, moderation-enabled chatbox via shortcode - Allows multiple visitors to chat together on the same page - Uses session-based display names (no accounts required) - Temporarily observes recent messages for moderation context only - Intervenes calmly and neutrally when moderation is needed - Uses WordPress REST API and vanilla JavaScript only ### What AdamBox Does *Not* Do - No long-term memory - No learning from conversations - No user profiling or identity tracking - No chat transcripts saved to the database - No analytics or tracking scripts - No feature gating in the free version AdamBox is built for site owners who want **responsible AI oversight** without sacrificing privacy, performance, or control. == Installation == 1. Upload the `adambox` folder to the `/wp-content/plugins/` directory 2. Activate the plugin through the **Plugins** menu in WordPress 3. Go to **Settings → AdamBox** to configure options 4. Add the shortcode `[adambox]` to any page or post == Usage == Insert the shortcode anywhere you want the live chat chatbox to appear: `[adambox]` Each page maintains its own conversation context. Messages are shared live between visitors on the same page. == Settings == AdamBox adds a settings page at: **Settings → AdamBox** Available options include: ### API Configuration - Optional OpenAI API key - Stored securely using WordPress options ### Moderation Controls - Moderation strictness: - Low - Medium (default) - High - AI intervention level: - Intervene only (default) - Summarize when needed - Actively guide These controls affect **how and when** the AI moderator intervenes — not what users are allowed to say. == Privacy == AdamBox is privacy-first by design. - No persistent user data - No chat logs stored in the database - No cookies beyond session state (or localStorage fallback) - No analytics or tracking scripts - No third-party JavaScript frameworks Messages exist **only temporarily** for moderation context and are discarded automatically. == External Services == AdamBox optionally connects to the OpenAI API to provide AI-powered moderation. This service is used only when a site administrator supplies their own OpenAI API key in the plugin settings. Data sent: - User-submitted chat messages (text only) - Sent only at the moment moderation is triggered No data is stored by AdamBox after processing. Service provider: OpenAI, Inc. Terms of Service: https://openai.com/policies/terms-of-use Privacy Policy: https://openai.com/policies/privacy-policy == Frequently Asked Questions == = Is AdamBox a chatbot? = No. AdamBox is an **AI moderator**, not a conversational agent. = Does AdamBox store conversations? = No. Messages are stored ephemerally only to support live moderation and are never written to the database. = Does AdamBox track users? = No. Display names are session-based only and are not linked to identities. = Can I use AdamBox without an API key? = Yes. The API key is optional. Without it, AdamBox continues to function using non-AI moderation logic. = Is AdamBox free? = Yes. AdamBox is fully functional as a free, open-source plugin licensed under GPL v3. == Screenshots == 1. AdamBox live chat moderation interface embedded on a page 2. AdamBox settings panel in WordPress admin == Changelog == = 1.1.4 = * Added missing WordPress.org banner asset size for full directory support * Cleaned up plugin distribution archive * Updated readme metadata and tags for improved discoverability * Removed unintended contributor attribution * No functional behavior changes = 1.1.3 = * Replaced direct database queries in uninstall routine with WordPress multisite APIs * Removed remaining Plugin Check warnings * No functional behavior changes = 1.1.2 = * Fixed uninstall routine to comply with WordPress coding standards * Prefixed all global variables to prevent namespace collisions * No functional behavior changes = 1.1.1 = * Documentation updates for WordPress.org compliance * External service disclosure added * Distribution cleanup (no functional changes) = 1.1.0 = * Added tier-based moderation strictness with meaningful behavioral differences * Implemented automatic cooldowns for severe (Tier 1) violations * Added placeholder replacement for removed messages to prevent escalation * Improved intent-based handling for low-level (Tier 3) hostility * Enhanced AI prompts with better context awareness and pattern detection * Strengthened abuse prevention while preserving low-friction conversation flow * Internal moderation logic refactored for future Pro feature expansion = 1.0.0 = * Initial stable release * Hardened moderation pipeline with keyword tiers and optional AI oversight * Privacy-first architecture validated for WordPress.org compliance * REST API rate limiting and abuse protection * Mobile stability and caching fixes finalized * Plugin Checker warnings resolved = 0.3.2 = * Fixed aggressive mobile browser caching preventing live updates * Improved polling reliability across Chrome Mobile and Safari * Fixed scroll jumping and message flashing during live updates * Added session-locked display names for clearer multi-user conversations * Improved mobile behavior when switching tabs or returning to the page = 0.2.0 = * Added per-page shared conversation context * Messages now visible to all visitors on the same page * Context stored ephemerally using WordPress transients * No user tracking or persistent storage = 0.1.0 = * Initial release * Plugin bootstrap and architecture * Shortcode rendering * Admin settings foundation * REST API scaffolding * WordPress.org compliance baseline == Upgrade Notice == = 1.1.4 = Maintenance and presentation update. No configuration changes are required. == License == This plugin is licensed under the GNU General Public License v3.0 or later. You are free to use, modify, and distribute this software under the terms of the GPL.