Cómo crear Blueprints personalizados de WordPress

WordPress Studio funciona con WordPress Playground, que admite Blueprints. Los Blueprints en Studio te ayudan a:

• Agilizar configuraciones repetibles: crea Blueprints para los tipos de sitio más habituales (como un blog, un portfolio o una tienda) y empieza nuevos proyectos de Studio de forma más eficiente. 
• Mantener a los equipos alineados: añade un archivo blueprint.json al repositorio de GitHub de tu proyecto, ya sea un plugin, un tema o un sitio completo. Reproduce el mismo entorno siempre, de modo que tu equipo pueda empezar a desarrollar un plugin, un tema o un sitio completo en cuestión de minutos, mientras el control de versiones mantiene los cambios revisables y coherentes.
• Simplificar demos y pruebas: inicia Studio con el tema, los plugins y el contenido de ejemplo exactos que necesites. Reproduce errores o confirma correcciones con una configuración fiable y repetible.

Esta guía te enseñará los conceptos básicos para crear un Blueprint personalizado y te proporcionará recursos adicionales en los que ampliar información.

¿Qué son los Blueprints?

Un Blueprint es un archivo JSON que define la configuración de un sitio WordPress. Dentro de un Blueprint puedes configurar ajustes como tus versiones preferidas de WordPress y PHP. También puedes especificar una lista de pasos que se ejecutan al crear el sitio, como instalar y activar plugins y temas, establecer opciones del sitio, importar contenido de demostración y ejecutar consultas PHP o SQL.

Los Blueprints se escriben utilizando un esquema JSON público, lo que estandariza su uso en Playground, WordPress Studio y más allá.

Este ejemplo mínimo configura las versiones preferidas de WordPress y PHP, instala y activa el plugin WooCommerce y el tema Pendant, y establece la combinación de colores del administrador en «Modern».

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/wp-admin/",
  "login": true,
  "preferredVersions": {
    "php": "8.3",
    "wp": "latest"
  },
  "steps": [
    {
      "step": "installPlugin",
      "pluginData": {
        "resource": "wordpress.org/plugins",
        "slug": "woocommerce"
      },
      "options": {
        "activate": true
      }
    },
    {
      "step": "installTheme",
      "themeData": {
        "resource": "wordpress.org/themes",
        "slug": "pendant"
      },
      "options": {
        "activate": true
      }
    },
    {
      "step": "updateUserMeta",
      "meta": {
        "admin_color": "modern"
      },
      "userId": 1
    }
  ]
}

Aspectos clave que conviene conocer:

• preferredVersions te permite predefinir las versiones de PHP y WordPress.
• steps es donde ocurre la magia. Puedes iniciar sesión, instalar o activar plugins y temas, importar contenido WXR, establecer opciones, ejecutar PHP y mucho más. Por ejemplo, el código de muestra anterior instala WooCommerce, establece el idioma del sitio en español y ajusta la combinación de colores del administrador. Consulta la biblioteca de pasos para ver cada acción disponible con sus ejemplos.

WordPress Playground ofrece un constructor de Blueprints interactivo que te permite probar distintas configuraciones de Blueprint. Es una buena forma de validar tus Blueprints personalizados antes de ejecutarlos en Studio.

Utiliza el botón anterior para previsualizar y descargar este Blueprint. Una vez descargado, podrás usarlo para crear un nuevo sitio en Studio. Para ver las instrucciones detalladas, consulta el flujo de creación de sitios en Studio.

Limitaciones de los Blueprints en Studio

La siguiente tabla destaca en qué se diferencia el funcionamiento de los Blueprints en Studio respecto a playground.wordpress.net, a partir de la versión 1.6.0:

Recursos adicionales

Los Blueprints pueden ser tan sencillos como el ejemplo anterior o tan sofisticados como lo requiera tu flujo de trabajo. La documentación de Playground ofrece una visión clara del formato JSON de los Blueprints, un tutorial de inicio rápido y referencias detalladas. Si quieres crear tus propios Blueprints o explorar ejemplos de la comunidad de WordPress, consulta los recursos siguientes:

• Introducción a los Blueprints y tutorial de inicio rápido
• Formato de datos y esquema
• Referencia de pasos y biblioteca visual de pasos
• Ejemplos de Blueprints y galería de la comunidad

Aprovechar herramientas de IA como el Studio Assistant es una buena forma de obtener ayuda para crear Blueprints personalizados. Basta con pedirle que te escriba un Blueprint:

También existen varios proyectos de la comunidad que ofrecen una interfaz para crear Blueprints y que merece la pena revisar:

• WordPress Playground Step Library
• Pootle Playground
• Block Based Visual Blueprint Builder