{"id":389082,"date":"2026-10-27T10:54:32","date_gmt":"2026-10-27T10:54:32","guid":{"rendered":"https:\/\/de.wordpress.org\/plugins\/candlear-booking-widget\/"},"modified":"2026-10-27T10:53:55","modified_gmt":"2026-10-27T10:53:55","slug":"candlear-booking-widget","status":"publish","type":"plugin","link":"https:\/\/bo.wordpress.org\/plugins\/candlear-booking-widget\/","author":23588696,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.0","stable_tag":"1.1.0","tested":"7.1.4","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Candlear Booking Widget","header_author":"Synergic Systems","header_description":"Adds the Candlear chat widget (appointment booking via chat) to your website. API key and widget settings are managed under Settings &rarr; Candlear, no theme code needed.","assets_banners_color":"706c7c","last_updated":"2026-10-27 10:53:55","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/candlear.de","rating":0,"author_block_rating":0,"active_installs":0,"downloads":52,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.0":{"tag":"1.1.0","author":"synergicsystems","date":"2026-10-27 10:53:55","revision":3768278}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3768278,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3768278,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3768278,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3768278,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3768278,"resolution":"1","location":"assets","locale":"","width":1920,"height":915},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3768278,"resolution":"2","location":"assets","locale":"","width":1901,"height":916},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3768278,"resolution":"3","location":"assets","locale":"","width":1902,"height":916},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3768278,"resolution":"4","location":"assets","locale":"","width":1903,"height":918}},"screenshots":{"1":"Settings -&gt; Candlear: API key, widget title, greeting, position and privacy policy URL.","2":"The Candlear chat bubble on the website.","3":"The chat tab: visitors talk to the AI assistant (German).","4":"The booking tab: visitors pick a day and time for their appointment (German)."}},"plugin_section":[],"plugin_tags":[8132,269,14160,2364,268],"plugin_category":[40],"plugin_contributors":[288911],"plugin_business_model":[],"class_list":["post-389082","plugin","type-plugin","status-publish","hentry","plugin_tags-appointments","plugin_tags-booking","plugin_tags-chat-widget","plugin_tags-chatbot","plugin_tags-scheduling","plugin_category-calendar-and-events","plugin_contributors-synergicsystems","plugin_committers-synergicsystems"],"banners":{"banner":"https:\/\/ps.w.org\/candlear-booking-widget\/assets\/banner-772x250.png?rev=3768278","banner_2x":"https:\/\/ps.w.org\/candlear-booking-widget\/assets\/banner-1544x500.png?rev=3768278","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/candlear-booking-widget\/assets\/icon-128x128.png?rev=3768278","icon_2x":"https:\/\/ps.w.org\/candlear-booking-widget\/assets\/icon-256x256.png?rev=3768278","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/candlear-booking-widget\/assets\/screenshot-1.png?rev=3768278","caption":"Settings -&gt; Candlear: API key, widget title, greeting, position and privacy policy URL."},{"src":"https:\/\/ps.w.org\/candlear-booking-widget\/assets\/screenshot-2.png?rev=3768278","caption":"The Candlear chat bubble on the website."},{"src":"https:\/\/ps.w.org\/candlear-booking-widget\/assets\/screenshot-3.png?rev=3768278","caption":"The chat tab: visitors talk to the AI assistant (German)."},{"src":"https:\/\/ps.w.org\/candlear-booking-widget\/assets\/screenshot-4.png?rev=3768278","caption":"The booking tab: visitors pick a day and time for their appointment (German)."}],"raw_content":"<!--section=description-->\n<p>Candlear is a booking system for local businesses (hairdressers, physiotherapy, coaching, trades, restaurants and more). Customers book appointments by chat directly on your website.<\/p>\n\n<p><strong>What this plugin is for:<\/strong> 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.<\/p>\n\n<p><strong>This plugin requires a Candlear account (candlear.de).<\/strong> It only connects your website to that service. Without an API key it does nothing.<\/p>\n\n<p><strong>Language and region:<\/strong> 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.<\/p>\n\n<p><strong>How to get an API key:<\/strong> Register at https:\/\/candlear.de, open the dashboard and copy the API key under Chat bot -&gt; Embed widget.<\/p>\n\n<p><strong>Plugin reviewers and testers:<\/strong> 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 and a privacy policy URL under Settings -&gt; Candlear, then open the website and use the chat bubble to book an appointment.<\/p>\n\n<p>The plugin adds the Candlear widget script to the footer of your pages and passes your settings to it:<\/p>\n\n<ul>\n<li>API key<\/li>\n<li>Widget title<\/li>\n<li>Greeting<\/li>\n<li>Position (bottom right \/ bottom left)<\/li>\n<li>Privacy policy URL (required)<\/li>\n<\/ul>\n\n<p>No theme editor, no footer snippet, no additional Google Fonts. The widget uses Shadow DOM and stays visually isolated from your theme.<\/p>\n\n<p>The script is loaded through the regular WordPress enqueue pipeline (<code>wp_enqueue_script<\/code>), 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.<\/p>\n\n<p>The plugin does not show the widget until an API key and a privacy policy URL are set. Under Settings -&gt; Privacy -&gt; Policy Guide the plugin adds suggested text for your privacy policy. You are responsible for adapting it to your website and for informing your visitors.<\/p>\n\n<p>You will find your API key in the Candlear dashboard under Chat bot -&gt; Embed widget. Test accounts are available on request at support@candlear.de.<\/p>\n\n<h3>External services<\/h3>\n\n<p>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.<\/p>\n\n<p><strong>What is loaded:<\/strong> On every public page, once an API key and a privacy policy URL are set, the browser of each visitor loads the widget script from <code>https:\/\/candlear.de\/chat-widget.js<\/code>.<\/p>\n\n<p><strong>What data is sent and when:<\/strong> 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 <code>https:\/\/candlear.de\/api\/chat<\/code>. 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.<\/p>\n\n<ul>\n<li>Service provider: Synergic Systems - Jannick Mueller, https:\/\/candlear.de<\/li>\n<li>Terms of service: https:\/\/candlear.de\/agb<\/li>\n<li>Privacy policy: https:\/\/candlear.de\/datenschutz<\/li>\n<li>Data processing agreement: https:\/\/candlear.de\/avv<\/li>\n<li>AI sub-processor: Google Gemini API, terms at https:\/\/ai.google.dev\/gemini-api\/terms<\/li>\n<\/ul>\n\n<h3>Privacy<\/h3>\n\n<p>The plugin stores your settings in the WordPress options table (<code>candlear_booking_widget_options<\/code>) 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 must mention the chatbot in your privacy policy.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin via \"Plugins -&gt; Add New -&gt; Upload Plugin\" and activate it.<\/li>\n<li>Go to \"Settings -&gt; Candlear\" and enter the API key from your Candlear dashboard.<\/li>\n<li>Enter your privacy policy URL, adjust title, greeting and position, and save.<\/li>\n<li>Add the chatbot section to your privacy policy (suggested text: Settings -&gt; Privacy -&gt; Policy Guide).<\/li>\n<li>Check the website for the chat bubble at the bottom right or left.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"where%20do%20i%20get%20my%20api%20key%3F\"><h3>Where do I get my API key?<\/h3><\/dt>\n<dd><p>In the Candlear dashboard under Chat bot -&gt; Embed widget. You need a Candlear account: register at https:\/\/candlear.de, or request a test account at support@candlear.de.<\/p><\/dd>\n<dt id=\"do%20i%20still%20have%20to%20add%20code%20to%20my%20theme%3F\"><h3>Do I still have to add code to my theme?<\/h3><\/dt>\n<dd><p>No. The plugin takes care of embedding the widget.<\/p><\/dd>\n<dt id=\"why%20is%20the%20widget%20not%20visible%3F\"><h3>Why is the widget not visible?<\/h3><\/dt>\n<dd><p>The widget is only shown when an API key and a privacy policy URL are set. Check Settings -&gt; Candlear.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20work%20with%20my%20cookie%20banner%3F\"><h3>Does the plugin work with my cookie banner?<\/h3><\/dt>\n<dd><p>The script is added with <code>wp_enqueue_script<\/code>, the usual integration point for consent manager plugins.<\/p><\/dd>\n<dt id=\"is%20the%20plugin%20available%20in%20german%3F\"><h3>Is the plugin available in German?<\/h3><\/dt>\n<dd><p>Yes, a German translation is included.<\/p><\/dd>\n<dt id=\"which%20languages%20and%20time%20zones%20does%20the%20chat%20widget%20support%3F\"><h3>Which languages and time zones does the chat widget support?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Privacy policy URL is now required: the widget is not shown without it.<\/li>\n<li>Adds suggested privacy policy text to Settings -&gt; Privacy -&gt; Policy Guide.<\/li>\n<li>Admin notice when the widget is hidden because no privacy policy URL is set.<\/li>\n<li>Plugin interface and readme now in English, German translation included.<\/li>\n<li>Documents the external service (Candlear) in the readme.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First version: settings page (API key, title, greeting, position, privacy policy URL) and automatic embedding in the footer.<\/li>\n<\/ul>","raw_excerpt":"Adds the Candlear chat widget for appointment booking via chat to your WordPress website, without copying code into your theme.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/bo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/389082","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/bo.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/bo.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=389082"}],"author":[{"embeddable":true,"href":"https:\/\/bo.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/synergicsystems"}],"wp:attachment":[{"href":"https:\/\/bo.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=389082"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/bo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=389082"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/bo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=389082"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/bo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=389082"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/bo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=389082"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/bo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=389082"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}