@caweb/cli 1.0.0 → 1.0.2

package/lib/caweb.js

@@ -2,97 +2,48 @@
 /**
  * External dependencies
  */
-const dockerCompose = require( 'docker-compose' );
-const path = require( 'path' );
-const loadConfig = require( '@wordpress/env/lib/config/load-config' );
-
+const retry = require( '@wordpress/env/lib/retry' );
 
 /**
  * Internal dependencies
  */
 const { CAWEB_OPTIONS } = require('./options');
+const { runDockerCmds } = require('./docker');
+const { isMultisite } = require('./wordpress');
+const { configureDivi } = require('./divi');
 
 /**
+ * Activates the CAWeb Theme for the WordPress Environment if it's installed.
  * 
- * @param {Object}  options
- * @param {Object}  options.spinner A CLI spinner which indicates progress.
- * @param {boolean} options.environment   Which environment to open terminal in.
- * @param {Array} options.cmds   Array of commands to run.
- * 
- * @returns {Object}
+ * @param {string}		environment   Which environment to activate the theme on.
+ * @param {WPConfig} 	config	      The wp-env config object.
  */
-async function runDockerCmd({
-	spinner,
+async function activateCAWeb(
 	environment,
-	cmds
-}) {
+	config
+){
 
-	try {
-		const config = await loadConfig(path.resolve('.'));
-
-		// -eo pipefail exits the command as soon as anything fails in bash.
-		//const setupCommands = [ 'set -eo pipefail' ];
-
-		// Execute all setup commands in a batch.
-		return await dockerCompose.run(
-			environment === 'development' ? 'cli' : 'tests-cli',
-			[ 'bash', '-c', cmds.join( ' && ' ) ],
-			{
-				cwd: config.workDirectoryPath,
-				commandOptions: [ '--rm' ],
-				log: config.debug,
-			}
-		).then(
-			(result) => {
-				if( '' !== result.out ){
-					console.log( result.out )
-				}else{
-					console.log(result.err)
-				}
-				return result;
-			},
-			(err) => {
-				return false;
-			}
-		)
+	const isMulti = await isMultisite( environment, config );
 
-	} catch(error) {
-		console.log(error)
+	let cmds = ['wp theme is-installed CAWeb'];
 
-		process.exit( 1 );
+	if( false !== isMulti ){
+		cmds.push( 'wp theme enable CAWeb --network --activate' );
+	}else{
+		cmds.push( 'wp theme activate CAWeb' );
 	}
-	
-};
 
-/**
- * Activates the CAWeb Theme for the WordPress Environment if it's installed.
- * 
- * @param {Object}  options
- * @param {Object}  options.spinner A CLI spinner which indicates progress.
- * @param {boolean} options.environment   Which environment to activate the theme on.
- */
-async function activateCAWeb({
-	spinner,
-	environment
-}){
-	return await runDockerCmd( {
-		spinner,
+	return await runDockerCmds(
 		environment,
-		cmds: ['wp theme is-installed CAWeb && wp theme activate CAWeb']
-	}).then(
-		(result) => {
-			return true;
-		},
-		(err) => {
-			return false;
-		}
-	)
+		cmds,
+		config
+	);
 
 }
 
 /**
- * Configures WordPress for the given environment by installing WordPress,
- * activating all plugins, and activating the first theme. These steps are
+ * Configures CAWebPublishing Service for the given environment by configure settings,
+ * and activating the CAWeb theme. These steps are
  * performed sequentially so as to not overload the WordPress instance.
  *
  * @param {WPEnvironment} environment The environment to configure. Either 'development' or 'tests'.
@@ -102,39 +53,79 @@ async function activateCAWeb({
 async function configureCAWeb( environment, config, spinner ) {
 	
 
-	const isThemeActivated = await activateCAWeb( {
-		spinner,
-		environment
-	})
+	const isThemeActivated = await activateCAWeb( environment, config );
+
+	const {
+		DESIGN_SYSTEM_ENABLED,
+		WP_PERMALINK
+	} = config.env[ environment ].config
 
 	// if our theme is active.
-	if( isThemeActivated ){
+	if( false !== isThemeActivated ){
 		let themeOptions = [];
 
 		// iterate over config options.
 		Object.entries(config.env[ environment ].config).forEach(([k,v]) => {
 			// if the option is prefixed with CAWEB_ and is a valid CAWeb Option.
 			if ( `${k}`.startsWith('CAWEB_') && undefined !== CAWEB_OPTIONS[k] ){
+				const option = CAWEB_OPTIONS[k];
 				// set the option.
 				themeOptions.push(
-					`wp option set '${CAWEB_OPTIONS[k]}' "${v}"`
+					`wp option set '${option.name}' "${v}"`
 				);
 			}
 		})
 
-
-		await runDockerCmd({
-			spinner,
+		if ( config.debug ) {
+			spinner.info(
+				`Running the following setup commands on the ${ environment } instance:\n - ${ setupCommands.join(
+					'\n - '
+				) }\n`
+			);
+		}
+		
+		// Execute theme option commands.
+		await runDockerCmds(
 			environment,
-			cmds: themeOptions
-		})
+			themeOptions,
+			config
+		);
+
+		// Make Divi WordPress Configurations.
+		await Promise.all( [
+			retry( () => configureDivi( 'development', config, spinner ), {
+				times: 2,
+			} ),
+			retry( () => configureDivi( 'tests', config, spinner ), {
+				times: 2,
+			} ),
+		] );
 	}
 		
+	// Activate Design System plugin
+	if( undefined !== DESIGN_SYSTEM_ENABLED && DESIGN_SYSTEM_ENABLED ){
+		await runDockerCmds(
+			environment,
+			[
+				'wp plugin is-installed design-system-wordpress', 
+				'wp plugin activate design-system-wordpress'
+			],
+			config
+		)
+	}
 	
+	// rewrite and flush permalink structure.
+	await runDockerCmds(
+		environment,
+		[
+			`wp rewrite structure ${WP_PERMALINK} --hard`,
+			'wp rewrite flush --hard'
+		],
+		config
+	);
 }
 
 module.exports = {
 	activateCAWeb,
 	configureCAWeb,
-	runDockerCmd
 };

package/lib/cli.js

@@ -96,14 +96,24 @@ module.exports = function cli() {
 				describe: 'True if excluding any downloads from CAWeb, use this if you want to use a local version of the CAWeb Theme, Configurations will still be applied.',
 				default: false,
 			} );
-			
+			args.option( 'multisite', {
+				alias: 'm',
+				type: 'boolean',
+				describe: 'True if converting to multisite.',
+				default: false,
+			} );
+			args.option( 'subdomain', {
+				type: 'boolean',
+				describe: 'If passed, the network will use subdomains, instead of subdirectories. Doesn’t work with ‘localhost’.',
+				default: false,
+			} );
 		},
 		withSpinner( env.start )
 	);
 
 	// Shell Terminal Command.
 	yargs.command(
-		'shell  ',
+		'shell [environment]',
 		'Open shell terminal in WordPress environment.', 
 		(args) => {
 			args.positional( 'environment', {
@@ -116,6 +126,21 @@ module.exports = function cli() {
 		withSpinner( env.shell )
 	)
 
+	// Update Plugin Command.
+	yargs.command(
+		'update-plugins [environment]',
+		'Updates all plugins in the WordPress environment.', 
+		(args) => {
+			args.positional( 'environment', {
+				type: 'string',
+				describe: "Which environment to update.",
+				choices: [ 'development', 'tests' ],
+				default: 'development',
+			} );
+		}, 
+		withSpinner( env.updatePlugins )
+	)
+
 	// Test Command.
 	yargs.command(
 		'test [environment]',
@@ -127,6 +152,7 @@ module.exports = function cli() {
 				choices: [ 'development', 'tests' ],
 				default: 'development',
 			} );
+			
 		}, 
 		withSpinner( env.test )
 	)

package/lib/commands/index.js

@@ -10,8 +10,11 @@ const shell = require('./shell')
 const start = require('./start')
 const test = require( './test' );
 
+const tasks = require('./tasks');
+
 module.exports = {
 	shell,
 	start,
-	test
+	test,
+	...tasks
 };

package/lib/commands/shell.js

@@ -2,7 +2,7 @@
 /**
  * External dependencies
  */
-const wpEnvRun = require( '@wordpress/env/lib/commands/run' );
+const run = require( '@wordpress/env/lib/commands/run' );
 
 /**
  * Internal dependencies
@@ -22,10 +22,8 @@ module.exports = async function shell({
 	debug
 }) {
 
-	const container = 'tests' === environment ? 'tests-cli' : 'cli';
-
-	await wpEnvRun({
-		container: container,
+	await run({
+		container: 'tests' === environment ? 'tests-cli' : 'cli',
 		command: ['bash'],
 		"": "",
 		envCwd: '.',

package/lib/commands/start.js

@@ -28,6 +28,7 @@ const CONFIG_CACHE_KEY = 'config_checksum';
 const { configureCAWeb } = require('../caweb');
 const { buildWPEnvConfig, buildDockerComposeConfig } = require('../configs');
 const {downloadSources } = require('../download-sources');
+const { convertToMultisite } = require('../wordpress');
 
 /**
  * Promisified dependencies
@@ -45,6 +46,8 @@ const sleep = util.promisify( setTimeout );
  * @param {boolean} options.scripts Indicates whether or not lifecycle scripts should be executed.
  * @param {boolean} options.debug   True if debug mode is enabled.
  * @param {boolean} options.bare   True if excluding any CAWeb Configurations.
+ * @param {boolean} options.multisite   True if converting to multisite.
+ * @param {boolean} options.subdomain   True if converting to multisite subdomain.
  * 
  */
 module.exports = async function start({
@@ -53,14 +56,16 @@ module.exports = async function start({
 	xdebug,
 	scripts,
 	debug,
-	bare
+	bare,
+	multisite,
+	subdomain
 }) {
 	spinner.text = 'Writing configuration file...';
 	
 	// Write CAWeb .wp-env.json file.
 	await writeFile(
 		path.join(process.cwd(), '.wp-env.json'),
-		JSON.stringify( buildWPEnvConfig({bare}), null, 4 )
+		JSON.stringify( buildWPEnvConfig(bare, multisite), null, 4 )
 	);
 
 	// Get current wp-env cache key
@@ -110,17 +115,45 @@ module.exports = async function start({
 			await sleep( 4000 );
 		}
 
+
 		// Download any resources required for CAWeb.
 		if( ! bare ){
 			await downloadSources({spinner, config});
 		}
 				
+		// if multisite.
+		if( multisite ){
+			spinner.text = 'Converting to multisite ' + ( subdomain ? 'subdomain' : 'subdirectory') + '...'
+
+			await Promise.all( [
+				retry( () => convertToMultisite( 'development', config, subdomain ), {
+					times: 2,
+				} ),
+				retry( () => convertToMultisite( 'tests', config, subdomain ), {
+					times: 2,
+				} ),
+			] );
+	
+		}
+
 		// Write docker-compose.override.yml file to workDirectoryPath.
 		await writeFile(
 			path.join(workDirectoryPath, 'docker-compose.override.yml'),
 			yaml.dump( buildDockerComposeConfig(workDirectoryPath) )
 		);
 
+		spinner.text = 'Configuring CAWebPublishing Environments...';
+
+		// Make CAWeb WordPress Configurations.
+		await Promise.all( [
+			retry( () => configureCAWeb( 'development', config, spinner ), {
+				times: 2,
+			} ),
+			retry( () => configureCAWeb( 'tests', config, spinner ), {
+				times: 2,
+			} ),
+		] );
+
 		// Start phpMyAdmin Service.
 		spinner.text = 'Starting phpMyAdmin Service';
 
@@ -137,18 +170,6 @@ module.exports = async function start({
 			log: debug
 		})
 
-		spinner.text = 'Configuring CAWebPublishing Environments...';
-
-		// Make CAWeb WordPress Configurations.
-		await Promise.all( [
-			retry( () => configureCAWeb( 'development', config, spinner ), {
-				times: 2,
-			} ),
-			retry( () => configureCAWeb( 'tests', config, spinner ), {
-				times: 2,
-			} ),
-		] );
-		
 		spinner.prefixText = preText + 
 			`phpMyAdmin development site started at http://localhost:8080\n` +
 			`phpMyAdmin development site started at http://localhost:9090\n\n`;

package/lib/commands/tasks/index.js

@@ -0,0 +1,13 @@
+'use strict';
+/**
+ * External dependencies
+ */
+
+/**
+ * Internal dependencies
+ */
+const updatePlugins = require('./update-plugins')
+
+module.exports = {
+	updatePlugins,
+};

package/lib/commands/tasks/update-plugins.js

@@ -0,0 +1,37 @@
+'use strict';
+/**
+ * External dependencies
+ */
+const run = require('@wordpress/env/lib/commands/run');
+
+/**
+ * Internal dependencies
+ */
+const { runDockerCmds } = require('../../docker');
+const path = require( 'path' );
+const loadConfig = require( '@wordpress/env/lib/config/load-config' );
+
+/**
+ * Promisified dependencies
+ */
+
+/**
+ * Updates all plugins for a given environment.
+ * 
+ * @param {Object}  options
+ * @param {Object}  options.spinner A CLI spinner which indicates progress.
+ * @param {string} options.environment   Which environment to updated.
+ */
+module.exports = async function updatePlugins({
+	spinner,
+	environment
+}) {
+
+	spinner.text = "Updating plugins...";
+	const config = await loadConfig(path.resolve('.'));
+
+	await runDockerCmds( environment, ['wp plugin update --all'], config );
+
+	spinner.text = 'Completed updating plugins!'
+	
+};

package/lib/commands/test.js

@@ -8,19 +8,36 @@ const SimpleGit = require( 'simple-git' );
 const { execSync } = require( 'child_process' );
 const dockerCompose = require( 'docker-compose' );
 const loadConfig = require( '@wordpress/env/lib/config/load-config' );
+const run = require('@wordpress/env/lib/commands/run');
 
 /**
  * Internal dependencies
  */
 const {
-	runDockerCmd,
-} = require('../caweb');
+	runDockerCmds, 
+} = require('../docker');
 
-const { buildWPEnvConfig, buildDockerComposeConfig } = require('../configs');
+const { 
+	buildWPEnvConfig, 
+	buildDockerComposeConfig 
+} = require('../configs');
 
 const pkg = require( '../../package.json' );
-const { CAWEB_OPTIONS } = require('../options');
+const { DIVI_OPTIONS } = require('../options');
+
+const { 
+	isDiviThemeActive, 
+	configureDivi 
+} = require('../divi');
+
+const {
+	activateCAWeb,
+	configureCAWeb
+} = require('../caweb');
 
+const {
+	generateHTAccess
+} = require( '../wordpress' );
 
 /**
  * Promisified dependencies
@@ -33,51 +50,37 @@ const { writeFile } = fs.promises;
  * @param {Object}  options
  * @param {Object}  options.spinner A CLI spinner which indicates progress.
  * @param {boolean} options.environment   Which environment to test in.
+ * @param {boolean} options.debug   True if debug mode is enabled.
  */
 module.exports = async function test({
 	spinner,
-	environment
+	environment,
+	debug,
+	multisite,
+	subdomain
 }) {
 
 	try {
 		const config = await loadConfig(path.resolve('.'));
+		const {WP_PERMALINK} = config.env[ environment ].config
+		
+		spinner.text = "Testing code...";
 		/*
-		let themeOptions = [];
-
-		Object.entries(config.env[ 'development' ].config).forEach(([k,v]) => {
-			// if the option is prefixed with CAWEB_ and is a valid CAWeb Option.
-			if ( `${k}`.startsWith('CAWEB_') && undefined !== CAWEB_OPTIONS[k] ){
-				console.log(CAWEB_OPTIONS[k])
-				// set the option.
-				themeOptions.push(
-					`wp option set '${CAWEB_OPTIONS[k]}' "${v}"`
-				);
-			}
-		})
-
-		console.log(themeOptions);
-
-
-		// Write CAWeb .wp-env.json file.
-		await writeFile(
-			path.join(process.cwd(), '.wp-env.json'),
-			JSON.stringify( buildWPEnvConfig({bare: false}), null, 4 )
-		);
-
-		let result = await runDockerCmd( {
-			spinner,
+		let result = await runDockerCmds(
 			environment,
-			cmds: [`wp option set 'ca_site_version' "5.5"`]
-		})
-		
-		
-		Object.entries(result).forEach((k,v) => {
-			//console.log(`${k}:${v}`)
-		})
+			['wp theme is-installed CAWeb'],
+			config
+		)
 
-		//console.log(`Result: ${result}`)
+		if( '' !== result.out ) {
+			console.log( JSON.parse(result.out))
+		}else{
+			console.log(result);
+		}
 		*/
 
+		spinner.text = 'Completed Testing code...'
+
 	} catch(error) {
 		console.log(error)
 

package/lib/configs.js

@@ -9,10 +9,12 @@ const pkg = require( '../package.json' );
 /**
  * Build .wp-env.json
  * 
- * @param {boolean} options.bare   True if excluding any CAWeb Configurations.
+ * @param {boolean} bare   True if excluding any CAWeb Configurations.
+ * @param {boolean} multisite   True if converting to multisite.
+ * 
  * @returns object
  */
-const buildWPEnvConfig = ({bare}) => {
+const buildWPEnvConfig = (bare, multisite) => {
     let config = {
         core: `WordPress/WordPress#${pkg.config.WP_VER}`,
         phpVersion: `${pkg.config.PHP_VER}`,
@@ -26,6 +28,11 @@ const buildWPEnvConfig = ({bare}) => {
         config['themes'] = [`CA-CODE-Works/CAWeb`];
     }
 
+    // if is multisite
+    if( multisite ){
+        config.config['WP_ALLOW_MULTISITE'] = true;
+    }
+
     return config;
     
 }
@@ -68,14 +75,14 @@ const buildDockerComposeConfig = (workDirectoryPath) => {
 
     let extraVolumes = [];
 
-    // Divi theme to wordpress services volumes.
-    if( fs.existsSync(path.join(workDirectoryPath, 'Divi')) ){
-        extraVolumes = extraVolumes.concat(path.join(workDirectoryPath, 'Divi') + ':/var/www/html/wp-content/themes/Divi');
+    // Add downloaded themes to services volumes.
+    if( fs.existsSync(path.join(workDirectoryPath, 'themes')) ){
+        extraVolumes = extraVolumes.concat(path.join(workDirectoryPath, 'themes') + ':/var/www/html/wp-content/themes');
     }
 
-    // Divi plugin to wordpress services volumes.
-    if( fs.existsSync(path.join(workDirectoryPath, 'divi-builder')) ){
-        extraVolumes = extraVolumes.concat(path.join(workDirectoryPath, 'divi-builder') + ':/var/www/html/wp-content/plugins/divi-builder');
+    // Add downloaded plugins to services volumes.
+    if( fs.existsSync(path.join(workDirectoryPath, 'plugins')) ){
+        extraVolumes = extraVolumes.concat(path.join(workDirectoryPath, 'plugins') + ':/var/www/html/wp-content/plugins');
     }
 
     // Add extra volumes to WordPress instances.

package/lib/divi.js

@@ -0,0 +1,119 @@
+'use strict';
+/**
+ * External dependencies
+ */
+
+
+/**
+ * Internal dependencies
+ */
+const { runDockerCmds } = require('./docker');
+const { DIVI_OPTIONS, DIVI_BUILDER_OPTIONS, DIVI_UPDATE_OPTIONS } = require('./options');
+
+
+/**
+ * Checks if Divi Theme is active for the WordPress Environment.
+ * 
+ * @param {string} environment   Which environment to activate the theme on.
+ * @param {WPConfig} config      The wp-env config object.
+ */
+async function isDiviThemeActive(
+	environment,
+	config
+){
+
+	return await runDockerCmds(
+		environment,
+		['wp theme is-active Divi'],
+		config
+	);
+
+}
+
+/**
+ * Configures Divi for CAWebPublishing Service for the given environment by configure settings.
+ * These steps are performed sequentially so as to not overload the WordPress instance.
+ *
+ * @param {WPEnvironment} environment The environment to configure. Either 'development' or 'tests'.
+ * @param {WPConfig}      config      The wp-env config object.
+ * @param {Object}        spinner     A CLI spinner which indicates progress.
+ */
+async function configureDivi( environment, config, spinner ) {
+	
+	const activeTheme = await isDiviThemeActive( environment, config );
+
+	// if Divi theme is active.
+	if( false !== activeTheme ){
+		let cmds = [];
+		let diviOptions = await runDockerCmds(
+			environment,
+			[ 'wp option get et_divi --format=json' ], 
+			config
+		)
+		let diviBuilderOptions = await runDockerCmds(
+			environment,
+			[ 'wp option get et_bfb_settings --format=json' ], 
+			config
+		)
+		let diviUpdateOptions = await runDockerCmds(
+			environment,
+			[ 'wp option get et_automatic_updates_options --format=json' ], 
+			config
+		)
+
+		// parse the options into a json object.
+		diviOptions = diviOptions ? JSON.parse( diviOptions ) : {};
+		diviBuilderOptions = diviBuilderOptions ? JSON.parse( diviBuilderOptions ) : {};
+		diviUpdateOptions = undefined !== diviUpdateOptions && diviUpdateOptions ? JSON.parse( diviUpdateOptions ) : {};
+
+		// iterate over config options.
+		Object.entries(config.env[ environment ].config).forEach(([k,v]) => {
+			// if the option is prefixed with ET_.
+			if ( `${k}`.startsWith('ET_') ){
+				
+				// is a valid Divi Option.
+				if( undefined !== DIVI_OPTIONS[k] ){
+					diviOptions[DIVI_OPTIONS[k].name] = v;
+				// is a valid Divi Builder Option.
+				}else if( undefined !== DIVI_BUILDER_OPTIONS[k] ){
+					diviBuilderOptions[DIVI_BUILDER_OPTIONS[k].name] = v;
+				// is a valid Divi Update Option.
+				}else if( undefined !== DIVI_UPDATE_OPTIONS[k] ){
+					diviUpdateOptions[DIVI_UPDATE_OPTIONS[k].name] = v;
+				}
+			}
+		});
+
+		// parse option object back to string.
+		diviOptions = JSON.stringify( diviOptions );
+		diviBuilderOptions = JSON.stringify( diviBuilderOptions );
+		diviUpdateOptions = JSON.stringify( diviUpdateOptions );
+
+		cmds.push(`wp option update et_divi '${diviOptions}' --format=json`);
+		cmds.push(`wp option update et_bfb_settings '${diviBuilderOptions}' --format=json`);
+		cmds.push(`wp option update et_automatic_updates_options '${diviUpdateOptions}' --format=json`);
+			
+
+		if ( config.debug ) {
+			spinner.info(
+				`Running the following setup commands on the ${ environment } instance:\n - ${ setupCommands.join(
+					'\n - '
+				) }\n`
+			);
+		}
+		
+		// Execute theme option commands.
+		await runDockerCmds(
+			environment,
+			cmds,
+			config
+		)
+	}
+		
+	
+}
+
+module.exports = {
+	configureDivi,
+	isDiviThemeActive
+};

package/lib/docker.js

@@ -0,0 +1,66 @@
+'use strict';
+/**
+ * External dependencies
+ */
+const dockerCompose = require( 'docker-compose' );
+const path = require( 'path' );
+const loadConfig = require( '@wordpress/env/lib/config/load-config' );
+
+
+/**
+ * Internal dependencies
+ */
+
+/**
+ * Runs commands on the given WordPress environment.
+ * 
+ * @param {string}		environment	Which environment to run docker command on.
+ * @param {string[]} 	cmds   		Array of commands to run.
+ * @param {WPConfig} 	config      The wp-env config object.
+ * 
+ * @returns {Object}
+ */
+async function runDockerCmds(
+	environment,
+	cmds,
+	config
+) {
+
+	try {
+		// Execute all setup commands in a batch.
+		return await dockerCompose.run(
+			environment === 'development' ? 'cli' : 'tests-cli',
+			[ 'bash', '-c', cmds.join( ' && ' ) ],
+			{
+				cwd: config.workDirectoryPath,
+				commandOptions: [ '--rm' ],
+				log: config.debug,
+			}
+		).then(
+			(output) => {
+				// Remove the Container information and new lines.
+				output.err = output.err.replace(/\s*Container .*Running\n|\n/g, '')
+				output.out = output.out.replace(/\s*Container .*Running\n|\n/g, '')
+
+				return '' !== output.out ? output.out : output.err;
+			},
+			(output) => {
+				// Remove the Container information and new lines.
+				output.err = output.err.replace(/\s*Container .*Running\n|\n/g, '')
+
+				return false;
+			}
+		);
+
+	} catch(error) {
+		console.log(error)
+
+		process.exit( 1 );
+	}
+	
+}
+
+
+module.exports = {
+	runDockerCmds
+};

package/lib/download-sources.js

@@ -54,7 +54,20 @@ async function downloadSources(
 
 	const { workDirectoryPath } = config;
 	const { development: dev, tests: test } = config.env;
-	let sources = [];
+
+	let pluginDir = path.resolve(workDirectoryPath, 'plugins');
+	let themeDir = path.resolve(workDirectoryPath, 'themes');
+
+	let sources = [
+		{
+			basename: 'Design System',
+			url: 'https://github.com/CA-CODE-Works/design-system-wordpress.git',
+			ref: 'main',
+			path: path.join(pluginDir, 'design-system-wordpress'),
+			clonePath: path.join(pluginDir, 'design-system-wordpress'),
+			type: 'git'
+		}
+	];
 
 	// Add Divi Theme and plugin to sources.
 	if( (undefined !== dev.config.ET_USERNAME && 
@@ -71,25 +84,22 @@ async function downloadSources(
 			{
 				basename: 'Divi',
 				url: `${url}?api_update=1&theme=Divi&api_key=${key}&username=${user}`,
-				path: path.join(workDirectoryPath, 'Divi'),
+				path: path.join(themeDir, 'Divi'),
 				type: 'zip'
 			},
 			{
 				basename: 'Divi Plugin',
 				url: `${url}?api_update=1&theme=divi-builder&api_key=${key}&username=${user}`,
-				path: path.join(workDirectoryPath, 'divi-builder'),
+				path: path.join(pluginDir, 'divi-builder'),
 				type: 'zip'
 			}
 		]);
 	}
 
+	// Ensure plugin/theme directory exists for downloading resources.
+	fs.ensureDir(themeDir);
+	fs.ensureDir(pluginDir);
 
-	// filter any undefined sources.
-	/*sources = sources.filter(function( element ) {
-		return element !== undefined;
-	 });
-	 
-	 */
 	 await Promise.all(
 		sources.map( ( source ) =>
 			downloadSource( source, {

package/lib/options.js

@@ -2,22 +2,260 @@
  * External dependencies
  */
 
+/**
+ * Missing options.
+ * 
+ * CAWEB_FAV_ICON
+ * CAWEB_ORG_LOGO
+ * Social Media Links
+ * Custom CSS/JS
+ * Alert Banners
+ * Additional Features
+ * 
+ *  @todo Add missing options.
+ */
 const caweb_general_options = {
-    CAWEB_TEMPLATE_VER: 'ca_site_version', // State Template Version
-    CAWEB_NAV_MENU_STYLE: 'ca_default_navigation_menu', // Header Menu Type
-    CAWEB_COLORSCHEME: 'ca_site_color_scheme', // Color Scheme
-    CAWEB_TITLE_DISPLAY: 'ca_default_post_title_display', // Title Display Default
-    CAWEB_STICKY_NAV: 'ca_sticky_navigation', // Sticky Navigation
-    CAWEB_MENU_HOME_LINK: 'ca_home_nav_link', // Menu Home Link
-    CAWEB_DISPLAY_POSTS_DATE: 'ca_default_post_date_display', // Display Date for Non-Divi Posts
-    CAWEB_X_UA_COMPATIBILITY: 'ca_x_ua_compatibility', // Legacy Browser Support
-    CAWEB_FRONTPAGE_SEARCH: 'ca_frontpage_search_enabled', // Show Search on Front Page
+    CAWEB_TEMPLATE_VER: {
+		name: 'ca_site_version',
+		defaultValue: '5.5',
+		label: 'State Template Version'
+	},
+    CAWEB_NAV_MENU_STYLE: {
+		name: 'ca_default_navigation_menu',
+		defaultValue: 'singlelevel',
+		label: 'Header Menu Type'
+	},
+    CAWEB_COLORSCHEME: {
+		name: 'ca_site_color_scheme',
+		defaultValue: 'oceanside',
+		label: 'Color Scheme'
+	},
+    CAWEB_TITLE_DISPLAY: {
+		name: 'ca_default_post_title_display',
+		defaultValue: false,
+		label: 'Title Display Default'
+	},
+    CAWEB_STICKY_NAV: {
+		name: 'ca_sticky_navigation',
+		defaultValue: false,
+		label: 'Sticky Navigation'
+	},
+    CAWEB_MENU_HOME_LINK: {
+		name: 'ca_home_nav_link',
+		defaultValue: false,
+		label: 'Menu Home Link'
+	},
+    CAWEB_DISPLAY_POSTS_DATE: {
+		name: 'ca_default_post_date_display',
+		defaultValue: false,
+		label: 'Display Date for Non-Divi Posts'
+	},
+    CAWEB_X_UA_COMPATIBILITY: {
+		name: 'ca_x_ua_compatibility',
+		defaultValue: false,
+		label: 'Legacy Browser Support'
+	},
+    CAWEB_FRONTPAGE_SEARCH: {
+		name: 'ca_frontpage_search_enabled',
+		defaultValue: false,
+		label: 'Show Search on Front Page'
+	},
+}
+
+let utility_links = [];
+
+for( let c = 1; c < 4; c++ ){
+	utility_links[`CAWEB_UTILITY_LINK${c}_ENABLED`] = {
+		name: `ca_utility_link_${c}_enable`,
+		defaultValue: false,
+		label: `Custom Link ${c}`	
+	}
+	utility_links[`CAWEB_UTILITY_LINK${c}_LABEL`] = {
+		name: `ca_utility_link_${c}_name`,
+		defaultValue: '',
+		label: `Custom Link ${c} Label`		
+	}
+	utility_links[`CAWEB_UTILITY_LINK${c}_URL`] = {
+		name: `ca_utility_link_${c}`,
+		defaultValue: '',
+		label: `Custom Link ${c} URL`		
+	}
+	utility_links[`CAWEB_UTILITY_LINK${c}_NEW_WINDOW`] = {
+		name: `ca_utility_link_${c}_new_window`,
+		defaultValue: false,
+		label: `Custom Link ${c} Open in New Tab`		
+	}
 }
 
+const caweb_utility_header_options = {
+	CAWEB_CONTACT_US_PAGE : {
+		name: 'ca_contact_us_link',
+		defaultValue: '',
+		label: 'Contact Us Page'
+	},
+	CAWEB_GEO_LOCATOR : {
+		name: 'ca_geo_locator_enabled',
+		defaultValue: false,
+		label: 'Enable Geo Locator'
+	},
+	CAWEB_UTILITY_HOME_LINK : {
+		name: 'ca_utility_home_icon',
+		defaultValue: false,
+		label: 'Home Link'
+	},
+	...utility_links
+};
+
+const page_header_options = {
+	CAWEB_CAWEB_ORG_LOGO_ALT_TEXT: {
+		name: '',
+		defaultValue: '',
+		label: 'Organization Logo-Alt Text'
+	}
+};
+
+const google_options = {
+	CAWEB_GOOGLE_SEARCH_ENGINE_ID : {
+		name: 'ca_google_search_id',
+		defaultValue: '',
+		label: 'Search Engine ID'
+	},
+	CAWEB_GOOGLE_ANALYTICS_ID: {
+		name: 'ca_google_analytic_id',
+		defaultValue: '',
+		label: 'Analytics ID'
+	},
+	CAWEB_GOOGLE_ANALYTICS4_ID: {
+		name: 'ca_google_analytic4_id',
+		defaultValue: '',
+		label: 'Analytics 4 ID'
+	},
+	CAWEB_GOOGLE_TAG_MANAGER_ID: {
+		name: 'ca_google_tag_manager_id',
+		defaultValue: '',
+		label: 'Tag Manager ID'
+	},
+	CAWEB_GOOGLE_META_ID: {
+		name: 'ca_google_meta_id',
+		defaultValue: '',
+		label: 'Site Verification Meta ID'
+	},
+	CAWEB_GOOGLE_TRANSLATE_MODE: {
+		name: 'ca_google_trans_enabled',
+		defaultValue: 'none',
+		label: 'Enable Google Translate'
+	},
+	CAWEB_GOOGLE_TRANSLATE_PAGE: {
+		name: 'ca_google_trans_page',
+		defaultValue: '',
+		label: 'Translate Page'
+	},
+	CAWEB_GOOGLE_TRANSLATE_PAGE_NEW_WINDOW: {
+		name: 'ca_google_trans_page_new_window',
+		defaultValue: true,
+		label: 'Open in New Tab'
+	},
+	CAWEB_GOOGLE_TRANSLATE_ICON: {
+		name: 'ca_google_trans_icon',
+		defaultValue: 'globe',
+		label: 'Icon'
+	}
+};
+
+const github_options = {
+	CAWEB_PRIVATE_REPO: {
+		name: 'caweb_private_theme_enabled',
+		defaultValue: false,
+		label: 'Is Private?'
+	},
+	CAWEB_GIT_USER: {
+		name: 'caweb_username',
+		defaultValue: 'CA-CODE-Works',
+		label: 'Username'
+	},
+	CAWEB_ACCESS_TOKEN: {
+		name: 'caweb_password',
+		defaultValue: '',
+		label: 'Token'
+	}
+};
+
 const CAWEB_OPTIONS = {
-    ...caweb_general_options
+    ...caweb_general_options,
+	...caweb_utility_header_options,
+	...page_header_options,
+	...google_options,
+	...github_options
+}
+
+const DIVI_OPTIONS = {
+	ET_DYNAMIC_MODULE: {
+		name: 'divi_dynamic_module_framework',
+		defaultValue: 'on',
+		label: 'Dynamic Module Framework'
+	},
+	ET_DYNAMIC_CSS: {
+		name: 'divi_dynamic_css',
+		defaultValue: 'on',
+		label: 'Dynamic CSS'
+	},
+	ET_CRITICAL_CSS: {
+		name: 'divi_critical_css',
+		defaultValue: 'on',
+		label: 'Critical CSS'
+	},
+	ET_DYNAMIC_JS: {
+		name: 'divi_dynamic_js_libraries',
+		defaultValue: 'on',
+		label: 'Dynamic JavaScript Libraries'
+	},
+	ET_CLASSIC_EDITOR: {
+		name: 'et_enable_classic_editor',
+		defaultValue: 'on',
+		label: 'Enable Classic Editor'
+	},
+	ET_STATIC_CSS_GENERATION: {
+		name: 'et_pb_static_css_file',
+		defaultValue: 'on',
+		label: 'Static CSS File Generation'
+	},
+	ET_PRODUCT_TOUR: {
+		name: 'et_pb_product_tour_global',
+		defaultValue: 'off',
+		label: 'Product Tour'
+	}
+}
+
+const DIVI_BUILDER_OPTIONS = {
+	ET_NEW_BUILDER_EXPERIENCE: {
+		name: 'enable_bfb',
+		defaultValue: 'off',
+		label: 'Enable The Latest Divi Builder Experience'
+	},
+	ET_OUTPUT_STYLES_INLINE: {
+		name: 'et_pb_css_in_footer',
+		defaultValue: 'off',
+		label: 'Output Styles Inline'
+	}
+}
+
+const DIVI_UPDATE_OPTIONS = {
+	ET_USERNAME: {
+		name: 'username',
+		defaultValue: '',
+		label: 'Username'
+	},
+	ET_API_KEY: {
+		name: 'api_key',
+		defaultValue: '',
+		label: 'API Key'
+	}
+
 }
 
 module.exports = {
-    CAWEB_OPTIONS
+    CAWEB_OPTIONS,
+	DIVI_OPTIONS,
+	DIVI_BUILDER_OPTIONS,
+	DIVI_UPDATE_OPTIONS
 }

package/lib/wordpress.js

@@ -0,0 +1,121 @@
+'use strict';
+const { writeFile } = require('fs-extra');
+const path = require( 'path' );
+/**
+ * External dependencies
+ */
+
+/**
+ * Internal dependencies
+ */
+const {runDockerCmds} = require('./docker');
+
+/**
+ * Checks whether WordPress environment is a multisite installation.
+ * 
+ * @param {string}		environment	Which environment to check for multisite installation.
+ * @param {WPConfig}    config      The wp-env config object.
+ * @returns 
+ */
+async function isMultisite( environment, config ){
+	return await runDockerCmds(
+		environment,
+		[ 'wp config get MULTISITE' ],
+		config
+	)
+}
+
+/**
+ * Transforms an existing single-site installation into a multisite installation.
+ * 
+ * @param {string} environment Which environment to convert into a multisite installation.
+ * @param {WPConfig} config The wp-env config object.
+ * @param {boolean} subdomain   True if converting to multisite subdomain.
+ * @returns 
+ */
+async function convertToMultisite( environment, config, subdomain ){
+	// before we can conver to multisite all plugins must be deactivated.
+	// first lets get all plugins
+	let activePlugins = await runDockerCmds(
+		environment,
+		['wp option get active_plugins --format=json'],
+		config
+	)
+
+	activePlugins = Object.values(JSON.parse( activePlugins ));
+
+	// deactivate all active plugins.
+	if( activePlugins.length ){
+		await runDockerCmds(
+			environment,
+			['wp plugin deactivate ' + activePlugins.join(' ')],
+			config
+		)
+	}
+	
+	// convert to multisite.
+	let command = 'wp core multisite-convert';
+
+	if( subdomain ){
+		command += ' --subdomains'
+	}
+
+	await runDockerCmds(
+		environment, 
+		[command],
+		config
+	)
+
+	// generate .htaccess
+	await generateHTAccess( environment, config.workDirectoryPath, subdomain );
+
+	// network activate all active plugins again.
+	if( activePlugins.length ){
+		await runDockerCmds(
+			environment,
+			['wp plugin activate ' + activePlugins.join(' ') + ' --network'],
+			config
+		)
+	}
+
+}
+
+/**
+ * Generates .htaccess file content.
+ * 
+ * @param {string} environment Which environment to generate .htaccess for.
+ * @param {boolean} subdomain True if converting to multisite subdomain.
+ */
+async function generateHTAccess(environment, workDirectoryPath, subdomain){
+	let trailingSlash = subdomain ? '^wp-admin$ wp-admin/ [R=301,L]' : '^([_0-9a-zA-Z-]+/)?wp-admin$ $1wp-admin/';
+	let writeRule1 = subdomain ? '^(wp-(content|admin|includes).*) $1 [L]' : '^([_0-9a-zA-Z-]+/)?(wp-(content|admin|includes).*) $2 [L]';
+	let writeRule2 = subdomain ? '^(.*\.php)$ $1 [L]' : '^([_0-9a-zA-Z-]+/)?(.*\.php)$ $2 [L]';
+
+	let htaccess = `
+		RewriteEngine On
+		RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
+		RewriteBase /
+		RewriteRule ^index\.php$ - [L]
+
+		# add a trailing slash to /wp-admin
+		RewriteRule ${trailingSlash}
+
+		RewriteCond %{REQUEST_FILENAME} -f [OR]
+		RewriteCond %{REQUEST_FILENAME} -d
+		RewriteRule ^ - [L]
+		RewriteRule ${writeRule1}
+		RewriteRule ${writeRule2}
+		RewriteRule . index.php [L]
+		`.replace(/\t/g, '').trim();
+
+	let folder = 'development' === environment ? 'WordPress' : 'Tests-WordPress'
+
+	await writeFile(path.join(workDirectoryPath, folder, '.htaccess'), htaccess);
+
+}
+
+module.exports = {
+	isMultisite,
+	convertToMultisite,
+	generateHTAccess
+};

package/package.json

@@ -1,21 +1,25 @@
 {
   "name": "@caweb/cli",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "CAWebPublishing Command Line Interface.",
   "main": "lib/env.js",
   "files": [
     "bin",
     "lib"
   ],
+  "directories": {
+    "doc": "docs",
+    "lib": "lib"
+  },
   "bin": {
     "caweb": "bin/caweb"
   },
   "scripts": {
     "caweb": "caweb",
-    "launch": "caweb start",
-    "pretest": "npm uninstall @caweb/cli",
-    "test": "npm pack && npm i caweb-cli-%npm_package_version%.tgz",
-    "posttest": "del caweb-cli-%npm_package_version%.tgz"
+    "test": "echo \"Error: run tests from root\" && exit 0",
+    "prelocaltest": "npm uninstall @caweb/cli",
+    "localtest": "npm pack && npm i caweb-cli-%npm_package_version%.tgz",
+    "postlocaltest": "del caweb-cli-%npm_package_version%.tgz"
   },
   "repository": {
     "type": "git",
@@ -30,6 +34,9 @@
   "bugs": {
     "url": "https://github.com/CAWebPublishing/caweb-cli/issues"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "homepage": "https://github.com/CAWebPublishing/caweb-cli#readme",
   "dependencies": {
     "@wordpress/env": "^8.11.0",
@@ -37,7 +44,7 @@
     "fs-extra": "^11.1.1"
   },
   "config": {
-    "WP_VER": "6.3.1",
+    "WP_VER": "6.3.2",
     "PHP_VER": "8.1",
     "DEFAULTS": {
       "WP_DEFAULT_THEME": "CAWeb",
@@ -45,15 +52,22 @@
       "WP_DEBUG": true,
       "WP_DEBUG_LOG": true,
       "WP_DEBUG_DISPLAY": false,
+      "WP_MEMORY_LIMIT": "256M",
+      "WP_MAX_MEMORY_LIMIT": "512M",
+      "WP_PERMALINK": "/%postname%/",
       "ADMIN_COOKIE_PATH": "/",
       "COOKIE_DOMAIN": "",
       "COOKIEPATH": "",
-      "SITECOOKIEPATH": ""
+      "SITECOOKIEPATH": "",
+      "ET_DYNAMIC_MODULE": "on",
+      "ET_DYNAMIC_CSS": "on",
+      "ET_CRITICAL_CSS": "on",
+      "ET_DYNAMIC_JS": "on",
+      "ET_STATIC_CSS_GENERATION": "on",
+      "ET_OUTPUT_STYLES_INLINE": "off",
+      "ET_PRODUCT_TOUR": "off",
+      "ET_NEW_BUILDER_EXPERIENCE": "off",
+      "ET_CLASSIC_EDITOR": "on"
     }
-  },
-  "directories": {
-    "doc": "docs",
-    "lib": "lib"
-  },
-  "devDependencies": {}
+  }
 }