@codigodoleo/wp-kit 3.1.1 → 3.2.0

package/templates/.lando.yml.hbs

@@ -1,9 +1,16 @@
 name: {{projectName}}
 recipe: wordpress
+env_file:
+  - .env
+excludes:
+  - vendor
+  - node_modules
 config:
   webroot: ./
   via: nginx
-  php: "{{phpVersion}}"
+  php: "8.4"
+  database: mariadb
+  cache: redis
   xdebug: true
   extra_php_extensions:
     - bcmath
@@ -16,29 +23,66 @@ config:
   config:
     php: ./server/php/php.ini
     vhosts: ./server/www/vhosts.conf
-  env_file:
-    - .env
 services:
   appserver:
-    build_as_root:
-      - apt-get update
-      - apt-get install -y curl gnupg
-      - curl -fsSL https://deb.nodesource.com/setup_23.x | bash -
-      - apt-get install -y nodejs
-      - npm install -g npm@latest
-      - npm install -g yarn@1.22
+    build:
+      - bash /app/server/cmd/setup-php.sh
+    overrides:
+      extra_hosts:
+        - "host.docker.internal:host-gateway"
+      environment:
+        PHP_IDE_CONFIG: "${PHP_IDE_CONFIG:-serverName=appserver}"
+        XDEBUG_MODE: "${XDEBUG_MODE:-develop,debug}"
+        XDEBUG_CONFIG: "${XDEBUG_CONFIG:-client_host=host.docker.internal discover_client_host=true}"
+  build:
+    type: node:24
+    ssl: true
+    build:
+      - bash /app/server/cmd/setup-node.sh
+    scanner: false
+    overrides:
+      ports:
+        - 5173:5173
+  database:
+    type: mariadb:10.11
+    portforward: true
+  cache:
+    type: redis
+    portforward: true
+  mailhog:
+    type: mailhog
+    portforward: true
+    hogfrom:
+      - appserver
 events:
   post-start:
     - bash ./server/cmd/install-wp.sh
-    - composer install --no-interaction --no-progress --optimize-autoloader
 tooling:
-  yarn:
+  node:
+    service: build
+  npm:
+    service: build
+  dev:
+    service: build
+    description: Run the Vite development server
+    cmd: npm run dev
+  redis-cli:
+    service: cache
+  acorn:
     service: appserver
-  yarn-upgrade:
+    cmd: wp acorn
+  flush:
     service: appserver
-    cmd: yarn upgrade --latest
-  yarn-clean-install:
+    description: Flush WordPress and Redis caches
+    cmd:
+      - appserver: wp rewrite flush
+      - appserver: wp cache flush
+      - cache: redis-cli FLUSHDB
+    dir: /app
+  reset-deps:
     service: appserver
+    description: Clean and reinstall all dependencies
     cmd:
-      - rm -rf node_modules
-      - yarn install
+      - appserver: rm -rf /app/vendor /app/node_modules
+      - appserver: bash /app/server/cmd/setup-php.sh
+      - build: bash /app/server/cmd/setup-node.sh

package/templates/README.md.hbs

@@ -1,11 +1,27 @@
-#
-{{projectName}}
+# {{projectName}}
 
-Scaffolded by wp-devops. ## 🧱 Stack - PHP
-{{phpVersion}}
-- Node.js
-{{nodeVersion}}
+Scaffolded by wp-devops.
+
+## 🧱 Stack
+
+- PHP {{phpVersion}}
+- Node.js {{nodeVersion}}
+
+## 🧩 Blocos com ACF Composer
+
+Quando Sage estiver habilitado, o projeto usa o fluxo de blocos via ACF Composer.
+
+- Classes de blocos: `content/themes/{{projectName}}/app/Blocks`
+- Fields do ACF: `content/themes/{{projectName}}/app/Fields`
+- Views Blade dos blocos: `content/themes/{{projectName}}/resources/views/blocks`
+
+Fluxo rapido:
+1. Criar classe do bloco com `wp acorn make:component NomeDoBloco`.
+2. Definir fields em `app/Fields` com ACF Composer.
+3. Renderizar o bloco em `resources/views/blocks`.
+
+Requisito: plugin Advanced Custom Fields (ACF) ativo no WordPress.
 
 ## 👤 Author
 
