BKiAI Chat Plugin – Function Documentation v3.0.0
Status: Analysis of the uploaded plugin file "bkiai-chat-premium-v3.0.0.zip"
Purpose: compact reference for website documentation, product maintenance, and later version updates

Important note on derivation:
- The analysed file was the Premium version v3.0.0.
- The differences between Free, Pro, and Expert were derived from the plugin’s internal plan and feature logic.
- In the Premium build, the plugin technically falls back to the Free plan when no valid licence is present.

General plugin baseline v3.0.0
- WordPress plugin for embedded AI chats on websites
- Shortcode integration per bot: [bkiai_chat bot="1"]
- OpenAI API key can be stored in the backend
- Chat can be embedded as a window or displayed as a popup (Bot 1)
- Streaming responses with gradual word-by-word output
- Copy button for bot responses
- Clear chat button
- Expand/shrink function (fullscreen / enlarged view)
- Structured frontend output for:
  - headings
  - bullet lists
  - numbered lists
  - tables
  - code blocks
  - bold/italic text
  - links
- Source references can be displayed as badges at the end of responses
- Frontend conversation history: up to 8 previous messages per active session
- Configurable daily usage limits per visitor and per bot:
  - messages per day
  - approximate tokens per day
- Default values per bot:
  - 25 messages per visitor per day
  - 12,000 tokens per visitor per day
- Knowledge files possible per bot
- Supported knowledge file formats:
  - .md / .markdown
  - .txt
  - .csv
- Licence area available in the backend
- Chat logs can be stored locally in a dedicated database table (plan-dependent)

==================================================
FREE VERSION
==================================================

1. Design settings
Note:
- In the analysed v3.0.0 code, most design options are available across editions.
- The main differences between editions lie in bot count and premium features, not in most colour/layout fields.

- Freely definable window width
  - supported units: px, %, vh, vw, rem, em
  - example values in the plugin: 100%, 780px, 90vw
- Freely definable window height
  - controls the height of the message area
  - example values: 420px, 60vh
- Corner radius for chat window / popup
  - range: 0 to 80 px
- Corner radius for input field
  - range: 0 to 80 px
- Selectable design presets
  - BusinessKiAI Light
  - BusinessKiAI Dark
  - ChatGPT similar
  - Modern Blue-Gray
- Configurable chat border
  - border thickness
  - border colour
- Configurable colours / surfaces for:
  - chat background
  - header
  - footer
  - send button
  - expand/shrink button
- Display modes for colour surfaces:
  - solid
  - gradient
  - pattern
- Presets for surfaces / patterns:
  - Soft
  - Light
  - Intense
  - Multi-step
  - Diagonal stripes
  - Dots
  - Grid
  - Cross lines
- Angles for gradients / patterns:
  - 0°
  - 45°
  - 90°
  - 135°
  - 180°
  - 225°
  - 270°
  - 315°
- Chat title text colour configurable
- Send button text freely definable
- Clear chat text freely definable
- Clear chat button text colour configurable
- Input placeholder text freely definable
- Logo / image in header can be uploaded or embedded via URL
- Background image can be applied only to the chat history / message area
- Box shadow can be enabled / disabled
- Source badges at the end of responses can be enabled / disabled
- Microphone button can be enabled in the chat
  - in Free: simple speech input / voice recording only
  - no real live conversation with AI response voice

2. Functions
- 1 active bot per website
  - Bot 1 usable
- Models in Free:
  - gpt-4o-mini
  - gpt-4.1-mini
- Bot settings per bot:
  - bot active / inactive
  - chat title
  - model selection within the Free limit
  - welcome message
  - system prompt
- PDF generation: no
- Image generation: no
- Web search: no
- Website knowledge: no
- Knowledge files:
  - up to 1 knowledge file per bot
- Popup function for Bot 1 available
  - as a collapsible floating chat window
  - positions:
    - bottom right
    - bottom left
    - top right
    - top left
  - display:
    - on all allowed pages
    - or only on selected pages/posts
  - opens automatically by default only on desktop
- Speech input:
  - browser-based microphone recording
  - no realtime voice conversation with AI voice
- Chat logs: no
- Multiple active bots: no
- Bot duplication: no
- Deletion of dynamically created bots: no
- Licence tab available
  - in a true Free build, no licence required

==================================================
PRO VERSION
==================================================

1. Design settings
- All design settings from the Free version
- additionally for voice functions:
  - live conversation can be enabled
  - response voice selectable:
    - female
    - male
- Microphone button can start a real voice conversation with AI
- Realtime voice mode can be enabled separately in the backend

2. Functions
- 2 active bots per website
  - Bot 1 and Bot 2 usable
