Plugin WordPress : installer LabelGrid Tools

Mis à jour en septembre 2026.

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 vérité — le plugin importe vos données toutes les 6 heures, pour que votre site web reflète toujours votre catalogue le plus récent.

Disponible sur tous les plans

LabelGrid Tools est disponible pour tous les comptes LabelGrid sans frais supplémentaires et n’exige aucun plan API. C’est l’une des deux façons de profiter de l’expérience smart link de LabelGrid : chaque sortie dispose déjà d’une landing page hébergée et d’un lien court sur le domaine LabelGrid (voir Landing pages de sortie), et ce plugin apporte ces mêmes pages par sortie (liens vers les boutiques, boutons de pre-save Spotify et download gates) sur votre propre domaine WordPress, avec en plus votre catalogue complet et vos profils d’artistes.

Aperçu

Ce que vous pouvez faire

Vous pouvez placer chacune de ces fonctionnalités sur votre site sous forme de shortcode, de bloc Gutenberg natif ou via Elementor : voir Blocks (Gutenberg) et Elementor.

Fonctionnalité	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 toutes les grandes 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
Bannières de sorties	Bannières pour la page d’accueil mettant en avant vos dernières 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 Spotify
Lecteur web Spotify	Lecteur Spotify integre sur les pages de sorties
Communiques de presse	Sections dédiées aux communiques de presse sur les pages de sorties
Liens d’affiliation iTunes	Gagnez une commission sur les achats iTunes via votre site
Intégration Yoast SEO	Métadonnées Open Graph pour le partage social

Prérequis

• WordPress 7.0 ou supérieur
• PHP 8.0 ou supérieur
• 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. Téléchargez le plugin depuis LabelGrid
2. Allez dans Plugins → Add New → Upload Plugin
3. Sélectionnez le fichier ZIP telecharge
4. Cliquez sur Install Now
5. Cliquez sur Activate

---

Configuration

Obtenir votre clé d’autorisation

Les clés créées pour des versions antérieures du plugin ne fonctionnent plus

LabelGrid n’accepte plus les clés d’API créées pour des versions antérieures du plugin. Si vos download gates, vos pre-saves ou la synchronisation du catalogue ont cessé de fonctionner, créez une nouvelle clé en suivant les étapes ci-dessous et collez-la dans le plugin. Rien d’autre ne change : vos gates et pre-saves existants conservent leur configuration.

Tant que la clé est refusée, l’onglet Download Gate disparaît des réglages du plugin. La fonctionnalité n’a pas été supprimée : l’onglet revient dès qu’une clé valide est enregistrée.

C’est LabelGrid qui effectue cette vérification, pas le plugin. Toutes les versions sont donc concernées. Les sites encore en 1.5.0 ou 1.6.0 ne restent pas sans message : ils affichent une seule bannière plus ancienne et moins précise, API LabelGrid DÉSACTIVÉE : Vérifiez que le jeton d’API est correct et que votre compte est activé pour les services API de LabelGrid., qui décrit le même problème. La section de dépannage détaille tous les messages et leur signification.

Avant de configurer le plugin, créez une clé 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 déroulant
4. Cliquez sur le bouton Configure Plugin
5. Dans Step 1: Create Key, sélectionnez les labels a inclure :
   • Choisissez All My Labels pour synchroniser tout votre catalogue
   • Ou sélectionnez des labels spécifiques pour limiter ce qui apparaît 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 générer la clé
9. Copiez le token d’accès — vous en aurez besoin pour WordPress

Attention

Chaque clé est liée a un domaine spécifique. Si vous avez plusieurs sites WordPress, créez une clé séparée pour chacun.

Paramètres du plugin

Ouvrez LabelGrid Tools → Réglages généraux (Général Settings) dans votre admin WordPress : c’est une entrée de menu de premier niveau, elle n’est pas dans les Réglages de WordPress. Vous arrivez sur Réglages de LabelGrid Tools. La page comporte six onglets, donnés ici avec l’original anglais entre parenthèses :

