Wix Blocks: creare e gestire le raccolte
Tempo di lettura: 3 min.
Wix Blocks è aperto a tutti gli utenti di Wix Studio. Per ottenere l'accesso a Blocks, iscriviti a Wix Studio.
Wix Blocks ti consente di aggiungere raccolte (database) alla tua app. Gestire le raccolte in Blocks è simile alla gestione delle raccolte nei siti Wix. Ma ci sono alcuni punti che sono molto diversi: dai un'occhiata in questo articolo.
Suggerimento
Presta attenzione alle autorizzazioni della raccolta e le loro linee guida sulla sicurezza (pagina in inglese).
Una raccolta Blocks è un testo placeholder
La cosa più importante da capire su una raccolta Blocks è che è un placeholder per i dati di qualsiasi sito su cui è installata. Questo perché una raccolta Blocks può essere utilizzata su più siti, anche su migliaia. Questi siti possono essere molto diversi tra loro e avere i propri database. Pensa a una raccolta che contenga le informazioni sui clienti. Ogni sito può avere un elenco dei propri clienti e il tuo widget può essere applicato a tutti.
Quando crei una raccolta in Blocks, definisci i campi della raccolta e rendi possibile fare riferimento ad essa nel codice dell'app. Puoi anche aggiungere dati predefiniti in Blocks, ma non è necessario. Se aggiungi dati predefiniti, questi vengono installati automaticamente sul sito insieme all'app e possono essere sostituiti in seguito dai dati di qualsiasi sito su cui è installata l'app.
Se modifichi la struttura di una raccolta in Blocks in una versione futura della tua app, ciò influirà su qualsiasi sito su cui è installata. Quindi lavora con cautela e non apportare modifiche che possono danneggiare i siti.
Nota
Le raccolte di Blocks vengono conteggiate sotto i limiti degli elementi e delle raccolte del Gestore contenuti.
Informazioni sui dati predefiniti
I dati aggiunti alle raccolte Blocks verranno importati nel sito in cui è installata l'app, fornendo ai creatori del sito i dati predefiniti per la tua app. Se scegli di aggiungere dati predefiniti, tieni presente che:
- Il sito su cui è installata l'app può modificare i dati in un secondo momento
- I dati predefiniti verranno importati solo nella prima installazione. Se rilasci una nuova versione della tua app e modifichi i dati nella raccolta, questa non sovrascriverà i dati già esistenti in nessun sito su cui è installata la tua app
Per aggiungere una raccolta alla tua app
- Clicca su Database
nel menu a sinistra dell'app - Clicca su Crea raccolta
- Crea uno namespace (articolo in inglese) per la tua app, se non lo hai già fatto. Rendi il namespace chiaro e significativo (se non hai ancora assegnato un nome alla tua app, ti verrà chiesto di dargli un nome ora)
- Dai un nome alla tua raccolta
- Definisci la struttura della raccolta nel Gestore contenuti
- Facoltativo: aggiungi elementi alla tua raccolta. Questi dati predefiniti verranno importati insieme alla tua app su qualsiasi sito su cui è installata
Visualizza la tua raccolta nell'Editor
Quando importi un'app Blocks che ha una raccolta nel tuo sito, la raccolta apparirà nella sezione del Gestore contenuti 
, sotto Le tue raccolte. Il namespace dell'app apparirà accanto a questa raccolta, per indicare che proviene da Blocks. D'ora in poi puoi gestire la tua raccolta come in un qualsiasi altro sito Wix.
, sotto Le tue raccolte. Il namespace dell'app apparirà accanto a questa raccolta, per indicare che proviene da Blocks. D'ora in poi puoi gestire la tua raccolta come in un qualsiasi altro sito Wix. Importante
Se elimini l'app dal sito, verrà eliminata anche la raccolta.
Accedi ai dati della raccolta tramite codice
Per prima cosa, scrivi questa dichiarazione di importazione nel codice del tuo widget:
1import wixData from 'wix-data';Per accedere alla tua raccolta ed eseguire varie azioni, query, insert, ecc., utilizza la seguente sintassi con qualsiasi API wix-data. Ad esempio, in questo modo esegui query su una raccolta (scopri di più sul tuo namespace)
1wixData.query("/") .find() .then( (results) => { //your code using the "results"; });Scopri di più su come lavorare con Wix Data API (articolo in inglese).
Hai trovato utile questo articolo?
|