=== Roaster Recipe Widget by beean ===
Contributors: beean, beeancoffee
Tags: recipe, coffee, woocommerce, embed, widget
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Integrate beean coffee recipe widgets into WooCommerce product pages.

== Description ==

beean recipe widget seamlessly integrates beean coffee recipe widgets into your WooCommerce product pages. Perfect for coffee roasters who want to display brewing recipes alongside their products.

= Features =

* **Simple Integration** - Add a recipe widget ID in the product editor sidebar
* **Automatic Embedding** - Recipe widgets display automatically on product pages
* **Flexible Display Options** - Use action hook `do_action('beean_recipe')` for custom placement
* **Shortcode Support** - Use `[beean_recipe]` shortcode anywhere on your site
* **Theme Compatible** - Works with popular WordPress themes and page builders like Uncode
* **WooCommerce HPOS Ready** - Fully compatible with High-Performance Order Storage
* **Secure** - Proper nonce verification and input sanitization

= How It Works =

1. Install and activate the plugin
2. Edit any WooCommerce product
3. Find the "beean recipe widget ID" field in the sidebar
4. Enter your recipe widget ID (use this ID for testing: `njxnyk3pdqvbd-41`)
5. Save the product
6. The recipe widget will automatically display on the product page

= Display Methods =

**Shortcode**

Use the `[beean_recipe]` shortcode to embed recipe widgets anywhere on your site:

* `[beean_recipe]` - On product pages, automatically uses the recipe ID from the product meta
* `[beean_recipe id="njxnyk2lg3rk5-24"]` - Display a specific recipe by ID (works on any page)

**Action Hook**

For theme customization, use `<?php do_action('beean_recipe'); ?>` in your template files to display the widget in custom locations.

= Requirements =

* WordPress 5.0 or higher
* WooCommerce 3.0 or higher
* PHP 7.2 or higher
* A beean recipe widget ID from beean Coffee

= Third-Party Service Usage =

This plugin relies on the beean Coffee external service to display recipe widgets on your website.

**Service Provider:** beean Coffee (https://beeancoffee.com)

**What the service does:**
The plugin loads recipe widget content and functionality from beean's servers at `roaster.beeancoffee.com`. This service provides interactive brewing recipe widgets that display coffee preparation instructions, timing, and brewing parameters.

**When data is sent:**
* When a visitor views a product page or any page containing a recipe widget, the plugin loads JavaScript from `https://roaster.beeancoffee.com/api/embed/{recipe-id}/script`
* The recipe ID (a unique identifier for the recipe) is sent to beean's servers to retrieve the appropriate recipe widget content
* No personal visitor data is collected or transmitted by this plugin to beean's servers

**Data transmitted:**
* Recipe widget ID (stored in product meta, e.g., "njxnyk2lg3rk5-24")
* Standard browser information that occurs with any external resource request (IP address, user agent)

**Legal Information:**
* Terms of Service: https://roaster.beeancoffee.com/terms-of-service
* Privacy Policy: https://roaster.beeancoffee.com/privacy-policy

== Installation ==

1. Upload the `roaster-recipe-widget-by-beean` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Edit a WooCommerce product and enter a beean recipe widget ID in the sidebar field

== Changelog ==

= 1.0.0 =
* Initial release
* WooCommerce product integration
* Shortcode support
* Action hook for custom placement
* HPOS compatibility

== Upgrade Notice ==

= 1.0.0 =
Initial release of the beean recipe widget plugin.