Connexion (Connection) · Pages Sortie (Release Pages) · Pages Artiste (Artist Pages) · Liens et services (Links & Services) · Download Gate · Système (System)

Download Gate n’apparaît que lorsque le download gate est actif. Tant que le plugin n’a pas de clé d’API valide, l’onglet est entièrement masqué : s’il manque, consultez la section de dépannage plus bas.

Connexion

Setting	Description
Jeton d’API LabelGrid	Collez le token d’accès que vous avez copie depuis LabelGrid. Depuis la 1.6.1, c’est un champ sur une seule ligne, adapté aux clés plus courtes que LabelGrid délivre désormais
Synchronisation automatique du contenu via l’API LabelGrid	Activer ou désactiver la synchronisation automatique du catalogue

Pages Sortie

Setting	Description
Afficher les sorties à venir	Afficher les sorties a venir sur votre site
Pre-Save Spotify	Activer les boutons de pre-save Spotify sur le contenu non publie
Pre-Save Spotify - Collecte d’e-mails	Non / Oui (obligatoire) / Oui (optionnel) — collecter les emails pendant le pre-save
Précommande iTunes / Apple Music / Beatport / Juno / Amazon Music	Activer les liens de pre-commande pour iTunes, Apple Music, Beatport, Juno et Amazon
Afficher le lecteur web Spotify	Afficher le lecteur Spotify integre sur les pages de sorties
Afficher le communiqué de presse	Afficher les sections de communiques de presse
Afficher les artistes en vedette	Afficher les artistes en vedette sur les pages de sorties
Afficher les sorties similaires	Afficher les sorties similaires
Champ sous la pochette	Choisir quoi afficher sous la pochette : code de sortie ou label

Pages Artiste

Setting	Description
Afficher le fil Twitter	Afficher le flux Twitter sur les pages d’artistes
Afficher le fil Bandsintown	Afficher un fil Bandsintown sur les pages artistes

Liens et services

Setting	Description
Services SORTIES / Services ARTISTES	Ordonner, afficher ou masquer les liens de streaming et de stores sur les pages sorties et artistes
Services personnalisés	Ajouter vos propres services à afficher sur les pages sorties et artistes
Jeton Apple Performance Partner Program	Votre token d’affiliation iTunes pour gagner une commission sur les achats

Download Gate

Setting	Description
Afficher le communiqué de presse	Paramètres de visibilité presse
Afficher les artistes en vedette	Contrôler l’affichage des artistes sur les pages de gates
Libellé du bouton	Texte personnalise pour les boutons de gates
Titre de bienvenue	Titre affiche sur la page d’accueil du gate
Description de bienvenue	Texte de description pour la page d’accueil du gate
Libellé du bouton de gate	Texte du bouton de l’assistant du gate

Système

Setting	Description
Activer la journalisation des erreurs	Définissez le niveau de journalisation pour le dépannage
Durée de conservation des journaux (jours)	Durée de conservation des journaux système
Voir les journaux système	Ouvrir les journaux système enregistrés
Informations système	Détails d’environnement à joindre quand vous contactez le support
Désinstaller	Simple information, sans bouton ni réglage. Elle explique que supprimer le plugin depuis l’écran Extensions efface ses réglages, jeton d’API compris, ainsi que ses tables de journaux et d’entrées de gate, tandis que vos sorties, artistes, download gates et leurs champs restent dans la base de données

---

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, métadonnées 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 également une taxonomie Gate Category pour organiser vos gates en groupes.

Note

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

---

Shortcodes

Le plugin fournit 11 shortcodes organises en quatre catégories : sorties, artistes, download gates et pre-save. Chaque shortcode a aussi un bloc Gutenberg équivalent avec les mêmes options : voir Blocks (Gutenberg).

Shortcodes de sorties

[labelgrid-release-list]

Affichez vos sorties dans une grille filtrable.

