Donutwork Docs
Dynamic Content Modeling

Dynamic Content Modeling

Crea strutture dati personalizzate e gestisci contenuti dinamici con il sistema Content Box Headless di Donutwork.

Dynamic Content Modeling (Content Box)

Il sistema Content Box è progettato per eliminare la rigidità dei database tradizionali. Ti permette di creare dei "Modelli" (Types) che definiscono quali campi deve avere un contenuto, e successivamente di compilare tali contenuti tramite interfacce generate automaticamente.

Il Concetto: Types vs Contents

Per comprendere il funzionamento, bisogna distinguere due livelli:

  1. Types (Lo Schema): Definisci la struttura. Esempio: "Il tipo Membro del Team ha un nome, una foto, una bio e un ruolo."
  2. Contents (I Dati): Crei le istanze basate sullo schema. Esempio: "Mario Rossi, Foto.jpg, CTO..."

Tipi di Campi Supportati

Il Fields Manager di Donutwork offre una vasta gamma di input per coprire ogni esigenza di data-entry:

CategoriaTipo di InputUtilizzo Tipico
TestualeStandard TextTitoli, nomi brevi, etichette.
Long Text (Textarea)Descrizioni, biografie, contenuti ricchi.
Password / SecureChiavi API, segreti o dati sensibili (mascherati).
URLLink esterni, riferimenti a social media.
LogicaDropdown SelectScelta singola da una lista definita (es. Categoria).
Multi-selectTag, competenze, selezioni multiple.
Toggle / CheckboxStati booleani (Sì/No, Attivo/Inattivo).

Esempi di Strutture (Use Cases)

Ecco come puoi configurare i tuoi Types per diversi scenari comuni:

1. Sezione FAQ

  • Domanda: Standard Text (Obbligatorio)
  • Risposta: Long Text
  • Categoria: Dropdown Select (Opzioni: Billing, Tecnico, Account)
  • In evidenza: Toggle

2. Scheda Prodotto (SaaS)

  • Nome Prodotto: Standard Text
  • Prezzo Mensile: Standard Text (o Masked se è un ID di Stripe)
  • Feature List: Multi-select
  • Documentazione URL: URL Address
  • Stato: Dropdown Select (Beta, Stabile, Deprecato)

3. Testimonial Clienti

  • Nome Cliente: Standard Text
  • Azienda: Standard Text
  • Citazione: Long Text
  • Rating: Dropdown Select (1, 2, 3, 4, 5 stelle)

Gestione della Visibilità

Ogni Content Box può trovarsi in uno dei seguenti stati:

  • 🟡 Draft (Bozza): Il contenuto è salvato ma non è accessibile dalle API pubbliche o dal frontend.
  • 🟢 Public (Pubblico): Il contenuto è live e pronto per essere visualizzato.
  • 🔴 Private (Privato): Visibile solo all'interno dell'area amministrativa di Donutwork, ideale per dati di configurazione interna.

Funzionalità Avanzate

Generazione Automatica UI

Non devi creare i form. Appena modifichi lo schema di un Type, l'interfaccia di inserimento dati si aggiorna istantaneamente.

Ordinamento Drag & Drop

Puoi riordinare i campi nello schema per dare priorità visiva alle informazioni più importanti per il tuo team.

Headless-Ready

Tutti i dati salvati sono pronti per essere consumati tramite API in formato JSON, perfetti per React, Vue o Mobile App.

Suggerimento per Sviluppatori

Ogni campo ha una Internal Key (DB). Usa nomi chiari e in snake_case (es. hero_image_url) perché sarà la chiave che troverai nel JSON restituito dalle API di Donutwork.

On this page