Description

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:

Install Node.js (version 16 or higher)
Run npm install in the plugin directory
Run npm run build to compile the blocks
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)

Blocks

This plugin provides 11 blocks.

Add to Cart Add to cart button for a product.
Marzipan Products Display a grid of products with optional collection filtering.
Cart Shopping cart with line items and totals.
Checkout Checkout form for completing purchases.
Marzipan Form Display a Marzipan form.
Product Page Full product detail page. Automatically displays the product from the URL.
Collection Display products from a collection.
Account Customer account management portal.
Product Display a single product.
Cart Icon Cart icon with item count badge.
Marzipan Currency Switcher Currency selection dropdown.

Installation

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

FAQ

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

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Marzipan Commerce for Wineries” is open source software. The following people have contributed to this plugin.

Marzipan

Translate “Marzipan Commerce for Wineries” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.7

Replaced contactform component with new form component supporting a slug attribute
Added form block and Elementor widget with configurable form slug (defaults to “contact”)

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