Usiamo i cookie per migliorare la tua esperienza, analizzare il traffico del sito e personalizzare i contenuti. Cliccando su “Accetta Tutti”, accetti l’uso dei cookie.

Preferenze Cookie

Gestisci le impostazioni dei cookie. Puoi abilitare o disabilitare diversi tipi di cookie di seguito. Per maggiori dettagli, vedi la nostra Informativa sulla Privacy.

Utilizzo dei Plugin

Abilitare i Plugin 

Per questo motivo, l’esecuzione dei plugin è disabilitata di default per ogni progetto. Abilita i plugin in Visualizza > Plugin attivando “Abilita plugin per questo progetto”.

Abilita i plugin solo per progetti di cui ti fidi. Se sposti o rinomini il tuo progetto, dovrai riattivare i plugin.

Installazione dei Plugin 

Ci sono due modi per installare i plugin: tramite le dipendenze del tuo progetto o come file nella cartella plugins. Dopo l’installazione, apri Visualizza > Plugin per abilitarli/disabilitarli per progetto.

Tramite NPM 

Puoi installare i plugin tramite il node package manager (NPM). Installa un plugin con il seguente comando:

1npm i --save-dev @wonderlandengine/not-a-real-plugin

Sostituisci @wonderlandengine/not-a-real-plugin con il plugin che desideri installare. L’esecuzione di questo comando creerà una nuova voce nella sezione devDependencies del tuo file package.json.

Il plugin apparirà poi nella vista Plugin.

Gestione dei Plugin 

A volte potresti voler disattivare i plugin per ridurre il disordine nell’interfaccia o per migliorare le prestazioni dell’editor.

Apri Visualizza > Plugin per vedere tutti i plugin disponibili e gestirli:

  • Abilita i plugin per il progetto corrente tramite il checkbox superiore “Abilita plugin per questo progetto”.
  • Usa le schede per passare tra “Portata editor” (plugin che estendono l’editor stesso) e “Portata progetto” (plugin installati tramite devDependencies o la cartella plugins/).
  • Attiva/disattiva i singoli plugin tramite i checkbox. Le modifiche hanno effetto immediato; alcuni plugin potrebbero richiedere di ricaricare il progetto.

Sviluppo 

Creare plugin è semplice. Hai a disposizione tre metodi:

Script del Plugin 

Un singolo script che può condividere dipendenze con il package.json del tuo progetto principale. Ti consigliamo di installare tutte le dipendenze legate al plugin come devDependencies (usando --save-dev).

Puoi creare un nuovo plugin creando la cartella plugins nella radice del tuo progetto, poi clicca con il tasto destro > Nuovo Plugin.

Assicurati di installare il pacchetto @wonderlandengine/editor-api nella radice del tuo progetto:

1npm i --save-dev @wonderlandengine/editor-api

Directory del Plugin 

Simile agli Script del Plugin, crea prima una sottocartella plugins, poi crea un’altra sottocartella che nominerai secondo il tuo plugin.

In questa cartella puoi creare un nuovo file package.json (ad esempio usando npm init).

Assicurati di installare il pacchetto @wonderlandengine/editor-api in quella directory:

1npm i --save @wonderlandengine/editor-api

Nota, --save invece di --save-dev, poiché non stai installando nel tuo progetto Wonderland Engine, ma in un progetto plugin separato.

Pacchetto Plugin 

Se desideri condividere e distribuire il tuo plugin, puoi fare npm init in una cartella separata e specificare i punti d’ingresso del plugin nella chiave "wonderlandengine" del tuo package.json:

 1{
 2    // ...
 3    "wonderlandengine": {
 4        "plugins": [
 5            {
 6                "name": "My Plugin A",
 7                "main": "src/plugin-a.mjs"
 8            },
 9            {
10                "name": "My Plugin B",
11                "main": "src/plugin-b.mjs"
12            }
13        ]
14    },
15    // ...
16}

Assicurati di installare il pacchetto @wonderlandengine/editor-api in quella directory:

1npm i --save-peer @wonderlandengine/editor-api

Per utilizzare questo plugin locale nel tuo progetto, npm i --save-dev <path-to-the-directory>, oppure pubblicalo quando è pronto e installalo tramite il pacchetto, vedi Installazione.