-{{author}}
+{{author}}

package/templates/composer.json.hbs

@@ -1,12 +1,13 @@
 { "name": "{{projectName}}/wordpress", "type": "project", "description": "{{projectDescription}}",
 "authors": [ { "name": "{{author}}", "email": "{{authorEmail}}" } ], "repositories": { "wpackagist":
 { "type": "composer", "url": "https://wpackagist.org" } }, "license": "MIT", "require": { "php": ">={{phpVersion}}",
-"roots/wordpress": "{{wpCoreVersion}}", "inpsyde/wp-translation-downloader": "^2.5",
+"roots/wordpress": "{{wpCoreVersion}}", "roots/bedrock-autoloader": "^1.0",
+"inpsyde/wp-translation-downloader": "^2.5",
 "vlucas/phpdotenv": "^5.5" }, "config": { "allow-plugins": { "roots/wordpress-core-installer": true,
 "inpsyde/wp-translation-downloader": true, "composer/installers": true } }, "extra": {
 "wordpress-install-dir": "wp", "installer-paths": { "content/plugins/{$name}/": [
 "type:wordpress-plugin" ], "content/themes/{$name}/": [ "type:wordpress-theme" ],
 "content/mu-plugins/{$name}/": [ "type:wordpress-muplugin" ] }, "wp-translation-downloader": {
-"languages": [ "pt_BR", "en_US", "es_ES" ], "languageRootDir": "content/languages",
+"languages": [ "pt_BR", "en_US" ], "languageRootDir": "content/languages",
 "virtual-packages": [ { "name": "wordpress/wordpress", "type": "wordpress-core", "version": "{{wpCoreVersion}}"
-} ] } } }
+} ] } } }

package/templates/package.json.hbs

