WordPress-plug-in

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 momenteel de manier om Spotify pre-save op elk abonnement aan je website toe te voegen. Een losse pre-save-pagina in de app zelf (zonder plug-in) staat op de planning.

Overzicht

Wat je kunt doen

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 meer dan 25 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 acties om sociaal te volgen (Spotify, Twitter, SoundCloud)
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 5.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

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 naar Settings → LabelGrid Tools in je WordPress-beheeromgeving. De instellingenpagina heeft vier tabbladen:

Tabblad LabelGrid GATE

Instelling	Beschrijving
API Token	Plak hier het toegangstoken dat je bij LabelGrid hebt gekopieerd

Tabblad General Options

Instelling	Beschrijving
Debug level	Stel het detailniveau van de logging in voor het oplossen van problemen
Log retention	Hoe lang systeemlogs bewaard blijven
Auto-sync	Automatische catalogussync in- of uitschakelen
iTunes Affiliate Token	Je iTunes-affiliatetoken om commissie op aankopen te verdienen

Tabblad Releases

Instelling	Beschrijving
Show unreleased	Toon aankomende releases op je site
Spotify pre-save	Schakel Spotify pre-save-knoppen in op nog niet uitgebrachte content
Pre-save email collection	No / Yes (obligatory) / Yes (optional): verzamel e-mailadressen tijdens de pre-save
Pre-orders	Schakel pre-orderlinks in voor iTunes, Apple Music, Beatport, Juno en Amazon
Spotify Web Player	Toon een ingesloten Spotify-speler op releasepagina’s
Press release	Toon persberichtsecties
Featured artists	Toon uitgelichte artiesten op releasepagina’s
Similar releases	Toon vergelijkbare releases
Show below artwork	Kies wat je onder de artwork toont: releasecode of platenlabel
Twitter feed on artists	Toon een Twitter-feed op artiestpagina’s

Tabblad Download Gate

Instelling	Beschrijving
Press	Zichtbaarheidsinstellingen voor pers
Artists visibility	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
Wizard button label	Tekst voor de knop van de gate-wizard

---

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.

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 “Pre-save email collection” in op het tabblad Releases om tijdens de pre-save-flow e-mailadressen te verzamelen.

---

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

De plug-in bevat geen Gutenberg-blokken, Elementor-widgets of sidebar-widgets. Gebruik shortcodes om content in je pagina’s en templates te plaatsen.

---

Problemen oplossen

Releases verschijnen niet

1. Ga naar Settings → LabelGrid Tools en controleer of je API-token correct is ingevuld
2. Controleer of auto-sync is ingeschakeld op het tabblad General Options
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 Settings → LabelGrid Tools → General Options, 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 gate.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

---

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.

---

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.