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:

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)

適用於區塊編輯器

這個外掛提供 11 個可供 Gutenberg/區塊編輯器使用的區塊。

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

安裝方式

  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

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈Marzipan Commerce for Wineries〉的開發相關工作。

參與者

將〈Marzipan Commerce for Wineries〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

1.0.15

Product pages now also render a Schema.org Product JSON-LD block and the actual product content (name, description, price, availability and image) as real HTML server-side, extending the same per-product API fetch added in 1.0.14. Search crawlers and AI fetchers read the raw HTML and don’t run the web component’s JavaScript, so previously they saw an empty shell with no product details or structured data. The web component still hydrates and stays fully interactive on top of this server-rendered baseline, which it hides once it loads.

1.0.14

Product link previews now work when sharing a product page. The plugin renders Open Graph and Twitter Card tags (title, description, image, price and availability) server-side from the Marzipan API, because link scrapers (Facebook, X, iMessage, Slack, WhatsApp, etc.) fetch the raw HTML and don’t run the web component’s JavaScript. Generic Open Graph output from SEO plugins (Yoast, SEOPress, Rank Math) is suppressed on product pages so the per-product tags take effect.

1.0.13

Confirmed compatibility with WordPress 7.0 and bumped the “Tested up to” version. Fixed the block editor text domain so editor strings load translations correctly (all blocks now use the “marzipan-commerce-for-wineries” text domain).

1.0.12

Fixed the cart “continue shopping” link pointing to the wrong page. The cart component now receives the correct shop path across the block, Elementor widget and [marzipan_cart] shortcode, overriding the component’s default so it links to the actual store page.

1.0.11

Fixed Stripe Express Checkout and card fields not mounting when the checkout component is wrapped by wpautop (e.g. inside ACF/page-builder fields), which ejected the required slot containers out of the element. The checkout markup is now shielded from content formatting and restored intact.

1.0.10

Fixed the product detail page not rendering when the [marzipan_product_page] shortcode is placed inside an ACF field (e.g. page-builder themes), by injecting the product slug into ACF field content as well as the_content

1.0.9

Added support for Marzipan shortcodes inside ACF fields by stripping the

<

p> tags ACF wraps around Marzipan elements

1.0.8

Fixed Stripe Express Checkout and card payment form not always rendering on checkout

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