WordPress-plug-in: LabelGrid Tools instellen

Bijgewerkt in september 2026.

LabelGrid Tools is de officiële WordPress-plug-in die je releasecatalogus, artiestprofielen en download gates automatisch van LabelGrid naar je WordPress-website synchroniseert. LabelGrid is de bron van waarheid: de plug-in haalt je gegevens elke 6 uur op, zodat je website altijd je actuele catalogus toont.

Beschikbaar op elk abonnement

LabelGrid Tools is voor alle LabelGrid-accounts beschikbaar zonder extra kosten; een API-abonnement is niet vereist. Het is één van de twee manieren om de smart-linkervaring van LabelGrid te krijgen: elke release heeft al een gehoste landingspagina en korte link op het domein van LabelGrid (zie Release-landingspagina’s), en deze plug-in zet diezelfde releasepagina’s (storelinks, Spotify-pre-saveknoppen en download gates) op je eigen WordPress-domein, samen met je hele catalogus en artiestprofielen.

Overzicht

Wat je kunt doen

Je kunt elk van deze functies op je site plaatsen als shortcode, als native Gutenberg-blok, of via Elementor: zie Blocks (Gutenberg) en Elementor.

Functie	Beschrijving
Automatische catalogussync	Releases, artiesten en download gates worden elke 6 uur vanuit LabelGrid gesynchroniseerd
Releasepagina’s	Landingspagina’s met artwork en links naar alle grote streamingplatforms en winkels
Artiestprofielen	Artiestpagina’s met biografieën, sociale links en discografie
Releasegrids	Filterbare grids van je catalogus op genre, label of artiest
Releasebanners	Homepagebanners die je nieuwste of uitgelichte releases tonen
Spotify pre-save	Pre-save-knoppen met acties om een playlist en artiest te volgen
Pre-orders	Ondersteuning voor pre-orders op iTunes, Apple Music, Beatport, Juno en Amazon
Download gates	Gates die e-mailadressen verzamelen, met volgacties op Spotify
Spotify Web Player	Ingesloten Spotify-speler op releasepagina’s
Persberichten	Aparte persberichtsecties op releasepagina’s
iTunes-affiliatelinks	Verdien commissie op iTunes-aankopen via je site
Yoast SEO-integratie	Open Graph-metadata om te delen op sociale media

Vereisten

• WordPress 7.0 of hoger
• PHP 8.0 of hoger
• Een actief LabelGrid-account (geen API-abonnement vereist)

---

Installatie

Vanuit de WordPress-beheeromgeving

1. Ga naar Plugins → Add New
2. Zoek op “LabelGrid Tools”
3. Klik op Install Now
4. Klik op Activate

Handmatige installatie

1. Download de plug-in bij LabelGrid
2. Ga naar Plugins → Add New → Upload Plugin
3. Selecteer het gedownloade ZIP-bestand
4. Klik op Install Now
5. Klik op Activate

---

Configuratie

Je API-sleutel ophalen

Sleutels van oudere plug-inversies werken niet meer

LabelGrid accepteert geen API-sleutels meer die voor oudere versies van de plug-in zijn aangemaakt. Werken je download gates, pre-saves of de catalogussynchronisatie niet meer, maak dan met de stappen hieronder een nieuwe sleutel aan en plak die in de plug-in. Verder verandert er niets: je bestaande gates en pre-saves houden hun instellingen.

Zolang de sleutel wordt geweigerd, verdwijnt het tabblad Download Gate uit de plug-ininstellingen. De functie is niet verwijderd: het tabblad komt terug zodra je een geldige sleutel opslaat.

LabelGrid voert deze controle uit, niet de plug-in, dus alle versies zijn geraakt. Sites die nog op 1.5.0 of 1.6.0 draaien blijven niet zonder melding: ze tonen één oudere, minder specifieke banner, LabelGrid API DISABLED: Verify the API Token is correct and that your account is enabled for LabelGrid API Services., die hetzelfde probleem beschrijft. In het hoofdstuk over problemen oplossen staan alle meldingen en wat ze betekenen.

Maak in LabelGrid een autorisatiesleutel aan voordat je de plug-in instelt:

