Collegare i blocchi CMS ai dati dinamici dei plugin

Un plugin per cataloghi, commercio, eventi o notizie spesso possiede dati di dominio utili. Questo non significa che debba possedere anche il layout della pagina e il markup pubblico usati per presentarli.

Le fonti di contenuto di WebBlocks CMS separano queste responsabilità. Un plugin espone record tipizzati; gli editor li collegano ai campi dei blocchi CMS già noti. La pagina mantiene il controllo su composizione, traduzione, anteprima e rendering.

Una fonte di contenuto risponde quali dati sono disponibili. Un blocco risponde come vengono presentati i dati. La pagina e il relativo albero degli slot rispondono dove appare.

Ciò consente a un plug-in di riutilizzare il comportamento principale di intestazione, testo RTF, immagine, pulsante, elenco collegamenti, griglia, pila e dispositivo di scorrimento invece di fornire un altro set parallelo di renderer.

Modificare un blocco supportato e aprire la relativa scheda Impostazioni. In Content source, ogni campo compatibile può mantenere il valore letterale immesso in Campi blocco o selezionare un'origine plug-in, un record stabile e un campo dichiarato.

Ad esempio, un titolo di intestazione può essere collegato a un campo di testo da una voce di catalogo. Gli editori scelgono la relazione da un elenco; nessuna espressione vincolante viene digitata a mano.

Il valore del blocco originale rimane importante: è il fallback editoriale. Se il plugin è disabilitato, la fonte scompare, il record non può essere risolto o il valore risolto è vuoto, la pagina pubblica continua a visualizzare il valore editoriale memorizzato.

Le origini di raccolta gestiscono elenchi di record. Aggiungi un contenitore con funzionalità di raccolta come Griglia o Pila, crea un figlio diretto come modello visivo, quindi seleziona la raccolta e il figlio da ripetere.

È possibile impostare un limite di record, filtrare su un campo dichiarato, ordinare in entrambe le direzioni e decidere se un risultato vuoto o un errore del risolutore nasconde il modello o mostra il suo fallback editoriale.

Aprire un discendente supportato all'interno del modello scelto. Le sue opzioni Content source ora includono Current collection item. Collega l'intestazione, la descrizione, l'immagine o il collegamento ai campi compatibili del record corrente.

In fase di rendering il CMS clona la sottostruttura del modello una volta per ogni record risolto e fornisce quel record come elemento corrente. Gli altri elementi secondari nel contenitore mantengono il contenuto editoriale manuale e mantengono la loro posizione.

I collegamenti di entità attualmente coprono i titoli di intestazione; Contenuti in testo normale e Rich Text; Fonte dell'immagine, didascalia, testo alternativo e collegamento; Etichette e URL di pulsanti e collegamenti di pulsanti; e il titolo, il testo secondario, la descrizione e l'URL dell'elemento dell'elenco di collegamenti.

Il supporto della raccolta è basato su contratto. Sezione principale, Contenitore, Pila, Cluster, Griglia e Diapositiva possono ripetere elementi secondari diretti validi. Il dispositivo di scorrimento ripete la diapositiva; Colonne ripete l'elemento colonna; La griglia delle funzionalità ripete l'elemento funzione o l'elemento colonna; e Elenco collegamenti ripete la voce dell'elenco collegamenti. I contenitori strutturali che produrrebbero composizioni non valide non pubblicizzano il supporto della raccolta.

Un plugin abilitato registra un'origine entità o un'origine raccolta con un handle dello spazio dei nomi, un risolutore e definizioni dei campi tipizzate. I risolutori di entità restituiscono scelte di editor sicure e un record per una chiave stabile. I risolutori di raccolte restituiscono record iterabili; le fonti di grandi dimensioni possono implementare il contratto interrogabile in modo che filtraggio, ordinamento, limiti, totali e finestre di pagina rimangano nel database o nell'API upstream.

I dati riservati possono allegare una politica di accesso. Le fonti possono anche optare per la memorizzazione nella cache limitata e invalidare le varianti memorizzate nella cache dopo la scrittura del dominio. L'output del risolutore non diventa mai la fonte della verità del CMS: revisioni e trasferimenti memorizzano la configurazione di associazione e il normale fallback editoriale, non l’output eseguibile.

Il vantaggio di questo progetto non è solo rendere dinamici i dati. Il comportamento in caso di errore è esplicito. Record mancanti, plugin disabilitati, accesso negato, raccolte vuote ed eccezioni del risolutore non devono rendere indisponibile la pagina.

Gli editor mantengono un contenuto di fallback visibile, il pannello Settings segnala fonti o campi mancanti e il renderer pubblico può continuare a servire contenuti coerenti mentre l’integrazione viene riparata.

Per i contratti completi per gli sviluppatori e le strutture dell’Internal Content API, leggi Content Sources and Block Field Bindings.