=== Convly Chat Widget ===
Contributors: convly
Tags: chatbot, chat, ai, support, widget
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed Convly ChatBuilder chat widgets into WordPress with global defaults, per-page overrides, and category-based scenario routing.

== Description ==

Convly Chat Widget helps you add Convly chatbots to WordPress without editing theme files.

Key features:
- Global default scenario configuration
- Per-post and per-page override settings
- Category-based scenario routing
- Auto inject control by page context
- Shortcode support for manual placement
- Language-specific scenario IDs (JA / EN)
- Safe output with sanitization and escaping

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`, or upload the ZIP from the WordPress admin screen.
2. Activate **Convly Chat Widget** from the Plugins screen.
3. Open **Convly Chat** in the WordPress admin menu.
4. Set your `Embed JS URL` and default Scenario IDs.
5. Keep `Supabase URL (Advanced)` as-is unless your backend endpoint changed.
6. Save settings and verify on your site frontend.

== Usage ==

1. Set `Default Scenario ID` first (this is the main ID used on normal pages).
2. If you run multilingual pages, also set `Default Scenario ID (JA)` and `Default Scenario ID (EN)`.
3. Use `Exclude Page/Post IDs` with comma-separated numeric IDs (example: `12,45,102`).
4. Use `Category Rules` with one rule per line in this format:
`category-slug|defaultScenarioId|jaScenarioId|enScenarioId`
5. Example category rules:
`news|k98e449d1991|k98e449d1991|x54b0d5c7341`
`support|k98e449d1991||x54b0d5c7341`
6. For per-page overrides, open a post or page editor and configure the `Convly Chat Widget` meta box.

Language behavior:
- The widget uses the current WordPress locale.
- If locale starts with `ja`, `scenario_id_ja` is preferred.
- For other locales, `scenario_id_en` is preferred.
- If a language-specific ID is empty, the plugin falls back to `scenario_id`.

Scenario ID format:
- Use public random IDs (12 chars).
- Recommended format is lowercase letters and digits.
- Example IDs: `k98e449d1991`, `x54b0d5c7341`.

Style defaults:
- Leave `Button Size`, `Icon Size`, `Icon Offset`, `Z Index`, and `Font Family` empty to use `embed.js` defaults.
- If needed, set values such as `60px`, `26px`, `12px`, `9999`, or `Inter, sans-serif`.

== Frequently Asked Questions ==

= Can I set different scenarios per page? =

Yes. Use the meta box in the post/page editor to disable, inherit defaults, or use custom scenario IDs for that specific page.

= Can I control where the widget appears? =

Yes. You can enable or disable injection for front page, posts index, posts, pages, archives, search, and 404 pages.

= Can I embed manually in content? =

Yes. Use `[convly_chat_widget]` and optional shortcode attributes such as `scenario_id`, `scenario_id_ja`, and `scenario_id_en`.

= What are valid examples for exclusion IDs and category rules? =

Use `Exclude Page/Post IDs` like `12,45,102`.
Use `Category Rules` one line at a time, such as `news|k98e449d1991|k98e449d1991|x54b0d5c7341`.

= Do I need a specific multilingual plugin? =

No. This plugin reads WordPress locale. It works with multilingual plugins that switch locale (for example WPML or Polylang), and also works on single-language sites.

= Can I override settings in shortcode? =

Yes. Example:
`[convly_chat_widget scenario_id="k98e449d1991" scenario_id_ja="k98e449d1991" scenario_id_en="x54b0d5c7341" button_size="64px" icon_size="26px" z_index="9999"]`

== Changelog ==

= 1.0.4 =
* Renamed the main plugin class to follow WordPress prefix naming conventions

= 1.0.3 =
* Added icon size customization support via `data-icon-size` / `icon_size`
* Updated admin settings and per-page override fields for Icon Size
* Updated style customization docs and examples

= 1.0.2 =
* Added inline descriptions and concrete examples for each admin input field
* Added per-page meta box guidance for each override field
* Updated shortcode examples to public random Scenario ID patterns

= 1.0.1 =
* Expanded usage documentation with concrete examples
* Clarified language behavior, Scenario ID format, and style defaults

= 1.0.0 =
* Initial release
* Added global settings, per-page overrides, category rules, and shortcode support
* Added i18n-ready text domain configuration and Japanese translation source files
