[CLI] Add WordPress constants using CLI arguments

CHANGELOG.md

@@ -4,89 +4,86 @@ All notable changes to this project are documented in this file by a CI job
 that runs on every NPM release. The file follows the [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 format.
 
-## [v0.9.46] (2024-10-07) 
+## [v0.9.46] (2024-10-07)
 
 ### Enhancements
 
-- Webapp upgrade protocol: Disable HTTP caching and reload other browser tabs to prevent fatal errors after new deployments. ([#1822](https://github.com/WordPress/wordpress-playground/pull/1822))
+-   Webapp upgrade protocol: Disable HTTP caching and reload other browser tabs to prevent fatal errors after new deployments. ([#1822](https://github.com/WordPress/wordpress-playground/pull/1822))
 
 ### Documentation
 
-- Docs: Disable localeDropdown until more pages are translated. ([#1824](https://github.com/WordPress/wordpress-playground/pull/1824))
-- Docs: Review playground documentation translations page. ([#1826](https://github.com/WordPress/wordpress-playground/pull/1826))
-- Docs: Playground PR previews through GitHub actions. ([#1825](https://github.com/WordPress/wordpress-playground/pull/1825))
+-   Docs: Disable localeDropdown until more pages are translated. ([#1824](https://github.com/WordPress/wordpress-playground/pull/1824))
+-   Docs: Review playground documentation translations page. ([#1826](https://github.com/WordPress/wordpress-playground/pull/1826))
+-   Docs: Playground PR previews through GitHub actions. ([#1825](https://github.com/WordPress/wordpress-playground/pull/1825))
 
 ### Website
 
-- Use site slug as a stable scope. ([#1839](https://github.com/WordPress/wordpress-playground/pull/1839))
-- Close Playground Manager by default. ([#1831](https://github.com/WordPress/wordpress-playground/pull/1831))
-- Fix go-to-site menu items to reveal site view. ([#1833](https://github.com/WordPress/wordpress-playground/pull/1833))
+-   Use site slug as a stable scope. ([#1839](https://github.com/WordPress/wordpress-playground/pull/1839))
+-   Close Playground Manager by default. ([#1831](https://github.com/WordPress/wordpress-playground/pull/1831))
+-   Fix go-to-site menu items to reveal site view. ([#1833](https://github.com/WordPress/wordpress-playground/pull/1833))
 
 ### Various
 
-- Add Install instructions to the Playwright README. ([#1837](https://github.com/WordPress/wordpress-playground/pull/1837))
-- Resolve end-to-end failures. ([#1844](https://github.com/WordPress/wordpress-playground/pull/1844))
+-   Add Install instructions to the Playwright README. ([#1837](https://github.com/WordPress/wordpress-playground/pull/1837))
+-   Resolve end-to-end failures. ([#1844](https://github.com/WordPress/wordpress-playground/pull/1844))
 
 ### Contributors
 
 The following contributors merged PRs in this release:
 
 @adamziel @akirk @brandonpayton @juanmaguitar
 
-
-## [v0.9.45] (2024-09-30) 
+## [v0.9.45] (2024-09-30)
 
 ### Blueprints
 
-- Translate GitHub.com file URLs into CORS-accessible raw.githubusercontent.com. ([#1810](https://github.com/WordPress/wordpress-playground/pull/1810))
+-   Translate GitHub.com file URLs into CORS-accessible raw.githubusercontent.com. ([#1810](https://github.com/WordPress/wordpress-playground/pull/1810))
 
 ### Tools
 
-- [UX] Stored Playgrounds (no more data loss), multiple Playgrounds, UI WebApp Redesign. ([#1731](https://github.com/WordPress/wordpress-playground/pull/1731))
+-   [UX] Stored Playgrounds (no more data loss), multiple Playgrounds, UI WebApp Redesign. ([#1731](https://github.com/WordPress/wordpress-playground/pull/1731))
 
 ### Documentation
 
-- Docs: Translation i18n messages - JSON files. ([#1807](https://github.com/WordPress/wordpress-playground/pull/1807))
+-   Docs: Translation i18n messages - JSON files. ([#1807](https://github.com/WordPress/wordpress-playground/pull/1807))
 
 ### Website
 
-- Prevent creation of two temporary sites. ([#1817](https://github.com/WordPress/wordpress-playground/pull/1817))
-- Stop address bar from adding trailing slash to query params. ([#1820](https://github.com/WordPress/wordpress-playground/pull/1820))
+-   Prevent creation of two temporary sites. ([#1817](https://github.com/WordPress/wordpress-playground/pull/1817))
+-   Stop address bar from adding trailing slash to query params. ([#1820](https://github.com/WordPress/wordpress-playground/pull/1820))
 
 ### Bug Fixes
 
-- Fix broken Playwright tests. ([#1819](https://github.com/WordPress/wordpress-playground/pull/1819))
+-   Fix broken Playwright tests. ([#1819](https://github.com/WordPress/wordpress-playground/pull/1819))
 
 ### Various
 
-- Add Playwright tests for UI redesign changes. ([#1769](https://github.com/WordPress/wordpress-playground/pull/1769))
-- Docs: Contributions to translations. ([#1808](https://github.com/WordPress/wordpress-playground/pull/1808))
+-   Add Playwright tests for UI redesign changes. ([#1769](https://github.com/WordPress/wordpress-playground/pull/1769))
+-   Docs: Contributions to translations. ([#1808](https://github.com/WordPress/wordpress-playground/pull/1808))
 
 ### Contributors
 
 The following contributors merged PRs in this release:
 
 @adamziel @bgrgicak @brandonpayton @juanmaguitar
 
-
-## [v0.9.44] (2024-09-24) 
+## [v0.9.44] (2024-09-24)
 
 ### Bug Fixes
 
-- Docs: Fix links intro fr. ([#1795](https://github.com/WordPress/wordpress-playground/pull/1795))
+-   Docs: Fix links intro fr. ([#1795](https://github.com/WordPress/wordpress-playground/pull/1795))
 
 ### Various
 
-- Add missing functions required to succesfully connect with MySQL DB. ([#1752](https://github.com/WordPress/wordpress-playground/pull/1752))
+-   Add missing functions required to succesfully connect with MySQL DB. ([#1752](https://github.com/WordPress/wordpress-playground/pull/1752))
 
 ### Contributors
 
 The following contributors merged PRs in this release:
 
 @jeroenpf @juanmaguitar
 
-
-## [v0.9.43] (2024-09-23) 
+## [v0.9.43] (2024-09-23)
 
 ### Documentation
 

packages/docs/site/docs/main/changelog.md

@@ -9,89 +9,86 @@ All notable changes to this project are documented in this file by a CI job
 that runs on every NPM release. The file follows the [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 format.
 
-## [v0.9.46] (2024-10-07) 
+## [v0.9.46] (2024-10-07)
 
 ### Enhancements
 
-- Webapp upgrade protocol: Disable HTTP caching and reload other browser tabs to prevent fatal errors after new deployments. ([#1822](https://github.com/WordPress/wordpress-playground/pull/1822))
+-   Webapp upgrade protocol: Disable HTTP caching and reload other browser tabs to prevent fatal errors after new deployments. ([#1822](https://github.com/WordPress/wordpress-playground/pull/1822))
 
 ### Documentation
 
-- Docs: Disable localeDropdown until more pages are translated. ([#1824](https://github.com/WordPress/wordpress-playground/pull/1824))
-- Docs: Review playground documentation translations page. ([#1826](https://github.com/WordPress/wordpress-playground/pull/1826))
-- Docs: Playground PR previews through GitHub actions. ([#1825](https://github.com/WordPress/wordpress-playground/pull/1825))
+-   Docs: Disable localeDropdown until more pages are translated. ([#1824](https://github.com/WordPress/wordpress-playground/pull/1824))
+-   Docs: Review playground documentation translations page. ([#1826](https://github.com/WordPress/wordpress-playground/pull/1826))
+-   Docs: Playground PR previews through GitHub actions. ([#1825](https://github.com/WordPress/wordpress-playground/pull/1825))
 
 ### Website
 
-- Use site slug as a stable scope. ([#1839](https://github.com/WordPress/wordpress-playground/pull/1839))
-- Close Playground Manager by default. ([#1831](https://github.com/WordPress/wordpress-playground/pull/1831))
-- Fix go-to-site menu items to reveal site view. ([#1833](https://github.com/WordPress/wordpress-playground/pull/1833))
+-   Use site slug as a stable scope. ([#1839](https://github.com/WordPress/wordpress-playground/pull/1839))
+-   Close Playground Manager by default. ([#1831](https://github.com/WordPress/wordpress-playground/pull/1831))
+-   Fix go-to-site menu items to reveal site view. ([#1833](https://github.com/WordPress/wordpress-playground/pull/1833))
 
 ### Various
 
-- Add Install instructions to the Playwright README. ([#1837](https://github.com/WordPress/wordpress-playground/pull/1837))
-- Resolve end-to-end failures. ([#1844](https://github.com/WordPress/wordpress-playground/pull/1844))
+-   Add Install instructions to the Playwright README. ([#1837](https://github.com/WordPress/wordpress-playground/pull/1837))
+-   Resolve end-to-end failures. ([#1844](https://github.com/WordPress/wordpress-playground/pull/1844))
 
 ### Contributors
 
 The following contributors merged PRs in this release:
 
 @adamziel @akirk @brandonpayton @juanmaguitar
 
-
-## [v0.9.45] (2024-09-30) 
+## [v0.9.45] (2024-09-30)
 
 ### Blueprints
 
-- Translate GitHub.com file URLs into CORS-accessible raw.githubusercontent.com. ([#1810](https://github.com/WordPress/wordpress-playground/pull/1810))
+-   Translate GitHub.com file URLs into CORS-accessible raw.githubusercontent.com. ([#1810](https://github.com/WordPress/wordpress-playground/pull/1810))
 
 ### Tools
 
-- [UX] Stored Playgrounds (no more data loss), multiple Playgrounds, UI WebApp Redesign. ([#1731](https://github.com/WordPress/wordpress-playground/pull/1731))
+-   [UX] Stored Playgrounds (no more data loss), multiple Playgrounds, UI WebApp Redesign. ([#1731](https://github.com/WordPress/wordpress-playground/pull/1731))
 
 ### Documentation
 
-- Docs: Translation i18n messages - JSON files. ([#1807](https://github.com/WordPress/wordpress-playground/pull/1807))
+-   Docs: Translation i18n messages - JSON files. ([#1807](https://github.com/WordPress/wordpress-playground/pull/1807))
 
 ### Website
 
-- Prevent creation of two temporary sites. ([#1817](https://github.com/WordPress/wordpress-playground/pull/1817))
-- Stop address bar from adding trailing slash to query params. ([#1820](https://github.com/WordPress/wordpress-playground/pull/1820))
+-   Prevent creation of two temporary sites. ([#1817](https://github.com/WordPress/wordpress-playground/pull/1817))
+-   Stop address bar from adding trailing slash to query params. ([#1820](https://github.com/WordPress/wordpress-playground/pull/1820))
 
 ### Bug Fixes
 
-- Fix broken Playwright tests. ([#1819](https://github.com/WordPress/wordpress-playground/pull/1819))
+-   Fix broken Playwright tests. ([#1819](https://github.com/WordPress/wordpress-playground/pull/1819))
 
 ### Various
 
-- Add Playwright tests for UI redesign changes. ([#1769](https://github.com/WordPress/wordpress-playground/pull/1769))
-- Docs: Contributions to translations. ([#1808](https://github.com/WordPress/wordpress-playground/pull/1808))
+-   Add Playwright tests for UI redesign changes. ([#1769](https://github.com/WordPress/wordpress-playground/pull/1769))
+-   Docs: Contributions to translations. ([#1808](https://github.com/WordPress/wordpress-playground/pull/1808))
 
 ### Contributors
 
 The following contributors merged PRs in this release:
 
 @adamziel @bgrgicak @brandonpayton @juanmaguitar
 
-
-## [v0.9.44] (2024-09-24) 
+## [v0.9.44] (2024-09-24)
 
 ### Bug Fixes
 
-- Docs: Fix links intro fr. ([#1795](https://github.com/WordPress/wordpress-playground/pull/1795))
+-   Docs: Fix links intro fr. ([#1795](https://github.com/WordPress/wordpress-playground/pull/1795))
 
 ### Various
 
-- Add missing functions required to succesfully connect with MySQL DB. ([#1752](https://github.com/WordPress/wordpress-playground/pull/1752))
+-   Add missing functions required to succesfully connect with MySQL DB. ([#1752](https://github.com/WordPress/wordpress-playground/pull/1752))
 
 ### Contributors
 
 The following contributors merged PRs in this release:
 
 @jeroenpf @juanmaguitar
 
-
-## [v0.9.43] (2024-09-23) 
+## [v0.9.43] (2024-09-23)
 
 ### Documentation
 

packages/playground/blueprints/public/blueprint-schema-validator.js

@@ -607,8 +607,8 @@ const schema11 = {
 						},
 						password: {
 							type: 'string',
-							description:
-								"The password to log in with. Defaults to 'password'.",
+							deprecated:
+								'The password field is deprecated and will be removed in a future version.\nOnly the username field is required for user authentication.',
 						},
 					},
 					required: ['step'],
@@ -3183,8 +3183,8 @@ const schema22 = {
 				},
 				password: {
 					type: 'string',
-					description:
-						"The password to log in with. Defaults to 'password'.",
+					deprecated:
+						'The password field is deprecated and will be removed in a future version.\nOnly the username field is required for user authentication.',
 				},
 			},
 			required: ['step'],

packages/playground/blueprints/public/blueprint-schema.json

@@ -724,7 +724,7 @@
 						},
 						"password": {
 							"type": "string",
-							"description": "The password to log in with. Defaults to 'password'."
+							"deprecated": "The password field is deprecated and will be removed in a future version.\nOnly the username field is required for user authentication."
 						}
 					},
 					"required": ["step"]

packages/playground/blueprints/src/lib/compile.ts

@@ -38,6 +38,7 @@ const keyedStepHandlers = {
  * watching for changes.
  */
 import blueprintValidator from '../../public/blueprint-schema-validator';
+import { defaultWpCliPath, defaultWpCliResource } from './steps/wp-cli';
 
 export type CompiledStep = (php: UniversalPHP) => Promise<void> | void;
 
@@ -147,7 +148,7 @@ export function compileBlueprint(
 		blueprint.steps!.push({
 			step: 'login',
 			...(blueprint.login === true
-				? { username: 'admin', password: 'password' }
+				? { username: 'admin' }
 				: blueprint.login),
 		});
 	}
@@ -170,15 +171,24 @@ export function compileBlueprint(
 	/**
 	 * Download WP-CLI. {{{
 	 * Hardcoding this in the compile() function is a temporary solution
-	 * to provide the wpCLI step with the wp-cli.phar file it needs. Eventually,
+	 * to provide steps with the wp-cli.phar file it needs. Eventually,
 	 * each Blueprint step may be able to specify any pre-requisite resources.
 	 * Also, wp-cli should only be downloaded if it's not already present.
+	 *
+	 * The enableMultisite step uses wp-cli to convert the site to a multisite.
+	 * The wp-cli step itself depends on WP-CLI.
 	 */
-	const wpCliStepIndex =
+	const indexOfStepThatDependsOnWpCli =
 		blueprint.steps?.findIndex(
-			(step) => typeof step === 'object' && step?.step === 'wp-cli'
+			(step) =>
+				typeof step === 'object' &&
+				step?.step &&
+				['wp-cli', 'enableMultisite'].includes(step.step)
 		) ?? -1;
-	if (blueprint?.extraLibraries?.includes('wp-cli') || wpCliStepIndex > -1) {
+	if (
+		blueprint?.extraLibraries?.includes('wp-cli') ||
+		indexOfStepThatDependsOnWpCli !== -1
+	) {
 		if (blueprint.phpExtensionBundles.includes('light')) {
 			blueprint.phpExtensionBundles =
 				blueprint.phpExtensionBundles.filter(
@@ -192,21 +202,8 @@ export function compileBlueprint(
 		}
 		const wpCliInstallStep: WriteFileStep<FileReference> = {
 			step: 'writeFile',
-			data: {
-				resource: 'url',
-				/**
-				 * Use compression for downloading the wp-cli.phar file.
-				 * The official release, hosted at raw.githubusercontent.com, is ~7MB
-				 * and the transfer is uncompressed. playground.wordpress.net supports
-				 * transfer compression and only transmits ~1.4MB.
-				 *
-				 * @TODO: minify the wp-cli.phar file. It can be as small as 1MB when all the
-				 *        whitespaces and are removed, and even 500KB when libraries
-				 *        like the JavaScript parser or Composer are removed.
-				 */
-				url: 'https://playground.wordpress.net/wp-cli.phar',
-			},
-			path: '/tmp/wp-cli.phar',
+			data: defaultWpCliResource,
+			path: defaultWpCliPath,
 		};
 		/**
 		 * If the blueprint does not have a wp-cli step,
@@ -216,10 +213,14 @@ export function compileBlueprint(
 		 * If the blueprint has wp-cli steps,
 		 * we need to install wp-cli before running these steps.
 		 */
-		if (wpCliStepIndex === -1) {
+		if (indexOfStepThatDependsOnWpCli === -1) {
 			blueprint.steps?.push(wpCliInstallStep);
 		} else {
-			blueprint.steps?.splice(wpCliStepIndex, 0, wpCliInstallStep);
+			blueprint.steps?.splice(
+				indexOfStepThatDependsOnWpCli,
+				0,
+				wpCliInstallStep
+			);
 		}
 	}