Easy-WP/windows/README-Windows.md

Easy WordPress Bootstrap (Herd + DBngin) — Windows Edition

This kit lets Windows devs spin up a new local WordPress project using PowerShell only.

Includes

• wp-bootstrap.ps1 — main PowerShell script
• bootstrap.bat — one-click launcher
• plugins.json — minimal default plugin list (use file from repo root)

Prerequisites

• PHP installed and in PATH
• MySQL client (mysql.exe) in PATH (DBngin/MySQL installed and running)
• Git installed (for cloning the starter theme)
• WP-CLI: either installed globally as wp, or put wp-cli.phar next to this script and call with:
  • -WpCliPath "php .\wp-cli.phar"

Quick Start

1. Right-click PowerShell → Run as Administrator (first run only):

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
   

2. Open a normal PowerShell in this folder and run:

   .\wp-bootstrap.ps1 -ProjectName "Client Site"
   

   or double-click bootstrap.bat and enter the project name when prompted.

Optional parameters

• -AdminUser (default: vdidev)
• -AdminEmail (default: dev@vincentdesign.ca)
• -ThemeStarterRepo (default: VDI starter theme)
• -HerdWorkspace (default: "$HOME\Herd")
• -LocalTld (default: test)
• -MysqlHost / -MysqlPort / -MysqlRootUser / -MysqlRootPass
• -WpCliPath (set to "php .\wp-cli.phar" if not installed globally)

What it does

• Creates project folder under your Herd workspace
• Downloads WordPress core
• Creates database + user with random password
• Generates wp-config.php, shuffles salts
• Installs WordPress and sets the site/home URLs
• Creates Home and News pages, sets front page/posts page
• Sets permalinks to /%postname%/ and flushes
• Clones the starter theme, strips history, re-initializes a clean repo, and activates it
• Installs and (optionally) activates plugins from plugins.json
• Prints and saves a summary (bootstrap-summary.txt)

Troubleshooting

• WP-CLI not found: pass -WpCliPath "php .\wp-cli.phar" (place wp-cli.phar beside this script).
• MySQL not found: ensure mysql.exe is in PATH. With DBngin, add the MySQL bin folder to PATH.
• Access denied creating DB: verify -MysqlRootUser/-MysqlRootPass, or create a dev-only MySQL user with CREATE privileges.
• Herd not serving: Add/link the folder in Herd and browse to http://<slug>.test (or your chosen TLD).

Philosophy

DIY-first: keep plugins.json minimal. Only add big off‑the‑shelf stacks (e.g., ecomm) when warranted.