KimaAI | AI Chatbot, ChatGPT content writer and more

Contributors: nabiabdi

Donate link: https://kimaai.com

License: GPLv3

License URI: http://www.gnu.org/licenses/gpl.html

Tags: ai, chatbot, translate, artificial intelligence, assistant

Requires at least: 6.0

Tested up to: 6.9

Requires PHP: 8.0

Stable tag: 1.4.8

KimaAI is the first true all-in-one AI plugin for WordPress.

Description

KimaAI brings modern AI features to WordPress by connecting your site to AI providers (like OpenAI) and exposing them through an easy-to-configure chatbot and a growing set of AI tools.

With KimaAI you can:

  • Build a customizable chatbot with model/provider selection, content awareness, quick actions, and an optional attention popover.
  • Add a vector database search tool and multilingual embeddings to power smarter, language-aware answers.
  • Collect chatbot feedback to understand response quality and improve your on-site experience over time.
  • Use a setup wizard to get started quickly, plus a settings system designed to be maintainable and extensible.
  • Extend KimaAI via developer hooks/filters to register and control custom tools and tool execution.

KimaAI is built to stay flexible: it works for non-technical users who want a powerful chatbot, and it also provides hooks and internal APIs for developers who want to integrate AI deeper into their workflows.

Please make sure to carefully read the [Disclaimer](https://kimaai.com/disclaimer/) before using the plugin, check the [KimaAI](https://kimaai.com) website for more information. Thank you!

Features

  • AI Chatbot: provider/model selection, content awareness, quick actions, and UI customization.
  • Setup Wizard: guided first-time configuration.
  • Vector Search: vector DB search tool + embeddings to improve answers.
  • Multilingual-ready: multilingual embeddings and translatable dynamic settings (Polylang/WPML).
  • Feedback: collect user feedback on chatbot responses.
  • Developer hooks: register custom tools and control/observe tool calls.
  • More features coming soon!

My Vision for AI

AI is incredible, no doubt about it. It’s changing everything—from the way we work to the way we create. But for me, AI isn’t just about churning out endless content or automating everything for the sake of it. I want to see AI being used thoughtfully—as a tool that actually helps people.

I dream of an AI-driven world where creators can focus on their ideas instead of struggling with words, where language barriers don’t hold anyone back, and where tedious work is handled for us so we can spend more time on what really matters—our passions, our families, and just enjoying life.

I’ll always push for AI to be used in a way that empowers rather than overwhelms. Hope you’re with me on this! 💡💙

Disclaimer

KimaAI is a plugin that helps you to connect your websites to AI services. You need your own API keys and must follow the rules set by the AI service you choose. For OpenAI, check their [Terms of Service](https://openai.com/terms/) and [Privacy Policy](https://openai.com/privacy/). It is also important to check your usage on the [OpenAI website](https://platform.openai.com/usage) for accurate information. Please do so with other services as well.

The developer of KimaAI and related parties are not responsible for any issues or losses caused by using the plugin or AI-generated content. You should talk to a legal expert and follow the laws and regulations of your country. KimaAI does only store data on your own server, and it is your responsibility to keep it safe. KimaAI's full disclaimer is [here](https://kimaai.com/disclaimer/).

Installation

1. Upload the plugin files to the `/wp-content/plugins/kimaai` directory, or install the plugin through the WordPress plugins screen directly.

2. Activate the plugin through the 'Plugins' screen in WordPress

3. Create an account on OpenAI and get your API key

4. Use the Settings->KimaAI screen to configure the plugin and add your API key

5. Use the KimaAI chatbot on your website

6. Enjoy! 🚀 – Do not forget to keep an eye on [your OpenAI usage](https://platform.openai.com/usage)! 📊

Frequently Asked Questions

How do I get an API key?

You can get an API key from OpenAI by creating an account on their website. Check the [OpenAI website](https://openai.com) for more information.

Screenshots

1. KimaAI Chatbot widget on the website in different states

2. AI Provider and Environment settings

3. AI Presets settings

4. Chatbot Appearance settings

5. Chatbot Behavior settings

6. Chatbot Advanced settings

7. Chatbot Tools settings

8. Chatbot Quick Actions settings

9. Function Calling settings

10. Embedding settings

11. Playground Image Generation

12. Playground Image History

13. Playground Detailed Image View

Changelog

1.4.8 (April 06, 2026)

  • Added settings to allow users to choose post types for content awareness in the chatbot settings.
  • Added a debugging panel in the chatbot history and feedback analysis dashboards to show the raw AI response and request payload for each entry for easier debugging and insights.
  • Added chatbot history bulk delete action for easier cleanup of old histories.
  • Added copy to clipboard button for the AI response in the chatbot widget.
  • Added the ability to add avatar image for the AI and user in the chatbot settings.
  • Added WooCommerce integration to allow the chatbot to access product information and assist users with product-related queries.
  • Added WooCommerce Product Recommendation tool for the chatbot to suggest relevant products to users based on their queries and interactions.
  • Added WooCommerce Product Similar tool for the chatbot to find and suggest similar products based on a given product or user query.
  • Added WooCommerce Product Card tool for the chatbot to display product information in a visually appealing card format within the chat interface.
  • Added multi language support WooCommerce integration to allow the chatbot to assist users in different languages based on the site's language settings (using WPML or Polylang).
  • Improved the feedback analysis dashboard UI and allow more detailed insights by showing the related message and user information and debugging panel for each feedback entry.
  • Improved export settings security by removing the sensitive data from the exported file by default and adding an option to include them if needed.
  • Improved chatbot history by showing the histories by sessions instead of raw messages for better readability and insights.
  • Fixed offset setting not being shown correctly in settings dashboard.
  • Fixed Qdrant query calls and results.
  • Fixed layout issues while using the CodeMirror in the settings page.
  • Fixed import/export preview settings height.
  • Fixed some minor issues in chatbot API communication.

1.4.7 (March 13, 2026)

  • Added status report to the WordPress site health section to find and troubleshoot bugs and issues related to KimaAI.
  • Added log level setting to control the verbosity of the plugin logs for easier debugging and monitoring.
  • Restrict content awareness to published public posts and pages.
  • Updated chatbot default instructions for easy configuration.
  • Fixed some styling issues in the chatbot widget and settings page.]
  • Fixed rest_cookie_invalid_nonce error for non-logged-in users when the site has a caching plugin.
  • Secure the chatbot inputs to prevent XSS vulnerabilities.

1.4.6 (March 06, 2026)

  • Added export/import settings feature to the settings page for easier backup and migration of plugin configurations.
  • Ensured we have a default collection named after the domain during test connection.
  • Fixed some minor issues and styling in the settings page and chatbot widget.

1.4.5 (February 23, 2026)

  • Added open link action type for quick-actions
  • Centralized sanitization/validation by removing `sanitize_callback` and `validate_callback` from field definitions across all config files (playground.php, embedding.php, chatbot.php, aiServices.php)
  • Updated Settings.php to handle `number`, `float`, and `url` types in centralized sanitization logic
  • Refactored usePlaygroundChat React hook to avoid mutating settings and simplified code structure
  • Changed sticky positioning in FieldRenderer component and removed loading state display in Layout component for better UX

1.4.4 (February 20, 2026)

  • Added loading states for quick actions to show typing indicators while actions are being fetched
  • Implemented logic to hide feedback buttons on the latest bot message while it's being streamed or loaded
  • Updated chatbot greeting configuration to support HTML formatting via TextareaField with wp_kses_post sanitization
  • Made minor styling adjustments (reduced popover max-width, smaller font sizes, removed unnecessary !important flags)

1.4.3 (February 19, 2026)

  • feat(chatbot): smooth-scroll to feedback textarea on thumbs-down (#210)
  • fix: embedding bulk sync (#204)
  • fix: chatbot widget UI UX (#205)
  • fix: quick action button trigger before GDPR accept (#206)
  • fix: full screen on mobile size (#207)
  • fix(a11y): send on enter in chatbot widget (#208)
  • fix(chatbot): move textarea caret to end after quick action prefill (#209)
  • fix: chat message feedback textarea bg color on active state.

1.4.2 (February 09, 2026)

  • feat: add embedding multilingual feature (#197)
  • feat: add `kimaai_chatbot_should_load` hook to allow/deny chatbot loading based on custom logic.
  • feat: add Powered by KimaAI branding to the chatbot footer with a link to the website.
  • chore: refactor embed presets (removed and replaced with embed env) (#200)
  • fix: embedding bulk sync (#198)

1.4.1 (February 04, 2026)

  • feat: add reasoning effort and verbosity for reasoning models (#186)
  • feat: add streaming support.
  • chore: refactored chatbot class and chatbot ui code structure for better maintainability.

1.4.0 (January 30, 2026)

Added

  • feat: added `kimaai_tools_registry` filter to register custom tools.
  • feat: added `kimaai_tool_call_allowed` filter to allow/deny tool calls based on custom logic.
  • feat: added `kimaai_tool_execute` action that is triggered when a tool is executed.
  • feat: added setup wizard for first-time users.
  • feat: added chatbot feedback mechanism to collect user feedback on chatbot responses.
  • feat: added multilingual embedding support.
  • feat: added vector DB search tool for the chatbot.
  • feat: made dynamic settings translatable via Polylang and WPML.
  • feat: added configurable quick actions to the chatbot interface.
  • feat: added attention popover before opening the chatbot for the first time to inform the user about the chatbot in the website.

Changed / Improved

  • chore: refactored Ai related classes to improve maintainability.
  • chore: refactored settings API.

Fixed

  • fix: call to undefined function issue when `mb_strcut` is not available.
  • fix: playground with the new endpoints.
  • fix: content-awareness in Gutenberg content.
  • fix: chatbot widget overall visual issues.

1.3.9 (December 15, 2025)

Changed / Improved

  • chore: separated the internal link suggestions part into its own add-on.
  • chore: increased the AI call timeout to 300 seconds.

Fixed

  • fix: initial save for dependent options.

1.3.7 (December 13, 2025)

Added

  • Feature: add chatbot preview in the settings page.
  • Feature: add add-on API for third-party integrations.
  • Feature: add vector DB support for chatbot and AI Assistant.

Changed / Improved

  • Chore: tested with WordPress 6.9.
  • Chore: updated Freemius WP SDK to 2.13.0 version.
  • Chore: updated all node dependencies to their latest versions.

Fixed

  • fix: function calling was using wrong setting id and hook.
  • fix: refactored pro features to use proper DI architecture.
  • fix: hide unnecessary notices from third-party plugins in the settings page.

1.3.6

Added

  • Feature: add support for GPT 5 models.

1.3.5

Added

  • Feature: add support for gpt-image-1 model arguments.
  • Dev: added `kimaai_chatbot_theme` filter to customize chatbot theme colors.
  • Dev: added `kimaai_chatbot_prompt` filter to customize chatbot prompt before sending to AI.
  • Dev: added `kimaai_chatbot_gate` filter to allow/deny chatbot sending messages (`kimaai_chatbot_allowed` is now deprecated).
  • Dev: added `kimaai_chatbot_blocked` action that is triggered when a message is blocked by the gate.
  • Dev: added `kimaai_chatbot_rate_limited` action that is triggered when a message is rate limited.
  • Dev: added `kimaai_chatbot_tools_registry` filter to customize the chatbot tools registry.
  • Dev: added `kimaai_chatbot_ai_payload` filter to customize the final AI payload before sending to the AI service.
  • Dev: added `kimaai_chatbot_before_request` action that is triggered before sending the request to the AI service.
  • Dev: added `kimaai_chatbot_response_payload` filter to customize the AI response payload before processing.
  • Dev: added `kimaai_chatbot_after_response` action that is triggered after receiving the response from the AI service.
  • Dev: added `kimaai_chatbot_default_tools` filter to customize the default tools used by the chatbot.

Changed / Improved

  • Chore: refactored DI container registration and code structure for better maintainability.

1.3.4

Added

  • Settings page: added date and time picker field (#71)

Fixed

  • Settings page: fixed TextareaField to support isComingSoon
  • Settings page: fixed ToggleField by removing the extra {…props}
  • Settings page: fixed option save and load the correct settings (#70)
  • Settings page: fixed load Woo action-scheduler package

1.3.3

Added

  • Feature: function calling support for the chatbot (Pro feature) (#68).

Updated

  • Chore: updated freemius WP SDK to 2.12.2 version.

Fixed

  • DevOps: fixed WordPress playground test to pass.
  • Settings page: fixed responsive layout issue on smaller screens.
  • Settings page: fixed pro feature badge.
  • Settings page: fixed ToggleField to pass the extra props.

1.3.2

Added

  • Feature: add 4 more chatbot icons (#63)
  • Feature: add markdown format for chatbot (#66)
  • Feature(pro): add custom chatbot icon (#64)
  • Feature(pro): add custom offset for chatbot (#65)

Fixed

  • Setting page: SelectField to show the onlyPremium message for PRO features
  • Setting page: empty repeatable fields are being saved (#67)

1.3.1

Added

  • Embedding indexing support (Pro feature)

1.3.0

Added

  • Settings page: ability to show/hide API keys inside the text field for better security (#61)

1.2.9

Fixed

  • Chatbot: max message numbers to be based on IP not session id (#60)
  • Chatbot: position in RTL mode
  • Fixed Persian translation for some strings

1.2.8

Fixed

  • chatbot: style issues in RTL mode

1.2.7

Fixed

  • Build script in package.json file

1.2.6

Fixed

  • Build script in package.json file

1.2.5

Added

  • Persian language and RTL support. (#58)
  • Chatbot: GDPR Consent setting. (#56)
  • Chatbot: content awareness. (#46)
  • Chatbot: clear history button with in-button loading time. (#48)
  • Chatbot moderation: banned words option. (#51)
  • Chatbot moderation: banned IPs option. (#52)
  • Settings: test API keys connection from the settings page. (#54)
  • Settings: WP admin notices, including “no API key” notice. (#53)
  • Settings: reset-to-default for the color picker option.
  • Settings: disclaimer text (also shown in the chatbot footer). (#43)
  • AI Image: support for `gpt-image-1` model. (#42)
  • DevOps: Freemius deployer. (#41)

Changed / Improved

  • Settings page redesigned and reorganized for better UX. (#57)
  • Refactored `AiService` for improved robustness. (#50)
  • UI: show chat position and chat icon settings side by side.
  • General UI polish on settings (spacing and paddings).

Fixed

  • Repeatable fields deletion issue. (#55)
  • Conflict between chatbot setting fields.
  • Chatbot spacing when positioned on the left in fullscreen.
  • “Test connection” button colors for different states.

Removed

  • Legacy/unused code. (#59)

1.2.4

Fixed

  • Freemius SDK integration conflict with free version

1.2.3

Added

  • Freemius SDK integration to enable selling a Pro version. (#38)
  • Premium features bundle. (#39)
  • Support for reasoning models (e.g., o3/o4) in the chatbot.
  • Fullscreen button/function for the chatbot.
  • Settings: maximum number of chatbot messages.
  • Settings: max input length for the chatbot.
  • Settings: max context length for content awareness. (#33)
  • Settings: ability to order tabs via `order` key in schema. (#34)
  • Options storage: save options in separate keys using `save_key`. (#36)
  • Dynamic settings compatibility: schema changes won’t break existing settings. (#37)
  • Playground Image History: search capability.
  • Playground Image History: JSON beautify.
  • Backend display: `JsonBlock` to highlight code/data.

Changed / Improved

  • AI call pipeline refactor for simplicity and reliability. (#32)
  • Single-call response parser added.
  • Request logging now uses `JSON_UNESCAPED_UNICODE` to properly log Persian/Arabic text.

Fixed

  • Plugin ZIP script made compatible with the WP Deploy GitHub Action. (#40)
  • `kimaai-settings` element not present on DOM.
  • Admin menu icon display on submenus.
  • Chatbot width on smaller screens.
  • Removed border on chatbot trigger button with the WP 2025 theme.
  • Repeatable field component clarity.
  • AI model resolver “fixup”.
  • Playground Chatbot: removed history cache to avoid showing previous user messages.

Chore / Maintenance

  • Cleanup old code.
  • Updated plugin version in `package.json`.

1.2.2

Added

  • **Test mode API** for OpenAI Chat Completions and the `Responses` chat endpoints
  • **Initial test suite** for the chatbot (including standalone AI SDK & playground tests)
  • **Logger class** and **backend log‐file viewer**
  • **Chatbot settings** enhancements:
  • Selectable AI provider & model
  • Full suite of color‐customization options
  • **Extensibility hooks**: trigger‐button JS hook and settings‐extension filter

Fixed

  • Default AI engine selection for the **kimaai‑auto‑article** feature
  • Frontend & admin test failures (chatbot and settings APIs)
  • **Log menu** ordering and “Target container is not a DOM element” errors
  • **ShowLogFile** component: color bugs and layout/width issues
  • Chatbot styling glitches (load order, CSS vs SCSS for Tailwind v4)
  • Settings‐saving regressions (v1 & v2)
  • Build/watch and test runner compatibility (`npm run watch`, `wp‑playground` updates)

Changed / Chore

  • Code refactor for AI‑provider & model‑option methods
  • Updated core plugin code (#31) and package‐lock.json
  • Migrated chatbot styles from SCSS to plain CSS (#27)
  • Git housekeeping: merged remote `master`, updated `.gitignore`, added basic playground tests

1.2.1

  • Tested with WordPress 6.8

1.2.0

  • Added Playground AI
  • Added the ability to change the chatbot Model
  • Added the ability to generate images with DALL-E and Replicate

1.1.2

  • Added Persian font to the admin settings page

1.1.1

  • Translated the plugin to Persian

1.1.0

  • Added the chatbot awareness feature

1.0.9

  • Fixed chatbot position issue

1.0.8

  • Updated the plugin title

1.0.7

  • Added the ability to change the chatbot position

1.0.6

  • Added the ability to change the chatbot icon
  • Improved the admin settings page UI – Save Changes button
  • Fixed some issues

1.0.5

  • Added the ability to turn off the chatbot
  • Added `[kimaai_chatbot]` chatbot shortcode
  • Added RTL support
  • Fixed some issues and improved the performance

1.0.4

  • Fixed contributors issue

1.0.3

  • Fixed tag issue

1.0.2

  • Official release on WordPress.org

1.0.1

  • Fixed a few issues reported via official WordPress support

1.0.0

  • Initial release

Upgrade Notice

1.0.0

This is the initial release of KimaAI. Future updates will bring additional features and improvements. Always backup your site before updating.