Empezando 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. Crea la estructura de un sitio, ejecuta un WordPress real en su propio equipo sin más instalación que Node (sin Docker, sin MAMP, sin PHP en su variable PATH), comprueba lo que ha construido con el espacio de alojamiento al que va a realizar el despliegue 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 fallado.

Qué necesita

Node 24 o posterior. 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 se incluye 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.

Ninguno de los elementos siguientes 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 versión de Node es anterior a la >=24.18.1 que declara el paquete. La instalación finaliza de todos modos, pero la interfaz de comandos 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 realizar ninguna acción.

Paso 3 — leer la ayuda

zinnector --help

Éxito: un banner que nombra los cinco comandos del flujo (new, dev, link, check, push) y, a continuación, cada comando con una descripción de una sola línea de su propósito. Todos los comandos admiten también su propio parámetro --help: zinnector dev --help muestra las opciones de entorno de ejecución, PHP y puerto. La lista completa, con ejemplos, se encuentra en la referencia de comandos.

Paso 4 — estructurar 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 de wp-content con plugins/, themes/ y un archivo auxiliar mu-plugins/, un .gitignore y un archivo README), seguidos de los siguientes comandos que debe ejecutar. Ninguno de sus elementos es un marcador de posición; el proyecto se inicia tal cual. Los parámetros --template plugin o --template theme estructuran 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® pregunta una sola 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 en su proyecto. Responda Y, o proporcione --yes para omitir la pregunta. En Node 26 o posterior, también descarga una versión de Node 24 exclusivamente para el entorno de ejecución (unos 30 MB, verificados mediante las sumas de comprobación de nodejs.org), debido a que el módulo nativo del entorno de ejecución incluye binarios precompilados únicamente para Node 24 y 25; no necesita un compilador ni Visual Studio.

Éxito: un bloque que indica el proyecto, la versión de PHP y la versión de WordPress, seguido de:

✔ 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 de WordPress nuevo titulado My WordPress Website, servido por la versión de PHP que 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 aparecerá en la siguiente recarga; el entorno de ejecución sirve esos directorios directamente desde su proyecto.

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

Siguientes pasos

Desarrollo local con zinnector dev: los dos entornos de ejecución, la selección de las versiones de PHP y WordPress, y qué se sirve desde cada ubicación.
Despliegue con Zinnector®: iniciar sesión, vincular el proyecto a un espacio, realizar comprobaciones previas al vuelo y enviar.
La referencia de comandos: todos los comandos, parámetros y ejemplos.
Solución de problemas: los errores con los que se encuentran habitualmente los usuarios y la solución para cada uno de ellos.

La misma documentación está disponible en el archivo README del paquete en npm y en GitHub, donde se reciben gustosamente incidencias y solicitudes de extracción.