FAIR

Federated and Independent Repositories

Site Context Chat

Plugin Banner

Site Context Chat

by luciantstoian

Download
Description

Site Context Chat adds a floating AI chat widget to your WordPress site. Visitors get instant answers grounded in your content — not generic ChatGPT small talk. When someone is ready, the bot can hand off a qualified inquiry to your team.

This plugin is the WordPress frontend. You connect it to a Supabase backend (database + edge functions) and your own Anthropic API key. No monthly SaaS fee to us — bring your own keys (BYOK).

Who is this for?

  • Agencies & developers who want a self-hosted, open-source chat stack for client sites
  • Service businesses that want discovery chat + lead handoff, not just a contact form
  • Teams comfortable with a one-time backend setup (~30–45 min) or working with a developer

Features

  • Floating chat widget (dark, light, or auto theme)
  • Chat admin page via shortcode [techlads_chat_admin]
  • Train the bot with markdown site context (services, FAQs, how you work)
  • Conversation history stored in your Supabase database
  • Inquiry / contact handoff when the visitor is ready
  • Embedded step-by-step setup guide in plugin settings
  • Open source — full backend code on GitHub

Important

The chatbot will not reply until you complete the backend setup (Supabase project, SQL migrations, edge functions, API secrets). The plugin settings page includes a full setup guide. Detailed docs: BACKEND-SETUP.md

Not included in this plugin

  • Anthropic API subscription / usage fees (paid by you to Anthropic)
  • Supabase project (free tier available)
  • Automatic indexing of WordPress posts — context is managed as markdown in the chat admin

External services

This plugin connects to external services configured by the site administrator. No data is sent to the plugin author.

Supabase

  • What: Database, authentication context, and serverless edge functions for chat API and admin API.
  • When: Whenever a visitor uses the chat widget or an administrator uses the chat admin (after URL and anon key are saved in settings).
  • What data: Chat messages, session IDs, route path, inquiry form fields (name, email, message), and site configuration. Stored in the administrator’s Supabase project.
  • Terms: https://supabase.com/terms
  • Privacy: https://supabase.com/privacy

Anthropic (Claude)

  • What: Large language model used to generate chat replies.
  • When: When the site-chat edge function processes a message (configured on the administrator’s Supabase project, not in this plugin directly).
  • What data: Conversation context, system prompt including site markdown, and the visitor’s message.
  • Terms: https://www.anthropic.com/legal/consumer-terms
  • Privacy: https://www.anthropic.com/legal/privacy

Resend (optional)

  • What: Email delivery for chat inquiries (optional backend configuration).
  • When: Only if the administrator configures RESEND_API_KEY and related secrets on Supabase.
  • What data: Inquiry notification content (visitor name, email, message).
  • Terms: https://resend.com/legal/terms-of-service
  • Privacy: https://resend.com/legal/privacy-policy

Quick start

  1. Install and activate Site Context Chat.
  2. Settings Site Context Chat — follow the embedded Setup guide.
  3. Create a page with slug chat-admin and a Shortcode block: [techlads_chat_admin]
  4. Complete backend setup (Supabase + Claude) — see Setup guide Part 2.
  5. Paste Supabase URL and anon key in plugin settings enable widget Save.
  6. Open chat admin unlock with your admin secret paste site markdown Save.

Backend (summary)

  1. Create a Supabase project
  2. Run SQL migrations from the GitHub repo (supabase/migrations/)
  3. Set edge secrets: ANTHROPIC_API_KEY, SITE_CHAT_ADMIN_SECRET
  4. Deploy edge functions site-chat and site-chat-admin (Supabase CLI recommended)

Full walkthrough is in the plugin settings page and on GitHub.

  1. Chat widget on the frontend (launcher + open panel)

    Chat widget on the frontend (launcher + open panel)

  2. WordPress plugin settings — credentials, status, and appearance

    WordPress plugin settings — credentials, status, and appearance

  3. Chat admin — Context tab with markdown site content

    Chat admin — Context tab with markdown site content

  4. Chat admin — Settings tab (model and system prompt)

    Chat admin — Settings tab (model and system prompt)

  5. Chat admin — Activity tab (conversation history)

    Chat admin — Activity tab (conversation history)

  6. Chat admin — Appearance tab (brand colours preview)

    Chat admin — Appearance tab (brand colours preview)

Does this work without any coding?

You can install the plugin without code. Backend setup requires either following the setup guide (SQL paste in Supabase dashboard + a few terminal commands for function deploy) or asking a developer to do Part 2 only.

Which AI model does it use?

Claude via the Anthropic API. You provide your own API key as a Supabase edge function secret.

Where is conversation data stored?

In your Supabase Postgres database (project you create and control). Messages are sent to Anthropic for generating replies.

Is the service_role key stored in WordPress?

No. Only the anon (public) key and project URL go in WordPress settings. Sensitive keys stay in Supabase edge function secrets.

Can I use OpenAI instead of Claude?

Not out of the box. The bundled edge functions target Anthropic. The backend is open source — you can fork and adapt.

Does it auto-learn from my WordPress posts?

Not automatically. You paste or import markdown context in the chat admin (or export content and upload). Auto-sync from WP posts may come in a future release.

Is there a monthly fee for this plugin?

No. The plugin is free (GPL). You pay Supabase and Anthropic directly for usage.

0.1.6

  • Remove custom CSS field (WordPress.org policy)
  • Prefix plugin identifiers with techlads_

0.1.5

  • Embedded setup guide in plugin settings
  • Theme: dark, light, auto
  • Custom CSS field with examples

0.1.4

  • Theme and custom CSS options

0.1.3

  • Fix chat panel visibility (replace Tailwind with bundled CSS)

0.1.2

  • Fix browser process is not defined in bundled scripts

0.1.1

  • Improved script loading and widget error states

0.1.0

  • Initial release: widget, admin shortcode, Supabase connection settings
Back to top