WordPress Plugin

LabelGrid Tools ist das offizielle WordPress-Plugin, das automatisch Ihren Release-Katalog, Kuenstlerprofile und Download Gates von LabelGrid mit Ihrer WordPress-Website synchronisiert. LabelGrid ist die Quelle der Wahrheit — das Plugin importiert Ihre Daten alle 6 Stunden, sodass Ihre Website immer Ihren aktuellsten Katalog widerspiegelt.

In jedem Plan verfuegbar

LabelGrid Tools ist fuer alle LabelGrid-Konten ohne zusaetzliche Kosten verfuegbar — ein API-Plan ist nicht erforderlich. Es ist derzeit der Weg, um Spotify-Pre-Save in jedem Plan zu Ihrer Website hinzuzufuegen. Eine in die App integrierte Pre-Save-Seite (ohne Plugin) ist fuer die Zukunft geplant.

Ueberblick

Was Sie tun koennen

Funktion	Beschreibung
Automatische Katalogsynchronisation	Releases, Kuenstler und Download Gates synchronisieren sich alle 6 Stunden von LabelGrid
Release-Seiten	Seiten mit Artwork und Links zu ueber 25 Streaming-Plattformen und Stores
Kuenstlerprofile	Kuenstlerseiten mit Biografien, Social Links und Diskografie
Release-Raster	Filterbare Raster Ihres Katalogs nach Genre, Label oder Kuenstler
Release-Banner	Homepage-Banner, die Ihre neuesten Releases hervorheben
Spotify Pre-Save	Pre-Save-Buttons mit Playlist- und Kuenstler-Follow-Aktionen
Vorbestellungen	Unterstuetzung fuer Vorbestellungen bei iTunes, Apple Music, Beatport, Juno und Amazon
Download Gates	E-Mail-Erfassungs-Gates mit Social-Follow-Aktionen (Spotify, Twitter, SoundCloud)
Spotify Web Player	Eingebetteter Spotify-Player auf Release-Seiten
Pressemitteilungen	Dedizierte Pressemitteilungs-Bereiche auf Release-Seiten
iTunes-Affiliate-Links	Verdienen Sie Provisionen bei iTunes-Kaeufen ueber Ihre Website
Yoast SEO Integration	Open Graph Metadaten fuer Social Sharing

Anforderungen

• WordPress 5.0 oder hoeher
• PHP 8.0 oder hoeher
• Ein aktives LabelGrid-Konto (kein API-Plan erforderlich)

---

Installation

Ueber den WordPress-Admin

1. Gehen Sie zu Plugins → Add New
2. Suchen Sie nach “LabelGrid Tools”
3. Klicken Sie auf Install Now
4. Klicken Sie auf Activate

Manuelle Installation

1. Laden Sie das Plugin von LabelGrid herunter
2. Gehen Sie zu Plugins → Add New → Upload Plugin
3. Waehlen Sie die heruntergeladene ZIP-Datei
4. Klicken Sie auf Install Now
5. Klicken Sie auf Activate

---

Konfiguration

Ihren Autorisierungsschluessel erhalten

Bevor Sie das Plugin konfigurieren, erstellen Sie einen Autorisierungsschluessel in LabelGrid:

1. Melden Sie sich bei LabelGrid an
2. Klicken Sie auf Ihr Benutzermenue (Ihr Name/Avatar oben rechts)
3. Klicken Sie auf Wordpress im Dropdown-Menue
4. Klicken Sie auf die Schaltflaeche Configure Plugin
5. In Step 1: Create Key waehlen Sie aus, welche Labels einbezogen werden sollen:
   • Waehlen Sie All My Labels, um Ihren gesamten Katalog zu synchronisieren
   • Oder waehlen Sie bestimmte Labels, um einzuschraenken, was auf Ihrer Website erscheint
