Plugin WordPress

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 verita — il plugin importa i tuoi dati ogni 6 ore, in modo che il tuo sito web rifletta sempre il tuo catalogo piu recente.

Disponibile con qualsiasi piano

LabelGrid Tools e disponibile per tutti gli account LabelGrid senza costi aggiuntivi — non e richiesto un piano API. Attualmente e il modo per aggiungere il pre-save di Spotify al tuo sito web con qualsiasi piano. E prevista per il futuro una pagina di pre-save integrata nell’app (senza plugin).

Panoramica

Cosa puoi fare

Funzionalita	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 oltre 25 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 social (Spotify, Twitter, SoundCloud)
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 5.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

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 cio 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 e associata a un dominio specifico. Se hai piu siti WordPress, crea una chiave separata per ciascuno.

Impostazioni del plugin

Vai a Settings → LabelGrid Tools nell’admin di WordPress. La pagina delle impostazioni ha quattro schede:

Scheda LabelGrid GATE

Impostazione	Descrizione
API Token	Incolla il token di accesso che hai copiato da LabelGrid

Scheda General Options

Impostazione	Descrizione
Debug level	Imposta il livello di registrazione per la risoluzione dei problemi
Log retention	Per quanto tempo conservare i log di sistema
Auto-sync	Attivare o disattivare la sincronizzazione automatica del catalogo
iTunes Affiliate Token	Il tuo token affiliato iTunes per guadagnare commissioni sugli acquisti

Scheda Releases

Impostazione	Descrizione
Show unreleased	Mostrare le prossime release sul tuo sito
Spotify pre-save	Attivare i pulsanti di pre-save Spotify sul contenuto non pubblicato
Pre-save email collection	No / Si (obbligatorio) / Si (opzionale) — raccogliere email durante il pre-save
Pre-orders	Attivare i link di pre-ordine per iTunes, Apple Music, Beatport, Juno e Amazon
Spotify Web Player	Mostrare il lettore Spotify integrato nelle pagine release
Press release	Mostrare le sezioni dei comunicati stampa
Featured artists	Mostrare gli artisti in evidenza nelle pagine release
Similar releases	Mostrare release simili
Show below artwork	Scegliere cosa mostrare sotto l’artwork: codice release o etichetta discografica
Twitter feed on artists	Mostrare il feed Twitter nelle pagine artisti

Scheda Download Gate

Impostazione	Descrizione
Press	Impostazioni di visibilita stampa
Artists visibility	Controllare la visualizzazione degli artisti nelle pagine gate
Button label	Testo personalizzato per i pulsanti dei gate
Welcome title	Titolo mostrato nella pagina di destinazione del gate
Welcome description	Testo di descrizione per la pagina di destinazione del gate
Wizard button label	Testo per il pulsante della procedura guidata del gate

---

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 verita. 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.

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 modalita 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 piu 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 (piu 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 “Pre-save email collection” nella scheda impostazioni Releases per raccogliere indirizzi email durante il flusso di pre-save.

---

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

Il plugin non include blocchi Gutenberg, widget Elementor o widget della barra laterale. Usa gli shortcode per posizionare il contenuto nelle tue pagine e template.

---

Risoluzione dei problemi

Le release non appaiono

1. Vai a Settings → LabelGrid Tools e verifica che il tuo token API sia inserito correttamente
2. Controlla che auto-sync sia attivo nella scheda General Options
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 Settings → LabelGrid Tools → General Options 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 gate.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

---

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.

---

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.