Pagine automatiche

Pagine automatiche trasforma i record pubblici di una fonte in URL di dettaglio usando una pagina CMS esistente come modello. Il fornitore controlla pubblicazione, testi, traduzioni e metadati delle immagini. In Contenuti dinamici → Pagine automatiche scegli sito, intervallo di indirizzi e modello. Questa guida descrive CMS 1.104.0 usando il catalogo dei plugin come esempio.

Un ciclo Grid ripete schede dentro una pagina del catalogo; una regola di pagine automatiche serve un URL di dettaglio distinto per ogni record idoneo. Usano fonti correlate, ma si configurano separatamente. Consulta Contenuti dinamici per selezione delle fonti, cicli e associazioni dei campi.

Comprendi che cosa viene creato

Una regola attiva serve base path + / + record slug. Per esempio, il percorso base /extensions e lo slug webblocks-appointments producono /extensions/webblocks-appointments; la variante turca usa /tr/extensions/webblocks-appointments. Lo slug è uguale nelle sei lingue. Nomi e descrizioni sono tradotti dal fornitore.

Il CMS renderizza l'URL quando viene richiesto; non crea sei copie modificabili per ogni nuovo record. Pagine contiene il modello e le eventuali pagine native conservate, non una nuova pagina salvata per ogni URL generato. Una chiave stabile identifica il record; lo slug ne determina l'indirizzo pubblico. Mantieni entrambi stabili. Cambiare lo slug cambia l'URL; questo flusso non reindirizza automaticamente il vecchio slug.

Prepara la fonte e il modello di dettaglio

Il fornitore installato deve esporre una raccolta con contratto di pubblicazione 1.0 e una fonte di entità singola compatibile. Una raccolta normale non basta. Nell'esempio, Published plugin catalog (webblocks-extensions-live::plugins) pubblica record tramite Published plugin (webblocks-extensions-live::plugin). Credenziali API e impostazioni di pubblicazione dell'applicazione di origine appartengono all'integrazione del fornitore, non al modulo della regola.

Crea o seleziona una pagina modello di dettaglio dello stesso sito, tradotta in tutte le lingue abilitate. Collega i suoi campi propri alla fonte di entità dichiarata: Header a title, riepilogo a summary, origine di Image a image_url, testo alternativo a image_alt e didascalia a image_caption. Sono collegamenti di entità, non associazioni del Record corrente del ciclo. Il record selezionato fornisce questi campi durante il rendering automatico; la scelta del record salvata e i valori editoriali non vengono riscritti. Altre fonti, cicli e Shared Slot mantengono il proprio comportamento.

Il modello richiede almeno un collegamento di entità compatibile. Controlla blocco, campo di destinazione e campo della fonte in Campi del record selezionato. Consulta i collegamenti delle immagini di Contenuti dinamici per associare separatamente immagine, testo alternativo, didascalia e link. I blocchi pubblicati devono essere pronti per il rendering pubblico; un'anteprima privata può mostrare anche blocchi in bozza.

Crea una regola in bozza

  1. Apri Contenuti dinamici → Pagine automatiche, seleziona il sito e scegli Nuova regola in bozza.
  2. Inserisci il Nome della regola e seleziona la Fonte di contenuti idonea.
  3. Scegli il Modello di dettaglio. Puoi selezionare la normale Pagina del catalogo; questo non crea né configura il suo ciclo di schede.
  4. Inserisci un Percorso base, per esempio /extensions, e scegli Salva bozza. Usa un percorso canonico non riservato, senza prefisso di lingua né slug di un singolo record.

Il modulo mostra Lingue del sito e i campi di entità, slug, titolo, descrizione e immagine dichiarati dal fornitore. Se non appare una fonte idonea, controlla il fornitore installato e il contratto di pubblicazione. Non inventare un secondo campo di stato di pubblicazione nel CMS. È il fornitore a decidere quali record sono pubblici.

Salvare una bozza non pubblica rotte né modifica URL esistenti. Le configurazioni delle regole attive e in pausa sono di sola lettura; il modulo non permette modifiche arbitrarie a fonte, percorso base o modello.

Esamina i record e l'anteprima in ogni lingua

