Come usare asset dei temi per il centro assistenza

Quale piano sto usando?

Anteprima: Amministratore Guide > Personalizza design > seleziona tema > Modifica > Asset

Puoi caricare asset in qualsiasi tema del centro assistenza, come immagini e file.

L’articolo include le seguenti sezioni:

• Caricamento di un asset per il tema
• Uso degli asset caricati nel codice del tema
• Sostituzione di un asset nel tema
• Eliminazione di un asset del tema

Caricamento di un asset per il tema

Puoi caricare asset come immagini e file nel centro assistenza. Gli asset sono memorizzati in una cache web all'interno di una rete di distribuzione cloud (CDN). Le cache web riducono i requisiti di larghezza di banda e il carico del server e migliorano i tempi di risposta.

Esistono diversi tipi di file consentiti per i temi. Consulta Tipi di file consentiti per gli asset dei temi.

Per caricare i tuoi asset dei temi

1. In Guide, fai clic sull’icona Personalizza aspetto () nella barra laterale.
2. Fai clic su Personalizza per il tema da modificare.
3. Fai clic su Modifica codice.

   

4. Nella sezione File, fai clic su Aggiungi nuovo, quindi seleziona Asset.

   

5. Sfoglia per selezionare il file. I nomi degli asset dei temi devono essere univoci e non possono superare i 50 caratteri. I nomi degli asset possono contenere i seguenti elementi: lettere, numeri, punti, simbolo meno e più, trattino basso e trattino. I nomi degli asset non fanno distinzione tra maiuscole e minuscole, quindi non puoi avere un asset denominato asset.jpg e Asset.jpg.

   Il file di asset viene aggiunto all’elenco di file di asset.

Tipi di file consentiti per gli asset dei temi

La tabella seguente mostra i tipi di file consentiti come asset dei temi. I tipi di file consentiti per gli asset sono limitati ai tipi di file usati nei temi di un centro assistenza.

Tipo di asset	Tipi di file consentiti
Immagini	jpg, jpeg, png, gif, svg, webp, tiff, tif, bmp, ico, webm
Carattere	woff2, woff, eot, otf, ttf, svg
File di testo	js, css, html, json, txt, xml
Altro	mp4, swf, wav, ogg. mp3

I tipi di file con contenuti avanzati, come Microsoft PowerPoint, Microsoft Word e PDF, possono essere allegati di articoli ma non asset di temi.

Uso degli asset caricati nel codice del tema

Puoi fare riferimento a un asset caricato nel file style.css del tema o nei relativi modelli. In style.css, puoi usare le variabili di percorso degli asset fornite da Guide. Nei modelli, usi l’helper di asset di Curlybars.

L’uso di variabili di asset e helper nel codice ti consente di sostituire facilmente gli asset nel tema senza modificare il codice del tema. Consulta Sostituzione di un asset nel tema.

Nota: Non puoi usare le variabili di percorso o l’helper nel file script.js del tema.

Per usare un asset caricato nel codice del tema

1. In Guide, fai clic sull’icona Personalizza aspetto () nella barra laterale.
2. Fai clic su Personalizza per il tema da modificare.
3. Fai clic su Modifica codice.
4. Nella sezione Asset, fai clic sul file di asset che intendi usare.

   Vengono visualizzate varie espressioni per l’asset:

   

5. Fai clic su Copia per copiare l’espressione dell’asset negli Appunti.
6. Incolla l’espressione dell’asset nel codice del tema.

Esempi

style.css

.class-name { 
  background: url($assets-backpack2-jpeg);
}

Il valore assets-backpack2-jpeg è una variabile che contiene il percorso relativo all’asset.

file .hbs

Nel markup HTML:

<img src="{{asset 'backpack2.jpeg'}}">

In un tag di stile:

<style>
  .class-name { 
    background: url("{{asset 'backpack2.jpeg'}}");
  }
</style>

In un tag di script:

<script>
  var assetsBackpack2 = "{{asset 'backpack2.jpeg'}}";
</script>

Sebbene tu possa inserire l’helper di asset in un tag di script all’interno di un modello, non puoi usarlo nel file script.js.

Per ulteriori informazioni sulla modifica del codice del tema, consulta Personalizzazione del tema del centro assistenza.

Sostituzione di un asset nel tema

L’uso di variabili e helper di asset come descritto in Uso degli asset caricati nel codice del tema qui sopra, consente di sostituire dinamicamente un asset nel tema senza modificare il codice del tema. Puoi aggiornare il tema semplicemente selezionando un nuovo file di asset nel sistema.

Per sostituire un asset

1. In Guide, fai clic sull’icona Personalizza aspetto () nella barra laterale.
2. Fai clic su Personalizza per il tema da modificare.
3. Fai clic su Modifica codice.
4. Nella sezione Asset, individua il file di asset da sostituire.
5. Fai clic sul menu delle opzioni alla fine del nome del file dell’asset, quindi seleziona Sostituisci.

   

6. Seleziona un nuovo asset nel sistema.

   Una volta caricato, il tema viene aggiornato dinamicamente da qualsiasi variabile o helper che fa riferimento all’asset. La modifica è immediata.

   L’asset non viene sostituito se hai usato l’URL completo nella sorgente HTML delle pagine del centro assistenza pubblicate. Il link all’asset verrà interrotto perché la sostituzione di un asset modifica l’URL pubblicato dell’asset. Di conseguenza, evita di usare l’URL dell’asset pubblicato in un tema, in un modello di pagina o in una pagina web esterna.

Eliminazione di un asset del tema

Puoi eliminare facilmente qualsiasi asset del tema che non usi più nel tuo tema.

Per eliminare un asset del tema

1. In Guide, fai clic sull’icona Personalizza aspetto () nella barra laterale.
2. Fai clic su Personalizza per il tema da modificare.
3. Fai clic su Modifica codice.

   

4. Nella sezione Asset , individua il file di asset da eliminare.
5. Fai clic sul menu delle opzioni alla fine del nome del file dell’asset, quindi seleziona Elimina asset.

   

6. Conferma l’eliminazione dell’asset.

   L’asset viene rimosso dall’elenco degli asset.