docs

Ask Adam Documentation

Your complete guide to installing, configuring, and using Ask Adam Pro. Written for non-coders first, with extras for power users.

Quick Navigation
Quick Start Installation Usage Customization Features Troubleshooting

Quick Start (TL;DR)

  1. Install the plugin: Plugins → Add New → Upload ZIP
  2. Activate it: Plugins list
  3. Enter your license key: From your purchase email
  4. (If needed) Add your AI/API key: In Settings
  5. Add the assistant to a page: Use shortcode or widget
Shortcode (one-liner): [ ask_adam ] Widget: Appearance → Widgets → “Ask Adam” → place in Footer/Sidebar

Installation & Setup

  • Install: Go to Plugins → Add New → Upload Plugin, select your ZIP, Install, then Activate
  • License: Open Settings → Ask Adam → License, paste your key, and Save/Activate
  • API/Model: Settings → Ask Adam → Provider. Add your key, pick the model, save
Tip:
If you use a caching plugin, clear cache after activation.

Usage

Shortcode

Paste [ ask_adam ] into any Page or Post.

Works inside Group/Columns blocks and full-width sections.

Widget

Go to Appearance → Widgets and add Ask Adam to your Footer or Sidebar.

You can show the floating widget site-wide and still embed the shortcode on specific pages.

Recommended: Demo Page
Create a Demo page that uses only the shortcode so visitors can try it without distractions.

Customization

Quick CSS Tweaks

Avatar styling:

.ask-adam-avatar{width:48px;height:48px;border-radius:50%}

Card width cap:

.ask-adam-container{max-width:900px;margin:0 auto}

Bubble color:

.ask-adam-launcher{background:#17a2a2}

Hide on mobile:

@media(max-width:768px){.ask-adam-launcher{display:none}}
Custom Styling

Features (High Level)

Vision & Image Analysis (Pro)
Upload images/screenshots for instant explanations and analysis.
Search Assist
Can reference current information when enabled.
Shortcode + Widget
Place it anywhere—landing pages, product pages, or footers.
Access Controls
Optional rate limits, conversation resets, or page-scoped behavior.

Troubleshooting

The assistant doesn’t show up

  • Check that the shortcode is exactly, with no spaces [ ask_adam ]
  • Clear cache (plugin + CDN)
  • Temporarily disable minify/deferral for the assistant script

Stuck “loading”

  • Re-save settings with a valid API/Model key (if required)
  • Check browser console for blocked requests (ad-blockers can interfere)

Looks too wide / too narrow

Add the width cap one-liner to your “Additional CSS”:

.ask-adam-container{max-width:900px;margin:0 auto}

Featured image crowding the top

Twenty Twenty-One can output big header images. Cap width with:

.post-thumbnail img{max-width:900px;width:100%;height:auto;margin:0 auto;display:block}

Changelog

  • 1.0.2 — Added demo helpers, minor UI polish
  • 1.0.1 — Initial stable release
Full History
For complete changelog details, see the plugin readme or changelog file.

Licensing & Refunds

Licensed under GPL with commercial distribution via Freemius.

7-day money-back guarantee on first purchase (see terms for details).

Need More Help?

Have questions not covered here? Our support team is ready to help you succeed with Ask Adam Pro.

✉️ Email Support 📞 Contact Form