Showcase for Swell

Developer	Konstantinos Galanakis
Version	v1.3.0
Active Installs	0 +
Requires / Tested	6.0 / 6.9.4
Last Updated	2026-05-26 9:18pm GMT
Official Link	View Details →

Showcase for Swell connects your WordPress site to the Swell eCommerce platform — a headless commerce backend that handles your products, inventory, customers, orders, and checkout — and exposes that storefront natively inside WordPress through Gutenberg blocks and synced content.

If you run your store on Swell and want WordPress to be the front-end (for content, SEO, marketing pages, and a familiar admin), this plugin gives you the bridge: products are mirrored into WordPress as a custom post type so pages render fast and rank in search, while cart and checkout stay backed by Swell’s hosted infrastructure.

Why Swell + WordPress?

• Keep WordPress for what it does well — content, SEO, page building, editorial workflows — and let Swell handle the commerce engine.
• No WooCommerce required. No tax/shipping/payment plugin sprawl to manage. Swell handles orders, payments, taxes, and fulfillment integrations server-side.
• Products live as native WordPress posts, so every SEO, caching, and page-builder plugin you already use just works on product pages.

Features

• Native Gutenberg blocks — product grid, single product, category navigation, and search blocks you can drop into any post, page, or template.
• Product sync — products from your Swell store are pulled into a custom post type via WP-Cron. Pages render from the local DB, not live API calls, so they’re fast and crawlable.
• Cart sidebar — slide-out cart with quantity controls, item removal, and a checkout button that hands off to Swell’s hosted checkout.
• SEO out of the box — XML sitemap entries, JSON-LD Product structured data, Open Graph and Twitter meta tags are generated for every synced product.
• Block-based templates — ships with editable templates for single product and category archive views, fully customizable in the Site Editor.
• Setup wizard — guided onboarding that walks you through adding API credentials, picking which Swell categories to sync, and verifying the connection.
• Command center dashboard — a single admin screen showing sync status, last sync time, product counts, and quick links to Swell.

External Services

This plugin connects to the following external services:

1. Swell eCommerce API (api.swell.is) — Required for core functionality. Product data, cart operations, and checkout are handled via the Swell API. By configuring your Swell API keys and activating the plugin, you consent to data being exchanged with Swell’s servers. See Swell’s Terms of Service and Swell’s Privacy Policy.

2. Swell Hosted Checkout (*.swell.store) — When a customer proceeds to checkout, they are redirected to Swell’s hosted checkout page. Cart and order data is processed by Swell.

3. Stripe.js (js.stripe.com) — When the customer reaches a checkout page that uses a Stripe payment method configured in your Swell store, the plugin loads the Stripe.js client library from https://js.stripe.com/v3/. The library is fetched in the browser only on checkout pages and only when Stripe is the active payment provider; nothing is sent during normal browsing or product sync. The browser request shares the standard data Stripe needs to render its payment fields (referrer URL, user-agent, IP address). No card data is sent by the plugin itself — Stripe collects card data directly through its hosted iframe. See Stripe’s Terms of Service and Stripe’s Privacy Policy.

Development

The complete, unminified source code for every compiled asset shipped in this plugin is bundled inside the plugin ZIP under the src/ directory. The build configuration (webpack.config.js) and the package manifest (package.json) are included alongside it so any reviewer or developer can reproduce the contents of build/ from scratch.

Build steps

1. npm install — install the build toolchain (@wordpress/scripts, Webpack, Babel, etc.).
2. npm run build — produce the production assets in build/.
3. npm start — incremental development build with watch mode.

Source layout

• src/ — Gutenberg block scripts, frontend scripts, dashboard React app, and SCSS partials. Compiled by @wordpress/scripts into build/.
• includes/ — PHP classes autoloaded under the Showcase_For_Swell namespace via Composer.
• templates/ — block-based template HTML and PHP fallbacks.

Testing

• npm run lint:php / npm run lint:js / npm run lint:css — static analysis.
• npm run test:php — PHPUnit suite (configuration in phpunit.xml.dist).
• npm run test:js — Jest suite (configuration in jest.config.js).
• npm run test:e2e — Playwright end-to-end suite under tests/e2e/.

Privacy Policy

Showcase for Swell does not collect any personal data from site visitors or administrators beyond what is necessary for eCommerce functionality (cart contents, checkout data) which is processed by Swell.

No analytics, telemetry, or tracking data is collected by the plugin.