The plugin is now called Pommy AI and its settings move to Settings \u2192 Pommy AI. Your Project ID carries over automatically \u2014 then delete the old Pommy Chat plugin, or your site will load two chat widgets. Custom code using pommy_chat_* filters must be updated to pommy_ai_*.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3666818,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3666818,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3666818,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3666818,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.4.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3666818,"resolution":"1","location":"assets","locale":"","width":2560,"height":1462},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3666818,"resolution":"2","location":"assets","locale":"","width":2560,"height":1462}},"screenshots":{"1":"The settings screen. Paste your Project ID and press Test connection: the plugin asks Pommy whether the ID and API address really work for this site, and reports what it actually reached. WooCommerce stores also get a switch that keeps the launcher off the checkout page.","2":"The chat widget on a live site."}},"plugin_section":[],"plugin_tags":[191735,5707,2364,2369,4049],"plugin_category":[41,47],"plugin_contributors":[277582],"plugin_business_model":[],"class_list":["post-358844","plugin","type-plugin","status-publish","hentry","plugin_tags-ai-chatbot","plugin_tags-chat","plugin_tags-chatbot","plugin_tags-customer-support","plugin_tags-helpdesk","plugin_category-communication","plugin_category-education-and-support","plugin_contributors-pommyapp","plugin_committers-pommyapp"],"banners":{"banner":"https:\/\/ps.w.org\/pommy-ai\/assets\/banner-772x250.png?rev=3666818","banner_2x":"https:\/\/ps.w.org\/pommy-ai\/assets\/banner-1544x500.png?rev=3666818","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/pommy-ai\/assets\/icon-128x128.png?rev=3666818","icon_2x":"https:\/\/ps.w.org\/pommy-ai\/assets\/icon-256x256.png?rev=3666818","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/pommy-ai\/assets\/screenshot-1.png?rev=3666818","caption":"The settings screen. Paste your Project ID and press Test connection: the plugin asks Pommy whether the ID and API address really work for this site, and reports what it actually reached. WooCommerce stores also get a switch that keeps the launcher off the checkout page."},{"src":"https:\/\/ps.w.org\/pommy-ai\/assets\/screenshot-2.png?rev=3666818","caption":"The chat widget on a live site."}],"raw_content":"\n
Pommy AI connects your site to Pommy (https:\/\/pommy.ai), a hosted AI customer-support chat service. A Pommy account is required<\/strong>: this plugin is a client for that service and does nothing on its own. Pommy offers free and paid plans \u2014 see https:\/\/pommy.ai for current plans and pricing.<\/p>\n\n Install the plugin, paste the Project ID from your Pommy dashboard into Settings \u2192 Pommy AI<\/strong>, and the chat launcher appears in the corner of your site.<\/p>\n\n Read the External services<\/strong> section below before you install. It lists exactly what is sent to Pommy, when, and what is stored \u2014 including data collected from visitors who never open the chat.<\/p>\n\n Why a plugin instead of pasting code into your theme<\/strong><\/p>\n\n How it works<\/strong><\/p>\n\n The plugin registers a small loader script through the WordPress script API ( No chat content is stored in your WordPress database, and your server makes no request to Pommy on its own \u2014 but the visitor's browser does, on every page view. See External services<\/strong>.<\/p>\n\n What the plugin stores in WordPress<\/strong><\/p>\n\n Four options in your WordPress database:<\/p>\n\n Saving the settings screen writes these whether or not a Project ID is filled in. All four are deleted when you delete the plugin, along with the options used by the plugin's earlier \"Pommy Chat\" releases.<\/p>\n\n This plugin connects your site to Pommy (https:\/\/pommy.ai), the chat service that powers the widget. Without a Pommy account and a Project ID the plugin sends nothing.<\/p>\n\n 1. The chat widget, running in your visitor's browser<\/strong><\/p>\n\n Once a Project ID is saved, every front-end page loads the widget from the Pommy API host you configured (by default Sent on every page view, before the visitor interacts with anything:<\/em> your Project ID, the page URL and the referring URL, and \u2014 inherent to any request their browser makes \u2014 the visitor's IP address and user-agent string. Pommy resolves the IP to a country and city and derives browser, operating system and device type from the user agent, and keeps this as a visitor record whether or not the visitor ever opens the chat. The widget repeats this roughly every 30 seconds while the page is open, and holds a WebSocket connection open to Pommy for the same period. It also fetches the widget's configuration on load, and its interface translations when the visitor's language needs them.<\/p>\n\n Sent only if the visitor uses the chat:<\/em> the messages they write, and any contact details they choose to type in, for example a name or an email address.<\/p>\n\n Stored in the visitor's browser:<\/em> a visitor identifier and the most recent messages of the conversation, in local storage on Pommy's domain rather than yours, so the chat survives a page change.<\/p>\n\n Not sent by the plugin:<\/em> your WordPress user accounts, your posts, or your WooCommerce order and customer records. The plugin reads only its own settings and, on the settings screen, the current administrator's capabilities.<\/p>\n\n 2. Setup check, sent from your server<\/strong><\/p>\n\n When an administrator presses \"Test connection\" on the plugin's settings screen, WordPress makes one request from your server to Sent:<\/em> your Project ID, your site's home URL, and the plugin version.\nWhen:<\/em> only when that button is pressed. Your server contacts Pommy at no other time.\nReturned:<\/em> whether the project exists, whether the domain is verified, the project's name, and the address of the Pommy API that answered \u2014 so a site pointed at the wrong environment names it rather than failing silently.<\/p>\n\n Pommy's terms of service: https:\/\/pommy.ai\/terms\nPommy's privacy policy: https:\/\/pommy.ai\/privacy<\/p>\n\n\n In the Pommy dashboard, under Integrations \u2192 WordPress. It also appears inside the embed snippet on the Widgets page, as the value of Yes. The plugin enqueues its loader through the WordPress script API, which works on every standards-compliant theme \u2014 block themes included. It never touches No, not by default. On a phone the launcher lands in the same corner as the order button, so the plugin keeps it off that page. Untick Hide the chat launcher on the checkout page<\/strong> in Settings \u2192 Pommy AI if you want live help during payment.<\/p>\n\n The widget also stays off feeds, AMP pages, and the editing canvases of Elementor, Divi, Beaver Builder, WPBakery, Brizy and Oxygen.<\/p><\/dd>\n Use the Only when you press \"Test connection\". That sends one request containing your Project ID, your site's home URL and the plugin version. Nothing else leaves your server at any time. The widget itself talks to Pommy from the visitor's browser \u2014 see External services for what that involves.<\/p><\/dd>\n Activate Pommy AI; your Project ID and settings are carried over automatically. Then deactivate and delete the old Pommy Chat plugin \u2014 the folder name changed, so WordPress treats them as two plugins and would otherwise load two chat widgets on your site.<\/p><\/dd>\n All four plugin options are removed from the database, along with the options written by the earlier \"Pommy Chat\" releases, on single sites and on every site of a multisite network.<\/p><\/dd>\n\n<\/dl>\n\n\n\n
header.php<\/code> file.<\/li>\nDISALLOW_FILE_EDIT<\/code>.<\/li>\nwp_enqueue_script<\/code>), printed in the site footer. The loader creates a cross-origin iframe that hosts the chat interface on Pommy's own domain, so the widget's code and storage stay separate from your site. The iframe is granted microphone permission, for the chat's optional voice input, and clipboard access so a visitor can copy a reply.<\/p>\n\n\n
pommy_ai_project_id<\/code> \u2014 your Pommy Project ID.<\/li>\npommy_ai_api_url<\/code> \u2014 the Pommy API endpoint (defaults to https:\/\/api.pommy.ai<\/code>).<\/li>\npommy_ai_hide_on_checkout<\/code> \u2014 whether the launcher is hidden on the WooCommerce checkout page. On by default.<\/li>\npommy_ai_test_result<\/code> \u2014 the outcome of the last \"Test connection\" check, or the reason a Project ID was refused. Cleared whenever the settings are saved, because an old verdict describes old settings.<\/li>\n<\/ul>\n\nExternal services<\/h3>\n\n
https:\/\/api.pommy.ai<\/code>). From then on the widget talks to Pommy directly, from the visitor's browser rather than from your server.<\/p>\n\nPOST {API URL}\/api\/plugin\/verify<\/code>.<\/p>\n\n\n
https:\/\/api.pommy.ai<\/code>, paste that into the API URL<\/strong> field too. Click Save Changes<\/strong>.<\/li>\n\n
Where do I find my Project ID?<\/h3><\/dt>\n
projectId<\/code>. It is a UUID \u2014 it looks like 123e4567-e89b-12d3-a456-426614174000<\/code>.<\/p><\/dd>\nMy theme is a block theme. Does this work?<\/h3><\/dt>\n
header.php<\/code>.<\/p><\/dd>\nDoes the widget appear on the WooCommerce checkout page?<\/h3><\/dt>\n
How do I hide the widget on specific pages?<\/h3><\/dt>\n
pommy_ai_enabled<\/code> filter from your child theme's functions.php<\/code>:<\/p>\n\nadd_filter( 'pommy_ai_enabled', function ( $enabled ) { return is_page( 'pricing' ) ? false : $enabled; } );\n<\/code><\/pre><\/dd>\nWhat filters does the plugin provide?<\/h3><\/dt>\n
\n
pommy_ai_enabled<\/code> \u2014 boolean, default true. Return false to keep the widget off the current request.<\/li>\npommy_ai_skip_contexts<\/code> \u2014 boolean, always false when it runs. Return true to add a skip condition of your own. It runs after the built-in skips, so it cannot re-enable a page the plugin already skips.<\/li>\npommy_ai_loader_attributes<\/code> \u2014 array of attribute name => value placed on the loader <script><\/code> tag. Pass true for a boolean attribute. Only loading attributes and data-*<\/code> names are honoured.<\/li>\n<\/ul><\/dd>\nDoes the plugin send data to Pommy from my server?<\/h3><\/dt>\n
I was using the \"Pommy Chat\" plugin. What do I do?<\/h3><\/dt>\n
What happens when I delete the plugin?<\/h3><\/dt>\n
1.4.0<\/h4>\n\n
\n
pommy_ai_enabled<\/code>, pommy_ai_skip_contexts<\/code> and pommy_ai_loader_attributes<\/code>. Settings from the earlier \"Pommy Chat\" releases are carried over automatically; delete that plugin once this one is active.<\/li>\nPOMMY_AI_API_URL<\/code> in wp-config.php<\/code>.<\/li>\n1.3.5<\/h4>\n\n
\n
1.3.4<\/h4>\n\n
\n
script_loader_tag<\/code> filter.<\/li>\n<\/ul>\n\n1.3.3<\/h4>\n\n
\n
1.3.2<\/h4>\n\n
\n
1.3.1<\/h4>\n\n
\n
1.3.0<\/h4>\n\n
\n
1.2.0<\/h4>\n\n
\n
1.1.0<\/h4>\n\n
\n
1.0.0<\/h4>\n\n
\n
wp_footer<\/code>, an enable\/disable filter, full uninstall cleanup.<\/li>\n<\/ul>","raw_excerpt":"Add the Pommy chat widget to your WordPress site. Paste your Project ID and the widget goes live \u2014 no theme files touched.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/358844","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=358844"}],"author":[{"embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/pommyapp"}],"wp:attachment":[{"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=358844"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=358844"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=358844"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=358844"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=358844"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=358844"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}