Scegli Esamina record, selezionane uno, controlla Esamina campi della fonte e apri Anteprima della pagina per ogni lingua abilitata del sito. L'ispettore verifica i valori reali della fonte in tutte le sei lingue CMS: en, tr, de, es, it e fr. Anche il modello deve contenere le traduzioni di pagina abilitate.

Il fornitore offre titoli, riepiloghi, testi alternativi, didascalie e altri campi dichiarati nella lingua richiesta. Lo stesso file immagine può essere condiviso fra le lingue. Il CMS non traduce contenuti mancanti né li sostituisce silenziosamente con l'inglese. Verifica che l'immagine si carichi e che il testo alternativo sia appropriato; controlla i link oltre al testo visibile.

Le anteprime private richiedono autenticazione, usano noindex,nofollow e non attivano rotte, creano pagine di dettaglio salvate o modificano il modello. Cambiare lingua conserva il record selezionato. Il supporto linguistico dichiarato non sostituisce il controllo delle traduzioni effettive.

Controlla gli indirizzi esistenti prima dell'attivazione

Apri Esamina la transizione. La verifica elenca chiavi pubbliche attuali, URL proposti, preparazione nelle sei lingue, ID delle pagine di dettaglio esistenti e modello scelto per ogni record. Una pagina nativa corrispondente mantiene il proprio modello; i record senza pagina corrispondente usano il Modello di dettaglio condiviso. Il catalogo rimane una normale pagina CMS.

Risolvi gli errori prima dell'attivazione: intervalli di regole sovrapposti, pagine native in conflitto o senza corrispondenza, modelli protetti, traduzioni di pagina mancanti, contenuti della fonte non validi o ricerca pubblica dello slug non disponibile. Per conservare un indirizzo, mantieni ogni traduzione nativa di dettaglio nel percorso previsto del record. La verifica usa l'intero catalogo di pubblicazione, indipendentemente da filtri, limiti e paginazione di Grid.

La verifica comprende valori della fonte, revisione della regola e contenuti nativi conservati. Se uno cambia prima dell'attivazione, ripeti la verifica. Il CMS rifiuta una verifica obsoleta invece di attivare una transizione diversa.

Attiva, poi pubblica i record nella fonte

Attiva le rotte automatiche è un'azione di pubblicazione separata. Possono attivare i super amministratori e gli amministratori con accesso al sito selezionato; gli editor con accesso possono esaminare configurazione e anteprime. Salvare o visualizzare un'anteprima non concede l'autorità di pubblicare.

Supponi che, dopo l'attivazione, l'applicazione Plugins esponga un record pubblicato valido con slug webblocks-appointments. I testi della fonte vengono renderizzati con il modello scelto su /extensions/webblocks-appointments e sulle cinque varianti con prefisso di lingua. Quando un altro record valido diventa pubblico, la regola attiva può servirne l'URL senza copiare pagine CMS o attivare una nuova regola per quel record. La disponibilità dipende dal fornitore che restituisce un record pubblico con traduzioni complete, non da una parola di stato digitata nel CMS.

Questo è il flusso della richiesta:

Regola attiva + slug pubblico
  -> il fornitore risolve la chiave stabile del record
  -> il contenuto viene validato nelle sei lingue CMS
  -> si sceglie il modello conservato o quello di dettaglio condiviso
  -> la lingua richiesta viene renderizzata al suo URL esistente

Ritira un record senza lasciare vecchie copie pubbliche

Ritira il record nell'applicazione di origine. Quando il fornitore non lo espone più come pubblico, gli URL automatici restituiscono 404 in ogni lingua abilitata e il record non contribuisce più ai risultati automatici di ricerca né alla sitemap. Per esempio, ritirare webblocks-appointments elimina la disponibilità pubblica di /extensions/webblocks-appointments e delle varianti linguistiche. È una sequenza illustrativa; questa guida non modifica lo stato dell'esempio reale.

Non devi ritirare separatamente sei copie CMS. La regola attiva controlla il proprio intervallo di dettaglio: una pagina nativa conservata non può diventare una vecchia copia pubblica di ripiego. Non usare Ripristina la pubblicazione precedente per ritirare un solo record: ferma l'intera regola e può ripristinare la pubblicazione nativa precedente. La visibilità delle schede dipende dal fornitore della raccolta e dall'aggiornamento dei dati; un ciclo Grid non è la regola delle rotte automatiche.

