{"id":289965,"date":"2026-04-02T08:49:59","date_gmt":"2026-04-02T08:49:59","guid":{"rendered":"https:\/\/ja.wordpress.org\/plugins\/convly-chat-widget\/"},"modified":"2026-04-02T08:49:23","modified_gmt":"2026-04-02T08:49:23","slug":"convly-chat-widget","status":"publish","type":"plugin","link":"https:\/\/sq.wordpress.org\/plugins\/convly-chat-widget\/","author":23465804,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.4","stable_tag":"1.0.4","tested":"6.9.4","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Convly Chat Widget","header_author":"Convly","header_description":"Embed Convly ChatBuilder chat widgets into WordPress.","assets_banners_color":"6da6c0","last_updated":"2026-04-02 08:49:23","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/app.convly.jp\/","header_author_uri":"https:\/\/convly.jp\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":42,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.4":{"tag":"1.0.4","author":"convly","date":"2026-04-02 08:49:23"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3497352,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3497352,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3497352,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3497352,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.4"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2353,5707,2364,1104,162],"plugin_category":[41,43],"plugin_contributors":[259267],"plugin_business_model":[],"class_list":["post-289965","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-chat","plugin_tags-chatbot","plugin_tags-support","plugin_tags-widget","plugin_category-communication","plugin_category-customization","plugin_contributors-convly","plugin_committers-convly"],"banners":{"banner":"https:\/\/ps.w.org\/convly-chat-widget\/assets\/banner-772x250.png?rev=3497352","banner_2x":"https:\/\/ps.w.org\/convly-chat-widget\/assets\/banner-1544x500.png?rev=3497352","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/convly-chat-widget\/assets\/icon-128x128.png?rev=3497352","icon_2x":"https:\/\/ps.w.org\/convly-chat-widget\/assets\/icon-256x256.png?rev=3497352","generated":false},"screenshots":[],"raw_content":"\n

Convly Chat Widget helps you add Convly chatbots to WordPress without editing theme files.<\/p>\n\n

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

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

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

    Scenario ID format:\n- Use public random IDs (12 chars).\n- Recommended format is lowercase letters and digits.\n- Example IDs: k98e449d1991<\/code>, x54b0d5c7341<\/code>.<\/p>\n\n

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

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

      Can I set different scenarios per page?<\/h3><\/dt>\n

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

      Can I control where the widget appears?<\/h3><\/dt>\n

      Yes. You can enable or disable injection for front page, posts index, posts, pages, archives, search, and 404 pages.<\/p><\/dd>\n

      Can I embed manually in content?<\/h3><\/dt>\n

      Yes. Use [convly_chat_widget]<\/code> and optional shortcode attributes such as scenario_id<\/code>, scenario_id_ja<\/code>, and scenario_id_en<\/code>.<\/p><\/dd>\n

      What are valid examples for exclusion IDs and category rules?<\/h3><\/dt>\n

      Use Exclude Page\/Post IDs<\/code> like 12,45,102<\/code>.\nUse Category Rules<\/code> one line at a time, such as news|k98e449d1991|k98e449d1991|x54b0d5c7341<\/code>.<\/p><\/dd>\n

      Do I need a specific multilingual plugin?<\/h3><\/dt>\n

      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.<\/p><\/dd>\n

      Can I override settings in shortcode?<\/h3><\/dt>\n

      Yes. Example:\n [convly_chat_widget scenario_id=\"k98e449d1991\" scenario_id_ja=\"k98e449d1991\" scenario_id_en=\"x54b0d5c7341\" button_size=\"64px\" icon_size=\"26px\" z_index=\"9999\"]<\/p><\/dd>\n\n<\/dl>\n\n\n

      1.0.4<\/h4>\n\n
        \n
      • Renamed the main plugin class to follow WordPress prefix naming conventions<\/li>\n<\/ul>\n\n

        1.0.3<\/h4>\n\n
          \n
        • Added icon size customization support via data-icon-size<\/code> \/ icon_size<\/code><\/li>\n
        • Updated admin settings and per-page override fields for Icon Size<\/li>\n
        • Updated style customization docs and examples<\/li>\n<\/ul>\n\n

          1.0.2<\/h4>\n\n
            \n
          • Added inline descriptions and concrete examples for each admin input field<\/li>\n
          • Added per-page meta box guidance for each override field<\/li>\n
          • Updated shortcode examples to public random Scenario ID patterns<\/li>\n<\/ul>\n\n

            1.0.1<\/h4>\n\n
              \n
            • Expanded usage documentation with concrete examples<\/li>\n
            • Clarified language behavior, Scenario ID format, and style defaults<\/li>\n<\/ul>\n\n

              1.0.0<\/h4>\n\n
                \n
              • Initial release<\/li>\n
              • Added global settings, per-page overrides, category rules, and shortcode support<\/li>\n
              • Added i18n-ready text domain configuration and Japanese translation source files<\/li>\n<\/ul>","raw_excerpt":"Embed Convly ChatBuilder chat widgets into WordPress with global defaults, per-page overrides, and category-based scenario routing.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/sq.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/289965","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sq.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/sq.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/sq.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=289965"}],"author":[{"embeddable":true,"href":"https:\/\/sq.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/convly"}],"wp:attachment":[{"href":"https:\/\/sq.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=289965"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/sq.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=289965"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/sq.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=289965"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/sq.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=289965"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/sq.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=289965"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/sq.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=289965"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}