Plugin WordPress: configurare LabelGrid Tools

Aggiornato a settembre 2026.

LabelGrid Tools e il plugin WordPress ufficiale che sincronizza automaticamente il tuo catalogo di release, profili artisti e download gates da LabelGrid al tuo sito WordPress. LabelGrid e la fonte di verità — il plugin importa i tuoi dati ogni 6 ore, in modo che il tuo sito web rifletta sempre il tuo catalogo più recente.

Disponibile con qualsiasi piano

LabelGrid Tools è disponibile per tutti gli account LabelGrid senza costi aggiuntivi e non richiede un piano API. È uno dei due modi per avere l’esperienza smart link di LabelGrid: ogni release ha già una landing page ospitata e un link breve sul dominio LabelGrid (vedi Landing page delle release), e questo plugin porta le stesse pagine per release (link agli store, pulsanti di pre-save Spotify e download gate) sul tuo dominio WordPress, insieme all’intero catalogo e ai profili artista.

Panoramica

Cosa puoi fare

Puoi inserire ognuna di queste funzionalità sul tuo sito come shortcode, come blocco nativo di Gutenberg, oppure tramite Elementor: vedi Blocks (Gutenberg) e Elementor.

Funzionalità	Descrizione
Sincronizzazione automatica del catalogo	Release, artisti e download gates si sincronizzano da LabelGrid ogni 6 ore
Pagine release	Pagine con artwork e link a tutte le principali piattaforme di streaming e store
Profili artisti	Pagine artisti con biografie, link social e discografia
Griglie di release	Griglie filtrabili del tuo catalogo per genere, etichetta o artista
Banner release	Banner per la homepage che evidenziano le tue ultime release
Pre-save Spotify	Pulsanti pre-save con azioni di follow per playlist e artista
Pre-ordini	Supporto per pre-ordini su iTunes, Apple Music, Beatport, Juno e Amazon
Download gates	Gates di acquisizione email con azioni di follow su Spotify
Lettore web Spotify	Lettore Spotify integrato nelle pagine release
Comunicati stampa	Sezioni dedicate ai comunicati stampa nelle pagine release
Link affiliato iTunes	Guadagna commissioni sugli acquisti iTunes tramite il tuo sito
Integrazione Yoast SEO	Metadati Open Graph per la condivisione social

Requisiti

• WordPress 7.0 o superiore
• PHP 8.0 o superiore
• Un account LabelGrid attivo (nessun piano API richiesto)

---

Installazione

Dall’admin di WordPress

1. Vai a Plugins → Add New
2. Cerca “LabelGrid Tools”
3. Clicca su Install Now
4. Clicca su Activate

Installazione manuale

1. Scarica il plugin da LabelGrid
2. Vai a Plugins → Add New → Upload Plugin
3. Seleziona il file ZIP scaricato
4. Clicca su Install Now
5. Clicca su Activate

---

Configurazione

Ottenere la chiave di autorizzazione

Le chiavi create per versioni precedenti del plugin non funzionano più

LabelGrid non accetta più le chiavi API create per versioni precedenti del plugin. Se i tuoi download gate, i pre-save o la sincronizzazione del catalogo hanno smesso di funzionare, crea una nuova chiave seguendo i passaggi qui sotto e incollala nel plugin. Non devi cambiare altro: i gate e i pre-save esistenti mantengono la loro configurazione.

Finché la chiave viene rifiutata, la scheda Download Gate sparisce dalle impostazioni del plugin. La funzione non è stata rimossa: la scheda torna appena salvi una chiave valida.

Il controllo lo fa LabelGrid, non il plugin, quindi riguarda tutte le versioni. I siti ancora in 1.5.0 o 1.6.0 non restano senza avviso: mostrano un solo banner più vecchio e meno preciso, API LabelGrid DISABILITATA: Verifica che il token API sia corretto e che il tuo account sia abilitato ai servizi API di LabelGrid., che descrive lo stesso problema. Nella sezione sulla risoluzione dei problemi trovi tutti i messaggi e il significato di ciascuno.

Prima di configurare il plugin, crea una chiave di autorizzazione in LabelGrid:

