feat: add WP_BOOT_SYNC_ENABLED

Author: frugan-dev

.env.dist

@@ -1,3 +1,7 @@
+# Enable/disable WordPress sync to public directory
+# Set to 'true' to enable automatic sync via post-cmd.sh
+WP_BOOT_SYNC_ENABLED=false
+
 DB_HOST=
 DB_NAME=
 DB_USER=

README.md

@@ -69,8 +69,24 @@ composer create-project wp-spaghetti/wp-boot private/wp-boot
 cd private/wp-boot
 cp .env.dist .env
 # Edit .env with your configuration
+# IMPORTANT: Set WP_BOOT_SYNC_ENABLED=true to enable WordPress sync
 ```
 
+**Note:** During `composer create-project`, WordPress core will be downloaded to `vendor/wordpress/`, but files will **not** be synced to your `public/` directory until you set `WP_BOOT_SYNC_ENABLED=true` in your `.env` file.
+
+This gives you time to:
+1. Review and configure your `.env` file
+2. Verify the target `public/` directory exists and is correct
+3. Decide when to sync WordPress files
+
+Once configured, run:
+
+```bash
+composer install  # or composer update
+```
+
+This will trigger the sync script and copy WordPress core files to `../../public/`.
+
 Then add the bootstrap block to your `wp-config.php` file (see "How It Works" section above).
 
 ### Directory Structure

post-cmd.sh

@@ -18,9 +18,41 @@ _check_dependencies() {
 	fi
 }
 
+_load_env_files() {
+	local env_file=".env"
+	local env_files=("${env_file}")
+
+	# Check for environment-specific .env files (same logic as bootstrap.php)
+	if [[ -n "${APP_ENV:-}" ]]; then
+		env_files+=("${env_file}.${APP_ENV}")
+	fi
+
+	# Load .env files in order (later files override earlier ones)
+	for file in "${env_files[@]}"; do
+		if [[ -f "${file}" ]]; then
+			echo "Loading environment from: ${file}"
+			# Export variables while preserving quotes and handling comments
+			set -a
+			# shellcheck disable=SC1090
+			source <(grep -v '^[[:space:]]*#' "${file}" | grep -v '^[[:space:]]*$')
+			set +a
+		fi
+	done
+}
+
 main() {
 	_check_dependencies
 
+	# Load .env files
+	_load_env_files
+
+	# Check if sync is enabled
+	if [[ "${WP_BOOT_SYNC_ENABLED:-false}" != "true" ]]; then
+		echo "WordPress sync is disabled (WP_BOOT_SYNC_ENABLED is not set to 'true')."
+		echo "To enable sync, set WP_BOOT_SYNC_ENABLED=true in your .env file."
+		exit 0
+	fi
+
 	if [[ "$#" -lt 1 ]]; then
 		echo "Missing argument 'dest'." >&2
 		echo "Use: $0 <dest>"