外掛說明

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)

適用於區塊編輯器

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

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.

安裝方式

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

常見問題集

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

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

對開發相關資訊感興趣？

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

變更記錄

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