La creazione di modelli Knowledge esegue il rendering dei pacchetti di temi centro assistenza . Contiene il linguaggio di modellazione Curlybars usato nei file modello, nei file CSS e JS e nel file manifest.

Qual è il mio piano?
Tutte le suite Growth, Professional, Enterprise o Enterprise Plus
Support con Knowledge Professional o Enterprise

Riepilogo: ◀▼

La creazione di modelli dei temi del centro assistenza usa l’API per la creazione di modelli per controllare i file HTML, CSS, JavaScript e manifest del tema. Puoi controllare la versione attuale dei modelli nel codice del tema o nel manifest, quindi passare alla versione 4 per mantenere il tema funzionante, ottenere nuove funzionalità e migliorare l’accessibilità. Se usi file di temi personalizzati, visualizza in anteprima gli helper obsoleti prima del caricamento.

Importante: Zendesk annuncia la fine del ciclo di vita (EOL) per le API per la creazione di modelli del centro assistenza v1, v2 e v3. Per mantenere le funzionalità e lo stile del centro assistenza, i clienti devono passare alla versione 4 di API per la creazione di modelli. Il passaggio alla versione 4 avverrà in un’implementazione graduale per dare ai clienti il tempo di migrare i propri temi personalizzati. Consulta Annuncio della fine del ciclo di vita (EOL) per le API dei modelli centro assistenza v1, v2 e v3 .

La creazione di modelli Knowledge esegue il rendering dei pacchetti di temi centro assistenza . Questi contengono il linguaggio per modelli Curlybars usato nei file modello, nei file CSS e JS e nel file manifest.

I modelli Knowledge sono noti anche come API per la creazione di modelli.

Per ulteriori informazioni sui temi del centro assistenza, consulta Personalizzazione del tema del centro assistenza e la documentazione API per modelli.

Questo articolo include i seguenti argomenti:
  • Informazioni sulle versioni dei modelli di Knowledge
  • Verifica della versione dei modelli
  • Aggiornamento della versione dei modelli

Informazioni sulle versioni dei modelli di Knowledge

La tabella seguente elenca le versioni dei modelli di Knowledge, le date di rilascio e i link alla pagina della documentazione per sviluppatori correlata, dove puoi trovare informazioni specifiche su ciò che è disponibile in ciascuna versione.

Per verificare quale versione stai usando, consulta Verifica della versione dei modelli.

Tabella 1.
Versione Data di rilascio Pagina della documentazione per sviluppatori
1 20 novembre 2014 N/D
2 24 febbraio 2020 Aggiornamento dalla versione 1 di API per la creazione di modelli
3 1 giugno 2023 Aggiornamento dalla versione 2 di API per la creazione di modelli
4 2 luglio 2024 Aggiornamento dalla versione 3 di API per la creazione di modelli

Verifica della versione dei modelli

Puoi vedere la versione dei modelli quando modifichi il tema o quando visualizzi il file manifest.

Per controllare la versione dei modelli

  1. In Amministratore Knowledge, fai clic su Personalizza design () nella barra laterale.
  2. Fai clic su Personalizza per il tema da modificare.
  3. Fai clic su Modifica codice.
  4. Sotto il nome del tema, vedrai il numero di versione dei modelli, ad esempio Versione 2 di API per la creazione di modelli.

    Questo numero di versione corrisponde al campo api_version nel file manifest.

Aggiornamento della versione dei modelli

Se hai personalizzato il tema del centro assistenza, puoi passare all’ultima versione dei modelli per sfruttare le nuove funzioni, le prestazioni migliorate e i miglioramenti dell'accessibilità.

Quando esegui la migrazione da un’esperienza di utilizzo dei temi, ai temi verranno applicate alcune nuove limitazioni. Durante il processo di migrazione, sospendiamo alcune limitazioni relative al tipo e alle dimensioni dei file per consentirti di spostare il tema e gli asset nella nuova esperienza di utilizzo dei temi, dove sarà più semplice gestirli.

Ad esempio, se disponi di un certo numero di PDF o di altri file che non sono più supportati negli asset dei temi, potrai migrare il tema. Da lì puoi esportare il tema per recuperare facilmente tutti questi file. Tuttavia, non potrai duplicare o reimportare quel tema fino a quando i file non supportati non saranno stati rimossi dal tema.

Per aggiornare la versione dei modelli

  1. Scarica il tema del centro assistenza, consulta Scaricamento di un tema del centro assistenza.
  2. Apri il pacchetto dei temi in locale e modifica il file manifest.json.
  3. Nel file manifest.json, trova il campo api_version e imposta il valore sulla versione a cui vuoi passare.
  4. Visualizza in anteprima le modifiche apportate al tema in locale. Quando visualizzi in anteprima il tema, riceverai avvisi se usi helper che sono stati deprecati nella versione a cui stai effettuando l'aggiornamento.
  5. Se stai usando un helper obsoleto, fai riferimento alla documentazione per sviluppatori correlata (consulta Informazioni sulle versioni dei modelli di Knowledge ) per sostituire l’helper con un equivalente supportato.

    Visualizza di nuovo il tema in anteprima per verificare che non ci siano ulteriori avvisi.

  6. Carica il tema aggiornato in Knowledge (consulta Importazione del tema del centro assistenza ).

    Puoi verificare che la nuova versione sia stata applicata selezionando la versione dei modelli.

Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.

Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.

Powered by Zendesk