Shihela Contextual Site Assistant

Description

Shihela Contextual Site Assistant is a highly performant and context-aware chat assistant designed for WordPress sites. It embeds a sleek, floating chat bubble on your website. When a user asks a question, Shihela Contextual Site Assistant extracts context from the current page (e.g., page title, content snippets) and uses the native WordPress 7.0+ AI Client to provide accurate, contextually relevant answers.

Because it utilizes the native WordPress AI Client, credentials and model configurations are managed globally at the site level under Settings Connectors. This ensures maximum security and allows site administrators to change providers seamlessly without editing plugin options.

The plugin also automatically captures leads when visitors leave their contact information (such as name, email, or requirements), saves them securely in your database, and sends email notifications.

Features

  • Context-Aware Responses: Automatically reads page contents to answer questions in context.
  • WordPress Native AI Client: Fully integrated with the native WordPress 7.0+ AI Client API.
  • WhatsApp Admin / CS Integration: Direct WhatsApp contact button in chat and header with dynamic page context pre-filled messages.
  • Modern SaaS Tabbed Admin UI: Sleek, organized 5-tab settings layout for effortless plugin management.
  • Provider Agnostic: Out-of-the-box support for any LLM provider configured in your WordPress dashboard (Gemini, OpenAI, Anthropic, etc.).
  • Lead Capture & Management: Automatically parses and saves customer inquiries in the WordPress database and notifies administrators.
  • Quick Suggestion Chips: Present predefined prompt chips to guide visitor inquiries.
  • Lead CSV Export: Export captured leads to CSV directly from the WordPress Admin table.
  • Developer Hooks & Filters: Extensible action hooks (shihela_assistant_lead_captured) and filters (shihela_assistant_chat_context, shihela_assistant_system_prompt).
  • Custom Positioning & Styling: Set widget position (bottom-right, bottom-left, top-right, top-left) and customize branding colors.
  • Premium Design: Sleek layout featuring glassmorphic effects, responsive styles, typing animation loaders, and chat session histories.
  • Rate Limiting: Built-in server-side IP rate limiting protecting your server and API limits from bot abuse.

Third-Party Services & Data Privacy Notice

This plugin utilizes the native WordPress AI Client to communicate with generative AI models. Depending on your WordPress Core Connectors configuration, user queries and current page text context are transmitted via secure HTTPS API requests to the configured AI provider. No data is stored or logged on external servers managed by this plugin’s author; all captured customer leads are saved locally in your WordPress database.

Screenshots

Installation

  1. Upload the shihela-contextual-site-assistant folder to the /wp-content/plugins/ directory, or search for “Shihela Contextual Site Assistant” via the WordPress plugin dashboard and click Install.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Configure your preferred AI Provider globally in the WordPress admin panel under Settings > Connectors.
  4. Navigate to Shihela Site Assistant in the WordPress admin panel sidebar to customize your chatbot branding, greeting instructions, and quick suggestion chips.
  5. Save changes and the widget will appear on your front-end pages.

FAQ

How does the AI know the page context?

When a chat is initiated, the plugin retrieves the current page ID and queries WordPress for its title and content. Shortcodes, HTML tags, and script/style tags are stripped, and up to 1,000 words of pure text content are sent along with the prompt to provide accurate context.

How does the WhatsApp CS integration work?

When an administrator configures a WhatsApp number under Settings > WhatsApp & CS, the AI automatically detects when a visitor asks for human support or contact details, displaying a “Chat via WhatsApp” button with dynamic page title and URL pre-filled in the message.

Can I choose which AI provider to use?

Yes. You can manage and switch your AI providers globally inside WordPress under Settings > Connectors. This plugin automatically uses whichever model and credits are set as default by the administrator.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Shihela Contextual Site Assistant” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.2.0

  • Added WhatsApp Admin/CS Integration: Support for Admin WhatsApp phone number, custom pre-filled message with page context, and in-chat Click to WA CTA button.
  • Added optional WhatsApp Quick-Access button in chat widget header bar.
  • Redesigned WordPress Admin Settings page into a modern, responsive SaaS-style Tabbed UI (5 organized tabs).
  • Added automated WhatsApp intent detection protocol in system prompt.

1.1.0

  • Enhanced page context extraction: thorough HTML, shortcode, and script/style sanitization prior to word trimming, increased pure-text context reading to 1,000 words.
  • Added Quick Suggestion Chips (Preset Prompts) for visitors.
  • Added Lead Data CSV Export functionality in Admin dashboard.
  • Introduced extensible developer action hooks (shihela_assistant_lead_captured) and filters (shihela_assistant_chat_context, shihela_assistant_system_prompt, shihela_assistant_chat_response).
  • Enhanced accessibility (WCAG 2.1 AA) and performance controls.

1.0.0

  • Initial release of Shihela Contextual Site Assistant widget.
  • Integrated native WordPress 7.0+ AI Client API.
  • Added IP rate limiting and session-based lead capturing.