Marzipan Commerce for Wineries

Marzipan is subscription commerce software for wineries. This plugin integrates Marzipan’s web components into your WordPress site, providing:

Features

• Gutenberg Blocks for the WordPress block editor
• Elementor Widgets for Elementor page builder
• SEO Integration – Full support for Yoast SEO, SEOPress, and RankMath

Available Components

• Account – Customer account management portal
• Add to Cart – Add to cart button for a specific product
• Cart – Shopping cart with line items and totals
• Cart Icon – Cart icon with item count badge
• Collection – Display products from a specific collection
• Product – Display a single product by ID

Requirements

• WordPress 6.0 or higher
• PHP 7.4 or higher
• A Marzipan account with API token

External Services

This plugin connects to Marzipan’s web component service to provide e-commerce functionality:

• Service URL: https://web-components.marzipan.cloud
• When Used: Loaded on pages containing Marzipan blocks, widgets, or shortcodes
• Data Transmitted: Your Marzipan API token and customer interactions
• Terms of Service: https://marzipan.co/terms
• Privacy Policy: https://marzipan.co/privacy

Privacy Policy

This plugin stores your Marzipan API token in the WordPress database. When visitors interact with Marzipan components, their data is processed by Marzipan’s servers according to Marzipan’s Privacy Policy.

For more information about how Marzipan handles customer data, please visit our privacy policy.

Development

This plugin uses build tools to compile JavaScript for the Gutenberg blocks.

Source Code

The uncompiled source code for all JavaScript files is included in this plugin:

• Block source code: blocks/src/ directory contains the human-readable source for all Gutenberg blocks
• Build output: blocks/build/ directory contains the compiled production files

Build Instructions

To modify and rebuild the blocks:

1. Install Node.js (version 16 or higher)
2. Run npm install in the plugin directory
3. Run npm run build to compile the blocks
4. For development with hot reloading, run npm run start

Build Tools

• @wordpress/scripts – WordPress official build tooling for blocks
• webpack – Module bundler (configured via wp-scripts)

1. Upload the marzipan-commerce-for-wineries folder to the /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Go to Settings > Marzipan to configure your API token
4. Start using Marzipan blocks in Gutenberg or widgets in Elementor

How do I get an API token?

Log in to your Marzipan dashboard and navigate to Settings > API to generate a token.

Does this work with my theme?

Yes, the components should work with any theme.

Where can I read more about the plugin and the web components? +

You can browser our web component or (plugin)[https://docs.marzipan.co/web-components/wordpress?utm_source=wordpress&utm_medium=plugin&utm_campaign=readme] docs

1.0.6

Fixed admin menu icon alignment

1.0.5

Fixed license identifier consistency

1.0.4

Added store defaults support for boolean attributes
Updated readme

1.0.3

Updated stable version

1.0.2

Added assets for plugin page
Updated readme

1.0.1

Various bug fixes

1.0.0

Initial release of the Marzipan WordPress plugin.
* Initial release
* Gutenberg blocks
* Elementor widgets
* Yoast SEO and SEOPress integration