=== Factorize Setup ===
Contributors: webyoungstown
Tags: woocommerce, setup wizard, demo content, store builder, onboarding
Requires at least: 6.2
Tested up to: 6.7
Stable tag: 1.0.1
Requires PHP: 7.4
License: Factorize License (proprietary)
License URI: https://factorize.webyoungstown.com/license/

Build a complete Factorize store on the WordPress you are logged into: one screen, step-by-step progress, dark or light palette, demo catalog.

== Description ==

Factorize Setup is the in-admin twin of the Factorize Site Builder. Instead of assembling a new Docker stack, it converts the WordPress it is installed on: pick a store name, what you sell, a color scheme, and the Factorize features you want, click Build, and watch it install WooCommerce, the auction engine, the Factorize plugins and theme, apply your palette, and fill the store with demo products, a generated logo, a home page, and a menu.

= Features =

* One screen, same questions as the Site Builder wizard: identity, vertical (tools / clothing / general), palette, features, demo size, auction length.
* Installs WooCommerce from wordpress.org and skips its onboarding wizard, task list, and "coming soon" curtain.
* Installs Ultimate WooCommerce Auction when Auctions is chosen.
* Installs the chosen Factorize plugins and the Empire Tools theme from bundled zips; folders already present are reused, never overwritten.
* Nine palettes — five dark (Ember, Ocean, Forest, Violet, Amber) and four light (Paper, Linen, Cloud, Blush) — each setting all 35 theme color tokens.
* Generated two-tone logo and favicon from the store name, in the palette.
* WooCommerce basics: USD, guest checkout, Local Pickup + Flat Rate, Pay at pickup.
* Demo catalog for the vertical: categories, products with placeholder tiles (garment silhouettes for clothing), retail prices for the "% below retail" line, stock and sales variety, SKUs DEMO-0001….
* Category thumbnails, deal ranks, popularity scores (when Catalog is present).
* ~60% of in-stock products become live auctions (when Auctions is present).
* A paid demo member so perks are visible at once.
* Storefront band, Visit-the-Store address/hours/phone, shortcode home page, main menu.
* Step-by-step progress with retry; safe to re-run — products are never duplicated.
* Registers a Setup tab and card in the shared Factorize hub, and lets plain administrators see the hub before WooCommerce exists.

= Works standalone, better together =

Factorize Setup is standalone by definition: it is the plugin that brings the rest of the suite onto a site. It ships the guarded copy of the Factorize hub like every other Factorize plugin.

= Configuration =

Defaults live in config.php and merge with the factorize-setup_options option (override any subset), filtered through factorize-setup_config:

* features (all nine slugs) — which Factorize plugins the wizard offers.
* default_on (essentials catalog analytics storefront auctions perks portal) — ticked by default.
* product_chunk (12) — demo products created per step.
* bundle_dir (bundle/) — where the plugin/theme zips live.
* theme (empire-tools) — theme slug to install and activate.

== Installation ==

1. Upload the factorize-setup folder to /wp-content/plugins/ and activate it.
2. Open Factorize → Setup.
3. Answer the form and click Build this store. First build on a fresh site takes 2–4 minutes.
4. Follow the links to the store, the Factorize hub, and the Customizer.

== Frequently Asked Questions ==

= Will it touch an existing store? =

Yes — it installs plugins, switches the theme, and adds products and pages. Run it on a fresh site or one you mean to convert. It never deletes anything.

= Can I run it again? =

Yes. Settings, palette, and the home page refresh; products with existing SKUs are skipped; the logo, band, menu, and demo member are kept.

= Where do the Factorize plugins come from? =

From zips in the plugin's bundle/ folder (rebuild with build-bundle.sh). WooCommerce and the auction engine download from wordpress.org.

= It says the filesystem cannot be initialized. =

The web server user cannot write wp-content. Add define( 'FS_METHOD', 'direct' ); to wp-config.php and fix folder ownership, or unzip the bundle by hand and re-run.

== Changelog ==

= 1.0.0 =
* Initial release: one-screen store builder with WooCommerce/auction-engine install, bundled Factorize plugins + theme, nine palettes, three demo verticals, chunked seeding with progress.