@@ -22,8 +22,6 @@
   },
   "devDependencies": {
     "@cspell/dict-php": "^4.0.14",
-    "@cspell/dict-pt-br": "^2.4.0",
-    "standard-version": "^9.5.0",
     "eslint": "^9.30.1",
     "eslint-config-prettier": "^10.1.5",
     "eslint-plugin-import": "^2.32.0",

package/templates/server/cmd/install-wp.sh.hbs

@@ -1,43 +1,54 @@
-#!/bin/bash # Colors for output RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[1;33m'
-BLUE='\033[0;34m' NC='\033[0m' # No Color echo -e "${BLUE}🔍 Checking WordPress installation
-status...${NC}" # Wait for database to be ready (connectivity only) echo -e "${YELLOW}⏳ Waiting for
-database connection...${NC}" echo -e "${BLUE}🔧 Debug: DB_HOST=${WORDPRESS_DB_HOST:-database}
-DB_NAME=${WORDPRESS_DB_NAME:-wordpress} DB_USER=${WORDPRESS_DB_USER:-wordpress}${NC}" # Show what
-WP-CLI reads from wp-config.php wp config get DB_HOST --path=/app/wp 2>/dev/null || true wp config
-get DB_NAME --path=/app/wp 2>/dev/null || true wp config get DB_USER --path=/app/wp 2>/dev/null ||
-true # Force-disable SSL/TLS for MySQL client connections in environments where server uses
-self-signed certs export MYSQL_SSL_MODE=DISABLED export MYSQLI_OPT_SSL_VERIFY_SERVER_CERT=0
-MAX_ATTEMPTS=60 ATTEMPT=0 # PHP/mysqli-based readiness check to bypass mysql CLI TLS verification
-issues db_ready() { php -d display_errors=1 -r ' $host = getenv("WORDPRESS_DB_HOST") ?: "database";
-$user = getenv("WORDPRESS_DB_USER") ?: "wordpress"; $pass = getenv("WORDPRESS_DB_PASSWORD") ?:
-"wordpress"; $name = getenv("WORDPRESS_DB_NAME") ?: "wordpress"; $port = getenv("WORDPRESS_DB_PORT")
-?: 3306; $mysqli = mysqli_init(); if (defined("MYSQLI_OPT_SSL_VERIFY_SERVER_CERT")) {
-mysqli_options($mysqli, MYSQLI_OPT_SSL_VERIFY_SERVER_CERT, false); } $flags =
-defined("MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT") ? MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT :
-0; if (!@mysqli_real_connect($mysqli, $host, $user, $pass, null, (int)$port, null, $flags)) {
-fwrite(STDERR, "connect_error: ".mysqli_connect_error().PHP_EOL); exit(1); } @mysqli_query($mysqli,
-"CREATE DATABASE IF NOT EXISTS `{$name}`"); $ok = @mysqli_query($mysqli, "SELECT 1"); if (!$ok) {
-fwrite(STDERR, "query_error: ".mysqli_error($mysqli).PHP_EOL); exit(1); } exit(0); ' } until
-db_ready >/dev/null 2>&1; do ATTEMPT=$((ATTEMPT+1)) if [ "$ATTEMPT" -eq 1 ] || [ $((ATTEMPT % 5))
--eq 0 ]; then echo -e "${BLUE}🔧 Debug: attempting connection (#${ATTEMPT})...${NC}" getent hosts
-"${WORDPRESS_DB_HOST:-database}" 2>/dev/null || true # Also surface last error from PHP checker
-db_ready 2>&1 >/dev/null | tail -n1 || true fi echo -e "${YELLOW}⌛ Database not ready yet,
-waiting...${NC}" sleep 2 if [ "$ATTEMPT" -ge "$MAX_ATTEMPTS" ]; then echo -e "${RED}❌ Timeout
-waiting for database connectivity. Aborting.${NC}" exit 1 fi done echo -e "${GREEN}✅ Database
-connection established${NC}" # Check if WordPress is already installed if wp core is-installed
---path=/app/wp 2>/dev/null; then echo -e "${GREEN}✅ WordPress is already installed${NC}" echo -e
-"${BLUE}📊 Current site info:${NC}" wp option get siteurl --path=/app/wp wp option get admin_email
---path=/app/wp exit 0 fi echo -e "${YELLOW}🚀 WordPress not installed. Starting
-installation...${NC}" # Download WordPress core if not present if [ ! -d wp-admin ]; then echo -e
-"${BLUE}📥 Downloading WordPress core...${NC}" wp core download --force --path=/app/wp
---skip-content fi # Install WordPress echo -e "${BLUE}🏗️ Installing WordPress...${NC}" wp core
-install \ --url="${PROJECT_DOMAIN}" \ --title="${PROJECT_NAME:-WordPress Development}" \
---admin_user="${WORDPRESS_ADMIN_USER:-admin}" \
---admin_password="${WORDPRESS_ADMIN_PASSWORD:-admin}" \
---admin_email="${WORDPRESS_ADMIN_EMAIL:-admin@example.com}" \ --skip-email \ --path=/app/wp echo -e
-"${GREEN}✅ WordPress installed successfully!${NC}" # Update permalinks wp rewrite structure
-'/%postname%/' --hard --path=/app/wp echo -e "${GREEN}🎉 WordPress setup completed
-successfully!${NC}" echo -e "${BLUE}📋 Access Details:${NC}" echo -e "${YELLOW}URL:${NC} ${APP_URL}"
-echo -e "${YELLOW}Admin User:${NC} ${WORDPRESS_ADMIN_USER:-admin}" echo -e "${YELLOW}Admin
-Password:${NC} ${WORDPRESS_ADMIN_PASSWORD:-admin}" echo -e "${YELLOW}Admin Email:${NC}
-${WORDPRESS_ADMIN_EMAIL:-admin@example.com}"
+#!/usr/bin/env bash
+set -euo pipefail
+
+PROJECT_ROOT="${PROJECT_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+WP_PATH="${WP_PATH:-${PROJECT_ROOT}/wp}"
+
+# Read a value from .env — used when the variable is not exported into the shell environment
+read_dotenv_var() {
+	local key="$1"
+	local env_file="${PROJECT_ROOT}/.env"
+	[ -f "${env_file}" ] || return 1
+	grep -E "^${key}=" "${env_file}" | head -n1 | cut -d'=' -f2- | sed "s/^['\"]//; s/['\"]$//"
+}
+
+# Resolve SITE_URL from environment or .env
+SITE_URL="${WORDPRESS_SITE_URL:-${APP_URL:-}}"
+if [ -z "${SITE_URL}" ]; then SITE_URL="$(read_dotenv_var WORDPRESS_SITE_URL || true)"; fi
+if [ -z "${SITE_URL}" ]; then SITE_URL="$(read_dotenv_var APP_URL || true)"; fi
+if [ -z "${SITE_URL}" ]; then SITE_URL="https://${PROJECT_DOMAIN:-$(read_dotenv_var PROJECT_DOMAIN || echo 'localhost')}"; fi
+
+# WordPress core files are placed by `composer install` via roots/wordpress — no wp core download needed.
+
+# Wait until the database is ready. Use PHP/PDO directly to avoid MariaDB CLI SSL negotiation issues.
+echo "Waiting for database..."
+DB_HOST="${WORDPRESS_DB_HOST:-database}"
+DB_NAME="${WORDPRESS_DB_NAME:-wordpress}"
+DB_USER="${WORDPRESS_DB_USER:-wordpress}"
+DB_PASS="${WORDPRESS_DB_PASSWORD:-wordpress}"
+max=30; i=0
+until php -r "try { new PDO('mysql:host=${DB_HOST};dbname=${DB_NAME}', '${DB_USER}', '${DB_PASS}'); exit(0); } catch(Exception \$e) { exit(1); }" 2>/dev/null; do
+	i=$((i + 1))
+	[ "$i" -ge "$max" ] && echo "Database timeout after $((max * 2))s. Aborting." && exit 1
+	sleep 2
+done
+
+if wp core is-installed --path="${WP_PATH}" 2>/dev/null; then
+	echo "WordPress already installed at ${SITE_URL}"
+	exit 0
+fi
+
+echo "Installing WordPress..."
+
+wp core install \
+	--url="${SITE_URL}" \
+	--title="${PROJECT_NAME:-WordPress Development}" \
+	--admin_user="${WORDPRESS_ADMIN_USER:-admin}" \
+	--admin_password="${WORDPRESS_ADMIN_PASSWORD:-admin}" \
+	--admin_email="${WORDPRESS_ADMIN_EMAIL:-admin@example.com}" \
+	--skip-email \
+	--path="${WP_PATH}"
+
+wp rewrite structure '/%postname%/' --hard --path="${WP_PATH}"
+
+echo "WordPress installed successfully."

package/templates/server/cmd/setup-node.sh.hbs

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# Installs root Node.js dependencies via npm.
+# Invoked from: Lando (build service build step), Devcontainer (setup.sh), CI/CD.
+set -euo pipefail
+
+PROJECT_ROOT="${PROJECT_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+
+echo "Installing Node.js dependencies..."
+cd "${PROJECT_ROOT}"
+npm install
+echo "Node.js dependencies installed."

package/templates/server/cmd/setup-php.sh.hbs

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+# Installs root PHP dependencies via Composer.
+# Invoked from: Lando (appserver build step), Devcontainer (setup.sh), CI/CD.
+set -euo pipefail
+
+PROJECT_ROOT="${PROJECT_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+
+echo "Installing PHP dependencies..."
+composer install \
+	--working-dir="${PROJECT_ROOT}" \
+	--no-interaction \
+	--no-progress \
+	--optimize-autoloader
+echo "PHP dependencies installed."

package/templates/server/www/vhosts.conf.hbs

@@ -1,21 +1,58 @@
-upstream php { server fpm:9000; } server { listen 80 default_server; listen 443 ssl; server_name
-localhost; ssl_certificate /certs/cert.crt; ssl_certificate_key /certs/cert.key; ssl_verify_client
-off; ssl_session_cache shared:SSL:1m; ssl_session_timeout 5m; ssl_ciphers HIGH:!aNULL:!MD5;
-ssl_prefer_server_ciphers on; port_in_redirect off; client_max_body_size 100M; ## Your only path
-reference. root "/app"; ## This should be in your http block and if it is, it's not needed here.
-index index.php; location = /favicon.ico { log_not_found off; access_log off; } location =
-/robots.txt { allow all; log_not_found off; access_log off; } # Add Server-Timing header to track
-request time and database response time add_header Server-Timing 'php=$request_time;
-db=$upstream_response_time';
+upstream php {
+  server fpm:9000;
+}
+
+server {
+  listen 80 default_server;
+  listen 443 ssl;
+  server_name localhost;
+
+  ssl_certificate /certs/cert.crt;
+  ssl_certificate_key /certs/cert.key;
+  ssl_verify_client off;
+  ssl_session_cache shared:SSL:1m;
+  ssl_session_timeout 5m;
+  ssl_ciphers HIGH:!aNULL:!MD5;
+  ssl_prefer_server_ciphers on;
+  port_in_redirect off;
+  client_max_body_size 100M;
+
+  root "/app";
+  index index.php;
+
+  location = /favicon.ico {
+    log_not_found off;
+    access_log off;
+  }
+
+  location = /robots.txt {
+    allow all;
+    log_not_found off;
+    access_log off;
+  }
+
+  add_header Server-Timing 'php=$request_time; db=$upstream_response_time';
 
 {{#if useRocket}}
-  # Include Rocket Nginx configuration include /app/server/www/rocket.conf;
+  include /app/server/www/rocket.conf;
 {{/if}}
 
-location / { # This is cool because no php is touched for static content. # include the "?$args"
-part so non-default permalinks doesn't break when using query string try_files $uri $uri/
-/index.php?$args; } location ~ \.php$ { #NOTE: You should have "cgi.fix_pathinfo = 0;" in php.ini
-fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param PATH_TRANSLATED
-$document_root$fastcgi_script_name; include fastcgi_params; fastcgi_intercept_errors on;
-fastcgi_pass php; fastcgi_buffers 16 16k; fastcgi_buffer_size 32k; } location ~*
-\.(js|css|png|jpg|jpeg|gif|ico)$ { expires max; log_not_found off; } }
+  location / {
+    try_files $uri $uri/ /index.php?$args;
+  }
+
+  location ~ \.php$ {
+    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+    fastcgi_param PATH_TRANSLATED $document_root$fastcgi_script_name;
+    include fastcgi_params;
+    fastcgi_intercept_errors on;
+    fastcgi_pass php;
+    fastcgi_buffers 16 16k;
+    fastcgi_buffer_size 32k;
+  }
+
+  location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
+    expires max;
+    log_not_found off;
+  }
+}

package/templates/workspace.json.hbs

@@ -171,6 +171,62 @@
 					"panel": "shared"
 				},
 				"problemMatcher": []
+			},
+			{
+				"label": "🐳 Devcontainer: Up",
+				"type": "shell",
+				"command": "docker",
+				"args": ["compose", "-f", ".devcontainer/docker-compose.yml", "up", "-d", "--build"],
+				"group": "build",
+				"presentation": {
+					"echo": true,
+					"reveal": "always",
+					"focus": false,
+					"panel": "shared"
+				},
+				"problemMatcher": []
+			},
+			{
+				"label": "🐳 Devcontainer: Down",
+				"type": "shell",
+				"command": "docker",
+				"args": ["compose", "-f", ".devcontainer/docker-compose.yml", "down"],
+				"group": "build",
+				"presentation": {
+					"echo": true,
+					"reveal": "always",
+					"focus": false,
+					"panel": "shared"
+				},
+				"problemMatcher": []
+			},
+			{
+				"label": "🐳 Devcontainer: Rebuild",
+				"type": "shell",
+				"command": "docker",
+				"args": ["compose", "-f", ".devcontainer/docker-compose.yml", "up", "-d", "--build", "--force-recreate"],
+				"group": "build",
+				"presentation": {
+					"echo": true,
+					"reveal": "always",
+					"focus": false,
+					"panel": "shared"
+				},
+				"problemMatcher": []
+			},
+			{
+				"label": "🐳 Devcontainer: Bootstrap",
+				"type": "shell",
+				"command": "docker",
+				"args": ["compose", "-f", ".devcontainer/docker-compose.yml", "exec", "wordpress", "bash", ".devcontainer/setup.sh"],
+				"group": "build",
+				"presentation": {
+					"echo": true,
+					"reveal": "always",
+					"focus": false,
+					"panel": "shared"
+				},
+				"problemMatcher": []
 			}
 		]
 	}

package/templates/wp-cli.yml.hbs

@@ -0,0 +1 @@
+path: wp