Plugin WordPress

LabelGrid Tools est le plugin WordPress officiel qui synchronise automatiquement votre catalogue de sorties, profils d’artistes et download gates depuis LabelGrid vers votre site WordPress. LabelGrid est la source de verite — le plugin importe vos donnees toutes les 6 heures, pour que votre site web reflète toujours votre catalogue le plus recent.

Disponible sur tous les plans

LabelGrid Tools est disponible pour tous les comptes LabelGrid sans frais supplementaires — aucun plan API n’est requis. C’est actuellement le moyen d’ajouter le pre-save Spotify a votre site web sur n’importe quel plan. Une page de pre-save integree a l’application (sans plugin) est prevue pour l’avenir.

Apercu

Ce que vous pouvez faire

Fonctionnalite	Description
Synchronisation automatique du catalogue	Sorties, artistes et download gates se synchronisent depuis LabelGrid toutes les 6 heures
Pages de sorties	Pages avec pochette et liens vers plus de 25 plateformes de streaming et boutiques
Profils d’artistes	Pages d’artistes avec biographies, liens sociaux et discographie
Grilles de sorties	Grilles filtrables de votre catalogue par genre, label ou artiste
Bannieres de sorties	Bannieres pour la page d’accueil mettant en avant vos dernieres sorties
Pre-save Spotify	Boutons de pre-save avec actions de suivi de playlist et d’artiste
Pre-commandes	Support des pre-commandes iTunes, Apple Music, Beatport, Juno et Amazon
Download gates	Gates de capture d’email avec actions de suivi social (Spotify, Twitter, SoundCloud)
Lecteur web Spotify	Lecteur Spotify integre sur les pages de sorties
Communiques de presse	Sections dediees aux communiques de presse sur les pages de sorties
Liens d’affiliation iTunes	Gagnez une commission sur les achats iTunes via votre site
Integration Yoast SEO	Metadonnees Open Graph pour le partage social

Prerequis

• WordPress 5.0 ou superieur
• PHP 8.0 ou superieur
• Un compte LabelGrid actif (aucun plan API requis)

---

Installation

Depuis l’admin WordPress

1. Allez dans Plugins → Add New
2. Recherchez “LabelGrid Tools”
3. Cliquez sur Install Now
4. Cliquez sur Activate

Installation manuelle

1. Telechargez le plugin depuis LabelGrid
2. Allez dans Plugins → Add New → Upload Plugin
3. Selectionnez le fichier ZIP telecharge
4. Cliquez sur Install Now
5. Cliquez sur Activate

---

Configuration

Obtenir votre cle d’autorisation

Avant de configurer le plugin, creez une cle d’autorisation dans LabelGrid :

1. Connectez-vous a LabelGrid
2. Cliquez sur votre menu utilisateur (votre nom/avatar en haut a droite)
3. Cliquez sur Wordpress dans le menu deroulant
4. Cliquez sur le bouton Configure Plugin
5. Dans Step 1: Create Key, selectionnez les labels a inclure :
   • Choisissez All My Labels pour synchroniser tout votre catalogue
   • Ou selectionnez des labels specifiques pour limiter ce qui apparait sur votre site
