=== Koedoor Site Chat ===
Tags: chatbot, customer support
Requires at least: 6.3
Requires PHP: 7.4
Tested up to: 7.1
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display your Koedoor website bot using its public bot ID.

== Description ==

Koedoor answers visitor questions from your website information and accepts inquiries through its hosted chat. You can review conversations and improve the same bot in your Koedoor account.

This plugin connects a WordPress site to that service. It does not create a bot, generate answers locally, or require an API key. A Koedoor account and a saved bot are required. Free and paid service plans have usage limits; see https://koedoor.mz-works.com/pricing for current terms.

Settings > Koedoor stores only a public bot ID and your display opt-in on this WordPress site. Until a valid ID is saved and the display checkbox is selected, this plugin does not load external resources. Only administrators with manage_options can change these settings.

== External service and privacy ==

Service: Koedoor, https://koedoor.mz-works.com

When display is enabled, visitors' browsers request /widget.js and launcher images from the fixed HTTPS service. Opening the chat loads /widget/{public-bot-id}; the public bot ID identifies the bot. Questions and, if enabled by the bot owner, inquiries are sent to Koedoor for answering and storage. Normal HTTP information such as IP address, user agent and referring site origin accompanies browser requests. Koedoor records conversation, usage and installation activity as described in its privacy policy. This plugin does not transmit the WordPress administrator's login or API credentials.

The hosted chat includes Koedoor branding and a referral link. These are rendered by the Koedoor service, not inserted into the page by this plugin. Review the output and your site's privacy notice before enabling it.

* Privacy policy: https://koedoor.mz-works.com/privacy
* Terms of service: https://koedoor.mz-works.com/terms
* Help: https://koedoor.mz-works.com/help/setup

== Installation ==

1. Install this plugin folder and activate Koedoor Site Chat.
2. Create or open your bot at https://koedoor.mz-works.com/account.
3. In the bot's installation section, copy only the bot_... value from the embed tag's data-ai-reception-bot attribute.
4. Open Settings > Koedoor, paste the public bot ID, review the external service disclosure, select the display checkbox and save.
5. Open a signed-out public page, open the chat and test a question. If using inquiries, verify a test inquiry in the Koedoor management screen separately.

== Frequently Asked Questions ==

= Which PHP version should my host use? =

PHP 7.4 is the plugin's compatibility minimum, not a guarantee that this PHP branch receives security support. Use a maintained PHP branch and the latest security updates from your hosting vendor. PHP 7.4 is unsupported and is not recommended. This plugin cannot patch your host's PHP or change PHP settings automatically. Check https://www.php.net/supported-versions.php for PHP branch support status.

= Can I use the existing bot-specific Koedoor Widget ZIP too? =

Use one installation method. If the legacy bot-specific plugin is active, this plugin gives it precedence and does not enqueue a second loader. Deactivate the legacy Koedoor Widget plugin to use this settings page. Also remove manually pasted embed tags or Tag Manager installations; this plugin cannot reliably detect those methods.

= How do I stop the chat? =

Clear the display checkbox and save, or deactivate this plugin. This stops this plugin's loader; it does not disable a legacy plugin or a manually installed embed. Page caches may need clearing. Deactivation preserves local settings. Deleting this plugin removes its local settings; it does not delete bots, conversations or inquiries held by Koedoor. Manage those through your Koedoor account.

= Does saving the ID verify ownership or answer quality? =

No. A public bot ID is not a credential. Review the bot's answers, source material and inquiry settings before making it available to visitors.

== Compatibility ==

The WordPress 7.1 branch was checked using WordPress 7.1.4. Hosting policies, themes and page caches can affect script delivery, so verify the chat on a signed-out public page after enabling it. Multisite/network activation has not been validated.

== Changelog ==

= 0.1.0 =

* Initial local preparation of the public-ID connection plugin.