1. Log in bij LabelGrid
2. Klik op je gebruikersmenu (je naam/avatar rechtsboven)
3. Klik op Wordpress in het uitklapmenu
4. Klik op de knop Configure Plugin
5. Kies bij Step 1: Create Key welke labels je wilt meenemen:
   • Kies All My Labels om je hele catalogus te synchroniseren
   • Of selecteer specifieke labels om te beperken wat er op je website verschijnt
6. Klik op Create New Key
7. Voer het domein van je WordPress-website in (bijv. https://yoursite.com)
8. Klik op OK om de sleutel te genereren
9. Kopieer het toegangstoken; dat heb je nodig voor WordPress

Opgepast

Elke sleutel is gekoppeld aan één specifiek domein. Heb je meerdere WordPress-sites, maak dan voor elke site een aparte sleutel aan.

Plug-ininstellingen

Ga in je WordPress-beheeromgeving naar LabelGrid Tools → General Settings — een menu-item op het hoogste niveau, niet onder Settings van WordPress — om LabelGrid Tools Settings te openen. De instellingenpagina heeft zes tabbladen:

Connection · Release Pages · Artist Pages · Links & Services · Download Gate · System

Download Gate verschijnt alleen als de download gate actief is. Zolang de plug-in geen geldige API-sleutel heeft, is het tabblad volledig verborgen. Ontbreekt het, kijk dan hieronder bij problemen oplossen.

Connection

Setting	Description
LabelGrid API Token	Plak hier het toegangstoken dat je bij LabelGrid hebt gekopieerd. Sinds 1.6.1 is dit een veld van één regel, passend bij de kortere sleutels die LabelGrid nu uitgeeft
Automatic LabelGrid API Content Sync	Automatische catalogussync in- of uitschakelen

Release Pages

Setting	Description
Show unreleased releases	Toon aankomende releases op je site
Spotify Pre-Save	Schakel Spotify pre-save-knoppen in op nog niet uitgebrachte content
Spotify Pre-Save - Collect Email	No / Yes (obligatory) / Yes (optional): verzamel e-mailadressen tijdens de pre-save
iTunes / Apple Music / Beatport / Juno / Amazon Music Pre-Order	Schakel pre-orderlinks in voor iTunes, Apple Music, Beatport, Juno en Amazon
Show Spotify Web Player	Toon een ingesloten Spotify-speler op releasepagina’s
Show press release	Toon persberichtsecties
Show featured artists	Toon uitgelichte artiesten op releasepagina’s
Show similar releases	Toon vergelijkbare releases
Field below Artwork	Kies wat je onder de artwork toont: releasecode of platenlabel

Artist Pages

Setting	Description
Show Twitter feed	Toon een Twitter-feed op artiestpagina’s
Show Bandsintown feed	Een Bandsintown-feed op artiestenpagina’s tonen

Links & Services

Setting	Description
Release services / Artist services	De streaming- en winkellinks op release- en artiestenpagina’s ordenen, tonen of verbergen
Custom Services	Je eigen diensten toevoegen om op release- en artiestenpagina’s te tonen
Apple Performance Partner Program Token	Je iTunes-affiliatetoken om commissie op aankopen te verdienen

Download Gate

Setting	Description
Show press release	Zichtbaarheidsinstellingen voor pers
Show featured artists	Bepaal hoe artiesten op gate-pagina’s worden getoond
Button Label	Aangepaste tekst voor de gate-knoppen
Welcome title	Titel die op de landingspagina van de gate wordt getoond
Welcome description	Beschrijvende tekst voor de landingspagina van de gate
Gate button label	Tekst voor de knop van de gate-wizard

System

Setting	Description
Error log level	Stel het detailniveau van de logging in voor het oplossen van problemen
Log Retention Days	Hoe lang systeemlogs bewaard blijven
View System Logs	De opgeslagen systeemlogs openen
System Information	Omgevingsgegevens om mee te sturen als je contact opneemt met support
Uninstall	Alleen informatie, geen knop of instelling. Het legt uit dat het verwijderen van de plug-in via het scherm Plugins de instellingen inclusief de API-token wist, samen met de log- en gate-inschrijvingstabellen, terwijl je releases, artiesten, download gates en hun velden in de database blijven

---

Catalogussync

De plug-in synchroniseert je catalogus elke 6 uur automatisch vanuit LabelGrid. Dit omvat releases, artiesten en download gates.

De plug-in maakt drie aangepaste berichttypen (custom post types) aan in WordPress:

Berichttype	Beschrijving	URL-structuur
Release	Muziekreleases met artwork, metadata en platformlinks	/release/release-name/
Artist	Artiestprofielen met biografie en sociale links	/artist/artist-name/
Gate Download	Download gates met e-mailverzameling	/free-download/gate-name/

Download gates ondersteunen ook een Gate Category-taxonomie om je gates in groepen te ordenen.

Opmerking

LabelGrid is de bron van waarheid. Wijzigingen die je in WordPress aanbrengt in release- of artiestberichten worden bij de volgende sync overschreven. Doe alle wijzigingen aan je catalogus in LabelGrid.

---

Shortcodes

De plug-in biedt 11 shortcodes, verdeeld over vier categorieën: releases, artiesten, download gates en pre-save. Elke shortcode heeft ook een bijbehorend Gutenberg-blok met dezelfde opties: zie Blocks (Gutenberg).

Releaseshortcodes

[labelgrid-release-list]

Toon je releases in een filterbaar grid.

Basisvoorbeeld:

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

Parameters:

Parameter	Standaard	Beschrijving
show-title	null	Releasetitels tonen
label	null	Filteren op platenlabel
items-page	12	Aantal releases per pagina
items-row	4	Aantal kolommen per rij
pagination	null	Paginering inschakelen
showcase-last	null	Showcase-modus inschakelen
item-filter	released	Filtertype: released of unreleased
title-below	null	Titel onder de artwork plaatsen
filter-artists	null	Filteren op artiest-ID’s
exclude	null	Specifieke release-ID’s uitsluiten
image-quality	lgt_artwork_medium	Vooraf ingestelde afbeeldingsgrootte

Aankomende releases tonen:

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

[labelgrid-release-list-filter]

Voeg een keuzefilter toe boven je releasegrid. Plaats deze shortcode vóór [labelgrid-release-list] op dezelfde pagina.

Basisvoorbeeld:

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

Parameters:

Parameter	Standaard	Beschrijving
record_label	null	Toon een keuzefilter voor platenlabel

[labelgrid-release-banner]

Toon een banner met een of meer releases, ideaal voor homepages.

Basisvoorbeeld:

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

Parameters:

Parameter	Standaard	Beschrijving
label	null	Filteren op platenlabel
items-page	1	Aantal releases dat wordt getoond
item-filter	released	Filtertype: released of unreleased
item-order	DESC	Sorteervolgorde: DESC (nieuwste eerst) of ASC
filter-artists	null	Filteren op artiest-ID’s
exclude	null	Specifieke release-ID’s uitsluiten

[labelgrid-release-links]

Toon streaming- en winkellinks voor een specifieke release. Gebruik dit binnen templates van releasepagina’s, of op elke pagina door een release-ID op te geven.

Basisvoorbeeld:

[labelgrid-release-links]

Met een specifieke release:

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

Parameters:

Parameter	Standaard	Beschrijving
release-id	ID van het huidige bericht	Het bericht-ID van de release
artists	null	Toon artiestinformatie naast de links

[labelgrid-release-detail]

Render de volledige detailpagina van een release, inclusief artwork, metadata, platformlinks en ingesloten speler. Deze shortcode gebruikt het huidige bericht en heeft geen parameters.

Voorbeeld (in een releasetemplate):

[labelgrid-release-detail]

Artiestshortcodes

[labelgrid-artist-list]

Toon je artiesten in een grid-indeling.

Basisvoorbeeld:

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

Parameters:

Parameter	Standaard	Beschrijving
show-title	false	Artiestnamen onder de afbeeldingen tonen
category	null	Filteren op categorie
items-page	12	Aantal artiesten per pagina
items-row	4	Aantal kolommen per rij
pagination	null	Paginering inschakelen
title-below	null	Titel onder de afbeelding plaatsen

[labelgrid-artist-detail]

Render de volledige profielpagina van een artiest, inclusief biografie, sociale links en discografie. Deze shortcode gebruikt het huidige bericht en heeft geen parameters.

Voorbeeld (in een artiesttemplate):

[labelgrid-artist-detail]

Download gate-shortcodes

[labelgrid-gate-button]

Toon een download gate-knop. Bij een klik doorloopt de bezoeker de gate-flow (e-mailadres opgeven en optioneel sociale accounts volgen) voordat hij toegang tot de download krijgt.

Basisvoorbeeld:

[labelgrid-gate-button]

Met aangepaste tekst:

[labelgrid-gate-button gate-id="45" button-label="Get Free Download" custom-class="my-button"]

Parameters:

Parameter	Standaard	Beschrijving
gate-id	ID van het huidige bericht	Het bericht-ID van de download gate
post-id	ID van het huidige bericht	Bericht-ID van de bijbehorende release
button-label	null	Aangepaste knoptekst
custom-class	null	Aanvullende CSS-klasse
download-text	null	Aangepaste tekst voor de downloadknop

[labelgrid-gate-download-list]

Toon je download gates in een grid-indeling.

Basisvoorbeeld:

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

Parameters:

Parameter	Standaard	Beschrijving
show-title	false	Gate-titels tonen
category	null	Filteren op gate-categorie
items-page	12	Items per pagina
items-row	4	Kolommen per rij
pagination	null	Paginering inschakelen
title-below	null	Titel onder de afbeelding plaatsen

[labelgrid-gate-download-detail]

Render de volledige detailpagina van een download gate. Deze shortcode gebruikt het huidige bericht en heeft geen parameters.

Voorbeeld (in een gate-template):

[labelgrid-gate-download-detail]

Pre-save-shortcode

[labelgrid-presave-button]

Toon een Spotify pre-save-knop voor een aankomende release. Bezoekers kunnen de release pre-saven en optioneel de artiest en een playlist volgen op Spotify.

Basisvoorbeeld:

[labelgrid-presave-button]

Voor een specifieke release:

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

Parameters:

Parameter	Standaard	Beschrijving
release-id	ID van het huidige bericht	Het bericht-ID van de release

Tip

Schakel “Spotify Pre-Save - Collect Email” in op het tabblad Release Pages om tijdens de pre-save-flow e-mailadressen te verzamelen.

---

Gate- en pre-save-acties

Een download gate vraagt fans om Spotify te koppelen en een of meer acties uit te voeren voordat de download vrijkomt. Een pre-save slaat altijd de release zelf op en kan daar volgacties bij zetten.

Dit zijn de beschikbare Spotify-acties:

• De release opslaan: zit altijd in een pre-save
• Een artiest volgen
• Een playlist volgen
• Een Spotify-profiel volgen: nieuw in 1.6.0

Volgdoelen zijn niet meer beperkt tot artiesten uit je eigen catalogus, dus je kunt een gate ook op een samenwerkingspartner of gastartiest richten.

Acties voor SoundCloud en Twitter zijn gepauzeerd

Sinds versie 1.6.0 werken download-gate-acties alleen met Spotify. Die voor SoundCloud en Twitter zijn gepauzeerd terwijl ze opnieuw worden gebouwd: ze draaien niet meer en fans zien ze niet meer. De gate blijft werken met de Spotify-acties.

Vroeg een van je gates om meer dan één dienst te koppelen, dan vraagt de plug-in nu alleen nog om de diensten die er nog zijn, want anders zou de gate nooit afgerond kunnen worden. Je opgeslagen instelling blijft staan en geldt weer zodra de andere diensten terug zijn. Loop elke gate na die eerder meer dan één account eiste en controleer of de overgebleven Spotify-acties nog vragen wat jij wilt.

Een gate waarvan de acties uitsluitend SoundCloud of Twitter waren, heeft niets meer om naar te vragen en werkt helemaal niet meer totdat je er een Spotify-actie aan toevoegt.

Hoe actielimieten worden geteld

Gates accepteren veel meer Spotify-acties dan voorheen, en de gate-editor laat tijdens het bewerken zien hoeveel je er al gebruikt.

Elke link telt als één actie. Een actieregel met drie playlistlinks telt als drie, niet als één. Precies daar gaat de telling mis als een gate tegen de limiet aan loopt.

Playlists zoeken tijdens een pre-save

Als een pre-save aanbiedt om de release aan een playlist van je fan toe te voegen, kan die nu zoeken in de eigen playlists in plaats van de hele lijst door te scrollen.

---

Blocks (Gutenberg)

Vanaf versie 1.5.0 levert LabelGrid Tools native blokeditor-blokken voor elke functie. Klik in de WordPress-editor op de blokkeninvoeger (de knop +) en zoek de categorie LabelGrid Tools, of zoek een blok op naam. Stel de opties van elk blok in via de blokzijbalk: dezelfde opties die de bijbehorende shortcode accepteert.

Er zijn 11 blokken, één voor elke shortcode:

Block	Overeenkomstige shortcode	Wat het doet
LabelGrid Release List	[labelgrid-release-list]	Responsieve grid van je releases (kolommen, items per pagina, label, paginering, titelopties)
LabelGrid Release List Filter	[labelgrid-release-list-filter]	Genrefilter (plus een platenlabelfilter wanneer er een label is geconfigureerd); combineer het met een releaselijst op dezelfde pagina
LabelGrid Release Banner	[labelgrid-release-banner]	Full-width banner met een release, ideaal voor homepages
LabelGrid Release Links	[labelgrid-release-links]	Streaming- en winkellinks voor de huidige release
LabelGrid Release Detail	[labelgrid-release-detail]	De volledige releasetekst; gebruik het op een single-template voor Releases
LabelGrid Artist List	[labelgrid-artist-list]	Responsieve grid van je artiesten
LabelGrid Artist Detail	[labelgrid-artist-detail]	De volledige artiesttekst; gebruik het op een single-template voor Artists
LabelGrid Gate Button	[labelgrid-gate-button]	Download gate-knop; wordt alleen weergegeven als de LabelGrid-verbinding actief is
LabelGrid Gate Download List	[labelgrid-gate-download-list]	Grid van gated downloads; alleen als de verbinding actief is
LabelGrid Gate Download Detail	[labelgrid-gate-download-detail]	De volledige tekst van de gated download; alleen als de verbinding actief is
LabelGrid Presave Button	[labelgrid-presave-button]	Spotify pre-save-knop; wordt alleen weergegeven als de verbinding actief is en de releasedatum nog niet is verstreken

Blokken en shortcodes zijn onderling inwisselbaar

Elk blok gebruikt dezelfde renderer als de bijbehorende shortcode, dus een pagina die met blokken is gebouwd en een pagina die met shortcodes is gebouwd, leveren identieke output op. Blokken zijn puur additief: het toevoegen van een blok verandert nooit een pagina waar je het niet aan hebt toegevoegd, en je bestaande release- en artiesttemplates blijven ongewijzigd wanneer je de plug-in bijwerkt. Heb je liever shortcodes? Die blijven volledig ondersteund en werken in elk thema.

Voorkom dat de detail dubbel wordt weergegeven

Gebruik in een single-itemtemplate in de Site-editor (blokthema’s) ofwel het blok Release Detail / Artist Detail, ofwel het blok Post Content (‘Content’) van WordPress, niet allebei. Als je beide gebruikt, wordt de release- of artiestdetail twee keer weergegeven.

Opmerking

De blokken Gate Button, Gate Download List, Gate Download Detail en Presave Button worden alleen weergegeven op sites die zijn gekoppeld aan een LabelGrid-account met een actief abonnement.

---

Elementor

Elke functie van LabelGrid Tools is ook beschikbaar als shortcode, en met de ingebouwde Shortcode-widget van Elementor — die in de gratis versie van Elementor zit — plaats je elke functie op een pagina zonder extra add-on. De Theme Builder-aanpak hieronder is anders: Single-templates, weergavevoorwaarden en de Post Content-widget zijn functies van Elementor Pro. Gebruik in de gratis versie van Elementor in plaats daarvan een Shortcode-widget op een willekeurige pagina — en de ingebouwde release- en artiestpagina’s van de plug-in worden al vanzelf weergegeven, zonder Elementor-template.

Om release- en artiestpagina’s te maken met de Theme Builder van Elementor Pro:

1. Maak een Theme Builder → Single-template aan en stel de weergavevoorwaarde in op Releases (en/of Artists).
2. Gebruik voor de release- of artiesttekst een Shortcode-widget met [labelgrid-release-detail] / [labelgrid-artist-detail] — deze methode rendert de detail altijd. De Post Content-widget rendert de detail ook in de meeste configuraties. Gebruik er één, nooit beide, anders wordt de detail twee keer weergegeven.
3. Voeg releasegrids, banners, artiestenoverzichten, smart-linkknoppen, pre-saves en download gates elders in je layout toe met de Shortcode-widget.

Opmerking

Functies voor download gates en pre-save worden alleen weergegeven op sites die zijn gekoppeld aan een LabelGrid-account met een actief abonnement.

---

Je eigen themetemplate gebruiken voor release- en artiestpagina’s

Standaard rendert de plug-in de single pagina’s voor releases en artiesten door zijn eigen layout in de paginacontent te injecteren, zodat ze zonder themawijzigingen werken. Wil je deze pagina’s liever in je eigen thema bouwen, dan kan de plug-in een stap terug doen en een klassieke PHP-template ze laten renderen.

Om het renderen in een klassiek thema over te nemen:

1. Voeg add_theme_support( 'labelgrid-tools-templates' ); toe aan de functions.php van je thema.
2. Voeg een klassieke single-release.php- en/of single-artist.php-template toe aan je thema.

Wanneer een thema zich zowel aanmeldt als de bijbehorende template aanlevert, detecteert de plug-in dat je template het heeft overgenomen en onderdrukt hij zijn eigen content-injectie, zodat de pagina één keer wordt gerenderd vanuit jouw template, zonder dubbele layout. Plaats de release- of artiesttekst waar je wilt met de blokken Release Detail / Artist Detail of de shortcodes [labelgrid-release-detail] / [labelgrid-artist-detail] binnen je template.

Je kunt de aanmelding ook per verzoek in- of uitschakelen met het filter lgt_use_theme_templates. Het ontvangt de huidige aanmeldwaarde en het huidige bericht, en geeft true of false terug, zodat je je themetemplate alleen voor bepaalde releases of artiesten kunt inschakelen.

Opmerking

Deze override geldt alleen voor klassieke PHP-templates. Het overnemen van release- en artiestpagina’s vanuit de Site-editor van een blokthema wordt nog niet ondersteund en staat gepland als toekomstige toevoeging. Sites die zich niet aanmelden, ondervinden geen gevolgen: de ingebouwde layout wordt precies als voorheen weergegeven.

---

Overzicht van CSS-klassen

De plug-in gebruikt deze CSS-klasseprefixen voor de styling:

Klasse	Element
.lgsquarelist	Gridcontainer voor release- en artiestlijsten
.releaseelement	Individuele release- of artiestkaart
.elementrow1 t/m .elementrow8	Kolomspecifieke indeling (komt overeen met de instelling items-row)
.elementrowx	Flexibele indelingsvariant
.spotify, .twitter, .youtube, .soundcloud, .facebook	Dienstspecifieke styling op platformlinks
.banner-*	Elementen van de releasebanner
.gate, .gateimage, .freedownload	Elementen van de download gate

Opmerking

Shortcodes werken in elk thema en elke pagebuilder. Dezelfde functies zijn ook beschikbaar als native Gutenberg-blokken en via Elementor: zie hierboven Blocks (Gutenberg) en Elementor.

---

Problemen oplossen

Gates, pre-saves en catalogussynchronisatie werken niet meer

LabelGrid accepteert geen API-sleutels meer die voor oudere versies van de plug-in zijn aangemaakt. Zijn je download gates, Spotify-pre-saves of de catalogussynchronisatie gestopt zonder dat je iets hebt veranderd, dan is dit vrijwel altijd de oorzaak.

De oplossing: maak een nieuwe sleutel aan en plak die in de plug-in. De stappen zijn dezelfde als de eerste keer en staan hierboven in het hoofdstuk over de configuratie. Je bestaande gates en pre-saves houden hun instellingen, dus je hoeft niets opnieuw op te bouwen.

Waaraan je het herkent:

• Download gates, pre-saves en de catalogussynchronisatie werken niet meer.
• Het tabblad Download Gate ontbreekt in de plug-ininstellingen. De functie is niet verwijderd: het tabblad blijft verborgen zolang er geen geldige sleutel is en komt terug zodra je een nieuwe opslaat.
• Versie 1.6.1 toont een van drie specifieke meldingen in de WordPress-beheeromgeving. Oudere versies, waaronder 1.5.0 en 1.6.0, tonen in plaats daarvan één oudere, minder specifieke melding — LabelGrid API DISABLED: Verify the API Token is correct and that your account is enabled for LabelGrid API Services., met een link Set API in General Settings — maar zijn net zo geraakt, want de controle gebeurt bij LabelGrid en niet in de plug-in.

Wat de meldingen van de plug-in betekenen

Versie 1.6.1 toont een van deze drie meldingen. Twee ervan beginnen met LabelGrid API DISABLED:, dus lees de hele zin voordat je iets doet. De meldingen staan hier in het Engels omdat de plug-in ze op dit moment niet vertaalt.

Je sleutel moet vervangen worden:

LabelGrid API DISABLED: 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.

Maak met de stappen uit het hoofdstuk over de configuratie een nieuwe sleutel aan en plak die in de plug-in.

Er is nog geen sleutel opgeslagen:

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

Maak een sleutel aan en plak die in de plug-ininstellingen.

Een tijdelijk verbindingsprobleem, geen probleem met je sleutel:

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.

Wil je de verbinding meteen opnieuw laten controleren, in welke versie dan ook, dan moet je iets wijzigen. De knop Save Settings blijft grijs tot er echt een instelling verandert, en dezelfde sleutel opnieuw plakken telt niet als wijziging. Wijzig dus een willekeurige instelling, sla op, zet hem terug en sla opnieuw op. Log Retention Days op het tabblad System is daar geschikt voor, want er hangt niets anders van af. Elke keer dat je opslaat, wordt de verbinding opnieuw gecontroleerd, en je site blijft uiteindelijk precies zoals hij was.

Vanaf versie 1.6.2 draait ook de dagelijkse achtergrondcontrole vanzelf opnieuw zolang er een sleutel is opgeslagen, zodat een site waarvan de storing of de verzoekslimiet voorbij is er zelf weer bovenop komt. In 1.5.0, 1.6.0 en 1.6.1 gebeurde dat nooit: zodra de plug-in zichzelf had uitgeschakeld, sloeg de dagelijkse controle de verbindingstest over totdat iemand de instellingen met de hand opsloeg.

Dit geldt alleen voor verbindingsproblemen. Een geweigerde sleutel komt in geen enkele versie vanzelf goed; zie hierboven ‘Je sleutel moet vervangen worden’. Blijft het probleem bestaan, kijk dan hieronder bij de API-verbindingsfouten.

Releases verschijnen niet

1. Ga naar LabelGrid Tools → General Settings — een menu-item op het hoogste niveau, niet onder Settings van WordPress — en controleer of je API-token correct is ingevuld
2. Controleer of auto-sync is ingeschakeld op het tabblad Connection
3. Wacht tot maximaal 6 uur op de volgende synccyclus, of deactiveer en heractiveer de plug-in om meteen een sync te starten
4. Controleer of de releases in LabelGrid zijn gepubliceerd (niet in conceptstatus staan)
5. Ga naar LabelGrid Tools → General Settings → System, verhoog het debug level en bekijk daarna de logs

Shortcodes verschijnen als platte tekst

1. Zorg dat de plug-in is geactiveerd onder Plugins
2. Controleer of je koppeltekens gebruikt in shortcode-namen (bijv. [labelgrid-release-list]), geen underscores
3. Controleer de shortcode-naam op typefouten

Stylingproblemen

1. Controleer op CSS-conflicten met je thema
2. Inspecteer de elementklassen met de ontwikkelaarstools van je browser
3. Voeg aangepaste CSS-overrides toe die de klassenamen van de plug-in targeten (zie het overzicht van CSS-klassen hierboven)
4. Test met een standaard WordPress-thema om themaconflicten uit te sluiten

API-verbindingsfouten

1. Controleer of je API-token geldig is en niet is verlopen
2. Bevestig dat je LabelGrid-account actief is
3. Controleer of je server uitgaande verzoeken kan doen naar api.labelgrid.com
4. Bekijk de plug-inlogs voor specifieke foutmeldingen

Gate-inzendingen en exports

Inzendingen van download gates (verzamelde e-mailadressen) kun je als CSV exporteren vanuit de WordPress-beheeromgeving. Ga naar het bericht van de download gate en zoek de exportoptie.

---

Updates

Automatische updates

1. Ga naar Plugins in je WordPress-beheeromgeving
2. Zoek “LabelGrid Tools”
3. Klik op Enable auto-updates

Handmatige updates

1. Download de nieuwste versie bij LabelGrid
2. Ga naar Plugins → Add New → Upload Plugin
3. Upload het nieuwe ZIP-bestand
4. WordPress vraagt je om de bestaande versie te vervangen
5. Klik op Replace current with uploaded

---

FAQ

”Wat is de WordPress-plug-in LabelGrid Tools?”

LabelGrid Tools is de officiële WordPress-plug-in van LabelGrid. De plug-in synchroniseert je releasecatalogus, artiestprofielen en download gates elke 6 uur automatisch van LabelGrid naar je WordPress-site, en voegt releasepagina’s met smart links, Spotify pre-save-knoppen en gated downloads toe. Je vindt de plug-in in de WordPress Plugin Directory.

”Heb ik een betaald abonnement of API-abonnement nodig voor de WordPress-plug-in?”

Nee — LabelGrid Tools is voor alle LabelGrid-accounts beschikbaar zonder extra kosten, en een API-abonnement is niet vereist. De Gate-functies die de plug-in biedt, zitten bij alle standaard- en API-abonnementen inbegrepen, en er bestaat een los Gate-abonnement voor wie alleen de WordPress-integratie wil zonder distributie.

”Hoe installeer en koppel ik de plug-in?”

Ga in WordPress naar Plugins en dan Add New, installeer LabelGrid Tools en activeer de plug-in. Open in LabelGrid je gebruikersmenu, dan Wordpress, dan Configure Plugin, maak een autorisatiesleutel voor je domein aan en plak het toegangstoken in het tabblad Connection bij de instellingen van de plug-in. Elke sleutel is aan één domein gekoppeld.

”Hoe vaak synchroniseert de plug-in mijn catalogus?”

De plug-in synchroniseert je releases, artiesten en download gates elke 6 uur vanuit LabelGrid. LabelGrid is de bron van waarheid, dus voer alle wijzigingen in je catalogus in LabelGrid door: aanpassingen die je rechtstreeks in gesynchroniseerde WordPress-berichten maakt, worden bij de volgende sync overschreven.

”Kan ik met de plug-in Spotify pre-saves aan mijn site toevoegen?”

Ja. Schakel Spotify pre-save in op het tabblad Release Pages bij de instellingen en plaats de shortcode [labelgrid-presave-button] bij een aankomende release. Bezoekers kunnen de release pre-saven en eventueel ook de artiest en een playlist volgen, en jij kunt tijdens het pre-save-proces e-mailadressen verzamelen.

”Kan ik Gutenberg-blokken of Elementor gebruiken, of alleen shortcodes?”

Alle drie. Vanaf versie 1.5.0 is elke functie beschikbaar als shortcode, als native Gutenberg-blok (te vinden in de blokkeninvoeger onder de categorie LabelGrid Tools) en via Elementor met de Shortcode-widget. Elk blok geeft dezelfde output als de bijbehorende shortcode, en shortcodes blijven werken in elk thema.

---

Gerelateerd

Lees op onze website meer over de LabelGrid Tools WordPress-plug-in, met landingspagina’s vol smart links, Spotify pre-save-campagnes en gated downloads. Zie ook Pre-save-campagnes opzetten.

---

Hulp nodig?

Heb je hulp nodig bij de WordPress-plug-in, neem dan contact op met ons supportteam met details over je WordPress-versie, PHP-versie en eventuele foutmeldingen uit de plug-inlogs.