Përshkrim
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
- Set
Default Scenario IDfirst (this is the main ID used on normal pages). - If you run multilingual pages, also set
Default Scenario ID (JA)andDefault Scenario ID (EN). - Use
Exclude Page/Post IDswith comma-separated numeric IDs (example:12,45,102). - Use
Category Ruleswith one rule per line in this format:
category-slug|defaultScenarioId|jaScenarioId|enScenarioId - Example category rules:
news|k98e449d1991|k98e449d1991|x54b0d5c7341
support|k98e449d1991||x54b0d5c7341 - For per-page overrides, open a post or page editor and configure the
Convly Chat Widgetmeta 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.
Instalim
- Upload the plugin folder to
/wp-content/plugins/, or upload the ZIP from the WordPress admin screen. - Activate Convly Chat Widget from the Plugins screen.
- Open Convly Chat in the WordPress admin menu.
- Set your
Embed JS URLand default Scenario IDs. - Keep
Supabase URL (Advanced)as-is unless your backend endpoint changed. - Save settings and verify on your site frontend.
PBR
-
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 asscenario_id,scenario_id_ja, andscenario_id_en. -
What are valid examples for exclusion IDs and category rules?
-
Use
Exclude Page/Post IDslike12,45,102.
UseCategory Rulesone line at a time, such asnews|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″]
Shqyrtime
Për këtë shtojcë s’ka shqyrtime.
Kontribues & Zhvillues
“Convly Chat Widget” është software me burim të hapur. Në këtë shtojcë kanë dhënë ndihmesë personat vijues.
KontribuesPërkthejeni “Convly Chat Widget” në gjuhën tuaj.
Ju intereson zhvillimi?
Shfletoni kodin, shkarkoni depon SVN, ose pajtohuni përmes RSS-je te regjistri i zhvillimeve.
Regjistër ndryshimesh
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
