=== Oberon Chat === Contributors: oberonie Tags: chatbot, ai, openai, support, assistant Requires at least: 6.0 Tested up to: 6.8 Requires PHP: 8.0 Stable tag: 2.9.0 License: GPL-2.0-or-later License URI: https://www.gnu.org/licenses/gpl-2.0.html Professional LLM-powered assistant with transcript management and deep customization. == Description == Oberon Chat delivers a polished, privacy-aware GPT experience to your WordPress site. Configure prompts, tone, rate controls, and interface styling directly from wp-admin, while every conversation is captured for review or compliance. ### Highlights * **Chat Experience** – AI responses backed by your choice of OpenAI (ChatGPT), Google Gemini, or Anthropic Claude with system prompts, context window control, and an optional natural delay. * **Brand-Ready UI** – Customize the chat badge, colours, text treatments, agent name, greeting, and reach visitors with both trigger styles out of the box (advanced bubble background/text colours require Pro). * **Prompt Presets** – Pick from goal-based system prompts (lead generation, support, product discovery) and insert them with one click. * **Transcript Vault** – Store complete conversation logs, email stale sessions automatically, and review, export, or delete transcripts within WordPress. * **Admin Friendly** – WordPress Settings API integration, color pickers, nonce-protected AJAX, and cron cleanup ensure the plugin plays nicely in production. * **Performance & Safety** – Inline history trimming on both client and server protects API usage, Pro-only settings revert to safe defaults if the licence lapses, and no UI assets load in admin or on pages without the shortcode. * **Backend LLM Hub** – Configure your provider, API key, and preferred model from a dedicated tab. ### External Services Oberon Chat connects to third-party large language model APIs when you supply your own credentials: * **OpenAI** (`https://api.openai.com/v1/chat/completions`, `https://api.openai.com/v1/models`) – Sends system prompt, trimmed message history, and optional function definitions; receives the generated reply. Subject to [OpenAI Terms](https://openai.com/policies/terms-of-use) and [Privacy Policy](https://openai.com/policies/privacy-policy). * **OpenRouter** (`https://openrouter.ai/api/v1/models`) – Optional model discovery endpoint for OpenRouter-compatible keys. See [OpenRouter Terms](https://openrouter.ai/terms) and [Privacy Policy](https://openrouter.ai/privacy). * **Google Gemini** (`https://generativelanguage.googleapis.com/v1beta/models`) – Used to fetch available Gemini models and send chat completions. Governed by the [Generative Language API Terms](https://ai.google.dev/terms) and [Google Privacy Policy](https://policies.google.com/privacy). * **Anthropic Claude** (`https://api.anthropic.com/v1/models`) – Accessed for model discovery and chat completions with supplied keys. Covered by the [Anthropic Terms of Service](https://www.anthropic.com/legal/terms-of-service) and [Privacy Policy](https://www.anthropic.com/legal/privacy). Only the data required to fulfil each request is transmitted directly from your server to the selected provider; the plugin does not proxy or log API payloads beyond the optional transcript storage you control. ### Accessibility & Localization Frontend markup includes ARIA attributes, focus states, and keyboard-friendly controls. Text strings are translation-ready via the `oberon-chat` text domain. == Installation == 1. Upload the `oberon-chat` folder to the `/wp-content/plugins/` directory or install through the WordPress plugins screen. 2. Activate the plugin via **Plugins → Installed Plugins**. 3. Visit **Oberon Chat → Settings** to add your Backend LLM connection(s), then tailor prompts, activation rules, and the chat interface. 4. Embed the assistant anywhere with the `[oberon_chat]` shortcode or the provided menu toggle. == Frequently Asked Questions == = Do I need an AI provider account? = Yes. Bring your own API key(s) for OpenAI, Google Gemini, or Anthropic Claude and add them on the Backend LLM tab—the plugin never exposes them publicly. = How do I limit token usage? = Set the "Chat History Length" option to control how many prior exchanges are sent with each request. Older history is trimmed before the API call. = Can I export transcripts? = Every transcript can be viewed, emailed, or deleted from **Oberon Chat → Transcripts**. Export from there or copy the log into your CRM. = Is the widget translation-ready? = All strings use `esc_html__()` / `esc_attr__()`; load your translations via the standard WordPress mechanism. == Screenshots == 1. Settings overview with API credentials, prompts, and style controls. 2. Frontend chat widget showing customizable trigger buttons. 3. Transcript management screen with view, email, and delete actions. == Changelog == = 2.9.0 = * Fix: Resolved fatal error in settings sanitization for Community users. * Enhancement: General stability improvements and build process updates. = 2.7.0 = * Streamlined OpenRouter conversations and refreshed default widget branding. == Upgrade Notice == = 2.9.0 = Critical fix for settings saving error in Community edition. = 2.7.0 = OpenRouter improvements and refreshed default widget styling. = 2.6.4 = Refresh for OpenRouter stability and branding updates. = 2.6.3 = Polish update for admin interface messaging. = 2.6.2 = Upgrade for security issues