- Models in Pro:
  - gpt-4o-mini
  - gpt-4o
  - gpt-4.1-mini
  - gpt-4.1
  - gpt-5-mini
  - gpt-5.1
  - gpt-5.3
  - gpt-5.4
- Bot settings per bot:
  - bot active / inactive
  - chat title
  - full model selection from the premium model set
  - welcome message
  - system prompt
- Image generation can be enabled per bot
- PDF generation can be enabled per bot
  - reacts to requests such as /pdf, “create a PDF”, “export as PDF”
  - download link to the generated PDF appears in the chat
- Web search can be enabled per bot
- Website knowledge can be enabled per bot
  - full website content
  - or selected pages/posts only
- Knowledge files:
  - significantly expanded
  - technical internal code limit: 999 files per bot
- Popup function for Bot 1 available
- Speech / voice:
  - microphone button
  - live conversation with OpenAI Realtime
  - AI response as audio
  - response voice selectable: female / male
- Chat logs available
  - local storage in the WordPress backend
  - log retention configurable: 1 to 180 days
  - default value: 30 days
  - CSV export available
  - search / filter in the log area available
  - individual log entries can be deleted
- Multiple active bots: yes, up to 2
- Bot duplication: no
- Deletion of dynamically created bots: no
- Backend licence activation:
  - licence field
  - activate / deactivate
  - status display

==================================================
EXPERT VERSION
==================================================

1. Design settings
- All design settings from the Pro version
- no additional design logic compared to Pro identifiable in the code
- Expert mainly extends multi-bot management and bot administration

2. Functions
- up to 20 active bots per website
- By default, Bot 1 to Bot 5 are created in the plugin
- Additional bots can be created via duplication
- Plus tab available in the backend
  - duplicates the currently active bot into a new bot tab
- Dynamic bot duplication up to a maximum of 20 total bots
- Dynamically created bots above Bot 5 can be deleted again
- Models in Expert:
  - gpt-4o-mini
  - gpt-4o
  - gpt-4.1-mini
  - gpt-4.1
  - gpt-5-mini
  - gpt-5.1
  - gpt-5.3
  - gpt-5.4
- All premium functions from Pro are additionally available:
  - image generation
  - PDF generation
  - web search
  - website knowledge
  - extended knowledge files
  - chat logs
  - live conversation
  - response voice female / male
- Suitable for larger multi-bot setups on one website
- Popup function still intended only for Bot 1
- Knowledge files:
  - technical internal code limit: 999 files per bot
- Multiple bot configurations can be managed in parallel
- Extended internal bot management:
  - duplicate bot
  - delete dynamic bots
  - larger multi-bot workflow

==================================================
ADDITIONAL TECHNICAL SHORT NOTES ON v3.0.0
==================================================

Design / Frontend
- Default width: 100%
- Default message area height: 420px
- Default chat window radius: 18px
- Default input field radius: 22px
- Default border thickness: 1px
- Default input placeholder: “Ask any question”
- Default send button: “Send”
- Default clear text: “Clear chat”

Bots / Content
- 5 bot tabs are created in the plugin by default
- By default, only Bot 1 is active
- Default system prompt:
  - “You are a helpful assistant on a WordPress website.”
- Default welcome message:
  - “Hello! How can I help?”
- Configurable per bot:
  - active / inactive
  - title
  - model
  - welcome message
  - system prompt
  - daily limits
  - knowledge sources
  - popup settings (Bot 1)
  - image generation
  - PDF generation

Knowledge sources
- Knowledge files per bot
- Website content can be used
- Selection either:
  - entire website
  - selected pages/posts only
- Selectable website content in the backend:
  - published pages
  - published posts

Knowledge file uploads
- accepted formats:
  - Markdown
  - TXT
  - CSV
- Files can be set active / inactive
- Files can be deleted in the backend
- File status visible:
  - saved / missing
  - file type
  - file size
  - upload timestamp

Output / response formats
- text responses
- structured text formatting
- table display
- code blocks
- image output with download link
- PDF output with download link
- source badges at the end of the response

Voice / Speech
- Browser-based speech input
- Realtime voice session with audio response in Pro/Expert
- Code indicates fluent standard German in live voice mode

Logs / Privacy
- own log table in the WordPress database
- automatic deletion after the defined retention period
- configurable range: 1 to 180 days
- CSV export available

Licence / Edition
- Premium build contains licence area
- Activation / deactivation against EDD intended
- Plan detection in code:
  - Free
  - Pro
  - Expert
- Without a valid premium licence, the feature set falls back to Free

Short conclusion v3.0.0
- Free = 1 bot, basic chat, basic voice input, reduced model set, no premium sources/features
- Pro = 2 bots, full model set, image/PDF/web search/website knowledge/logs/live voice
- Expert = Pro + multi-bot workflow with duplication and up to 20 bots in total