VANTA//01 Fashion Demo Importer

VANTA//01 Fashion Demo Importer creates a fictional futuristic streetwear storefront for WordPress and WooCommerce. It imports products, variations, editorial posts, synthetic customers, reviews, and sample orders in bounded, resumable batches.

This plugin is intended for local development, staging, screenshots, and demonstrations—not production stores.

Dataset

• 38 products
• 20 variable products
• 285 generated variations
• 5 product categories
• Product tags
• 10 editorial blog posts
• 3 blog categories
• Editorial tags
• 10 synthetic customer accounts
• 12 product reviews
• 3 completed sample orders

All product names, brand names, customer identities, reviews, posts, and orders are fictional. Demo email addresses use the reserved .test top-level domain.

Safety and idempotency

• Every created product, variation, post, attachment, user, review, and order receives a stable importer ownership/source marker.
• Existing products with matching SKUs, posts with matching slugs, or users with matching generated logins/emails are never overwritten unless they carry the expected importer marker. Collisions are reported in the import status.
• Repair passes update only importer-owned content and preserve unrelated content, including user-created variations.
• Demo users receive independent random 32-character passwords. The plugin never stores or displays a shared password.
• Sample orders use real purchasable variations for variable products and are found by stable order metadata, so repair passes do not duplicate them.
• Each request processes a small batch. Progress is stored between requests, each completed item is persisted immediately, and a database lock prevents concurrent import batches. Item writes and ownership markers share a database transaction so interrupted requests can be replayed safely.
• WooCommerce High-Performance Order Storage is supported.

Image provenance

The release contains no third-party photographs. Product and editorial records contain individual images.unsplash.com source URLs in data/products.json and data/blog-posts.json. During import, WordPress downloads those URLs directly into its Media Library.

See IMAGE-SOURCES.md for usage and attribution details.

Requirements

• WordPress 6.0 or newer
• PHP 7.4 or newer
• WooCommerce 8.0 or newer
• Outbound HTTPS access to images.unsplash.com for demo imagery

Installation

1. Download vanta-demo-1.3.0.zip from the latest GitHub release.
2. In WordPress, open Plugins > Add New > Upload Plugin.
3. Select the ZIP, install it, and activate VANTA//01 Fashion Demo Importer.
4. Open Tools > VANTA//01 Demo.
5. Select Import / Continue Demo repeatedly until the stage reads Complete.

You can also clone this repository into wp-content/plugins/vanta-demo.

Import flow

The importer deliberately does not attempt all content in one HTTP request. Each submission processes one of the following stages or one bounded item batch:

1. Create WooCommerce attribute definitions.
2. Create categories, tags, and attribute terms on the next request.
3. Import products and variations in groups of four.
4. Import editorial posts in groups of five.
5. Import users in groups of five.
6. Import reviews in groups of six.
7. Create or repair three sample orders.

Errors and image download failures are retained in the visible status. A failed item does not silently stop later items. After a pass completes, select Run Repair Pass to retry missing content and update importer-owned records.

The importer reuses existing categories, tags, and global attribute terms when their slugs already exist. Those shared taxonomy terms are not ownership-marked or automatically removed.

Demo customer access

Demo accounts are intentionally created with random passwords. If a demo customer login is needed, use WordPress's normal password-reset flow or assign a new password from the Users screen.

Uninstall behavior

Uninstalling removes only the import progress option. It does not delete products, posts, users, media, reviews, orders, or taxonomies because deleting store content automatically would be unsafe. Imported records keep their source markers for a future repair pass or deliberate manual cleanup.

Development

The production source is maintained in the coded-letter-monorepo and released to this public repository. The plugin has no build step.

Validate PHP changes with:

php -l vanta-demo.php
php -l includes/class-coded-letter-vanta-demo-importer.php
php -l includes/superfunky-release-client.php
php -l includes/superfunky-update-client.php
php -l uninstall.php

Validate data files with:

jq empty data/*.json

License

The plugin code and fictional dataset are free software licensed under the GNU General Public License v2.0 or later. Third-party images are not included in this repository or release.