The Chatbot AI Plugin is a WordPress plugin that gives a WordPress site an AI-powered chat interface. Site visitors open the chat on the WordPress site, send messages, and read AI-generated replies. The WordPress site owner installs the plugin, verifies identity, and configures the chatbot settings that govern how the chat behaves for visitors.
The product intent is narrow and concrete: add an AI chat to a WordPress site, let visitors ask questions and receive AI answers, and let the site owner control the chatbot's configuration. The audience is two roles — the WordPress site owner who operates the plugin, and the site visitor who converses with the chatbot.
This document is the System Requirements Document for the Chatbot AI Plugin. It records the accepted current behavior, the delivery and access boundaries, the page contract, the personas, the core user flows, and the supporting technical and design constraints.
The Chatbot AI Plugin is delivered as a WordPress plugin with a first-party application surface. The current delivery includes:
The active human actors are the WordPress site owner and the Site visitor. The system also relies on an AI model provider reached through a LiteLLM gateway, and on application-owned persistent storage.
The provisioned infrastructure comprises a shared FastAPI backend for application APIs and domain modules, a MariaDB database for application-owned persistent data, a React frontend, a LiteLLM gateway for the backend's model-provider calls, and a PostgreSQL database supporting LiteLLM (separate from application-owned storage). These services support the accepted behavior; they do not add product requirements.
Removed from scope
The product is a plugin for WordPress. Its first-party surfaces are the Landing page, the Login page, the Chat page, and the Chatbot Settings page. The Landing page is anonymously reachable and explains the plugin. The Login page is anonymously reachable and establishes the site owner's identity; it does not itself grant access to protected settings. The Chat page is anonymously reachable by site visitors, who send messages and read AI replies. The Chatbot Settings page is role-restricted and requires the site owner to have verified identity through Login.
AI replies are produced by the backend calling a model provider through the LiteLLM gateway. Application-owned durable state — the site owner's identity and the chatbot settings — is stored in the application's MariaDB database. LiteLLM's PostgreSQL database is separate and is not application-owned storage.
Current scope covers the four pages above and the two personas. No adjacent account-management, billing, analytics, or multi-site administration capabilities are included.
FR-1 — Plugin delivery. As a WordPress site owner, I should be able to use the product as a plugin for WordPress, so that the chatbot is delivered within my WordPress site. (explicit)
FR-2 — Visitor chat with AI answers. As a site visitor, I should be able to open the chat on the WordPress site, send my messages, and read AI replies, so that my questions are answered. (explicit)
FR-3 — Site owner configures settings. As a WordPress site owner, I should be able to configure the chatbot settings in WordPress, so that the chatbot behaves as I intend for my site. (explicit)
FR-4 — Site owner verifies identity before changing settings. As a WordPress site owner, I should verify my identity before changing chatbot settings, so that durable settings remain protected. (required_inference)
FR-5 — Visitor opens the chat on the WordPress site. As a site visitor, I should be able to open the chat on the WordPress site, so that I can begin a conversation. (required_inference)
The creative direction is authoritative for this section. Muse: Zaha Hadid — fluid parametric grandeur for an AI chat plugin. Headline: "Your site answers every question."
Mode: Dark.
Color tokens (exact hex by role):
#121316#1C1E23#F2F1ED#C9A227#8FD6C9#8A8D94Gold stays under 10 percent of each screen. Charcoal ground with pearl-white text; gold marks key actions; mint teal marks live chat state.
Typography:
Shape language: Long sweeping curves, capsule controls, soft diagonal section edges. Corners are continuous, not sharp.
Layout: Asymmetric editorial grid with a curved hero band. Settings use calm two-column rows. The chat window floats on a wide curve.
Imagery: Smooth 3D curved surfaces and flowing light lines. No stock photos and no flat clip art.
Avoid: Flat grey admin panels; sharp 90-degree card corners; blue primary buttons on white; photographic stock people; grids of identical hover-lift cards. The generic indigo/blue-on-white SaaS template is forbidden.
Readability constraint: Headlines, wordmarks, labels, numbers, cards' text and controls stay entirely inside the viewport and their container at 375px, 768px, and 1280px, wrapping or scaling (for example font-size: clamp(...) with its mobile size) to fit, with no other element covering any part of them. Imagery, decoration, and motion may be cropped, bled, rotated, overlapped, or cut as the direction asks, as long as they cover no readable text or control. With prefers-reduced-motion, provide a usable static arrangement.
The public entry (Landing) is built around a full-bleed charcoal field holding one large golden curved ribbon that sweeps from the left edge. A pearl-white headline — "Your site answers every question" — sits over the curve at 96px on desktop and 44px on mobile, carried on the ribbon's upper arc. The subline "Add an AI chat to WordPress. Visitors ask, the chatbot replies." sits beneath, and the "Add the plugin" call to action is a capsule control in gold. A chat preview panel floats at the lower right as a floating capsule with a mint live dot, recomposing the accepted Chat page's message-and-reply state. Section boundaries curve as soft diagonal arcs rather than straight rules. The concept recomposes only accepted content, states, and controls; it introduces no new behavior or destination.
Interaction Model: Animated Motion Tempo: cinematic Hero Dimensionality: dimensional_css
Landing Hero Motion Brief
prefers-reduced-motion, a usable static arrangement is provided. (explicit)
Chatbot for WordPress
Add an AI chat to WordPress. Visitors ask, the chatbot replies.
PreviewA look at the chat your visitors see on your WordPress site. Visitors ask, the chatbot replies.
VisitorHi, what does this site sell?
ChatbotWelcome. Ask me anything about this site and I will reply right here.
What the plugin does
chatbot-wordpress installs as a WordPress plugin, so the chat lives on the site you already run rather than on a separate tool.
Visitors send a message in the chat and read the AI reply. Conversation history, the live state and replies stay in one continuous thread.
After verifying your identity at Login, you configure the chatbot on Chatbot Settings — calm rows with a gold toggle for each option.

Chatbot for WordPress
Add an AI chat to WordPress. Visitors ask, the chatbot replies.
PreviewA look at the chat your visitors see on your WordPress site. Visitors ask, the chatbot replies.
VisitorHi, what does this site sell?
ChatbotWelcome. Ask me anything about this site and I will reply right here.
What the plugin does
chatbot-wordpress installs as a WordPress plugin, so the chat lives on the site you already run rather than on a separate tool.
Visitors send a message in the chat and read the AI reply. Conversation history, the live state and replies stay in one continuous thread.
After verifying your identity at Login, you configure the chatbot on Chatbot Settings — calm rows with a gold toggle for each option.
No comments yet. Be the first!