Convly Chat Widget

چۈشەندۈرۈش

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

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.

ئورنىتىش

  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.

FAQ

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″]

باھالاشلار

بۇ قىستۇرمىغا تېخى باھا يېزىلمىدى.

تۆھپىكار ۋە ئىجادكار

«Convly Chat Widget» كودى ئوچۇق يۇمشاق دېتال. تۆۋەندىكى كىشىلەر بۇ قىستۇرمىغا تۆھپە قوشقان.

تۆھپىكار

«Convly Chat Widget» نى تىلىڭىزغا تەرجىمە قىلىڭ

ئىجادىيەتكە قىزىقامسىز؟

كودقا كۆز يۈگۈرتۈپ، SVN خەزىنە تەكشۈرۈپ ياكى RSSئارقىلىق ئىجادىيەت خاتىرىسىگە مۇشتەرى بولغىلى بولىدۇ.

ئۆزگىرىش خاتىرىسى

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