Vai al contenuto

Come creare Blueprint WordPress personalizzati

Questo testo è stato tradotto utilizzando l’IA. Se desideri visualizzare il testo originale in inglese, fai clic qui.

WordPress Studio è basato su WordPress Playground, che supporta i Blueprint. I Blueprint in Studio ti aiutano a:

  • Semplificare le configurazioni ripetibili: Crea Blueprint per i tipi di sito più comuni (come blog, portfolio o negozio) per avviare nuovi progetti Studio in modo più efficiente. 
  • Mantenere il team allineato: Aggiungi un file blueprint.json al repository GitHub del tuo progetto, che tu stia sviluppando un plugin, un tema o un sito completo. Il file predispone lo stesso ambiente ogni volta, così i membri del team possono iniziare a lavorare su un plugin, un tema o un sito completo in pochi minuti, mentre il controllo di versione mantiene le modifiche verificabili e coerenti.
  • Semplificare demo e test: Avvia Studio con il tema, i plugin e i contenuti di esempio esatti di cui hai bisogno. Riproduci bug o conferma correzioni con una configurazione affidabile e ripetibile.

Questa guida ti insegnerà le basi per creare un Blueprint personalizzato e fornirà risorse aggiuntive per approfondire l’argomento.

Cosa sono i Blueprint?

Un Blueprint è un file JSON che definisce la configurazione di un sito WordPress. All’interno di un Blueprint, puoi configurare impostazioni come le versioni preferite di WordPress e PHP. Puoi anche specificare un elenco di passaggi da eseguire quando il sito viene creato, come installare e attivare plugin e temi, impostare opzioni del sito, importare contenuti demo ed eseguire query PHP o SQL.

I Blueprint sono scritti utilizzando uno schema JSON pubblico, standardizzandone l’uso in Playground, WordPress Studio e oltre.

Questo esempio minimale configura le versioni preferite di WordPress e PHP, installa e attiva il plugin WooCommerce e il tema Pendant, e imposta lo schema dei colori dell’amministratore su «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
    }
  ]
}

Aspetti fondamentali da conoscere:

  • preferredVersions consente di predefinire le versioni di PHP e WordPress.
  • steps è dove avviene la magia. È possibile effettuare l’accesso, installare o attivare plugin e temi, importare contenuti WXR, impostare opzioni, eseguire PHP e molto altro. Ad esempio, l’esempio mostra come installare WooCommerce, impostare la lingua del sito in spagnolo e modificare lo schema dei colori dell’amministrazione. Consulta la Libreria degli Step per ogni azione disponibile con relativi esempi.

WordPress Playground offre un builder interattivo di Blueprint, che consente di testare diverse configurazioni di Blueprint. È un ottimo modo per validare i propri Blueprint personalizzati prima di eseguirli in Studio.

Il builder di Blueprint in WordPress Playground.

Visualizza l’anteprima e scarica questo Blueprint utilizzando il pulsante qui sopra. Una volta scaricato, puoi utilizzarlo per creare un nuovo sito in Studio. Per istruzioni dettagliate, consulta il flusso di creazione del sito in Studio.

Limitazioni dei Blueprint in Studio

La tabella seguente evidenzia come i Blueprint funzionano in modo diverso in Studio rispetto a playground.wordpress.net, a partire dalla versione 1.6.0:

ProprietàPerché viene ignorata da Studio
landingPageGli utenti possono navigare verso l’area di amministrazione WP e il frontend del sito locale tramite i link presenti nell’interfaccia utente di Studio.
loginL’accesso viene effettuato automaticamente quando si naviga verso i siti locali dall’interfaccia utente di Studio. 
extraLibrariesStudio gestisce direttamente tutte le librerie aggiuntive.
features → networkingGli utenti dovrebbero sempre poter installare plugin e temi in Studio. 
steps → step → defineSiteUrlL’URL del sito è impostato su localhost per impostazione predefinita e può essere personalizzato nell’interfaccia utente di Studio durante la creazione del sito. 
steps → step → enableMultisiteIl multisito non è attualmente supportato in Studio.
steps → step → setSiteOptions → blogName
oppure
siteOptions → blogName
Il nome del sito viene impostato nell’interfaccia utente di Studio durante la creazione del sito. 
steps → step → setSiteOptions → login → username/password
oppure
siteOptions → login → username/password
Il nome utente e la password per un sito locale vengono impostati da Studio durante la creazione del sito. 

Risorse aggiuntive

I Blueprint possono essere semplici come l’esempio precedente o sofisticati quanto richiesto dal proprio flusso di lavoro. La documentazione di Playground fornisce una panoramica chiara del formato JSON dei Blueprint, un tutorial di avvio rapido e riferimenti dettagliati. Per creare i propri Blueprint o esplorare esempi dalla community di WordPress, consulta le risorse seguenti:

Sfruttare strumenti di intelligenza artificiale come l’Assistente di Studio è un ottimo modo per ottenere aiuto nella creazione di Blueprint personalizzati. Basta chiedergli di scrivere un Blueprint:

Chiedere all'Assistente di Studio di creare Blueprint.

Esistono anche diversi progetti della community che offrono un’interfaccia utente per la creazione di Blueprint, che vale la pena esplorare:

Chi segue da vicino il progetto WordPress Playground potrebbe essere a conoscenza del fatto che una nuova versione dei Blueprint è in fase di sviluppo. Non appena i Blueprint v2 saranno stabili in Playground, il supporto verrà aggiunto a Studio in una release successiva. Tutti i Blueprint v1 continueranno a essere supportati.

Ultimo aggiornamento: giugno 22, 2026