Description
Ask Adam Lite makes it easy to add an AI-powered assistant to your WordPress site.
It works out of the box with your own OpenAI API key and provides a simple, standalone solution.
You can display it as a floating widget or drop it into any page or post using a shortcode.
Features in Lite:
– Floating AI chat widget or [ask_adam_lite] shortcode
– Works with your own OpenAI API key (no extra accounts required)
– Basic knowledge base: index up to one sitemap and one priority URL
– Simple admin settings for position, assistant name, and avatar
– Privacy-friendly — no data collection or tracking of your visitors
– Lightweight, fast, and secure — follows WordPress Coding Standards
Need more features?
Ask Adam Lite is fully functional on its own.
If you’d like advanced options such as multiple AI providers, real-time web search, custom chat themes, or multi-profile assistants, those are available in the Pro version at https://www.askadamit.com
External Services
This plugin connects directly to the OpenAI API to generate chat responses and create semantic embeddings for knowledge-base search.
Data sent:
– Text prompts entered by site visitors or admins.
– Optional content indexed by the site owner (titles, excerpts, or text).
– Images uploaded by site visitors (base64-encoded), when vision is used.
Images are sent directly to OpenAI and are never stored on your server
or in the WordPress database.
Destination:
https://api.openai.com
Purpose:
To generate AI responses and semantic vectors for local search.
User data handling:
– No personally identifying information is sent unless a user explicitly types it.
– Site owners control what content is indexed.
– The plugin does not store chat logs or personal data.
Privacy
Ask Adam Lite does not track, log, or store user data.
All AI interactions are handled directly through your OpenAI account.
The plugin is compatible with WordPress privacy guidelines and GDPR when used responsibly.
Installation
- Upload the plugin ZIP file via Plugins Add New Upload Plugin.
- Activate the plugin through the Plugins menu in WordPress.
- Go to Ask Adam Lite Settings and enter your OpenAI API key.
- Use the [ask_adam_lite] shortcode on any page, or enable the floating widget.
FAQ
-
Do I need an OpenAI account?
-
Yes. You’ll need your own OpenAI API key. No additional subscription is required.
-
Does Ask Adam Lite work without Pro?
-
Yes. Lite is a complete standalone version that provides a working AI chat widget and small knowledge base.
-
Is any data sent to your servers?
-
No. All requests go directly from your WordPress site to OpenAI’s API. No data is stored or transmitted anywhere else.
-
How do I upgrade to Pro?
-
Pro adds support for multiple AI providers, web search, custom themes, and multi-profile assistants.
Learn more at https://www.askadamit.com
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Ask Adam Lite” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Ask Adam Lite” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.0.0
- Architecture: Introduced centralized Ask_Adam_Lite_Model_Config class
as the single source of truth for all model identifiers, API endpoints,
and response normalization. No hardcoded model strings remain in
business logic. - GPT-5 Support: Full OpenAI Responses API support for GPT-5 and later
models. Endpoint routing is automatic based on model prefix. Legacy
Chat Completions API continues to work for GPT-4o and earlier. - Vision: Image upload support added to both the floating widget and the
[ask_adam_lite] shortcode embed. Accepts JPEG, PNG, GIF, and WebP up
to 5MB. Images are transmitted directly to OpenAI — never written to
disk or stored in the WordPress database. - Reasoning Models: o1 and o3 models now correctly use
max_completion_tokens and omit unsupported parameters (temperature,
max_tokens) that cause API 400 errors on those model families. - Knowledge Base: Embedding model is now configurable via WordPress
options. Admin warning displayed when the active embedding model
differs from the model used during the last index build. Sites
upgraded from 1.x are automatically backfilled on activation so the
mismatch warning appears correctly. - Knowledge Base: Partial-batch embedding protection — the indexed model
option is only recorded after all chunks are fully embedded, preventing
the mismatch warning from clearing prematurely on large sites. - Knowledge Base: Database chunk COUNT query moved outside the insert
loop — eliminates a full table scan on every chunk insert during crawl. - Knowledge Base: All timestamps now stored in UTC via
current_time(‘mysql’, true) for consistency across timezone changes. - Localization: Shared wp_localize_script data extracted into a single
static method (get_widget_l10n()) called by both enqueue_front() and
the shortcode — eliminates risk of the two diverging. - Security: Removed unnecessary jQuery dependency from front-end script.
- Security: Inline widget styles moved from PHP footer output into the
enqueued widget stylesheet — passes WordPress Plugin Check. - Security: Inline onclick attribute removed from FAB button — event
wired via existing inline script registration instead. - Security: Missing translators comments added to all sprintf/__()
calls containing placeholders. - Security: All output escaping audited — esc_attr() applied at output,
not at assignment, to prevent double-escaping. - Bug Fix: Admin CSS filename mismatch corrected (adam-admin.css vs
admin.css) — admin styles now load reliably on all server
configurations. - Bug Fix: Shortcode embed now correctly injects REST URL and nonce via
wp_localize_script even when the floating widget is disabled. - Bug Fix: Uninstall routine consolidated into uninstall.php — the
duplicate function in ask-adam-lite.php removed. All plugin options
including the five new model options are fully cleaned up on removal. - Bug Fix: Global variables in uninstall.php prefixed with aalite_ to
comply with WordPress naming conventions. - Compliance: All changes pass WordPress Coding Standards (WPCS),
Plugin Check, and PHP 7.4+ compatibility requirements.
1.0.5
- Compatibility: Fully tested with WordPress 6.9.
- Maintenance: General cleanup and version bump for WP.org.
1.0.4
- Assets: Added WordPress.org banner and icon.
- Deployment: Added GitHub Actions workflow for automatic WP.org deployment.
- Polish: Minor UI cleanup and improved file organization.
1.0.3
- UI Improvements: Refined floating chat widget for better alignment.
- Accessibility: Added Escape key to close the widget and improved ARIA states.
- Stability: Simplified inline JavaScript for reliable open/close behavior.
- CSS Cleanup: Reduced redundant selectors and fixed FAB centering.
- Compliance: Removed powered-by and credit links from all front-end displays.
- Encoding Fix: Normalized placeholder text and labels to plain UTF-8.
- Code Quality: Removed unused markup and improved escaping.
1.0.2
- Sanitized input handling and improved database cleanup.
- Fixed inline script handling and added proper versioning to enqueue calls.
- Resolved WordPress Coding Standards issues and improved uninstall routine.
1.0.1
- Improved shortcode rendering and widget script loading.
- General cleanup for WordPress.org compliance.
1.0.0
- Initial release.
