=== Allspice ===
Contributors: allspicelabs
Tags: recipes, cooking, food, widget, analytics
Requires at least: 6.2
Tested up to: 6.9
Stable tag: 1.4.37
Requires PHP: 7.4
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed Allspice buttons on recipe posts, sync button configurations from Allspice, and enable automatic placement on supported recipe pages.

== Description ==

Allspice helps recipe publishers embed modern recipe interaction buttons directly into WordPress recipe pages.

This plugin loads the Allspice widget assets, syncs button configurations from Allspice, and supports both manual placement (shortcodes/blocks) and automatic placement based on your Allspice configuration.

**Key features:**

* **Manual placement** via shortcode:
  * `[allspice_button id="..."]`
* **Block editor support** (Gutenberg blocks)
* **Automatic placement** on supported recipe pages (when enabled in your Allspice configuration)
* **Sync tools** in the WordPress admin to fetch the latest button configuration and recipe URL mappings
* Lightweight front-end loading: widget scripts only load where needed

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/allspice/` or install via the WordPress admin.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Go to **Settings → Allspice**.
4. Enter your **Publisher ID** and **Domain ID** (provided by Allspice).
5. Click **Sync With Allspice** to fetch button settings.

== Frequently Asked Questions ==

= How do I add an Allspice button to a post? =

Use the shortcode:

`[allspice_button id="YOUR_BUTTON_ID"]`

You can also use blocks in the WordPress block editor if enabled.

= Will this slow down my site? =

The plugin is designed to only load Allspice widget assets on pages where they are needed, such as supported recipe pages or where you placed an Allspice button.

= Does this plugin work with recipe plugins like WP Recipe Maker? =

Yes. The plugin includes detection logic for common recipe themes/plugins and can support automatic placement depending on your configuration.

= Does Allspice require an account? =

Yes. You will need a Publisher ID and Domain ID to sync button configurations.

== Screenshots ==

1. Allspice settings page showing configuration fields and sync status.

== Changelog ==

= 1.4.16 =
* Improvements to automatic placement logic for inline and floating buttons.
* Added hardened front-end loading behavior and cache initialization.

== Upgrade Notice ==

= 1.4.16 =
General improvements and compatibility updates.