Candlear Booking Widget

By synergicsystems

0+ active installationsVersion 1.2.1

Adds the Candlear chat widget for appointment booking via chat to your WordPress website, without copying code into your theme.

Description

Candlear is a booking system for local businesses (hairdressers, physiotherapy, coaching, trades, restaurants and more). Customers book appointments by chat directly on your website.

What this plugin is for: Candlear is a hosted booking service. Businesses set up their services, opening hours and staff in the Candlear dashboard. Visitors of the business website can then chat with an AI assistant that checks free time slots and books the appointment. This plugin is the WordPress connector: it adds the Candlear chat bubble to your site, so you do not have to paste a script into your theme.

This plugin requires a Candlear account (candlear.de). It only connects your website to that service. Without an API key it does nothing.

Language and region: For now, the Candlear service is built for businesses in Germany. The chat widget, the AI assistant and the booking flow are in German, and appointments use the Europe/Berlin time zone. The plugin’s settings page is in English; a German translation will be provided through translate.wordpress.org. More languages and time zones may follow later.

How to get an API key: Register at https://candlear.de, open the dashboard and copy the API key under Chat bot -> Embed widget.

Plugin reviewers and testers: If you want to test the plugin without registering, write to support@candlear.de and ask for a test account. You will receive dashboard login data and an API key for a demo business. Enter the key under Settings -> Candlear, then open the website and use the chat bubble to book an appointment.

The plugin adds the Candlear widget script to the footer of your pages and passes your settings to it:

  • API key
  • Widget title
  • Greeting
  • Position (bottom right / bottom left)
  • Privacy policy URL (required)

No theme editor, no footer snippet, no additional Google Fonts. The widget uses Shadow DOM and stays visually isolated from your theme.

The script is loaded through the regular WordPress enqueue pipeline (wp_enqueue_script), so common consent manager plugins (for example Real Cookie Banner, Borlabs Cookie, Complianz) can detect it like any other script and delay it according to their own rules.

The plugin shows the widget once an API key is set. The chat window links to a privacy notice hosted by Candlear, which shows the business details you enter in the Candlear dashboard (Chat bot -> Privacy notice in the widget). Under Settings -> Privacy -> Policy Guide the plugin adds a suggested sentence for your own privacy policy. You are responsible for your website’s privacy policy and for informing your visitors.

You will find your API key in the Candlear dashboard under Chat bot -> Embed widget. Test accounts are available on request at support@candlear.de.

External services

This plugin connects your website to the Candlear service operated by Synergic Systems – Jannick Mueller, Cologne, Germany. It is required for the chat widget to work.

What is loaded: On every public page, once an API key is set, the browser of each visitor loads the widget script from https://candlear.de/chat-widget.js.

What data is sent and when: When a visitor opens the chat and sends a message, the message text (which may contain name, contact details and appointment wishes entered by the visitor), a chat session ID, your API key and the visitor’s IP address (as part of the request) are sent to https://candlear.de/api/chat. Chat messages are processed by an AI service (Google Gemini, Google LLC) to answer the visitor. No data is sent to Candlear before the widget is loaded in the visitor’s browser. The plugin itself does not send any data from your WordPress server.

  • Service provider: Synergic Systems – Jannick Mueller, https://candlear.de
  • Terms of service: https://candlear.de/agb
  • Privacy policy: https://candlear.de/datenschutz
  • Data processing agreement: https://candlear.de/avv
  • AI sub-processor: Google Gemini API, terms at https://ai.google.dev/gemini-api/terms

Privacy

The plugin stores your settings in the WordPress options table (candlear_booking_widget_options) and deletes them when the plugin is deleted. The plugin itself does not set cookies. For the data sent to the Candlear service by the widget, see “External services” above. As the site operator you remain responsible for your privacy policy; a suggested sentence is available under Settings -> Privacy -> Policy Guide.

Installation

  1. Upload the plugin via “Plugins -> Add New -> Upload Plugin” and activate it.
  2. Go to “Settings -> Candlear” and enter the API key from your Candlear dashboard.
  3. Adjust title, greeting and position, and save.
  4. In the Candlear dashboard, enter your business details for the privacy notice (Chat bot -> Privacy notice in the widget), and add the suggested sentence to your privacy policy (Settings -> Privacy -> Policy Guide).
  5. Check the website for the chat bubble at the bottom right or left.

FAQ

Where do I get my API key?

In the Candlear dashboard under Chat bot -> Embed widget. You need a Candlear account: register at https://candlear.de, or request a test account at support@candlear.de.

Do I still have to add code to my theme?

No. The plugin takes care of embedding the widget.

Why is the widget not visible?

The widget is only shown when an API key is set. Check Settings -> Candlear.

Does the plugin work with my cookie banner?

The script is added with wp_enqueue_script, the usual integration point for consent manager plugins.

Is the plugin available in German?

Yes, a German translation is included.

Which languages and time zones does the chat widget support?

Currently German only, with appointments in the Europe/Berlin time zone. The service is built for businesses in Germany for now. More languages and time zones may follow later.

Screenshots

Changelog

1.2.1

  • Widget title and greeting are optional. If left empty, the widget uses its German defaults instead of English ones.

1.2.0

  • The privacy link in the chat window now always points to the privacy notice hosted by Candlear, filled with the business details from the Candlear dashboard. The privacy policy URL setting was removed.
  • The widget is shown as soon as an API key is set.
  • Shorter suggested text for your privacy policy, with a link to that notice.

1.1.0

  • Privacy policy URL is now required: the widget is not shown without it (falls back to the WordPress privacy page).
  • Adds suggested privacy policy text to Settings -> Privacy -> Policy Guide.
  • Admin notice when the widget is hidden because no privacy policy URL is set.
  • Plugin interface and readme now in English, German translation included.
  • Documents the external service (Candlear) in the readme.

1.0.0

  • First version: settings page (API key, title, greeting, position, privacy policy URL) and automatic embedding in the footer.