6. Cliquez sur Create New Key
7. Entrez le domaine de votre site WordPress (ex. : https://votresite.com)
8. Cliquez sur OK pour generer la cle
9. Copiez le token d’acces — vous en aurez besoin pour WordPress

Attention

Chaque cle est liee a un domaine specifique. Si vous avez plusieurs sites WordPress, creez une cle separee pour chacun.

Parametres du plugin

Allez dans Settings → LabelGrid Tools dans votre admin WordPress. La page de parametres comporte quatre onglets :

Onglet LabelGrid GATE

Parametre	Description
API Token	Collez le token d’acces que vous avez copie depuis LabelGrid

Onglet General Options

Parametre	Description
Debug level	Definissez le niveau de journalisation pour le depannage
Log retention	Duree de conservation des journaux systeme
Auto-sync	Activer ou desactiver la synchronisation automatique du catalogue
iTunes Affiliate Token	Votre token d’affiliation iTunes pour gagner une commission sur les achats

Onglet Releases

Parametre	Description
Show unreleased	Afficher les sorties a venir sur votre site
Spotify pre-save	Activer les boutons de pre-save Spotify sur le contenu non publie
Pre-save email collection	Non / Oui (obligatoire) / Oui (optionnel) — collecter les emails pendant le pre-save
Pre-orders	Activer les liens de pre-commande pour iTunes, Apple Music, Beatport, Juno et Amazon
Spotify Web Player	Afficher le lecteur Spotify integre sur les pages de sorties
Press release	Afficher les sections de communiques de presse
Featured artists	Afficher les artistes en vedette sur les pages de sorties
Similar releases	Afficher les sorties similaires
Show below artwork	Choisir quoi afficher sous la pochette : code de sortie ou label
Twitter feed on artists	Afficher le flux Twitter sur les pages d’artistes

Onglet Download Gate

Parametre	Description
Press	Parametres de visibilite presse
Artists visibility	Controler l’affichage des artistes sur les pages de gates
Button label	Texte personnalise pour les boutons de gates
Welcome title	Titre affiche sur la page d’accueil du gate
Welcome description	Texte de description pour la page d’accueil du gate
Wizard button label	Texte du bouton de l’assistant du gate

---

Synchronisation du catalogue

Le plugin synchronise automatiquement votre catalogue depuis LabelGrid toutes les 6 heures. Cela inclut les sorties, artistes et download gates.

Le plugin cree trois types de contenu personnalises dans WordPress :

Type de contenu	Description	Structure d’URL
Release	Sorties musicales avec pochette, metadonnees et liens vers les plateformes	/release/nom-de-la-sortie/
Artist	Profils d’artistes avec biographie et liens sociaux	/artist/nom-de-l-artiste/
Gate Download	Download gates avec capture d’email	/free-download/nom-du-gate/

Les download gates supportent egalement une taxonomie Gate Category pour organiser vos gates en groupes.

Note

LabelGrid est la source de verite. Les modifications que vous apportez aux articles de sorties ou d’artistes dans WordPress seront ecrasees lors de la prochaine synchronisation. Effectuez tous les changements de catalogue dans LabelGrid.

---

Shortcodes

Le plugin fournit 11 shortcodes organises en quatre categories : sorties, artistes, download gates et pre-save.

Shortcodes de sorties

[labelgrid-release-list]

Affichez vos sorties dans une grille filtrable.

Exemple basique :

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

Parametres :

Parametre	Par defaut	Description
show-title	null	Afficher les titres des sorties
label	null	Filtrer par label
items-page	12	Nombre de sorties par page
items-row	4	Nombre de colonnes par ligne
pagination	null	Activer la pagination
showcase-last	null	Activer le mode vitrine
item-filter	released	Type de filtre : released ou unreleased
title-below	null	Positionner le titre sous la pochette
filter-artists	null	Filtrer par IDs d’artistes
exclude	null	Exclure des IDs de sorties specifiques
image-quality	lgt_artwork_medium	Preset de taille d’image

Afficher les prochaines sorties :

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

[labelgrid-release-list-filter]

Ajoutez un filtre deroulant au-dessus de votre grille de sorties. Placez ce shortcode avant [labelgrid-release-list] sur la meme page.

Exemple basique :

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

Parametres :

Parametre	Par defaut	Description
record_label	null	Afficher un filtre deroulant de label

[labelgrid-release-banner]

Affichez une banniere mettant en avant une ou plusieurs sorties — ideal pour les pages d’accueil.

Exemple basique :

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

Parametres :

Parametre	Par defaut	Description
label	null	Filtrer par label
items-page	1	Nombre de sorties a afficher
item-filter	released	Type de filtre : released ou unreleased
item-order	DESC	Ordre de tri : DESC (plus recentes d’abord) ou ASC
filter-artists	null	Filtrer par IDs d’artistes
exclude	null	Exclure des IDs de sorties specifiques

[labelgrid-release-links]

Affichez les liens de streaming et de boutiques pour une sortie specifique. Utilisez ce shortcode dans les modeles de pages de sorties ou sur n’importe quelle page en specifiant un ID de sortie.

Exemple basique :

[labelgrid-release-links]

Avec une sortie specifique :

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

Parametres :

Parametre	Par defaut	Description
release-id	ID de l’article actuel	L’ID de l’article de sortie
artists	null	Afficher les informations de l’artiste a cote des liens

[labelgrid-release-detail]

Affichez la page complete de detail de la sortie, incluant pochette, metadonnees, liens vers les plateformes et lecteur integre. Ce shortcode utilise l’article actuel et n’accepte aucun parametre.

Exemple (dans un modele de sortie) :

[labelgrid-release-detail]

Shortcodes d’artistes

[labelgrid-artist-list]

Affichez vos artistes dans une mise en page en grille.

Exemple basique :

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

Parametres :

Parametre	Par defaut	Description
show-title	false	Afficher les noms d’artistes sous les images
category	null	Filtrer par categorie
items-page	12	Nombre d’artistes par page
items-row	4	Nombre de colonnes par ligne
pagination	null	Activer la pagination
title-below	null	Positionner le titre sous l’image

[labelgrid-artist-detail]

Affichez la page complete du profil de l’artiste, incluant biographie, liens sociaux et discographie. Ce shortcode utilise l’article actuel et n’accepte aucun parametre.

Exemple (dans un modele d’artiste) :

[labelgrid-artist-detail]

Shortcodes de download gates

[labelgrid-gate-button]

Affichez un bouton de download gate. Lorsque le visiteur clique, il passe par le flux du gate (capture d’email et suivi social optionnel) avant d’obtenir l’acces au telechargement.

Exemple basique :

[labelgrid-gate-button]

Avec du texte personnalise :

[labelgrid-gate-button gate-id="45" button-label="Telechargement Gratuit" custom-class="mon-bouton"]

Parametres :

Parametre	Par defaut	Description
gate-id	ID de l’article actuel	L’ID de l’article de download gate
post-id	ID de l’article actuel	ID de l’article de sortie associe
button-label	null	Texte personnalise du bouton
custom-class	null	Classe CSS supplementaire
download-text	null	Texte personnalise du bouton de telechargement

[labelgrid-gate-download-list]

Affichez vos download gates dans une mise en page en grille.

Exemple basique :

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

Parametres :

Parametre	Par defaut	Description
show-title	false	Afficher les titres des gates
category	null	Filtrer par categorie de gate
items-page	12	Elements par page
items-row	4	Colonnes par ligne
pagination	null	Activer la pagination
title-below	null	Positionner le titre sous l’image

[labelgrid-gate-download-detail]

Affichez la page complete de detail du download gate. Ce shortcode utilise l’article actuel et n’accepte aucun parametre.

Exemple (dans un modele de gate) :

[labelgrid-gate-download-detail]

Shortcode de pre-save

[labelgrid-presave-button]

Affichez un bouton de pre-save Spotify pour une sortie a venir. Les visiteurs peuvent faire un pre-save de la sortie et optionnellement suivre l’artiste et une playlist sur Spotify.

Exemple basique :

[labelgrid-presave-button]

Pour une sortie specifique :

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

Parametres :

Parametre	Par defaut	Description
release-id	ID de l’article actuel	L’ID de l’article de sortie

Astuce

Activez “Pre-save email collection” dans l’onglet des parametres Releases pour collecter les adresses email pendant le flux de pre-save.

---

Reference des classes CSS

Le plugin utilise ces prefixes de classes CSS pour le style :

Classe	Element
.lgsquarelist	Conteneur de grille pour les listes de sorties et d’artistes
.releaseelement	Carte individuelle de sortie ou d’artiste
.elementrow1 a .elementrow8	Mise en page specifique par colonne (correspond au parametre items-row)
.elementrowx	Variante de mise en page flexible
.spotify, .twitter, .youtube, .soundcloud, .facebook	Style specifique par service sur les liens de plateformes
.banner-*	Elements de banniere de sorties
.gate, .gateimage, .freedownload	Elements de download gate

Note

Le plugin n’inclut pas de blocs Gutenberg, de widgets Elementor ni de widgets de barre laterale. Utilisez les shortcodes pour placer du contenu dans vos pages et modeles.

---

Depannage

Les sorties n’apparaissent pas

1. Allez dans Settings → LabelGrid Tools et verifiez que votre token API est correctement saisi
2. Verifiez que auto-sync est active dans l’onglet General Options
3. Attendez jusqu’a 6 heures pour le prochain cycle de synchronisation, ou desactivez et reactivez le plugin pour declencher une synchronisation immediate
4. Verifiez que les sorties sont publiees dans LabelGrid (pas en brouillon)
5. Allez dans Settings → LabelGrid Tools → General Options et augmentez le niveau de debogage, puis consultez les journaux

Les shortcodes s’affichent en texte brut

1. Assurez-vous que le plugin est active dans Plugins
2. Verifiez que vous utilisez des tirets dans les noms de shortcodes (ex. : [labelgrid-release-list]), pas des underscores
3. Verifiez qu’il n’y a pas de fautes de frappe dans le nom du shortcode

Problemes de style

1. Verifiez les conflits CSS avec votre theme
2. Utilisez les outils de developpement de votre navigateur pour inspecter les classes d’elements
3. Ajoutez des surcharges CSS personnalisees ciblant les noms de classes du plugin (voir la reference des classes CSS ci-dessus)
4. Testez avec un theme WordPress par defaut pour isoler les conflits de theme

Erreurs de connexion API

1. Verifiez que votre token API est valide et n’a pas expire
2. Confirmez que votre compte LabelGrid est actif
3. Verifiez que votre serveur peut effectuer des requetes sortantes vers gate.labelgrid.com
4. Consultez les journaux du plugin pour des messages d’erreur specifiques

Entrees de gates et exportations

Les entrees de download gates (adresses email collectees) peuvent etre exportees en CSV depuis l’admin WordPress. Allez dans l’article du download gate et cherchez l’option d’exportation.

---

Mises a jour

Mises a jour automatiques

1. Allez dans Plugins dans votre admin WordPress
2. Trouvez “LabelGrid Tools”
3. Cliquez sur Enable auto-updates

Mises a jour manuelles

1. Telechargez la derniere version depuis LabelGrid
2. Allez dans Plugins → Add New → Upload Plugin
3. Telechargez le nouveau fichier ZIP
4. WordPress vous demandera de remplacer la version existante
5. Cliquez sur Replace current with uploaded

---

Ressources liées

Découvrez le plugin WordPress LabelGrid Tools — pages smart-link, campagnes de pré-save Spotify et téléchargements avec inscription — sur notre site web.

---

Besoin d’aide ?

Si vous avez besoin d’aide avec le plugin WordPress, contactez notre equipe support avec les details de votre version WordPress, version PHP et tout message d’erreur des journaux du plugin.