=== Plugixa Recipe ===
Contributors: plugixa, freemius
Tags: recipe, recipes, nutrition, food, schema
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A modern recipe plugin with a React admin, multiple layouts, nutrition facts, reviews, collections, meal plans, and Recipe structured data for SEO.

== Description ==

Plugixa Recipe is a complete recipe management plugin for WordPress, built on a modern React admin panel. Create structured recipes with grouped ingredients and instructions, an FDA-style nutrition label, user reviews, collections, meal plans, and multiple frontend layouts.

= Key Features =

* **Modern React Admin** - Fast, Material UI-based admin for managing recipes, taxonomies, and settings
* **Unlimited Content** - Unlimited recipes, categories, cuisines, and courses
* **Rich Recipe Data** - Grouped ingredients and instructions, prep/cook times, servings, and 11 diet flags
* **Nutrition Facts** - 17-field FDA-style nutrition label
* **Multiple Layouts** - Grid, slider, masonry, and list display layouts
* **Saved Views & Shortcodes** - Unlimited saved views and saved shortcodes with a visual shortcode builder
* **Gutenberg Block & Widgets** - Recipe block plus 8 widget shortcodes (categories, cuisines, latest, popular, related, search, recipe of the day, and count)
* **User Engagement** - 5-star reviews with photos and admin replies, favorites, shopping lists, collections/cookbooks, and meal plans
* **Frontend Submission** - Let visitors submit recipes with the `[plugixa_recipe_form]` shortcode
* **Print View** - A clean, printable version of every recipe
* **Structured Data** - schema.org Recipe microdata (including ratings and nutrition) plus Open Graph and Twitter Card meta
* **Theming** - Dark mode, a font picker with locally-served fonts, and custom CSS per view
* **Multilingual** - WPML and Polylang support, including translatable categories and cuisines
* **Clean URLs** - `/recipe/`, `/recipe-category/`, `/recipe-cuisine/`
* **Integrations** - Elementor widget
* **Developer Friendly** - REST API (`plugixarecipe/v1`), action/filter hooks, and template overrides

= Shortcode Usage =

Display recipes:
`[plugixarecipe]`

With options (view and layout are configured via saved Views in the admin):
`[plugixarecipe view="12" layout="grid"]`

Frontend submission form:
`[plugixa_recipe_form]`

== Installation ==

1. Upload the `plugixarecipe` folder to `/wp-content/plugins/` (or install the ZIP via Plugins > Add New > Upload Plugin)
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to 'Plugixa Recipe' in the admin menu to add your recipes
4. Use the `[plugixarecipe]` shortcode or the Recipe block to display recipes on any page or post

== Frequently Asked Questions ==

= How do I add a recipe? =

After activating the plugin, open Plugixa Recipe in the WordPress admin menu and click "Add Recipe".

= How do I display recipes on my site? =

Use the `[plugixarecipe]` shortcode, the Recipe block, or one of the widget shortcodes on any page, post, or widget area.

= Does it output Recipe structured data for SEO? =

Yes. Every recipe is marked up with schema.org Recipe microdata, including aggregate ratings and nutrition information, so search engines can read it for rich results. Open Graph and Twitter Card meta tags are included too.

= Is it compatible with page builders? =

Yes. The shortcodes and block work with Gutenberg and major page builders, and an Elementor widget is included.

= Does it support translations? =

Yes. Plugixa Recipe is compatible with WPML and Polylang, including translatable categories and cuisines.

= Does it slow down my site? =

No. Recipe queries are served through the WordPress object cache, and the fonts used by the font picker are bundled with the plugin and served from your own server rather than a font CDN.

== External services ==

This plugin connects to the third-party services listed below. Apart from Freemius, every connection is optional: it is made only when a site administrator turns the relevant feature on.

= Freemius =

We use Freemius to handle licensing, software updates, and - only if you opt in - anonymous usage diagnostics. On activation you are shown an opt-in screen; if you skip it, no identifiable data is sent. When you opt in, or when you manage a license or purchase, data such as your site URL, WordPress and PHP versions, active theme/plugins, and the email address used at opt-in may be transmitted. This occurs on activation, plugin updates, and license actions.
Provided by Freemius, Inc. - Terms: https://freemius.com/terms/ - Privacy: https://freemius.com/privacy/

= Google reCAPTCHA (optional) =

If you enable reCAPTCHA for the frontend recipe submission form and/or the review form and enter your own reCAPTCHA site and secret keys, the plugin loads Google reCAPTCHA on those forms and verifies each submission with Google. When a visitor submits a protected form, the reCAPTCHA token and the visitor's IP address are sent to Google. It is disabled by default and requires your own reCAPTCHA keys.
Service: https://www.google.com/recaptcha/ - Terms: https://policies.google.com/terms - Privacy: https://policies.google.com/privacy

= YouTube and Vimeo (optional) =

If you add a YouTube or Vimeo video URL to a recipe, that recipe's page embeds the video using WordPress's built-in oEmbed. Your server requests the embed code from the video host, and the visitor's browser then loads the player from that host, which may set cookies. No video is embedded unless you add a video URL to a recipe.
YouTube - Terms: https://www.youtube.com/t/terms - Privacy: https://policies.google.com/privacy
Vimeo - Terms: https://vimeo.com/terms - Privacy: https://vimeo.com/privacy

The premium version adds optional features that, only when you enable and configure them, connect to their own providers: AI recipe generation (OpenAI - https://openai.com/policies/privacy-policy/ - or Google Gemini - https://policies.google.com/privacy), importing a recipe from a web address you supply (that address is fetched by your server), and one-click demo content, whose sample photos are downloaded from Unsplash (https://unsplash.com/privacy). None of these providers are contacted by the free version.

== Source Code ==

The compiled JavaScript and CSS in this plugin are built from human-readable source,
published as a versioned archive:

https://plugixa.com/source/plugixarecipe-source-1.0.0.zip

The archive contains the complete buildable source with pinned dependencies
(package.json + package-lock.json) and a README with build instructions:

* Admin app - assets/backend/app/ (React 19, Material UI, TanStack Query; Vite 6)
* Frontend styles - assets/frontend/ (Tailwind CSS 4)

Build with Node.js 20+: from each app directory run `npm install` then `npm run build`.

== Screenshots ==

1. Dashboard with statistics
2. Recipe management list
3. Recipe editor with React admin
4. Frontend recipe layouts (grid, slider, masonry, list)
5. Single recipe with nutrition facts and reviews
6. Settings page

== Changelog ==

= 1.0.0 =
* Initial release
* React admin panel for recipes, categories, cuisines, and courses
* Grid, slider, masonry, and list layouts with saved views and shortcodes
* FDA-style nutrition facts label
* Reviews, favorites, collections, shopping lists, and meal plans
* Frontend recipe submission form
* schema.org Recipe microdata, Open Graph and Twitter Card meta
* WPML and Polylang multilingual support
* REST API and developer hooks

== Upgrade Notice ==

= 1.0.0 =
Initial release of Plugixa Recipe.
