=== ByNeural AI Assistant === Contributors: byneural Tags: woocommerce, byneural, assistant, chatbot Requires at least: 5.0 Tested up to: 7.1 Requires PHP: 7.0 Stable tag: 1.2.0 License: GPL v2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html == Description == The byNeural WooCommerce Integration plugin connects the byNeural AI Virtual Assistant platform with WooCommerce, enabling seamless integration between the two systems. This plugin serves two main purposes: providing limited access to WooCommerce data and embedding the Virtual Assistant widget into the WordPress website. The first function of the plugin is to provide secure access to specific WooCommerce data, such as product information and shipping statuses, from the byNeural platform. Only public product details that are already visible on the WooCommerce website are accessible. To access shipping statuses, the order ID and an access key must be provided, ensuring that only the customer who placed the order can retrieve this information. The plugin requires the WordPress user to enter an access key in the plugin’s settings panel. This key is used to authenticate and enable secure access to WooCommerce data exclusively via requests that include the correct key in the URL. This design ensures privacy and exclusive use of the information. The second function of the plugin is to embed the byNeural AI Virtual Assistant widget into the WordPress website. The plugin injects a script hosted on byNeural's server, enabling the Assistant to be displayed and used directly on the site. **Note**: This plugin loads a remote script (https://static.byneural.es/dist2/bundle.js). Refer to our privacy policy at https://byneural.ai/politicas-asistentes and for more information. Users of the platform and the plugin have already accepted byNeural's privacy policies prior to use. == External Services == **1) byNeural AI Assistant** - **Domain/Service**: https://static.byneural.es (byNeural) - **What it’s used for**: The plugin injects a script that displays the byNeural AI Virtual Assistant widget on your site. - **What data is sent and when**: When visitors interact with the Assistant, usage data (e.g., messages typed, conversation context) is sent to byNeural's servers for processing. - **Terms of service & privacy policy**: - [byNeural Terms and Conditions](https://byneural.ai/terminos-y-condiciones) - [byNeural Privacy Policy](https://byneural.ai/politicas-asistentes) **2) Shipping Trackers** (optional links displayed to help your customers track orders) - **NACEX** (https://www.nacex.es/) - We generate a tracking link if your site uses the NACEX shipping method and the order data includes a NACEX expedition code. - When clicking that link, your order’s tracking code is passed to NACEX to display shipping status. - [NACEX privacy policy](https://www.nacex.es/irPolitica.do) - [NACEX Terms & Conditions](https://www.nacex.es/pages/img/servicios/condiciones_tramitaciones/NACEX_SERVICIOS_15_COND_GEN_INTERN_en.pdf) - **SEUR** (https://www.seur.com/) - We provide a link for SEUR tracking if your site uses SEUR and there is a SEUR shipping ID associated with the order. - The tracking code is included in the link so the shipping status can be displayed. - [SEUR Privacy Policy](https://www.seur.com/en/privacy-policy-and-cookies/) - [SEUR Terms and Transport Conditions](https://www.seur.com/es/condiciones-de-transporte/) - **GLS** (https://www.gls-spain.es/) - A link is generated for GLS if you have GLS shipping info in the order (barcode and shipping postcode). - Clicking the link will pass that information to GLS to show shipping progress. - [GLS Terms and Conditions](https://www.gls-spain.es/en/terms-and-conditions/) - [GLS Privacy Policy]()https://gls-group.eu/GROUP/en/privacy-policy/ - [GLS Data Protection declaration](https://www.gls-spain.es/en/data-protection/) - **TIPSA** (https://www.tip-sa.com/) - We display a link to the TIPSA shipment locator if your site ships an order with TIPSA. TIPSA offers no direct deep link, so the link points to their locator page and **no order data is included in it**. - [TIPSA Privacy Policy](https://www.tip-sa.com/es/tipsa-politica-privacidad) - [TIPSA Legal Notice](https://www.tip-sa.com/es/tipsa-aviso-legal) **3) Google Fonts** - **Domain/Service**: https://fonts.googleapis.com / https://fonts.gstatic.com (Google) - **What it's used for**: The Assistant widget loads the web fonts it renders with. - **What data is sent and when**: When a page containing the widget is loaded, the visitor's browser requests the font files from Google, which receives the request's IP address and user agent. - **Terms of service & privacy policy**: - [Google Terms of Service](https://policies.google.com/terms) - [Google Privacy Policy](https://policies.google.com/privacy) **4) ByNeural Platform redirection button** - This plugin connects to the byNeural platform to configure and manage the integration with WooCommerce. When users click the "Plataforma byNeural" button, they are redirected to the external URL: https://byneural.ai/dashboard. **No data is automatically sent** to the byNeural platform by this plugin when clicking the button. These external links and scripts are essential for the plugin’s functionality, allowing both the byNeural AI Assistant to be shown and the shipping trackers to be displayed if required. == Installation == 1. Upload the `byneural-ai-assistants-plugin` folder to `/wp-content/plugins/`. 2. Activate the plugin via the "Plugins" screen in WordPress. 3. Configure the key under "Settings -> ByNeural Custom WC API". == Frequently Asked Questions == = Does this plugin require WooCommerce? = Yes, WooCommerce must be active. = Where can I manage the plugin settings? = In the WordPress admin menu, look for the "ByNeural" page. The integration key can be modified from the plugin settings menu. == Screenshots == 1. Plugin settings in the admin panel (optional) == Changelog == = 1.2.0 = * Added: products sent to the Assistant now include every category branch they belong to, not just one. A product filed under several categories at once was previously visible in only one of them when browsing or searching. * Added: the product brand is now detected from the common brand taxonomies and product attributes, so the Assistant can answer questions about brands. * Added: the theme's search bar is marked up so the Assistant can enhance it, including the block editor and WooCommerce product search blocks. * Improved: orders are now resolved by the order number the customer actually sees. On stores using a custom order-numbering plugin, looking an order up by that number returned nothing or, worse, a different order. * Added: order tracking reads a free-text tracking field filled in by hand when the store does not use a tracking plugin. * Improved: the settings screen now uses `wp_die()` when the security check fails. * Fixed: the NACEX table lookup escaped the table name so it can no longer match a different table. = 1.1.0 = * Fixed: the widget markup and assets are no longer output on admin requests. On some stores this could interfere with the WooCommerce product editor and leave the admin screen unusable. * Improved: the widget script is now loaded after the page `load` event instead of being enqueued directly, so it no longer competes with the page's own resources and does not affect render-blocking or LCP. * Added: automatic WP Rocket compatibility. When WP Rocket is active, the widget loader is excluded from Delay JS, so the Assistant works without any manual configuration. * Added: order tracking now reads the WooCommerce "Shipment Tracking" order data when present, so the carrier, tracking number and shipping date are returned for any courier, not only the ones with a built-in integration. * Added: TIPSA is recognised as a courier. * Improved: the integration key is now compared using a timing-safe comparison. * Improved: the settings form sanitizes and unslashes submitted values before saving them. * Fixed: the widget mount element uses a namespaced id (`byneural-chatbot-root`) instead of the generic `root`, avoiding collisions with themes and other plugins. * Fixed: text domain mismatch in the settings screen. = 1.0 = * First release == Upgrade Notice == = 1.2.0 = Recommended for stores using a custom order-numbering plugin, and for anyone who wants the Assistant to know product categories and brands. = 1.1.0 = Recommended for all users: fixes an admin conflict with the WooCommerce product editor, improves front-end loading performance and extends order tracking support. = 1.0 = Initial recommended version.