Distingui il ritiro da un errore della fonte

  • Pronto: il contenuto pubblico attuale rispetta il contratto della fonte in tutte le sei lingue; una rotta di dettaglio idonea può essere renderizzata.
  • Non pubblico / non trovato: il record o lo slug esatto è assente o ritirato; la rotta pubblica restituisce 404.
  • Fonte non disponibile: il fornitore non è raggiungibile o la ricerca di pubblicazione fallisce; la risoluzione pubblica restituisce 503.
  • Contenuto incompleto o incompatibile: identità, slug, titolo, schema o traduzione effettiva non superano la validazione; la risoluzione pubblica restituisce 503 invece di una pagina parzialmente tradotta.

Un ritiro intenzionale è diverso da un timeout o da un record francese non valido. Correggi il fornitore o la traduzione quando necessario. Il CMS non espone una vecchia copia nativa per nascondere un problema della fonte. Anche ricerca e sitemap richiedono un catalogo di pubblicazione attuale valido; un catalogo non valido può restituire 503 invece di risultati obsoleti o parziali.

Controlla ricerca, URL canonical e sitemap

Le regole attive includono i record pubblici attuali nella normale ricerca HTML e JSON del sito, senza ricostruire manualmente l'indice. La ricerca usa titolo di pubblicazione, descrizione e URL pubblico dichiarati nella lingua richiesta, non ogni campo della fonte o il testo nativo conservato. I record nuovi e ritirati vengono verificati nelle ricerche successive. Le query vuote o troppo brevi mantengono il comportamento normale senza risolvere la fonte.

Le pagine generate usano l'URL pubblico del record come canonical e offrono alternative nelle lingue abilitate. La sitemap elenca i record attualmente idonei con URL e alternative linguistiche; restano valide le normali regole di indicizzabilità e accesso. Il limite di un blocco di raccolta non limita la scoperta dei dettagli automatici. Dopo un'attivazione autorizzata, verifica sei URL, contenuti tradotti, metadati delle immagini, ricerca e sitemap. Consulta Ricerca e Localizzazione.

Ripristina consapevolmente la pubblicazione nativa precedente

L'attivazione conserva revisioni complete di recupero delle pagine native corrispondenti, le imposta come bozze e serve i contenuti della fonte con i modelli preservati. Indirizzi, blocchi, immagini e traduzioni restano salvati. I modelli conservati non possono essere eliminati o spostati su un altro sito finché esistono i record di adozione.

Su una regola attiva, Ripristina la pubblicazione precedente recupera gli stati originali delle pagine conservate e mette in pausa le rotte automatiche. Verifica che il contenuto non sia cambiato dall'attivazione e blocca il ripristino in caso di differenze. La pulizia di manutenzione non elimina revisioni di recupero protette. Una regola in pausa mantiene la configurazione e deve superare una nuova verifica della transizione prima di essere riattivata.

Il ripristino riguarda le pagine native conservate; non crea copie native per nuovi record esistiti solo come rotte automatiche. Consideralo una decisione di pubblicazione del sito e controlla poi rotte pubbliche e risultati di scoperta. Consulta Flusso di lavoro editoriale.

Riferimento per il fornitore

Una raccolta di standard 1.0 dichiara publishesPages() con una fonte di entità dello stesso plugin e le associazioni dei campi di pubblicazione. Implementa ContentPublicationSource::publicationPage() per identità pubbliche limitate e ContentPublicationSource::publicationRecord() per lo stato attuale del record. Le rotte pubbliche richiedono anche ContentPublicationRouteSource::publicationKey() per risolvere uno slug esatto senza scorrere il catalogo. Entrambe le politiche di accesso devono consentire la risoluzione pubblica.

L'enumerazione deve avanzare il cursore e rifiutare identità o slug duplicati. La ricerca distingue contenuti disponibili, mancanti, non disponibili e incompleti. Le chiavi stabili e gli slug minuscoli separati da trattini devono coincidere nei sei record tradotti; _locale deve corrispondere alla lingua richiesta. Il rendering pubblico usa un contesto non di anteprima e senza amministratore. Non restituire vecchi dati di successo dopo il ritiro né etichettare contenuti inglesi come un'altra lingua. Consulta il contratto delle fonti di Contenuti dinamici per tipi di campo, immagini e traduzioni del fornitore.