설명
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.
설치
- 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.
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 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″]
후기
이 플러그인에 대한 평가가 없습니다.
기여자 & 개발자
변경이력
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