1. Accedi a LabelGrid
2. Clicca sul tuo menu utente (il tuo nome/avatar nell’angolo in alto a destra)
3. Clicca su Wordpress dal menu a tendina
4. Clicca sul pulsante Configure Plugin
5. In Step 1: Create Key, seleziona quali etichette includere:
   • Scegli All My Labels per sincronizzare l’intero catalogo
   • Oppure seleziona etichette specifiche per limitare ciò che appare sul tuo sito web
6. Clicca su Create New Key
7. Inserisci il dominio del tuo sito WordPress (es. https://iltuosito.com)
8. Clicca su OK per generare la chiave
9. Copia il token di accesso — ti servira per WordPress

Attenzione

Ogni chiave è associata a un dominio specifico. Se hai più siti WordPress, crea una chiave separata per ciascuno.

Impostazioni del plugin

Apri LabelGrid Tools → Impostazioni generali (General Settings) nell’admin di WordPress: è una voce di menu di primo livello, non si trova sotto Impostazioni di WordPress. Arrivi così a Impostazioni di LabelGrid Tools. La pagina ha sei schede, qui con l’originale inglese tra parentesi:

Connessione (Connection) · Pagine delle release (Release Pages) · Pagine degli artisti (Artist Pages) · Link e servizi (Links & Services) · Download Gate · Sistema (System)

Download Gate compare solo quando il download gate è attivo. Finché il plugin non ha una chiave API valida la scheda è nascosta del tutto, quindi se non la vedi consulta più sotto la sezione sulla risoluzione dei problemi.

Connessione

Setting	Description
Token API LabelGrid	Incolla il token di accesso che hai copiato da LabelGrid. Dalla 1.6.1 è un campo su una sola riga, in linea con le chiavi più corte che LabelGrid rilascia adesso
Sincronizzazione automatica dei contenuti tramite API LabelGrid	Attivare o disattivare la sincronizzazione automatica del catalogo

Pagine delle release

Setting	Description
Mostra le release non ancora pubblicate	Mostrare le prossime release sul tuo sito
Pre-Save Spotify	Attivare i pulsanti di pre-save Spotify sul contenuto non pubblicato
Pre-Save Spotify - Raccolta e-mail	No / Si (obbligatorio) / Si (opzionale) — raccogliere email durante il pre-save
Pre-Order iTunes / Apple Music / Beatport / Juno / Amazon Music	Attivare i link di pre-ordine per iTunes, Apple Music, Beatport, Juno e Amazon
Mostra il web player di Spotify	Mostrare il lettore Spotify integrato nelle pagine release
Mostra il comunicato stampa	Mostrare le sezioni dei comunicati stampa
Mostra gli artisti in evidenza	Mostrare gli artisti in evidenza nelle pagine release
Mostra release simili	Mostrare release simili
Campo sotto l’artwork	Scegliere cosa mostrare sotto l’artwork: codice release o etichetta discografica

Pagine degli artisti

Setting	Description
Mostra il feed di Twitter	Mostrare il feed Twitter nelle pagine artisti
Mostra il feed di Bandsintown	Mostra un feed Bandsintown sulle pagine artista

Link e servizi

Setting	Description
Servizi RELEASE / Servizi ARTISTI	Ordina e mostra o nascondi i link di streaming e store sulle pagine release e artista
Servizi personalizzati	Aggiungi servizi tuoi da mostrare sulle pagine release e artista
Token dell’Apple Performance Partner Program	Il tuo token affiliato iTunes per guadagnare commissioni sugli acquisti

Download Gate

Setting	Description
Mostra il comunicato stampa	Impostazioni di visibilità stampa
Mostra gli artisti in evidenza	Controllare la visualizzazione degli artisti nelle pagine gate
Etichetta del pulsante	Testo personalizzato per i pulsanti dei gate
Titolo di benvenuto	Titolo mostrato nella pagina di destinazione del gate
Descrizione di benvenuto	Testo di descrizione per la pagina di destinazione del gate
Etichetta del pulsante del gate	Testo per il pulsante della procedura guidata del gate

Sistema

Setting	Description
Abilita la registrazione dei log di errore	Imposta il livello di registrazione per la risoluzione dei problemi
Giorni di conservazione dei log	Per quanto tempo conservare i log di sistema
Visualizza i Log di sistema	Apri i log di sistema salvati
Informazioni di sistema	Dettagli sull’ambiente da allegare quando contatti il supporto
Disinstallazione	Solo un’informazione, senza pulsante né impostazione. Spiega che eliminando il plugin dalla schermata Plugin vengono rimosse le sue impostazioni, token API compreso, e le sue tabelle di log e di iscrizioni al gate, mentre le tue release, gli artisti, i download gate e i loro campi restano nel database

---

Sincronizzazione del catalogo

Il plugin sincronizza automaticamente il tuo catalogo da LabelGrid ogni 6 ore. Questo include release, artisti e download gates.

Il plugin crea tre tipi di contenuto personalizzati in WordPress:

Tipo di contenuto	Descrizione	Struttura URL
Release	Release musicali con artwork, metadati e link alle piattaforme	/release/nome-della-release/
Artist	Profili artisti con biografia e link social	/artist/nome-dell-artista/
Gate Download	Download gates con acquisizione email	/free-download/nome-del-gate/

I download gates supportano anche una tassonomia Gate Category per organizzare i tuoi gate in gruppi.

Nota

LabelGrid e la fonte di verità. Le modifiche apportate ai post di release o artisti in WordPress verranno sovrascritte alla prossima sincronizzazione. Effettua tutti i cambiamenti al catalogo in LabelGrid.

---

Shortcode

Il plugin fornisce 11 shortcode organizzati in quattro categorie: release, artisti, download gates e pre-save. Ogni shortcode ha anche un blocco Gutenberg corrispondente con le stesse opzioni: vedi Blocks (Gutenberg).

Shortcode per le release

[labelgrid-release-list]

Mostra le tue release in una griglia filtrabile.

Esempio base:

[labelgrid-release-list items-page="12" items-row="4"]

Parametri:

Parametro	Predefinito	Descrizione
show-title	null	Mostrare i titoli delle release
label	null	Filtrare per etichetta discografica
items-page	12	Numero di release per pagina
items-row	4	Numero di colonne per riga
pagination	null	Attivare la paginazione
showcase-last	null	Attivare la modalità vetrina
item-filter	released	Tipo di filtro: released o unreleased
title-below	null	Posizionare il titolo sotto l’artwork
filter-artists	null	Filtrare per ID artisti
exclude	null	Escludere ID di release specifici
image-quality	lgt_artwork_medium	Preset dimensione immagine

Mostrare le prossime release:

[labelgrid-release-list item-filter="unreleased" items-row="3"]

[labelgrid-release-list-filter]

Aggiungi un filtro a tendina sopra la tua griglia di release. Posiziona questo shortcode prima di [labelgrid-release-list] nella stessa pagina.

Esempio base:

[labelgrid-release-list-filter]
[labelgrid-release-list items-page="12"]

Parametri:

Parametro	Predefinito	Descrizione
record_label	null	Mostrare un filtro a tendina per etichetta discografica

[labelgrid-release-banner]

Mostra un banner che evidenzia una o più release — ideale per le homepage.

Esempio base:

[labelgrid-release-banner items-page="1"]

Parametri:

Parametro	Predefinito	Descrizione
label	null	Filtrare per etichetta discografica
items-page	1	Numero di release da mostrare
item-filter	released	Tipo di filtro: released o unreleased
item-order	DESC	Ordine: DESC (più recenti prima) o ASC
filter-artists	null	Filtrare per ID artisti
exclude	null	Escludere ID di release specifici

[labelgrid-release-links]

Mostra i link di streaming e store per una release specifica. Usa questo shortcode nei template delle pagine release o in qualsiasi pagina specificando un ID release.

Esempio base:

[labelgrid-release-links]

Con una release specifica:

[labelgrid-release-links release-id="123" artists="true"]

Parametri:

Parametro	Predefinito	Descrizione
release-id	ID del post corrente	L’ID del post della release
artists	null	Mostrare le informazioni dell’artista accanto ai link

[labelgrid-release-detail]

Visualizza la pagina completa di dettaglio della release, inclusi artwork, metadati, link alle piattaforme e lettore integrato. Questo shortcode utilizza il post corrente e non accetta parametri.

Esempio (in un template di release):

[labelgrid-release-detail]

Shortcode per gli artisti

[labelgrid-artist-list]

Mostra i tuoi artisti in un layout a griglia.

Esempio base:

[labelgrid-artist-list items-page="8" items-row="4"]

Parametri:

Parametro	Predefinito	Descrizione
show-title	false	Mostrare i nomi degli artisti sotto le immagini
category	null	Filtrare per categoria
items-page	12	Numero di artisti per pagina
items-row	4	Numero di colonne per riga
pagination	null	Attivare la paginazione
title-below	null	Posizionare il titolo sotto l’immagine

[labelgrid-artist-detail]

Visualizza la pagina completa del profilo dell’artista, inclusi biografia, link social e discografia. Questo shortcode utilizza il post corrente e non accetta parametri.

Esempio (in un template di artista):

[labelgrid-artist-detail]

Shortcode per i download gates

[labelgrid-gate-button]

Mostra un pulsante di download gate. Quando viene cliccato, il visitatore passa attraverso il flusso del gate (acquisizione email e follow social opzionale) prima di ottenere l’accesso al download.

Esempio base:

[labelgrid-gate-button]

Con testo personalizzato:

[labelgrid-gate-button gate-id="45" button-label="Scarica Gratis" custom-class="mio-pulsante"]

Parametri:

Parametro	Predefinito	Descrizione
gate-id	ID del post corrente	L’ID del post del download gate
post-id	ID del post corrente	ID del post della release associata
button-label	null	Testo personalizzato del pulsante
custom-class	null	Classe CSS aggiuntiva
download-text	null	Testo personalizzato del pulsante di download

[labelgrid-gate-download-list]

Mostra i tuoi download gates in un layout a griglia.

Esempio base:

[labelgrid-gate-download-list items-page="6" items-row="3"]

Parametri:

Parametro	Predefinito	Descrizione
show-title	false	Mostrare i titoli dei gate
category	null	Filtrare per categoria gate
items-page	12	Elementi per pagina
items-row	4	Colonne per riga
pagination	null	Attivare la paginazione
title-below	null	Posizionare il titolo sotto l’immagine

[labelgrid-gate-download-detail]

Visualizza la pagina completa di dettaglio del download gate. Questo shortcode utilizza il post corrente e non accetta parametri.

Esempio (in un template di gate):

[labelgrid-gate-download-detail]

Shortcode di pre-save

[labelgrid-presave-button]

Mostra un pulsante di pre-save Spotify per una release in uscita. I visitatori possono effettuare il pre-save della release e opzionalmente seguire l’artista e una playlist su Spotify.

Esempio base:

[labelgrid-presave-button]

Per una release specifica:

[labelgrid-presave-button release-id="123"]

Parametri:

Parametro	Predefinito	Descrizione
release-id	ID del post corrente	L’ID del post della release

Consiglio

Attiva “Spotify Pre-Save - Collect Email” nella scheda impostazioni Release Pages per raccogliere indirizzi email durante il flusso di pre-save.

---

Azioni di gate e pre-save

Un download gate chiede ai fan di collegare Spotify e completare una o più azioni prima di sbloccare il download. Un pre-save salva sempre la release stessa e può aggiungere azioni di follow.

Le azioni Spotify disponibili sono:

• Salvare la release: sempre inclusa in un pre-save
• Seguire un artista
• Seguire una playlist
• Seguire un profilo Spotify: novità della 1.6.0

I target dei follow non sono più limitati agli artisti del tuo catalogo, quindi puoi puntare un gate su un collaboratore o su un artista ospite.

Le azioni SoundCloud e Twitter sono in pausa

Dalla versione 1.6.0 le azioni dei download gate sono solo Spotify. Quelle SoundCloud e Twitter sono in pausa mentre vengono ricostruite: non vengono più eseguite né mostrate ai fan, e il gate continua a funzionare con le sue azioni Spotify.

Se uno dei tuoi gate chiedeva di collegare più di un servizio, ora il plugin chiede solo quelli ancora disponibili, altrimenti il gate non potrebbe mai essere completato. La tua impostazione salvata resta invariata e torna valida quando gli altri servizi rientrano. Controlla ogni gate che prima richiedeva più di un account e verifica che le azioni Spotify rimaste chiedano ancora quello che vuoi.

Un gate le cui azioni erano solo SoundCloud o Twitter non ha più nulla da chiedere e non funziona affatto finché non gli aggiungi un’azione Spotify.

Come si contano i limiti delle azioni

I gate accettano molte più azioni Spotify di prima, e l’editor del gate mostra quante ne hai usate mentre modifichi.

Ogni link conta come un’azione. Una riga di azione con tre link a playlist conta come tre, non come una. È proprio qui che si sbaglia il conto quando un gate si avvicina al limite.

Cercare tra le playlist durante un pre-save

Quando un pre-save propone di aggiungere la release a una playlist del fan, questi può cercare tra le sue playlist invece di scorrere tutto l’elenco.

---

Blocks (Gutenberg)

A partire dalla versione 1.5.0, LabelGrid Tools include blocchi nativi per l’editor a blocchi per ogni funzionalità. Nell’editor di WordPress, clicca sull’inseritore di blocchi (il pulsante +) e cerca la categoria LabelGrid Tools, oppure cerca un blocco per nome. Imposta le opzioni di ogni blocco nella barra laterale del blocco: le stesse opzioni accettate dallo shortcode corrispondente.

Ci sono 11 blocchi, uno per ogni shortcode:

Blocco	Shortcode equivalente	Cosa fa
LabelGrid Release List	[labelgrid-release-list]	Griglia responsive delle tue release (colonne, elementi per pagina, etichetta, paginazione, opzioni titolo)
LabelGrid Release List Filter	[labelgrid-release-list-filter]	Filtro per genere (più un filtro per etichetta quando è configurata un’etichetta); abbinalo a una release list nella stessa vista
LabelGrid Release Banner	[labelgrid-release-banner]	Banner a larghezza intera che mette in evidenza una release: ideale per le homepage
LabelGrid Release Links	[labelgrid-release-links]	Link di streaming e store per la release corrente
LabelGrid Release Detail	[labelgrid-release-detail]	Il corpo completo della release; usalo in un template singolo di Releases
LabelGrid Artist List	[labelgrid-artist-list]	Griglia responsive dei tuoi artisti
LabelGrid Artist Detail	[labelgrid-artist-detail]	Il corpo completo dell’artista; usalo in un template singolo di Artists
LabelGrid Gate Button	[labelgrid-gate-button]	Pulsante download gate; viene visualizzato solo quando la connessione LabelGrid è attiva
LabelGrid Gate Download List	[labelgrid-gate-download-list]	Griglia dei download con registrazione; solo quando la connessione è attiva
LabelGrid Gate Download Detail	[labelgrid-gate-download-detail]	Il corpo completo del download con registrazione; solo quando la connessione è attiva
LabelGrid Presave Button	[labelgrid-presave-button]	Pulsante di pre-save Spotify; viene visualizzato solo quando la connessione è attiva e se la data di release non è ancora passata

Blocchi e shortcode sono intercambiabili

Ogni blocco utilizza lo stesso motore di rendering del suo shortcode corrispondente, quindi una pagina costruita con i blocchi e una costruita con gli shortcode producono lo stesso output. I blocchi sono puramente additivi: aggiungere un blocco non modifica mai una pagina in cui non lo hai inserito, e i tuoi template esistenti per release e artisti restano invariati quando aggiorni il plugin. Preferisci gli shortcode? Restano pienamente supportati e funzionano in qualsiasi tema.

Evita di visualizzare il dettaglio due volte

In un template per singolo elemento nel Site Editor (temi a blocchi), usa o il blocco Release Detail / Artist Detail oppure il blocco Post Content (“Content”) di WordPress, non entrambi. Usarli entrambi visualizza il dettaglio della release o dell’artista due volte.

Nota

I blocchi Gate Button, Gate Download List, Gate Download Detail e Presave Button vengono visualizzati solo sui siti collegati a un account LabelGrid con un piano attivo.

---

Elementor

Ogni funzionalità di LabelGrid Tools è disponibile anche come shortcode, e il widget Shortcode integrato di Elementor — incluso nella versione gratuita di Elementor — ne inserisce una qualsiasi in una pagina senza alcun add-on aggiuntivo. La procedura con Theme Builder descritta di seguito è diversa: i template Single, le condizioni di visualizzazione e il widget Post Content sono funzionalità di Elementor Pro. Con la versione gratuita di Elementor, usa un widget Shortcode in qualsiasi pagina — e le pagine release e artisti integrate del plugin vengono già visualizzate da sole, senza alcun template Elementor.

Per creare pagine release e artisti con il Theme Builder di Elementor Pro:

1. Crea un template Theme Builder → Single e imposta la sua condizione di visualizzazione su Releases (e/o Artists).
2. Per il corpo della release o dell’artista, usa un widget Shortcode contenente [labelgrid-release-detail] / [labelgrid-artist-detail] — questo metodo visualizza sempre il dettaglio. Anche il widget Post Content lo visualizza nella maggior parte delle configurazioni; usane uno, mai entrambi, altrimenti il dettaglio viene visualizzato due volte.
3. Aggiungi griglie di release, banner, elenchi di artisti, pulsanti smart-link, pre-save e download gate in qualsiasi altro punto del tuo layout con il widget Shortcode.

Nota

Le funzionalità di download gate e pre-save vengono visualizzate solo sui siti collegati a un account LabelGrid con un piano attivo.

---

Usare un template del tuo tema per le pagine release e artisti

Per impostazione predefinita, il plugin visualizza le pagine singole di release e artisti inserendo il proprio layout nel contenuto della pagina, quindi funzionano senza alcuna modifica al tema. Se preferisci costruire queste pagine nel tuo tema, il plugin può farsi da parte e lasciare che sia un classico template PHP a visualizzarle.

Per prendere il controllo della visualizzazione in un tema classico:

1. Aggiungi add_theme_support( 'labelgrid-tools-templates' ); al file functions.php del tuo tema.
2. Aggiungi un classico template single-release.php e/o single-artist.php al tuo tema.

Quando un tema attiva l’opzione e fornisce il template corrispondente, il plugin rileva che il tuo template ha preso il controllo e sospende la propria iniezione di contenuto, in modo che la pagina venga visualizzata una sola volta dal tuo template, senza layout duplicato. Posiziona il corpo della release o dell’artista dove preferisci con i blocchi Release Detail / Artist Detail oppure gli shortcode [labelgrid-release-detail] / [labelgrid-artist-detail] dentro il tuo template.

Puoi anche attivare o disattivare l’opzione per ogni richiesta con il filtro lgt_use_theme_templates. Riceve il valore attuale dell’opzione e il post corrente, e restituisce true o false, così puoi abilitare il template del tuo tema solo per alcune release o artisti.

Nota

Questa sovrascrittura si applica solo ai template PHP classici. Prendere il controllo delle pagine release e artisti dal Site Editor di un tema a blocchi non è ancora supportato ed è un’aggiunta prevista. I siti che non attivano l’opzione non sono interessati: il layout integrato viene visualizzato esattamente come prima.

---

Riferimento classi CSS

Il plugin utilizza questi prefissi di classi CSS per lo stile:

Classe	Elemento
.lgsquarelist	Contenitore griglia per liste di release e artisti
.releaseelement	Carta individuale di release o artista
.elementrow1 a .elementrow8	Layout specifico per colonna (corrisponde all’impostazione items-row)
.elementrowx	Variante di layout flessibile
.spotify, .twitter, .youtube, .soundcloud, .facebook	Stile specifico per servizio sui link delle piattaforme
.banner-*	Elementi banner release
.gate, .gateimage, .freedownload	Elementi download gate

Nota

Gli shortcode funzionano in qualsiasi tema e page builder. Le stesse funzionalità sono disponibili anche come blocchi nativi di Gutenberg e tramite Elementor: vedi Blocks (Gutenberg) e Elementor sopra.

---

Risoluzione dei problemi

Gate, pre-save e sincronizzazione del catalogo hanno smesso di funzionare

LabelGrid non accetta più le chiavi API create per versioni precedenti del plugin. Se i download gate, i pre-save di Spotify o la sincronizzazione del catalogo si sono fermati senza che tu abbia cambiato nulla, quasi sempre è questo il motivo.

La soluzione: crea una nuova chiave e incollala nel plugin. I passaggi sono gli stessi della prima volta e li trovi sopra, nella sezione sulla configurazione. I gate e i pre-save esistenti mantengono la loro configurazione, quindi non devi rifare niente.

Come te ne accorgi:

• I download gate, i pre-save e la sincronizzazione del catalogo smettono di funzionare.
• La scheda Download Gate non compare più nelle impostazioni del plugin. La funzione non è stata rimossa: la scheda resta nascosta finché non c’è una chiave valida e ricompare appena ne salvi una nuova.
• La versione 1.6.1 mostra uno di tre avvisi specifici nell’admin di WordPress. Le versioni precedenti, 1.5.0 e 1.6.0 incluse, ne mostrano uno solo, più vecchio e meno preciso — API LabelGrid DISABILITATA: Verifica che il token API sia corretto e che il tuo account sia abilitato ai servizi API di LabelGrid., con il link Imposta l'API nelle Impostazioni generali —, ma sono colpite allo stesso modo, perché il controllo avviene su LabelGrid e non nel plugin.

Che cosa significano gli avvisi del plugin

La versione 1.6.1 mostra uno di questi tre messaggi. Due iniziano con API LabelGrid DISABILITATA:, quindi leggi tutta la frase prima di intervenire. Questa prima parte compare in italiano; la frase che segue al momento appare in inglese, ed è per questo che qui la citiamo in inglese.

La chiave va sostituita:

API LabelGrid DISABILITATA: Your API key was rejected. Keys created for older versions of this plugin are no longer accepted — create a new API key in your LabelGrid account and paste it below.

Crea una nuova chiave seguendo i passaggi della sezione sulla configurazione e incollala nel plugin.

Non è ancora stata salvata nessuna chiave:

API LabelGrid DISABILITATA: No API key is set, so gates, pre-saves and catalog sync are inactive.

Crea una chiave e incollala nelle impostazioni del plugin.

Un problema di connessione temporaneo, non un problema della chiave:

LabelGrid API UNAVAILABLE: We could not reach LabelGrid to check your connection. This is usually temporary and your key is probably fine — the check runs again automatically.

Per rifare subito il controllo, in qualsiasi versione, devi cambiare qualcosa. Il pulsante Salva impostazioni resta disattivato finché un’impostazione non cambia davvero, e reincollare la stessa chiave non conta come modifica. Cambia quindi una qualsiasi impostazione, salva, rimettila com’era e salva di nuovo. Giorni di conservazione dei log, nella scheda Sistema, va benissimo perché non influisce su nient’altro. Ogni salvataggio avvia un nuovo controllo della connessione, e il tuo sito resta esattamente com’era.

Dalla versione 1.6.2 anche il controllo quotidiano in background riparte da solo finché è salvata una chiave: un sito il cui disservizio o limite di richieste è ormai passato si riprende senza che nessuno intervenga. In 1.5.0, 1.6.0 e 1.6.1 non succedeva mai. Una volta che il plugin si era disattivato, il controllo quotidiano saltava il test di connessione finché qualcuno non salvava le impostazioni a mano.

Questo vale solo per i problemi di connessione. Una chiave rifiutata non si sistema da sola in nessuna versione: vedi più sopra «La chiave va sostituita». Se il problema continua, vedi più sotto la sezione sugli errori di connessione all’API.

Le release non appaiono

1. Vai a LabelGrid Tools → Impostazioni generali (General Settings), una voce di menu di primo livello e non dentro Impostazioni di WordPress, e verifica che il tuo token API sia inserito correttamente
2. Controlla che auto-sync sia attivo nella scheda Connection
3. Attendi fino a 6 ore per il prossimo ciclo di sincronizzazione, oppure disattiva e riattiva il plugin per attivare una sincronizzazione immediata
4. Verifica che le release siano pubblicate in LabelGrid (non in bozza)
5. Vai a LabelGrid Tools → Impostazioni generali → Sistema e aumenta il livello di debug, poi controlla i log

Gli shortcode appaiono come testo semplice

1. Assicurati che il plugin sia attivato in Plugins
2. Verifica di usare i trattini nei nomi degli shortcode (es. [labelgrid-release-list]), non gli underscore
3. Controlla eventuali errori di battitura nel nome dello shortcode

Problemi di stile

1. Verifica conflitti CSS con il tuo tema
2. Usa gli strumenti di sviluppo del browser per ispezionare le classi degli elementi
3. Aggiungi override CSS personalizzati mirando ai nomi delle classi del plugin (vedi il riferimento delle classi CSS sopra)
4. Testa con un tema WordPress predefinito per isolare i conflitti del tema

Errori di connessione API

1. Verifica che il tuo token API sia valido e non scaduto
2. Conferma che il tuo account LabelGrid sia attivo
3. Controlla che il tuo server possa effettuare richieste in uscita verso api.labelgrid.com
4. Consulta i log del plugin per messaggi di errore specifici

Voci dei gate ed esportazioni

Le voci dei download gate (indirizzi email raccolti) possono essere esportate come CSV dall’admin di WordPress. Vai al post del download gate e cerca l’opzione di esportazione.

---

Aggiornamenti

Aggiornamenti automatici

1. Vai a Plugins nel tuo admin WordPress
2. Trova “LabelGrid Tools”
3. Clicca su Enable auto-updates

Aggiornamenti manuali

1. Scarica l’ultima versione da LabelGrid
2. Vai a Plugins → Add New → Upload Plugin
3. Carica il nuovo file ZIP
4. WordPress ti chiedera di sostituire la versione esistente
5. Clicca su Replace current with uploaded

---

FAQ

”Cos’è il plugin WordPress LabelGrid Tools?”

LabelGrid Tools è il plugin WordPress ufficiale di LabelGrid. Sincronizza automaticamente il tuo catalogo di release, i profili artisti e i download gates da LabelGrid al tuo sito WordPress ogni 6 ore, e aggiunge pagine release con smart link, pulsanti di pre-save su Spotify e download con registrazione. È disponibile nella directory dei plugin di WordPress.

”Serve un piano a pagamento o un piano API per usare il plugin WordPress?”

No: LabelGrid Tools è disponibile per tutti gli account LabelGrid senza costi aggiuntivi e non richiede un piano API. Le funzionalità Gate che offre sono incluse in tutti i piani standard e API, ed esiste un piano Gate autonomo per chi vuole solo l’integrazione con WordPress senza la distribuzione.

”Come installo e collego il plugin?”

Installa LabelGrid Tools da Plugins, poi Add New in WordPress e attivalo. In LabelGrid apri il menu utente, poi Wordpress, poi Configure Plugin, crea una chiave di autorizzazione per il tuo dominio e incolla il token di accesso nella scheda delle impostazioni Connection del plugin. Ogni chiave è legata a un solo dominio.

”Ogni quanto il plugin sincronizza il mio catalogo?”

Il plugin sincronizza release, artisti e download gates da LabelGrid ogni 6 ore. LabelGrid è la fonte di verità, quindi fai tutte le modifiche al catalogo in LabelGrid: le modifiche apportate direttamente ai contenuti WordPress sincronizzati vengono sovrascritte alla sincronizzazione successiva.

”Posso aggiungere i pre-save di Spotify al mio sito con il plugin?”

Sì. Attiva il pre-save di Spotify nella scheda delle impostazioni Release Pages e inserisci lo shortcode [labelgrid-presave-button] su una release in uscita. Chi visita il sito può salvare in anticipo la release e, se vuole, seguire l’artista e una playlist; puoi anche raccogliere le email durante il pre-save.

”Posso usare i blocchi Gutenberg o Elementor, oppure solo gli shortcode?”

Tutti e tre. A partire dalla versione 1.5.0, ogni funzionalità è disponibile come shortcode, come blocco nativo di Gutenberg (li trovi nell’inseritore di blocchi nella categoria LabelGrid Tools) e tramite Elementor con il suo widget Shortcode. Ogni blocco genera lo stesso output dello shortcode corrispondente, e gli shortcode continuano a funzionare in qualsiasi tema.

---

Risorse correlate

Scopri di più sul plugin WordPress LabelGrid Tools — pagine smart-link, campagne di pre-save su Spotify e download con registrazione — sul nostro sito web. Vedi anche Configurare le campagne di pre-save.

---

Hai bisogno di aiuto?

Se hai bisogno di assistenza con il plugin WordPress, contatta il nostro team di supporto con i dettagli della tua versione WordPress, versione PHP e qualsiasi messaggio di errore dai log del plugin.