Primeros pasos con Zinnector®, la CLI para desarrolladores

Zinnector® es la herramienta de línea de comandos gratuita y con licencia MIT de Zinn Digital® para desarrolladores de WordPress. Genera la estructura de un sitio, ejecuta un WordPress real en su propia máquina sin nada más instalado que Node —sin Docker, sin MAMP, sin PHP en su PATH—, luego verifica lo que usted construyó con respecto al espacio de alojamiento en el que está a punto de desplegar y lo envía. Esta guía le lleva desde cero hasta un sitio en funcionamiento en unos dos minutos, y le indica qué aspecto tiene el éxito en cada paso para que sepa cuándo algo ha salido mal.

Lo que necesita

• Node 24 o más reciente. Ejecute node --version; debe mostrar v24 o superior. Instale la versión LTS actual desde nodejs.org —en Windows winget install OpenJS.NodeJS.LTS, en macOS brew install node@24.
• npm, que viene con Node. Zinnector® lo utiliza una vez, para descargar el entorno de ejecución de WordPress en su propia caché.
• git, solo para zinnector push —los despliegues se gestionan desde su repositorio.
• Docker, solo si lo solicita con --runtime docker. El entorno de ejecución predeterminado no necesita ninguno.

Nada de lo que figura a continuación requiere una cuenta. Solo se necesita una clave de API cuando llegue a un espacio de alojamiento, en Despliegue con Zinnector®.

Paso 1 — instalarlo

npm install -g zinnector

Si npm muestra npm WARN EBADENGINE, su Node es más antiguo que el >=24.18.1 que declara el paquete. La instalación finaliza de todos modos, pero la CLI se negará a ejecutarse. Actualice Node primero y vuelva a instalarlo.

Paso 2 — comprobar la versión

zinnector --version

Éxito: un número de versión, por ejemplo 0.1.2. Si ve «Zinnector® needs Node 24 or newer — this is Node 20.x», el binario está instalado pero su versión de Node es demasiado antigua; el comando finaliza con el código 78 en lugar de hacer nada.

Paso 3 — leer la ayuda

zinnector --help

Éxito: un banner que nombra los cinco comandos del flujo (new, dev, link, check, push) y luego cada comando con su propósito en una sola línea. Cada comando también acepta su propio --help —zinnector dev --help enumera los modificadores de entorno de ejecución, PHP y puerto. La lista completa, con ejemplos, se encuentra en la referencia de comandos.

Paso 4 — generar la estructura de un sitio

zinnector new my-site

Éxito: un encabezado Created my-site y una lista de los archivos que ha escrito —zinnector.json, un árbol wp-content con plugins/, themes/ y un asistente mu-plugins/, un .gitignore y un README— seguidos de los siguientes comandos que debe ejecutar. Nada en él es un marcador de posición; el proyecto se inicia tal cual. --template plugin o --template theme generan la estructura de un plugin o un tema de bloques que se activa en el momento en que existe.

Paso 5 — ejecutarlo

cd my-site
zinnector dev

La primera vez, Zinnector® le preguntará una vez antes de descargar el entorno de ejecución de WordPress —unos 570 MB, ya que incluye todas las compilaciones de PHP desde la 5.2 hasta la 8.5— en su propio directorio de caché, nunca dentro de su proyecto. Responda Y, o pase --yes para omitir la pregunta. En Node 26 o más reciente también descarga un Node 24 solo para el entorno de ejecución (unos 30 MB, verificados con las sumas de comprobación de nodejs.org), porque el módulo nativo del entorno de ejecución tiene binarios precompilados únicamente para Node 24 y 25; usted no necesita un compilador ni Visual Studio.

Éxito: un bloque que nombra el proyecto, la versión de PHP y la versión de WordPress, y después:

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

Paso 6 — abrirlo

Visite http://127.0.0.1:9400 en un navegador. Éxito: un sitio web de WordPress nuevo titulado My WordPress Website, servido por la versión de PHP que usted solicitó. http://127.0.0.1:9400/wp-admin abre el panel de control con la sesión ya iniciada. Coloque un plugin en wp-content/plugins/ o un tema en wp-content/themes/ y estará allí en la siguiente recarga —el entorno de ejecución sirve esos directorios directamente desde su proyecto.

Presione Ctrl-C para detenerlo. zinnector dev --once inicia el entorno de ejecución, muestra lo que realmente se está ejecutando (versión de PHP, versión de WordPress, extensiones cargadas) y se detiene —útil cuando usted desea una prueba en lugar de una promesa.

Adónde ir a continuación

• Desarrollo local con zinnector dev — los dos entornos de ejecución, la elección de las versiones de PHP y WordPress, y qué se sirve desde dónde.
• Despliegue con Zinnector® — inicie sesión, vincule el proyecto a un espacio, realice la comprobación previa, envíe.
• La referencia de comandos — cada comando, modificador y ejemplo.
• Resolución de problemas — los errores con los que realmente se encuentra la gente, y la solución para cada uno.

La misma documentación está disponible en el README del paquete en npm y en GitHub, donde se agradecen los informes de problemas y las pull requests.