Exemple basique :

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

Paramètres :

Parametre	Par défaut	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 spécifiques
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 déroulant au-dessus de votre grille de sorties. Placez ce shortcode avant [labelgrid-release-list] sur la même page.

Exemple basique :

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

Paramètres :

Parametre	Par défaut	Description
record_label	null	Afficher un filtre déroulant de label

[labelgrid-release-banner]

Affichez une bannière mettant en avant une ou plusieurs sorties — idéal pour les pages d’accueil.

Exemple basique :

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

Paramètres :

Parametre	Par défaut	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 récentes d’abord) ou ASC
filter-artists	null	Filtrer par IDs d’artistes
exclude	null	Exclure des IDs de sorties spécifiques

[labelgrid-release-links]

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

Exemple basique :

[labelgrid-release-links]

Avec une sortie spécifique :

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

Paramètres :

Parametre	Par défaut	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 détail de la sortie, incluant pochette, métadonnées, 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"]

Paramètres :

Parametre	Par défaut	Description
show-title	false	Afficher les noms d’artistes sous les images
category	null	Filtrer par catégorie
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’accès au téléchargement.

Exemple basique :

[labelgrid-gate-button]

Avec du texte personnalise :

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

Paramètres :

Parametre	Par défaut	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 supplémentaire
download-text	null	Texte personnalise du bouton de téléchargement

