{"id":254803,"date":"2025-10-26T17:50:57","date_gmt":"2025-10-26T17:50:57","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ask-adam-lite\/"},"modified":"2026-05-18T10:52:09","modified_gmt":"2026-05-18T10:52:09","slug":"ask-adam-lite","status":"publish","type":"plugin","link":"https:\/\/test.wordpress.org\/plugins\/ask-adam-lite\/","author":18772735,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.0.0","stable_tag":"2.0.0","tested":"6.9.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Ask Adam Lite","header_author":"Ask Adam","header_description":"Free AI chat widget + mini knowledge base (1 sitemap + 1 priority URL) using OpenAI.","assets_banners_color":"b6b1ed","last_updated":"2026-05-18 10:52:09","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":387,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.4":{"tag":"1.0.4","author":"jackofall1232","date":"2025-10-26 17:50:39"},"1.0.5":{"tag":"1.0.5","author":"jackofall1232","date":"2025-12-03 13:18:08"},"2.0.0":{"tag":"2.0.0","author":"jackofall1232","date":"2026-05-18 10:52:09"}},"upgrade_notice":{"2.0.0":"

IMPORTANT: If you use the Knowledge Base feature, you must re-run Crawl\nand Embed from the Knowledge Base tab after upgrading. The embedding\narchitecture has changed and existing indexes need to be rebuilt.\nThis release also adds image\/vision support, GPT-5 compatibility, and\nfixes several Plugin Check compliance issues. Recommended for all users.<\/p>","1.0.5":"

Tested for compatibility with WordPress 6.9. Recommended update for all users.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3409548,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3409548,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.4","1.0.5","2.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Floating chat widget on a WordPress site","2":"Shortcode embed example","3":"Lite settings panel in WordPress admin"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2353,1320,2364,194533],"plugin_category":[],"plugin_contributors":[249752],"plugin_business_model":[],"class_list":["post-254803","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-assistant","plugin_tags-chatbot","plugin_tags-openai","plugin_contributors-jackofall1232","plugin_committers-jackofall1232"],"banners":{"banner":"https:\/\/ps.w.org\/ask-adam-lite\/assets\/banner-772x250.png?rev=3409548","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/ask-adam-lite\/assets\/icon-256x256.png?rev=3409548","icon_2x":"https:\/\/ps.w.org\/ask-adam-lite\/assets\/icon-256x256.png?rev=3409548","generated":false},"screenshots":[],"raw_content":"\n

Ask Adam Lite makes it easy to add an AI-powered assistant to your WordPress site.\nIt works out of the box with your own OpenAI API key and provides a simple, standalone solution.\nYou can display it as a floating widget or drop it into any page or post using a shortcode.<\/p>\n\n

Features in Lite:\n- Floating AI chat widget or [ask_adam_lite] shortcode\n- Works with your own OpenAI API key (no extra accounts required)\n- Basic knowledge base: index up to one sitemap and one priority URL\n- Simple admin settings for position, assistant name, and avatar\n- Privacy-friendly \u2014 no data collection or tracking of your visitors\n- Lightweight, fast, and secure \u2014 follows WordPress Coding Standards<\/p>\n\n

Need more features?\nAsk Adam Lite is fully functional on its own.\nIf you\u2019d 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<\/p>\n\n

External Services<\/h3>\n\n

This plugin connects directly to the OpenAI API to generate chat responses and create semantic embeddings for knowledge-base search.<\/p>\n\n

Data sent:\n- Text prompts entered by site visitors or admins.\n- Optional content indexed by the site owner (titles, excerpts, or text).\n- Images uploaded by site visitors (base64-encoded), when vision is used.\n Images are sent directly to OpenAI and are never stored on your server\n or in the WordPress database.<\/p>\n\n

Destination:\nhttps:\/\/api.openai.com<\/p>\n\n

Purpose:\nTo generate AI responses and semantic vectors for local search.<\/p>\n\n

User data handling:\n- No personally identifying information is sent unless a user explicitly types it.\n- Site owners control what content is indexed.\n- The plugin does not store chat logs or personal data.<\/p>\n\n

Privacy<\/h3>\n\n

Ask Adam Lite does not track, log, or store user data.\nAll AI interactions are handled directly through your OpenAI account.\nThe plugin is compatible with WordPress privacy guidelines and GDPR when used responsibly.<\/p>\n\n\n

    \n
  1. Upload the plugin ZIP file via Plugins \u2192 Add New \u2192 Upload Plugin.<\/li>\n
  2. Activate the plugin through the Plugins menu in WordPress.<\/li>\n
  3. Go to Ask Adam Lite \u2192 Settings and enter your OpenAI API key.<\/li>\n
  4. Use the [ask_adam_lite] shortcode on any page, or enable the floating widget.<\/li>\n<\/ol>\n\n\n
    \n

    Do I need an OpenAI account?<\/h3><\/dt>\n

    Yes. You\u2019ll need your own OpenAI API key. No additional subscription is required.<\/p><\/dd>\n

    Does Ask Adam Lite work without Pro?<\/h3><\/dt>\n

    Yes. Lite is a complete standalone version that provides a working AI chat widget and small knowledge base.<\/p><\/dd>\n

    Is any data sent to your servers?<\/h3><\/dt>\n

    No. All requests go directly from your WordPress site to OpenAI\u2019s API. No data is stored or transmitted anywhere else.<\/p><\/dd>\n

    How do I upgrade to Pro?<\/h3><\/dt>\n

    Pro adds support for multiple AI providers, web search, custom themes, and multi-profile assistants.\nLearn more at https:\/\/www.askadamit.com<\/p><\/dd>\n\n<\/dl>\n\n\n

    2.0.0<\/h4>\n\n
      \n
    • Architecture: Introduced centralized Ask_Adam_Lite_Model_Config class\nas the single source of truth for all model identifiers, API endpoints,\nand response normalization. No hardcoded model strings remain in\nbusiness logic.<\/li>\n
    • GPT-5 Support: Full OpenAI Responses API support for GPT-5 and later\nmodels. Endpoint routing is automatic based on model prefix. Legacy\nChat Completions API continues to work for GPT-4o and earlier.<\/li>\n
    • Vision: Image upload support added to both the floating widget and the\n[ask_adam_lite] shortcode embed. Accepts JPEG, PNG, GIF, and WebP up\nto 5MB. Images are transmitted directly to OpenAI \u2014 never written to\ndisk or stored in the WordPress database.<\/li>\n
    • Reasoning Models: o1 and o3 models now correctly use\nmax_completion_tokens and omit unsupported parameters (temperature,\nmax_tokens) that cause API 400 errors on those model families.<\/li>\n
    • Knowledge Base: Embedding model is now configurable via WordPress\noptions. Admin warning displayed when the active embedding model\ndiffers from the model used during the last index build. Sites\nupgraded from 1.x are automatically backfilled on activation so the\nmismatch warning appears correctly.<\/li>\n
    • Knowledge Base: Partial-batch embedding protection \u2014 the indexed model\noption is only recorded after all chunks are fully embedded, preventing\nthe mismatch warning from clearing prematurely on large sites.<\/li>\n
    • Knowledge Base: Database chunk COUNT query moved outside the insert\nloop \u2014 eliminates a full table scan on every chunk insert during crawl.<\/li>\n
    • Knowledge Base: All timestamps now stored in UTC via\ncurrent_time('mysql', true) for consistency across timezone changes.<\/li>\n
    • Localization: Shared wp_localize_script data extracted into a single\nstatic method (get_widget_l10n()) called by both enqueue_front() and\nthe shortcode \u2014 eliminates risk of the two diverging.<\/li>\n
    • Security: Removed unnecessary jQuery dependency from front-end script.<\/li>\n
    • Security: Inline widget styles moved from PHP footer output into the\nenqueued widget stylesheet \u2014 passes WordPress Plugin Check.<\/li>\n
    • Security: Inline onclick attribute removed from FAB button \u2014 event\nwired via existing inline script registration instead.<\/li>\n
    • Security: Missing translators comments added to all sprintf\/__()\ncalls containing placeholders.<\/li>\n
    • Security: All output escaping audited \u2014 esc_attr() applied at output,\nnot at assignment, to prevent double-escaping.<\/li>\n
    • Bug Fix: Admin CSS filename mismatch corrected (adam-admin.css vs\nadmin.css) \u2014 admin styles now load reliably on all server\nconfigurations.<\/li>\n
    • Bug Fix: Shortcode embed now correctly injects REST URL and nonce via\nwp_localize_script even when the floating widget is disabled.<\/li>\n
    • Bug Fix: Uninstall routine consolidated into uninstall.php \u2014 the\nduplicate function in ask-adam-lite.php removed. All plugin options\nincluding the five new model options are fully cleaned up on removal.<\/li>\n
    • Bug Fix: Global variables in uninstall.php prefixed with aalite_ to\ncomply with WordPress naming conventions.<\/li>\n
    • Compliance: All changes pass WordPress Coding Standards (WPCS),\nPlugin Check, and PHP 7.4+ compatibility requirements.<\/li>\n<\/ul>\n\n

      1.0.5<\/h4>\n\n
        \n
      • Compatibility: Fully tested with WordPress 6.9.<\/li>\n
      • Maintenance: General cleanup and version bump for WP.org.<\/li>\n<\/ul>\n\n

        1.0.4<\/h4>\n\n
          \n
        • Assets: Added WordPress.org banner and icon.<\/li>\n
        • Deployment: Added GitHub Actions workflow for automatic WP.org deployment.<\/li>\n
        • Polish: Minor UI cleanup and improved file organization.<\/li>\n<\/ul>\n\n

          1.0.3<\/h4>\n\n
            \n
          • UI Improvements: Refined floating chat widget for better alignment.<\/li>\n
          • Accessibility: Added Escape key to close the widget and improved ARIA states.<\/li>\n
          • Stability: Simplified inline JavaScript for reliable open\/close behavior.<\/li>\n
          • CSS Cleanup: Reduced redundant selectors and fixed FAB centering.<\/li>\n
          • Compliance: Removed powered-by and credit links from all front-end displays.<\/li>\n
          • Encoding Fix: Normalized placeholder text and labels to plain UTF-8.<\/li>\n
          • Code Quality: Removed unused markup and improved escaping.<\/li>\n<\/ul>\n\n

            1.0.2<\/h4>\n\n
              \n
            • Sanitized input handling and improved database cleanup.<\/li>\n
            • Fixed inline script handling and added proper versioning to enqueue calls.<\/li>\n
            • Resolved WordPress Coding Standards issues and improved uninstall routine.<\/li>\n<\/ul>\n\n

              1.0.1<\/h4>\n\n
                \n
              • Improved shortcode rendering and widget script loading.<\/li>\n
              • General cleanup for WordPress.org compliance.<\/li>\n<\/ul>\n\n

                1.0.0<\/h4>\n\n
                  \n
                • Initial release.<\/li>\n<\/ul>","raw_excerpt":"Ask Adam Lite is a secure, minimal AI chat widget and lightweight knowledge base for WordPress.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/254803","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=254803"}],"author":[{"embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/jackofall1232"}],"wp:attachment":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=254803"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=254803"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=254803"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=254803"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=254803"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=254803"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}