6. Klicken Sie auf Create New Key
7. Geben Sie die Domain Ihrer WordPress-Website ein (z.B. https://ihreseite.com)
8. Klicken Sie auf OK, um den Schluessel zu generieren
9. Kopieren Sie das Access Token — Sie benoetigen es fuer WordPress

Achtung

Jeder Schluessel ist an eine bestimmte Domain gebunden. Wenn Sie mehrere WordPress-Seiten haben, erstellen Sie fuer jede einen separaten Schluessel.

Plugin-Einstellungen

Gehen Sie zu Settings → LabelGrid Tools in Ihrem WordPress-Admin. Die Einstellungsseite hat vier Tabs:

Tab LabelGrid GATE

Einstellung	Beschreibung
API Token	Fuegen Sie das Access Token ein, das Sie von LabelGrid kopiert haben

Tab General Options

Einstellung	Beschreibung
Debug level	Legen Sie die Protokollierungsebene fuer die Fehlerbehebung fest
Log retention	Wie lange Systemprotokolle aufbewahrt werden
Auto-sync	Automatische Katalogsynchronisation aktivieren oder deaktivieren
iTunes Affiliate Token	Ihr iTunes-Affiliate-Token zum Verdienen von Provisionen bei Kaeufen

Tab Releases

Einstellung	Beschreibung
Show unreleased	Kommende Releases auf Ihrer Website anzeigen
Spotify pre-save	Spotify Pre-Save-Buttons fuer unveroeffentlichte Inhalte aktivieren
Pre-save email collection	Nein / Ja (obligatorisch) / Ja (optional) — E-Mails waehrend des Pre-Save sammeln
Pre-orders	Vorbestellungs-Links fuer iTunes, Apple Music, Beatport, Juno und Amazon aktivieren
Spotify Web Player	Eingebetteten Spotify-Player auf Release-Seiten anzeigen
Press release	Pressemitteilungs-Bereiche anzeigen
Featured artists	Vorgestellte Kuenstler auf Release-Seiten anzeigen
Similar releases	Aehnliche Releases anzeigen
Show below artwork	Waehlen, was unter dem Artwork angezeigt wird: Release-Code oder Plattenlabel
Twitter feed on artists	Twitter-Feed auf Kuenstlerseiten anzeigen

Tab Download Gate

Einstellung	Beschreibung
Press	Presse-Sichtbarkeitseinstellungen
Artists visibility	Kuenstleranzeige auf Gate-Seiten steuern
Button label	Benutzerdefinierter Text fuer Gate-Buttons
Welcome title	Titel auf der Gate-Landingpage
Welcome description	Beschreibungstext fuer die Gate-Landingpage
Wizard button label	Text fuer den Gate-Assistenten-Button

---

Katalogsynchronisation

Das Plugin synchronisiert automatisch Ihren Katalog von LabelGrid alle 6 Stunden. Dies umfasst Releases, Kuenstler und Download Gates.

Das Plugin erstellt drei benutzerdefinierte Inhaltstypen in WordPress:

Inhaltstyp	Beschreibung	URL-Struktur
Release	Musikveroeffentlichungen mit Artwork, Metadaten und Plattform-Links	/release/release-name/
Artist	Kuenstlerprofile mit Biografie und Social Links	/artist/kuenstlername/
Gate Download	Download Gates mit E-Mail-Erfassung	/free-download/gate-name/

Download Gates unterstuetzen auch eine Gate Category Taxonomie zum Organisieren Ihrer Gates in Gruppen.

Hinweis

LabelGrid ist die Quelle der Wahrheit. Aenderungen, die Sie an Release- oder Kuenstler-Beitraegen in WordPress vornehmen, werden bei der naechsten Synchronisation ueberschrieben. Nehmen Sie alle Katalogaenderungen in LabelGrid vor.

---

Shortcodes

Das Plugin bietet 11 Shortcodes, organisiert in vier Kategorien: Releases, Kuenstler, Download Gates und Pre-Save.

Release-Shortcodes

[labelgrid-release-list]

Zeigen Sie Ihre Releases in einem filterbaren Raster an.

Einfaches Beispiel:

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

Parameter:

Parameter	Standard	Beschreibung
show-title	null	Release-Titel anzeigen
label	null	Nach Plattenlabel filtern
items-page	12	Anzahl Releases pro Seite
items-row	4	Anzahl Spalten pro Reihe
pagination	null	Paginierung aktivieren
showcase-last	null	Showcase-Modus aktivieren
item-filter	released	Filtertyp: released oder unreleased
title-below	null	Titel unter dem Artwork positionieren
filter-artists	null	Nach Kuenstler-IDs filtern
exclude	null	Bestimmte Release-IDs ausschliessen
image-quality	lgt_artwork_medium	Bildgroessen-Preset

Kommende Releases anzeigen:

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

[labelgrid-release-list-filter]

Fuegen Sie ein Dropdown-Filter ueber Ihrem Release-Raster hinzu. Platzieren Sie diesen Shortcode vor [labelgrid-release-list] auf derselben Seite.

Einfaches Beispiel:

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

Parameter:

Parameter	Standard	Beschreibung
record_label	null	Plattenlabel-Dropdown-Filter anzeigen

[labelgrid-release-banner]

Zeigen Sie ein Banner mit einem oder mehreren Releases an — ideal fuer Startseiten.

Einfaches Beispiel:

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

Parameter:

Parameter	Standard	Beschreibung
label	null	Nach Plattenlabel filtern
items-page	1	Anzahl der anzuzeigenden Releases
item-filter	released	Filtertyp: released oder unreleased
item-order	DESC	Sortierung: DESC (neueste zuerst) oder ASC
filter-artists	null	Nach Kuenstler-IDs filtern
exclude	null	Bestimmte Release-IDs ausschliessen

[labelgrid-release-links]

Zeigen Sie Streaming- und Store-Links fuer ein bestimmtes Release an. Verwenden Sie diesen Shortcode in Release-Seitenvorlagen oder auf jeder Seite durch Angabe einer Release-ID.

Einfaches Beispiel:

[labelgrid-release-links]

Mit einem bestimmten Release:

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

Parameter:

Parameter	Standard	Beschreibung
release-id	Aktuelle Beitrags-ID	Die Release-Beitrags-ID
artists	null	Kuenstlerinformationen neben den Links anzeigen

[labelgrid-release-detail]

Rendert die vollstaendige Release-Detailseite, einschliesslich Artwork, Metadaten, Plattform-Links und eingebettetem Player. Dieser Shortcode verwendet den aktuellen Beitrag und akzeptiert keine Parameter.

Beispiel (in einer Release-Vorlage):

[labelgrid-release-detail]

Kuenstler-Shortcodes

[labelgrid-artist-list]

Zeigen Sie Ihre Kuenstler in einem Raster-Layout an.

Einfaches Beispiel:

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

Parameter:

Parameter	Standard	Beschreibung
show-title	false	Kuenstlernamen unter den Bildern anzeigen
category	null	Nach Kategorie filtern
items-page	12	Anzahl Kuenstler pro Seite
items-row	4	Anzahl Spalten pro Reihe
pagination	null	Paginierung aktivieren
title-below	null	Titel unter dem Bild positionieren

[labelgrid-artist-detail]

Rendert die vollstaendige Kuenstler-Profilseite, einschliesslich Biografie, Social Links und Diskografie. Dieser Shortcode verwendet den aktuellen Beitrag und akzeptiert keine Parameter.

Beispiel (in einer Kuenstler-Vorlage):

[labelgrid-artist-detail]

Download Gate Shortcodes

[labelgrid-gate-button]

Zeigen Sie einen Download Gate Button an. Wenn geklickt, durchlaeuft der Besucher den Gate-Flow (E-Mail-Erfassung und optionale Social Follows) bevor er Zugang zum Download erhaelt.

Einfaches Beispiel:

[labelgrid-gate-button]

Mit benutzerdefiniertem Text:

[labelgrid-gate-button gate-id="45" button-label="Kostenloser Download" custom-class="mein-button"]

Parameter:

Parameter	Standard	Beschreibung
gate-id	Aktuelle Beitrags-ID	Die Download Gate Beitrags-ID
post-id	Aktuelle Beitrags-ID	Zugehoerige Release-Beitrags-ID
button-label	null	Benutzerdefinierter Button-Text
custom-class	null	Zusaetzliche CSS-Klasse
download-text	null	Benutzerdefinierter Download-Button-Text

[labelgrid-gate-download-list]

Zeigen Sie Ihre Download Gates in einem Raster-Layout an.

Einfaches Beispiel:

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

Parameter:

Parameter	Standard	Beschreibung
show-title	false	Gate-Titel anzeigen
category	null	Nach Gate-Kategorie filtern
items-page	12	Elemente pro Seite
items-row	4	Spalten pro Reihe
pagination	null	Paginierung aktivieren
title-below	null	Titel unter dem Bild positionieren

[labelgrid-gate-download-detail]

Rendert die vollstaendige Download Gate Detailseite. Dieser Shortcode verwendet den aktuellen Beitrag und akzeptiert keine Parameter.

Beispiel (in einer Gate-Vorlage):

[labelgrid-gate-download-detail]

Pre-Save Shortcode

[labelgrid-presave-button]

Zeigen Sie einen Spotify Pre-Save Button fuer ein kommendes Release an. Besucher koennen das Release pre-saven und optional dem Kuenstler und einer Playlist auf Spotify folgen.

Einfaches Beispiel:

[labelgrid-presave-button]

Fuer ein bestimmtes Release:

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

Parameter:

Parameter	Standard	Beschreibung
release-id	Aktuelle Beitrags-ID	Die Release-Beitrags-ID

Tipp

Aktivieren Sie “Pre-save email collection” im Releases-Tab der Einstellungen, um E-Mail-Adressen waehrend des Pre-Save-Flows zu sammeln.

---

CSS-Klassen-Referenz

Das Plugin verwendet diese CSS-Klassen-Praefixe fuer das Styling:

Klasse	Element
.lgsquarelist	Raster-Container fuer Release- und Kuenstlerlisten
.releaseelement	Individuelle Release- oder Kuenstlerkarte
.elementrow1 bis .elementrow8	Spaltenspezifisches Layout (entspricht der items-row Einstellung)
.elementrowx	Flexible Layout-Variante
.spotify, .twitter, .youtube, .soundcloud, .facebook	Dienstspezifisches Styling auf Plattform-Links
.banner-*	Release-Banner-Elemente
.gate, .gateimage, .freedownload	Download Gate Elemente

Hinweis

Das Plugin enthaelt keine Gutenberg-Bloecke, Elementor-Widgets oder Sidebar-Widgets. Verwenden Sie Shortcodes, um Inhalte in Ihren Seiten und Vorlagen zu platzieren.

---

Fehlerbehebung

Releases werden nicht angezeigt

1. Gehen Sie zu Settings → LabelGrid Tools und ueberpruefen Sie, ob Ihr API-Token korrekt eingegeben ist
2. Pruefen Sie, ob Auto-Sync im Tab General Options aktiviert ist
3. Warten Sie bis zu 6 Stunden auf den naechsten Synchronisationszyklus, oder deaktivieren und reaktivieren Sie das Plugin, um eine sofortige Synchronisation auszuloesen
4. Stellen Sie sicher, dass die Releases in LabelGrid veroeffentlicht sind (nicht im Entwurf)
5. Gehen Sie zu Settings → LabelGrid Tools → General Options und erhoehen Sie die Debug-Stufe, dann pruefen Sie die Protokolle

Shortcodes werden als Klartext angezeigt

1. Stellen Sie sicher, dass das Plugin unter Plugins aktiviert ist
2. Ueberpruefen Sie, ob Sie Bindestriche in Shortcode-Namen verwenden (z.B. [labelgrid-release-list]), keine Unterstriche
3. Pruefen Sie auf Tippfehler im Shortcode-Namen

Styling-Probleme

1. Pruefen Sie auf CSS-Konflikte mit Ihrem Theme
2. Verwenden Sie die Entwicklertools Ihres Browsers, um die Element-Klassen zu inspizieren
3. Fuegen Sie benutzerdefinierte CSS-Ueberschreibungen hinzu, die auf die Klassennamen des Plugins abzielen (siehe CSS-Klassen-Referenz oben)
4. Testen Sie mit einem Standard-WordPress-Theme, um Theme-Konflikte zu isolieren

API-Verbindungsfehler

1. Ueberpruefen Sie, ob Ihr API-Token gueltig und nicht abgelaufen ist
2. Bestaetigen Sie, dass Ihr LabelGrid-Konto aktiv ist
3. Pruefen Sie, ob Ihr Server ausgehende Anfragen an gate.labelgrid.com senden kann
4. Ueberpruefen Sie die Plugin-Protokolle auf spezifische Fehlermeldungen

Gate-Eintraege und Exporte

Download Gate Eintraege (gesammelte E-Mail-Adressen) koennen als CSV aus dem WordPress-Admin exportiert werden. Gehen Sie zum Download Gate Beitrag und suchen Sie die Export-Option.

---

Updates

Automatische Updates

1. Gehen Sie zu Plugins in Ihrem WordPress-Admin
2. Finden Sie “LabelGrid Tools”
3. Klicken Sie auf Enable auto-updates

Manuelle Updates

1. Laden Sie die neueste Version von LabelGrid herunter
2. Gehen Sie zu Plugins → Add New → Upload Plugin
3. Laden Sie die neue ZIP-Datei hoch
4. WordPress fordert Sie auf, die bestehende Version zu ersetzen
5. Klicken Sie auf Replace current with uploaded

---

Weiterführend

Erfahren Sie mehr über das LabelGrid Tools WordPress-Plugin — Smart-Link-Landingpages, Spotify-Pre-Save-Kampagnen und Download-Gates — auf unserer Website.

---

Brauchen Sie Hilfe?

Wenn Sie Unterstuetzung beim WordPress Plugin benoetigen, kontaktieren Sie unser Support-Team mit Details zu Ihrer WordPress-Version, PHP-Version und etwaigen Fehlermeldungen aus den Plugin-Protokollen.