[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"]

Paramètres :

Parametre	Par défaut	Description
show-title	false	Afficher les titres des gates
category	null	Filtrer par catégorie de gate
items-page	12	Éléments 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 détail 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 spécifique :

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

Paramètres :

Parametre	Par défaut	Description
release-id	ID de l’article actuel	L’ID de l’article de sortie

Astuce

Activez “Spotify Pre-Save - Collect Email” dans l’onglet des paramètres Release Pages pour collecter les adresses email pendant le flux de pre-save.

---

Actions de gate et de pre-save

Un download gate demande aux fans de connecter Spotify et d’effectuer une ou plusieurs actions avant de débloquer le téléchargement. Un pre-save enregistre toujours la sortie elle-même et peut y ajouter des actions de suivi.

Les actions Spotify disponibles sont les suivantes :

• Enregistrer la sortie : toujours incluse dans un pre-save
• Suivre un artiste
• Suivre une playlist
• Suivre un profil Spotify : nouveauté de la 1.6.0

Les cibles de suivi ne se limitent plus aux artistes de votre propre catalogue : vous pouvez donc mettre en avant un collaborateur ou un artiste invité.

Les actions SoundCloud et Twitter sont suspendues

Depuis la version 1.6.0, les actions des download gates sont uniquement Spotify. Celles de SoundCloud et Twitter sont suspendues le temps d’être reconstruites : elles ne s’exécutent plus et n’apparaissent plus aux fans, et le gate continue de fonctionner avec ses actions Spotify.

Si l’un de vos gates demandait de connecter plusieurs services, le plugin ne demande plus que ceux encore disponibles, sinon le gate ne pourrait jamais être terminé. Votre réglage enregistré reste intact et redevient actif quand les autres services reviennent. Vérifiez tout gate qui exigeait auparavant plus d’un compte et assurez-vous que les actions Spotify restantes demandent bien ce que vous voulez.

Un gate dont les actions étaient uniquement SoundCloud ou Twitter n’a plus rien à demander : il ne fonctionne plus du tout tant que vous ne lui ajoutez pas une action Spotify.

Comment les limites d’actions sont comptées

Les gates acceptent bien plus d’actions Spotify qu’avant, et l’éditeur de gate affiche le nombre déjà utilisé pendant que vous modifiez.

Chaque lien compte pour une action. Une ligne d’action contenant trois liens de playlist compte pour trois, pas pour une. C’est précisément là que le calcul dérape quand un gate approche de la limite.

Rechercher une playlist pendant un pre-save

Quand un pre-save propose d’ajouter la sortie à une playlist du fan, celui-ci peut rechercher parmi ses playlists au lieu de parcourir toute la liste.

---

Blocks (Gutenberg)

Depuis la version 1.5.0, LabelGrid Tools fournit des blocs natifs pour l’editeur de blocs pour chaque fonctionnalité. Dans l’editeur WordPress, cliquez sur l’outil d’insertion de blocs (le bouton +) et cherchez la catégorie LabelGrid Tools, ou recherchez un bloc par son nom. Définissez les options de chaque bloc dans la barre latérale du bloc : ce sont les mêmes options que celles du shortcode correspondant.

Il y a 11 blocs, un pour chaque shortcode :

Bloc	Shortcode équivalent	Ce qu’il fait
LabelGrid Release List	[labelgrid-release-list]	Grille responsive de vos sorties (colonnes, éléments par page, label, pagination, options de titre)
LabelGrid Release List Filter	[labelgrid-release-list-filter]	Filtre par genre (plus un filtre par label quand un label est configure) ; associez-le a une liste de sorties sur la même vue
LabelGrid Release Banner	[labelgrid-release-banner]	Bannière pleine largeur mettant en avant une sortie, idéale pour les pages d’accueil
LabelGrid Release Links	[labelgrid-release-links]	Liens de streaming et de boutiques pour la sortie actuelle
LabelGrid Release Detail	[labelgrid-release-detail]	Le contenu complet de la sortie ; a utiliser sur un modele Single de sorties
LabelGrid Artist List	[labelgrid-artist-list]	Grille responsive de vos artistes
LabelGrid Artist Detail	[labelgrid-artist-detail]	Le contenu complet de l’artiste ; a utiliser sur un modele Single d’artistes
LabelGrid Gate Button	[labelgrid-gate-button]	Bouton de download gate ; ne s’affiche que lorsque la connexion LabelGrid est active
LabelGrid Gate Download List	[labelgrid-gate-download-list]	Grille de téléchargements sous gate ; uniquement lorsque la connexion est active
LabelGrid Gate Download Detail	[labelgrid-gate-download-detail]	Le contenu complet du téléchargement sous gate ; uniquement lorsque la connexion est active
LabelGrid Presave Button	[labelgrid-presave-button]	Bouton de pre-save Spotify ; ne s’affiche que lorsque la connexion est active et que la date de sortie n’est pas passée

Blocs et shortcodes sont interchangeables

Chaque bloc utilise le même moteur de rendu que le shortcode correspondant : une page construite avec des blocs et une page construite avec des shortcodes produisent un resultat identique. Les blocs sont purement additifs : ajouter un bloc ne modifie jamais une page ou vous ne l’avez pas ajoute, et vos modeles de sorties et d’artistes existants restent inchangés quand vous mettez le plugin a jour. Vous préférez les shortcodes ? Ils restent entièrement pris en charge et fonctionnent dans n’importe quel theme.

Évitez d’afficher le détail deux fois

Sur un modele d’élément unique dans l’editeur de site (themes de blocs), utilisez soit le bloc Release Detail / Artist Detail soit le bloc Post Content (« Contenu ») de WordPress, pas les deux. Utiliser les deux affiche le détail de la sortie ou de l’artiste deux fois.

Note

Les blocs Gate Button, Gate Download List, Gate Download Detail et Presave Button ne s’affichent que sur les sites connectes a un compte LabelGrid avec un plan actif.

---

Elementor

Chaque fonctionnalité de LabelGrid Tools est aussi disponible sous forme de shortcode, et le widget Shortcode integre d’Elementor — inclus dans la version gratuite d’Elementor — en place n’importe laquelle sur une page sans add-on supplémentaire. La recette Theme Builder ci-dessous est différente : les modeles Single, les conditions d’affichage et le widget Post Content sont des fonctionnalités Elementor Pro. Avec la version gratuite d’Elementor, placez plutôt un widget Shortcode sur n’importe quelle page — et les pages de sorties et d’artistes intégrées du plugin s’affichent déjà d’elles-memes, sans aucun modele Elementor.

Pour construire des pages de sorties et d’artistes avec le Theme Builder d’Elementor Pro :

1. Créez un modele Theme Builder → Single et définissez sa condition d’affichage sur Releases (et/ou Artists).
2. Pour le contenu de la sortie ou de l’artiste, utilisez un widget Shortcode contenant [labelgrid-release-detail] / [labelgrid-artist-detail] — cette méthode affiche toujours le détail. Le widget Post Content l’affiche aussi dans la plupart des configurations. Choisissez-en un, jamais les deux, sinon le détail s’affiche deux fois.
3. Ajoutez des grilles de sorties, des bannières, des listes d’artistes, des boutons smart link, des pre-saves et des download gates a tout autre endroit de votre mise en page avec le widget Shortcode.

Note

Les fonctionnalités de download gate et de pre-save ne s’affichent que sur les sites connectes a un compte LabelGrid avec un plan actif.

---

Utiliser votre propre modele de theme pour les pages de sorties et d’artistes

Par défaut, le plugin affiche les pages individuelles de sorties et d’artistes en injectant sa propre mise en page dans le contenu de la page, de sorte qu’elles fonctionnent sans aucune modification du theme. Si vous préférez construire ces pages dans votre theme, le plugin peut s’effacer et laisser un modele PHP classique les afficher.

Pour prendre en charge le rendu dans un theme classique :

1. Ajoutez add_theme_support( 'labelgrid-tools-templates' ); au fichier functions.php de votre theme.
2. Ajoutez un modele classique single-release.php et/ou single-artist.php a votre theme.

Lorsqu’un theme active la prise en charge et fournit le modele correspondant, le plugin detecte que votre modele a pris le relais et supprime sa propre injection de contenu, de sorte que la page s’affiche une seule fois depuis votre modele, sans mise en page dupliquée. Placez le contenu de la sortie ou de l’artiste ou vous le souhaitez avec les blocs Release Detail / Artist Detail ou les shortcodes [labelgrid-release-detail] / [labelgrid-artist-detail] dans votre modele.

Vous pouvez aussi activer ou désactiver cette prise en charge requête par requête avec le filtre lgt_use_theme_templates. Il prend la valeur d’activation actuelle et l’article actuel, et renvoie true ou false, ce qui vous permet d’activer votre modele de theme pour seulement certaines sorties ou certains artistes.

Note

Cette surcharge s’applique uniquement aux modeles PHP classiques. La prise en charge des pages de sorties et d’artistes depuis l’editeur de site d’un theme de blocs n’est pas encore couverte et constitue un ajout prévu. Les sites qui n’activent pas cette prise en charge ne sont pas affectes : la mise en page intégrée s’affiche exactement comme avant.

---

Référence des classes CSS

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

Classe	Élément
.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 spécifique par colonne (correspond au parametre items-row)
.elementrowx	Variante de mise en page flexible
.spotify, .twitter, .youtube, .soundcloud, .facebook	Style spécifique par service sur les liens de plateformes
.banner-*	Éléments de bannière de sorties
.gate, .gateimage, .freedownload	Éléments de download gate

Note

Les shortcodes fonctionnent dans n’importe quel theme et constructeur de page. Les mêmes fonctionnalités sont aussi disponibles sous forme de blocs Gutenberg natifs et via Elementor : voir Blocks (Gutenberg) et Elementor ci-dessus.

---

Dépannage

Les gates, les pre-saves et la synchronisation du catalogue ne fonctionnent plus

LabelGrid n’accepte plus les clés d’API créées pour des versions antérieures du plugin. Si vos download gates, vos pre-saves Spotify ou la synchronisation du catalogue se sont arrêtés sans que vous ayez rien modifié, c’est presque toujours la cause.

La solution : créez une nouvelle clé et collez-la dans le plugin. Les étapes sont les mêmes que la première fois et se trouvent plus haut, dans la section de configuration. Vos gates et pre-saves existants conservent leur configuration : il n’y a rien à refaire.

Ce que vous pouvez constater :

• Les download gates, les pre-saves et la synchronisation du catalogue cessent de fonctionner.
• L’onglet Download Gate a disparu des réglages du plugin. La fonctionnalité n’a pas été supprimée : l’onglet reste masqué tant qu’aucune clé valide n’est enregistrée, et il revient dès que vous en enregistrez une nouvelle.
• La version 1.6.1 affiche l’un de trois messages précis dans l’administration WordPress. Les versions antérieures, 1.5.0 et 1.6.0 comprises, en affichent un seul, plus ancien et moins précis — API LabelGrid DÉSACTIVÉE : Vérifiez que le jeton d’API est correct et que votre compte est activé pour les services API de LabelGrid., avec un lien Configurer l’API dans les réglages généraux —, mais elles sont touchées de la même façon, puisque la vérification a lieu chez LabelGrid et non dans le plugin.

Ce que signifient les messages du plugin

La version 1.6.1 affiche l’un de ces trois messages. Deux commencent par API LabelGrid DÉSACTIVÉE : : lisez donc la phrase entière avant d’agir. Ce début de message s’affiche en français ; la phrase qui suit apparaît pour l’instant en anglais, et elle est donc citée en anglais ci-dessous.

Votre clé doit être remplacée :

API LabelGrid DÉSACTIVÉE : 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.

Créez une nouvelle clé en suivant les étapes de la section de configuration, puis collez-la dans le plugin.

Aucune clé n’a encore été enregistrée :

API LabelGrid DÉSACTIVÉE : No API key is set, so gates, pre-saves and catalog sync are inactive.

Créez une clé et collez-la dans les réglages du plugin.

Un problème de connexion passager, pas un problème de clé :

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.

Pour relancer la vérification immédiatement, quelle que soit la version, il faut modifier quelque chose. Le bouton Enregistrer les réglages reste grisé tant qu’aucun réglage n’a changé, et coller à nouveau la même clé ne compte pas comme un changement. Modifiez donc n’importe quel réglage, enregistrez, remettez-le comme avant et enregistrez de nouveau. Durée de conservation des journaux (jours), dans l’onglet Système, convient bien : rien d’autre n’en dépend. Chaque enregistrement déclenche une nouvelle vérification de la connexion, et votre site se retrouve exactement dans son état d’origine.

À partir de la version 1.6.2, la vérification quotidienne en arrière-plan se relance aussi d’elle-même tant qu’une clé est enregistrée : un site dont la panne ou la limitation de débit est passée se rétablit sans intervention. En 1.5.0, 1.6.0 et 1.6.1, cela n’arrivait jamais. Une fois que le plugin s’était désactivé, la vérification quotidienne sautait le test de connexion jusqu’à ce que quelqu’un enregistre les réglages à la main.

Cela ne vaut que pour les problèmes de connexion. Une clé refusée ne se rétablit jamais d’elle-même, quelle que soit la version : voir plus haut « Votre clé doit être remplacée ». Si le problème persiste, consultez plus bas la section sur les erreurs de connexion à l’API.

Les sorties n’apparaissent pas

1. Allez dans LabelGrid Tools → Réglages généraux (Général Settings), une entrée de menu de premier niveau et non dans les Réglages de WordPress, et vérifiez que votre token d’API est correctement saisi
2. Vérifiez que auto-sync est active dans l’onglet Connection
3. Attendez jusqu’à 6 heures pour le prochain cycle de synchronisation, ou désactivez et réactivez le plugin pour déclencher une synchronisation immédiate
4. Vérifiez que les sorties sont publiées dans LabelGrid (pas en brouillon)
5. Allez dans LabelGrid Tools → Réglages généraux → Système et augmentez le niveau de débogage, puis consultez les journaux

Les shortcodes s’affichent en texte brut

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

Problèmes de style

1. Vérifiez les conflits CSS avec votre theme
2. Utilisez les outils de développement de votre navigateur pour inspecter les classes d’éléments
3. Ajoutez des surcharges CSS personnalisées ciblant les noms de classes du plugin (voir la référence des classes CSS ci-dessus)
4. Testez avec un theme WordPress par défaut pour isoler les conflits de theme

Erreurs de connexion API

1. Vérifiez que votre token API est valide et n’a pas expire
2. Confirmez que votre compte LabelGrid est actif
3. Vérifiez que votre serveur peut effectuer des requêtes sortantes vers api.labelgrid.com
4. Consultez les journaux du plugin pour des messages d’erreur spécifiques

Entrées de gates et exportations

Les entrées de download gates (adresses email collectées) peuvent être exportées 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. Téléchargez la dernière version depuis LabelGrid
2. Allez dans Plugins → Add New → Upload Plugin
3. Téléchargez le nouveau fichier ZIP
4. WordPress vous demandera de remplacer la version existante
5. Cliquez sur Replace current with uploaded

---

FAQ

« Qu’est-ce que le plugin WordPress LabelGrid Tools ? »

LabelGrid Tools est le plugin WordPress officiel de LabelGrid. Il synchronise automatiquement votre catalogue de sorties, vos profils d’artistes et vos download gates depuis LabelGrid vers votre site WordPress toutes les 6 heures, et il ajoute des pages de sorties en smart-link, des boutons de pré-save Spotify et des téléchargements avec inscription. Il est disponible dans le répertoire des plugins WordPress.

« Faut-il une formule payante ou un plan API pour utiliser le plugin WordPress ? »

Non, LabelGrid Tools est accessible à tous les comptes LabelGrid sans frais supplémentaires, et aucun plan API n’est requis. Les fonctionnalités Gate qu’il apporte sont incluses dans toutes les formules standard et API, et une formule GATE autonome existe pour ceux qui veulent uniquement l’intégration WordPress, sans distribution.

« Comment installer et connecter le plugin ? »

Installez LabelGrid Tools depuis Plugins puis Add New dans WordPress, et activez-le. Dans LabelGrid, ouvrez votre menu utilisateur, puis Wordpress et Configure Plugin ; créez une clé d’autorisation pour votre domaine et collez le jeton d’accès dans l’onglet de réglages Connection du plugin. Chaque clé est liée à un seul domaine.

« À quelle fréquence le plugin synchronise-t-il mon catalogue ? »

Le plugin synchronise vos sorties, vos artistes et vos download gates depuis LabelGrid toutes les 6 heures. LabelGrid est la source de vérité : faites toutes vos modifications de catalogue dans LabelGrid, car les changements apportés directement aux articles WordPress synchronisés sont écrasés à la synchronisation suivante.

« Puis-je ajouter des pré-saves Spotify à mon site avec le plugin ? »

Oui. Activez le pré-save Spotify dans l’onglet de réglages Release Pages et placez le shortcode [labelgrid-presave-button] sur une sortie à venir. Les visiteurs peuvent enregistrer la sortie à l’avance et, s’ils le souhaitent, suivre l’artiste et une playlist ; vous pouvez aussi collecter des adresses e-mail pendant le parcours de pré-save.

« Puis-je utiliser les blocs Gutenberg ou Elementor, ou uniquement les shortcodes ? »

Les trois. Depuis la version 1.5.0, chaque fonctionnalité est disponible sous forme de shortcode, de bloc Gutenberg natif (à trouver dans l’outil d’insertion de blocs, sous la catégorie LabelGrid Tools) et via Elementor grâce à son widget Shortcode. Chaque bloc produit le même résultat que le shortcode correspondant, et les shortcodes fonctionnent toujours dans n’importe quel thème.

---

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. Voir aussi Campagnes de pré-save.

---

Besoin d’aide ?

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