feat(env): Integrate Composer for WordPress plugin management

This change introduces Composer-based dependency management for WordPress plugins within the `wp-env` development environment.

- `composer.json` is updated to define the project as `wordpress-theme` and utilizes `installer-paths` to install plugins into `.wp-env/plugins`.
- Advanced Custom Fields (ACF) is now declared as a `require-dev` dependency and will be installed via Composer.
- The `.wp-env.json` `afterStart` script is simplified to activate the plugin, leveraging the Composer installation.
- `composer.lock` is removed and added to `.gitignore` to ensure a fresh, consistent dependency set on setup.
- The `README.md` is updated to reflect the new development environment setup.

This enhances environment consistency and provides better version control for WordPress plugin dependencies.

Author: firestar300

.gitignore

@@ -88,3 +88,9 @@ assets/conf-img/*.json
 ### theme.json
 src/scss/01-abstract/_theme-json.scss
 theme.json
+
+### wp-env
+.wp-env/
+
+### Composer
+composer.lock

.wp-env.json

@@ -2,8 +2,13 @@
 	"$schema": "https://schemas.wp.org/trunk/wp-env.json",
 	"core": null,
 	"phpVersion": "8.3",
-	"themes": [ "." ],
-  	"plugins": [ "https://downloads.wordpress.org/plugin/advanced-custom-fields.zip" ],
+	"testsEnvironment": false,
+	"themes": [
+		"."
+	],
+	"plugins": [
+		".wp-env/plugins/advanced-custom-fields"
+	],
 	"config": {
 		"WP_DEBUG": true,
 		"WP_DEBUG_LOG": true,
@@ -13,6 +18,6 @@
 		"WP_DEVELOPMENT_MODE": "theme"
 	},
 	"lifecycleScripts": {
-		"afterStart": "wp-env run cli --env-cwd=wp-content/themes/beapi-frontend-framework composer install --no-interaction"
+		"afterStart": "wp-env run cli wp theme activate beapi-frontend-framework && wp-env run cli wp plugin activate advanced-custom-fields"
 	}
-}
+}

README.md

@@ -104,8 +104,7 @@ On first start, wp-env will:
 
 - Spin up WordPress (PHP 8.3)
 - Mount this theme from the current directory
-- Install the [Advanced Custom Fields](https://wordpress.org/plugins/advanced-custom-fields/) plugin
-- Run `composer install` in the theme via the `afterStart` lifecycle script
+- Install and activate the [Advanced Custom Fields](https://wordpress.org/plugins/advanced-custom-fields/) plugin
 
 ### URLs and credentials
 
@@ -210,4 +209,4 @@ function customize_editor_settings( $settings ) {
 
 	return $settings;
 }
-```
+```

composer.json

@@ -1,17 +1,32 @@
 {
     "name": "beapi/beapi-frontend-framework",
     "description": "Frontend Framework theme for WordPress",
-    "type": "metapackage",
+    "type": "wordpress-theme",
+    "extra": {
+        "installer-paths": {
+            ".wp-env/plugins/{$name}/": [
+                "type:wordpress-plugin"
+            ]
+        }
+    },
+    "repositories": [
+        {
+            "name": "wp-packages",
+            "type": "composer",
+            "url": "https://repo.wp-packages.org"
+        }
+    ],
     "require-dev": {
         "dealerdirect/phpcodesniffer-composer-installer": "^1.0",
         "overtrue/phplint": "^9.0",
         "php-parallel-lint/php-parallel-lint": "^1.4",
         "phpcompatibility/phpcompatibility-wp": "^2.1",
         "phpro/grumphp-shim": "^2.6",
         "roave/security-advisories": "dev-latest",
-        "wp-coding-standards/wpcs": "^3.1"
+        "wp-coding-standards/wpcs": "3.3.0",
+        "wp-plugin/advanced-custom-fields": "6.8.4"
     },
-     "scripts": {
+    "scripts": {
         "cs": [
             "./vendor/bin/phpcs ."
         ],
@@ -27,7 +42,11 @@
     "config": {
         "allow-plugins": {
             "dealerdirect/phpcodesniffer-composer-installer": true,
-            "phpro/grumphp-shim": true
+            "phpro/grumphp-shim": true,
+            "composer/installers": true
+        },
+        "platform": {
+            "php": "8.3.0"
         }
     }
 }