WordPress-Plugin: LabelGrid Tools einrichten

Aktualisiert im September 2026.

LabelGrid Tools ist das offizielle WordPress-Plugin, das automatisch Ihren Release-Katalog, Künstlerprofile 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 verfügbar

LabelGrid Tools steht allen LabelGrid-Konten ohne zusätzliche Kosten zur Verfügung, ein API-Plan ist nicht erforderlich. Es ist einer von zwei Wegen zur Smart-Link-Erfahrung von LabelGrid: Jedes Release hat bereits eine gehostete Landing Page und einen Kurzlink auf der LabelGrid-Domain (siehe Release Landing Pages), und dieses Plugin bringt dieselben Release-Seiten (Store-Links, Spotify-Pre-Save-Buttons und Download Gates) auf Ihre eigene WordPress-Domain im Look Ihrer Marke, zusammen mit Ihrem gesamten Katalog und Ihren Artist-Profilen.

Überblick

Was Sie tun können

Sie können jede dieser Funktionen als Shortcode, als nativen Gutenberg-Block oder über Elementor auf Ihrer Website einbinden. Siehe Blocks (Gutenberg) und Elementor.

Funktion	Beschreibung
Automatische Katalogsynchronisation	Releases, Künstler und Download Gates synchronisieren sich alle 6 Stunden von LabelGrid
Release-Seiten	Seiten mit Artwork und Links zu allen großen Streaming-Plattformen und Stores
Künstlerprofile	Künstlerseiten mit Biografien, Social Links und Diskografie
Release-Raster	Filterbare Raster Ihres Katalogs nach Genre, Label oder Künstler
Release-Banner	Homepage-Banner, die Ihre neuesten Releases hervorheben
Spotify Pre-Save	Pre-Save-Buttons mit Playlist- und Künstler-Follow-Aktionen
Vorbestellungen	Unterstützung für Vorbestellungen bei iTunes, Apple Music, Beatport, Juno und Amazon
Download Gates	E-Mail-Erfassungs-Gates mit Spotify-Follow-Aktionen
Spotify Web Player	Eingebetteter Spotify-Player auf Release-Seiten
Pressemitteilungen	Dedizierte Pressemitteilungs-Bereiche auf Release-Seiten
iTunes-Affiliate-Links	Verdienen Sie Provisionen bei iTunes-Käufen über Ihre Website
Yoast SEO Integration	Open Graph Metadaten für Social Sharing

Anforderungen

• WordPress 7.0 oder höher
• PHP 8.0 oder höher
• Ein aktives LabelGrid-Konto (kein API-Plan erforderlich)

---

Installation

Über 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. Wählen Sie die heruntergeladene ZIP-Datei
4. Klicken Sie auf Install Now
5. Klicken Sie auf Activate

---

Konfiguration

Ihren Autorisierungsschlüssel erhalten

Schlüssel aus älteren Plugin-Versionen funktionieren nicht mehr

LabelGrid akzeptiert keine API-Schlüssel mehr, die für ältere Versionen des Plugins erstellt wurden. Wenn Ihre Download Gates, Pre-Saves oder die Katalogsynchronisation nicht mehr funktionieren, erstellen Sie mit den Schritten unten einen neuen Schlüssel und fügen Sie ihn im Plugin ein. Sonst ändert sich nichts: Ihre vorhandenen Gates und Pre-Saves behalten ihre Konfiguration.

Solange der Schlüssel abgelehnt wird, verschwindet der Tab Download Gate aus den Plugin-Einstellungen. Die Funktion wurde nicht entfernt, der Tab erscheint wieder, sobald ein gültiger Schlüssel gespeichert ist.

Diese Prüfung findet bei LabelGrid statt und nicht im Plugin. Deshalb sind alle Plugin-Versionen betroffen. Seiten, die noch 1.5.0 oder 1.6.0 verwenden, bleiben nicht ohne Hinweis: Sie zeigen einen einzelnen älteren, weniger genauen Banner, LabelGrid API DEAKTIVIERT: Überprüfe, ob der API-Token korrekt ist und dein Konto für die LabelGrid-API-Services freigeschaltet ist., der dasselbe Problem beschreibt. Welche Meldungen es gibt und was sie bedeuten, steht im Abschnitt zur Fehlerbehebung.

Bevor Sie das Plugin konfigurieren, erstellen Sie einen Autorisierungsschlüssel in LabelGrid:

1. Melden Sie sich bei LabelGrid an
2. Klicken Sie auf Ihr Benutzermenü (Ihr Name/Avatar oben rechts)
3. Klicken Sie auf Wordpress im Dropdown-Menü
4. Klicken Sie auf die Schaltfläche Configure Plugin
5. In Step 1: Create Key wählen Sie aus, welche Labels einbezogen werden sollen:
   • Wählen Sie All My Labels, um Ihren gesamten Katalog zu synchronisieren
   • Oder wählen Sie bestimmte Labels, um einzuschränken, 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 Schlüssel zu generieren
9. Kopieren Sie das Access Token — Sie benötigen es für WordPress

Achtung

Jeder Schlüssel ist an eine bestimmte Domain gebunden. Wenn Sie mehrere WordPress-Seiten haben, erstellen Sie für jede einen separaten Schlüssel.

Plugin-Einstellungen

Öffnen Sie im WordPress-Admin LabelGrid Tools → Allgemeine Einstellungen (General Settings) — ein Menüpunkt der obersten Ebene, nicht unter Einstellungen —, um zu LabelGrid Tools-Einstellungen zu gelangen. Die Seite hat sechs Tabs, hier jeweils mit dem englischen Original in Klammern:

Verbindung (Connection) · Release-Seiten (Release Pages) · Künstlerseiten (Artist Pages) · Links & Dienste (Links & Services) · Download-Gate (Download Gate) · System

Download-Gate erscheint nur, wenn das Download Gate aktiv ist. Solange das Plugin keinen gültigen API-Schlüssel hat, ist der Tab vollständig ausgeblendet. Fehlt er, lesen Sie den Abschnitt zur Fehlerbehebung weiter unten.

Verbindung

Setting	Description
LabelGrid-API-Token	Fügen Sie das Access Token ein, das Sie von LabelGrid kopiert haben. Seit 1.6.1 ist das ein einzeiliges Feld, passend zu den kürzeren Schlüsseln, die LabelGrid jetzt ausgibt
Automatische LabelGrid-API-Inhaltssynchronisation	Automatische Katalogsynchronisation aktivieren oder deaktivieren

Release-Seiten

Setting	Description
Unveröffentlichte Releases anzeigen	Kommende Releases auf Ihrer Website anzeigen
Spotify Pre-Save	Spotify Pre-Save-Buttons für unveröffentlichte Inhalte aktivieren
Spotify Pre-Save - E-Mail sammeln	Nein / Ja (obligatorisch) / Ja (optional) — E-Mails während des Pre-Save sammeln
iTunes / Apple Music / Beatport / Juno / Amazon Music Pre-Order	Vorbestellungs-Links für iTunes, Apple Music, Beatport, Juno und Amazon aktivieren
Spotify-Webplayer anzeigen	Eingebetteten Spotify-Player auf Release-Seiten anzeigen
Pressetext anzeigen	Pressemitteilungs-Bereiche anzeigen
Featured Artists anzeigen	Vorgestellte Künstler auf Release-Seiten anzeigen
Ähnliche Releases anzeigen	Ähnliche Releases anzeigen
Feld unter dem Artwork	Wählen, was unter dem Artwork angezeigt wird: Release-Code oder Plattenlabel

Künstlerseiten

Setting	Description
Twitter-Feed anzeigen	Twitter-Feed auf Künstlerseiten anzeigen
Bandsintown-Feed anzeigen	Einen Bandsintown-Feed auf Künstlerseiten anzeigen

Links & Dienste

Setting	Description
RELEASES-Dienste / KÜNSTLER-Dienste	Reihenfolge und Sichtbarkeit der Streaming- und Store-Links auf Release- und Künstlerseiten festlegen
Eigene Dienste	Eigene Dienste hinzufügen, die auf Release- und Künstlerseiten angezeigt werden
Token für das Apple Performance Partner Program	Ihr iTunes-Affiliate-Token zum Verdienen von Provisionen bei Käufen

Download-Gate

Setting	Description
Pressetext anzeigen	Presse-Sichtbarkeitseinstellungen
Featured Artists anzeigen	Künstleranzeige auf Gate-Seiten steuern
Button-Beschriftung	Benutzerdefinierter Text für Gate-Buttons
Begrüßungstitel	Titel auf der Gate-Landingpage
Begrüßungstext	Beschreibungstext für die Gate-Landingpage
Gate-Button-Beschriftung	Text für den Gate-Assistenten-Button

System

Setting	Description
Fehlerprotokollierung aktivieren	Legen Sie die Protokollierungsebene für die Fehlerbehebung fest
Log-Aufbewahrung in Tagen	Wie lange Systemprotokolle aufbewahrt werden
System-Logs anzeigen	Die gespeicherten Systemprotokolle öffnen
Systeminformationen	Angaben zur Umgebung, die Sie beim Kontakt mit dem Support mitschicken
Deinstallation	Nur ein Hinweis, kein Button und keine Einstellung. Er erklärt, dass beim Löschen des Plugins über die Seite Plugins dessen Einstellungen samt API-Token sowie die Log- und Gate-Eintragstabellen entfernt werden, während Ihre Releases, Künstler, Download Gates und deren Felder in der Datenbank bleiben

---

Katalogsynchronisation

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

Das Plugin erstellt drei benutzerdefinierte Inhaltstypen in WordPress:

Inhaltstyp	Beschreibung	URL-Struktur
Release	Musikveröffentlichungen mit Artwork, Metadaten und Plattform-Links	/release/release-name/
Artist	Künstlerprofile mit Biografie und Social Links	/artist/kuenstlername/
Gate Download	Download Gates mit E-Mail-Erfassung	/free-download/gate-name/

Download Gates unterstützen auch eine Gate Category Taxonomie zum Organisieren Ihrer Gates in Gruppen.

Hinweis

LabelGrid ist die Quelle der Wahrheit. Änderungen, die Sie an Release- oder Künstler-Beiträgen in WordPress vornehmen, werden bei der nächsten Synchronisation überschrieben. Nehmen Sie alle Katalogänderungen in LabelGrid vor.

---

Shortcodes

Das Plugin bietet 11 Shortcodes, organisiert in vier Kategorien: Releases, Künstler, Download Gates und Pre-Save. Jeder Shortcode hat auch einen passenden Gutenberg-Block mit denselben Optionen, siehe Blocks (Gutenberg).

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 Künstler-IDs filtern
exclude	null	Bestimmte Release-IDs ausschließen
image-quality	lgt_artwork_medium	Bildgrößen-Preset

Kommende Releases anzeigen:

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

[labelgrid-release-list-filter]

Fügen Sie ein Dropdown-Filter über 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 für 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 Künstler-IDs filtern
exclude	null	Bestimmte Release-IDs ausschließen

[labelgrid-release-links]

Zeigen Sie Streaming- und Store-Links für 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	Künstlerinformationen neben den Links anzeigen

[labelgrid-release-detail]

Rendert die vollständige Release-Detailseite, einschließlich 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]

Künstler-Shortcodes

[labelgrid-artist-list]

Zeigen Sie Ihre Künstler in einem Raster-Layout an.

Einfaches Beispiel:

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

Parameter:

Parameter	Standard	Beschreibung
show-title	false	Künstlernamen unter den Bildern anzeigen
category	null	Nach Kategorie filtern
items-page	12	Anzahl Künstler 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 vollständige Künstler-Profilseite, einschließlich Biografie, Social Links und Diskografie. Dieser Shortcode verwendet den aktuellen Beitrag und akzeptiert keine Parameter.

Beispiel (in einer Künstler-Vorlage):

[labelgrid-artist-detail]

Download Gate Shortcodes

[labelgrid-gate-button]

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

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	Zugehörige Release-Beitrags-ID
button-label	null	Benutzerdefinierter Button-Text
custom-class	null	Zusätzliche 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 vollständige 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 für ein kommendes Release an. Besucher können das Release pre-saven und optional dem Künstler und einer Playlist auf Spotify folgen.

Einfaches Beispiel:

[labelgrid-presave-button]

Für 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 “Spotify Pre-Save - Collect Email” im Release Pages-Tab der Einstellungen, um E-Mail-Adressen während des Pre-Save-Flows zu sammeln.

---

Gate- und Pre-Save-Aktionen

Ein Download Gate fordert Fans auf, Spotify zu verbinden und eine oder mehrere Aktionen auszuführen, bevor der Download freigeschaltet wird. Ein Pre-Save speichert immer das Release selbst und kann zusätzlich Follow-Aktionen enthalten.

Diese Spotify-Aktionen stehen zur Verfügung:

• Release speichern – bei einem Pre-Save immer enthalten
• Einem Künstler folgen
• Einer Playlist folgen
• Einem Spotify-Profil folgen – neu in 1.6.0

Follow-Ziele sind nicht auf Künstler aus Ihrem eigenen Katalog beschränkt, Sie können also auch auf Kooperationspartner oder Gastkünstler verweisen.

SoundCloud- und Twitter-Aktionen pausieren

Seit Version 1.6.0 sind Download-Gate-Aktionen nur mit Spotify möglich. SoundCloud- und Twitter-Aktionen pausieren, während sie neu gebaut werden: Sie laufen nicht mehr und werden Fans nicht mehr angezeigt. Das Gate funktioniert mit seinen Spotify-Aktionen weiter.

Wenn eines Ihrer Gates verlangt hat, mehr als einen Dienst zu verbinden, fragt das Plugin jetzt nur noch nach den weiterhin verfügbaren Diensten, weil das Gate sonst gar nicht abgeschlossen werden könnte. Ihre gespeicherte Einstellung bleibt unverändert und gilt wieder, sobald die anderen Dienste zurück sind. Prüfen Sie jedes Gate, das bisher mehr als ein Konto verlangt hat, und kontrollieren Sie, ob die verbliebenen Spotify-Aktionen noch das abfragen, was Sie möchten.

Ein Gate, dessen Aktionen ausschließlich SoundCloud oder Twitter waren, hat nichts mehr, wonach es fragen kann, und läuft überhaupt nicht, bis Sie ihm eine Spotify-Aktion hinzufügen.

Wie Aktionen gezählt werden

Gates akzeptieren deutlich mehr Spotify-Aktionen als früher, und der Gate-Editor zeigt beim Bearbeiten an, wie viele Sie bereits verwenden.

Jeder Link zählt als eine Aktion. Eine Aktionszeile mit drei Playlist-Links zählt als drei, nicht als eine. Genau daran verrechnen sich die meisten, wenn ein Gate nahe an das Limit kommt.

Playlists beim Pre-Save durchsuchen

Wenn ein Pre-Save anbietet, das Release einer Playlist des Fans hinzuzufügen, kann er seine Playlists jetzt durchsuchen, statt die ganze Liste zu scrollen.

---

Blocks (Gutenberg)

Seit Version 1.5.0 liefert LabelGrid Tools native Block-Editor-Blöcke für jede Funktion. Klicken Sie im WordPress-Editor auf den Block-Inserter (die Schaltfläche +) und suchen Sie die Kategorie LabelGrid Tools, oder suchen Sie einen Block über seinen Namen. Die Optionen jedes Blocks stellen Sie in der Block-Seitenleiste ein: dieselben Optionen, die auch der passende Shortcode akzeptiert.

Es gibt 11 Blöcke, einen für jeden Shortcode:

Block	Entsprechender Shortcode	Funktion
LabelGrid Release List	[labelgrid-release-list]	Responsives Raster Ihrer Releases (Spalten, Einträge pro Seite, Label, Seitennummerierung, Titeloptionen)
LabelGrid Release List Filter	[labelgrid-release-list-filter]	Genre-Filter (plus ein Plattenlabel-Filter, wenn ein Label konfiguriert ist); kombinieren Sie ihn mit einer Release-Liste in derselben Ansicht
LabelGrid Release Banner	[labelgrid-release-banner]	Vollbreiter Banner mit einem Release, ideal für Startseiten
LabelGrid Release Links	[labelgrid-release-links]	Streaming- und Store-Links für das aktuelle Release
LabelGrid Release Detail	[labelgrid-release-detail]	Der vollständige Release-Inhalt; verwenden Sie ihn in einem Single-Template für Releases
LabelGrid Artist List	[labelgrid-artist-list]	Responsives Raster Ihrer Künstler
LabelGrid Artist Detail	[labelgrid-artist-detail]	Der vollständige Künstler-Inhalt; verwenden Sie ihn in einem Single-Template für Künstler
LabelGrid Gate Button	[labelgrid-gate-button]	Button für ein Download Gate; wird nur angezeigt, wenn die LabelGrid-Verbindung aktiv ist
LabelGrid Gate Download List	[labelgrid-gate-download-list]	Raster von Downloads hinter einem Gate; nur bei aktiver Verbindung
LabelGrid Gate Download Detail	[labelgrid-gate-download-detail]	Der vollständige Inhalt eines Downloads hinter einem Gate; nur bei aktiver Verbindung
LabelGrid Presave Button	[labelgrid-presave-button]	Spotify-Pre-Save-Button; wird nur angezeigt, wenn die Verbindung aktiv ist und das Release-Datum noch nicht überschritten wurde

Blöcke und Shortcodes sind austauschbar

Jeder Block nutzt denselben Renderer wie sein passender Shortcode, sodass eine mit Blöcken erstellte Seite und eine mit Shortcodes erstellte Seite identische Ausgaben erzeugen. Blöcke sind rein additiv: Das Hinzufügen eines Blocks verändert nie eine Seite, auf der Sie ihn nicht eingefügt haben, und Ihre bestehenden Release- und Künstler-Templates bleiben beim Aktualisieren des Plugins unverändert. Lieber Shortcodes? Sie werden weiterhin vollständig unterstützt und funktionieren in jedem Theme.

Den Detail-Inhalt nicht doppelt ausgeben

Verwenden Sie in einem Single-Template im Site-Editor (Block-Themes) entweder den Block Release Detail / Artist Detail oder den Block Post Content (“Content”) von WordPress, nicht beide. Werden beide verwendet, wird der Release- oder Künstler-Inhalt doppelt ausgegeben.

Hinweis

Die Blöcke Gate Button, Gate Download List, Gate Download Detail und Presave Button werden nur auf Websites angezeigt, die mit einem LabelGrid-Konto mit aktivem Plan verbunden sind.

---

Elementor

Jede Funktion von LabelGrid Tools ist auch als Shortcode verfügbar, und Elementors integriertes Shortcode-Widget — Teil des kostenlosen Elementor — platziert jede davon ohne zusätzliches Add-on auf einer Seite. Die Theme Builder-Anleitung unten ist etwas anderes: Single-Templates, Anzeigebedingungen und das Post Content-Widget sind Elementor Pro-Funktionen. Mit dem kostenlosen Elementor setzen Sie stattdessen ein Shortcode-Widget auf eine beliebige Seite — und die eingebauten Release- und Künstlerseiten des Plugins werden bereits von selbst gerendert, ganz ohne Elementor-Template.

So bauen Sie Release- und Künstlerseiten mit dem Theme Builder von Elementor Pro:

1. Erstellen Sie ein Template unter Theme Builder → Single und setzen Sie dessen Anzeigebedingung auf Releases (und/oder Artists).
2. Verwenden Sie für den Release- oder Künstler-Inhalt ein Shortcode-Widget mit [labelgrid-release-detail] / [labelgrid-artist-detail] — dieser Weg rendert den Detailinhalt immer. Das Post Content-Widget rendert ihn in den meisten Setups ebenfalls. Verwenden Sie eines, niemals beide, sonst wird der Detailinhalt doppelt ausgegeben.
3. Fügen Sie Release-Raster, Banner, Künstlerlisten, Smart-Link-Buttons, Pre-Saves und Download Gates an jeder anderen Stelle Ihres Layouts mit dem Shortcode-Widget von Elementor ein.

Hinweis

Funktionen für Download Gates und Pre-Save werden nur auf Websites angezeigt, die mit einem LabelGrid-Konto mit aktivem Plan verbunden sind.

---

Eigene Theme-Vorlage für Release- und Künstlerseiten verwenden

Standardmäßig rendert das Plugin die Einzelseiten für Releases und Künstler, indem es sein eigenes Layout in den Seiteninhalt einfügt, sodass sie ohne jede Theme-Änderung funktionieren. Wenn Sie diese Seiten lieber in Ihrem Theme aufbauen möchten, kann das Plugin zurücktreten und eine klassische PHP-Vorlage sie rendern lassen.

So übernehmen Sie das Rendering in einem klassischen Theme:

1. Fügen Sie add_theme_support( 'labelgrid-tools-templates' ); in die functions.php Ihres Themes ein.
2. Fügen Sie eine klassische Vorlage single-release.php und/oder single-artist.php zu Ihrem Theme hinzu.

Wenn ein Theme sowohl die Unterstützung aktiviert als auch die passende Vorlage bereitstellt, erkennt das Plugin, dass Ihre Vorlage die Darstellung übernommen hat, und unterdrückt seine eigene Inhaltseinfügung, sodass die Seite einmal aus Ihrer Vorlage gerendert wird, ohne doppeltes Layout. Platzieren Sie den Release- oder Künstler-Inhalt mit den Blöcken Release Detail / Artist Detail oder den Shortcodes [labelgrid-release-detail] / [labelgrid-artist-detail] innerhalb Ihrer Vorlage genau dort, wo Sie ihn haben möchten.

Sie können die Aktivierung auch pro Anfrage mit dem Filter lgt_use_theme_templates umschalten. Er erhält den aktuellen Aktivierungswert und den aktuellen Beitrag und gibt true oder false zurück, sodass Sie Ihre Theme-Vorlage nur für bestimmte Releases oder Künstler aktivieren können.

Hinweis

Diese Überschreibung gilt nur für klassische PHP-Vorlagen. Die Übernahme von Release- und Künstlerseiten aus dem Site-Editor eines Block-Themes wird noch nicht unterstützt und ist als Ergänzung geplant. Websites, die die Unterstützung nicht aktivieren, sind nicht betroffen: Das eingebaute Layout wird genau wie zuvor gerendert.

---

CSS-Klassen-Referenz

Das Plugin verwendet diese CSS-Klassen-Präfixe für das Styling:

Klasse	Element
.lgsquarelist	Raster-Container für Release- und Künstlerlisten
.releaseelement	Individuelle Release- oder Künstlerkarte
.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

Shortcodes funktionieren in jedem Theme und Page-Builder. Dieselben Funktionen sind auch als native Gutenberg-Blöcke und über Elementor verfügbar, siehe Blocks (Gutenberg) und Elementor weiter oben.

---

Fehlerbehebung

Gates, Pre-Saves und Katalogsynchronisation funktionieren nicht mehr

LabelGrid akzeptiert keine API-Schlüssel mehr, die für ältere Versionen des Plugins erstellt wurden. Wenn Download Gates, Spotify-Pre-Saves oder die Katalogsynchronisation aufgehört haben zu funktionieren, ohne dass Sie etwas geändert haben, ist das fast immer die Ursache.

Die Lösung: Erstellen Sie einen neuen Schlüssel und fügen Sie ihn im Plugin ein. Die Schritte sind dieselben wie beim ersten Mal und stehen oben im Abschnitt zur Konfiguration. Ihre vorhandenen Gates und Pre-Saves behalten ihre Konfiguration, Sie müssen also nichts neu aufbauen.

Daran erkennen Sie es:

• Download Gates, Pre-Saves und die Katalogsynchronisation funktionieren nicht mehr.
• Der Tab Download Gate fehlt in den Plugin-Einstellungen. Die Funktion wurde nicht entfernt: Der Tab ist ausgeblendet, solange kein gültiger Schlüssel vorliegt, und erscheint wieder, sobald Sie einen neuen speichern.
• Version 1.6.1 zeigt eine von drei konkreten Meldungen im WordPress-Admin. Ältere Versionen, darunter 1.5.0 und 1.6.0, zeigen stattdessen eine einzelne ältere, ungenauere Meldung — LabelGrid API DEAKTIVIERT: Überprüfe, ob der API-Token korrekt ist und dein Konto für die LabelGrid-API-Services freigeschaltet ist. mit dem Link API in den Allgemeinen Einstellungen einrichten —, sind aber genauso betroffen, denn die Prüfung findet bei LabelGrid statt und nicht im Plugin.

Was die Meldungen des Plugins bedeuten

Version 1.6.1 zeigt eine von drei Meldungen. Zwei davon beginnen mit LabelGrid API DEAKTIVIERT: — lesen Sie also den ganzen Satz, bevor Sie handeln. Dieser einleitende Teil wird auf Deutsch angezeigt; der Satz danach erscheint derzeit auf Englisch und ist deshalb unten im englischen Wortlaut zitiert.

Ihr Schlüssel muss ersetzt werden:

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

Erstellen Sie mit den Schritten im Abschnitt zur Konfiguration einen neuen Schlüssel und fügen Sie ihn im Plugin ein.

Es ist noch kein Schlüssel gespeichert:

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

Erstellen Sie einen Schlüssel und fügen Sie ihn in den Plugin-Einstellungen ein.

Ein vorübergehendes Verbindungsproblem, kein Problem mit dem Schlüssel:

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.

Damit die Verbindung in jeder Version sofort erneut geprüft wird, müssen Sie etwas ändern. Die Schaltfläche Einstellungen speichern bleibt ausgegraut, bis sich eine Einstellung tatsächlich ändert, und ein erneut eingefügter identischer Schlüssel zählt nicht als Änderung. Ändern Sie also eine beliebige Einstellung, speichern Sie, stellen Sie den alten Wert wieder her und speichern Sie erneut. Log-Aufbewahrung in Tagen im Tab System eignet sich gut dafür, weil sonst nichts davon abhängt. Jedes Speichern löst eine neue Verbindungsprüfung aus, und Ihre Website bleibt am Ende genau wie vorher.

Ab Version 1.6.2 läuft auch die tägliche Hintergrundprüfung von allein wieder, solange ein Schlüssel gespeichert ist. Eine Website, deren Störung oder Ratenbegrenzung vorbei ist, erholt sich damit ohne Ihr Zutun. In 1.5.0, 1.6.0 und 1.6.1 war das nie der Fall: Hatte sich das Plugin einmal selbst deaktiviert, übersprang die tägliche Prüfung den Verbindungstest, bis jemand die Einstellungen von Hand speicherte.

Das gilt nur für Verbindungsprobleme. Ein abgelehnter Schlüssel wird in keiner Version von selbst wieder gültig, siehe weiter oben „Ihr Schlüssel muss ersetzt werden“. Bleibt das Problem bestehen, lesen Sie weiter unten den Abschnitt zu API-Verbindungsfehlern.

Releases werden nicht angezeigt

1. Gehen Sie zu LabelGrid Tools → Allgemeine Einstellungen (General Settings) — oberste Menüebene, nicht unter Einstellungen — und überprüfen Sie, ob Ihr API-Token korrekt eingegeben ist
2. Prüfen Sie, ob Auto-Sync im Tab Connection aktiviert ist
3. Warten Sie bis zu 6 Stunden auf den nächsten Synchronisationszyklus, oder deaktivieren und reaktivieren Sie das Plugin, um eine sofortige Synchronisation auszulösen
4. Stellen Sie sicher, dass die Releases in LabelGrid veröffentlicht sind (nicht im Entwurf)
5. Gehen Sie zu LabelGrid Tools → Allgemeine Einstellungen → System und erhöhen Sie die Debug-Stufe, dann prüfen Sie die Protokolle

Shortcodes werden als Klartext angezeigt

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

Styling-Probleme

1. Prüfen Sie auf CSS-Konflikte mit Ihrem Theme
2. Verwenden Sie die Entwicklertools Ihres Browsers, um die Element-Klassen zu inspizieren
3. Fügen Sie benutzerdefinierte CSS-Überschreibungen 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. Überprüfen Sie, ob Ihr API-Token gültig und nicht abgelaufen ist
2. Bestätigen Sie, dass Ihr LabelGrid-Konto aktiv ist
3. Prüfen Sie, ob Ihr Server ausgehende Anfragen an api.labelgrid.com senden kann
4. Überprüfen Sie die Plugin-Protokolle auf spezifische Fehlermeldungen

Gate-Einträge und Exporte

Download Gate Einträge (gesammelte E-Mail-Adressen) können 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

---

FAQ

„Was ist das WordPress-Plugin LabelGrid Tools?”

LabelGrid Tools ist das offizielle WordPress-Plugin von LabelGrid. Es synchronisiert Ihren Release-Katalog, Ihre Künstlerprofile und Ihre Download-Gates alle 6 Stunden automatisch aus LabelGrid auf Ihre WordPress-Website und ergänzt sie um Smart-Link-Release-Seiten, Spotify-Pre-Save-Buttons und Downloads hinter einem Gate. Sie finden es im WordPress-Plugin-Verzeichnis.

„Brauche ich einen kostenpflichtigen Plan oder einen API-Plan für das WordPress-Plugin?”

Nein – LabelGrid Tools steht allen LabelGrid-Konten ohne zusätzliche Kosten zur Verfügung, und ein API-Plan ist nicht erforderlich. Die Gate-Funktionen, die es mitbringt, sind in allen Standard- und API-Plänen enthalten, und für Nutzer, die nur die WordPress-Integration ohne Vertrieb möchten, gibt es einen eigenständigen Gate-Plan.

„Wie installiere und verbinde ich das Plugin?”

Installieren Sie LabelGrid Tools in WordPress unter Plugins → Installieren, und aktivieren Sie es anschließend. Öffnen Sie in LabelGrid Ihr Benutzermenü → Wordpress → Configure Plugin, erstellen Sie einen Autorisierungsschlüssel für Ihre Domain und fügen Sie das Access-Token in den Plugin-Einstellungen im Tab Connection ein. Jeder Schlüssel gilt für genau eine Domain.

„Wie oft synchronisiert das Plugin meinen Katalog?”

Das Plugin synchronisiert Ihre Releases, Künstler und Download-Gates alle 6 Stunden aus LabelGrid. LabelGrid ist die Quelle der Wahrheit, nehmen Sie Katalogänderungen also immer in LabelGrid vor – Änderungen direkt an den synchronisierten WordPress-Beiträgen werden bei der nächsten Synchronisation überschrieben.

„Kann ich mit dem Plugin Spotify-Pre-Saves auf meiner Website anbieten?”

Ja. Aktivieren Sie Spotify-Pre-Save in den Plugin-Einstellungen im Tab Release Pages und platzieren Sie den Shortcode [labelgrid-presave-button] bei einem kommenden Release. Besucher können das Release vorab speichern und optional dem Künstler und einer Playlist folgen, und Sie können während des Pre-Save-Vorgangs E-Mail-Adressen sammeln.

„Kann ich Gutenberg-Blöcke oder Elementor verwenden oder nur Shortcodes?”

Alle drei. Seit Version 1.5.0 ist jede Funktion als Shortcode, als nativer Gutenberg-Block (im Block-Inserter unter der Kategorie LabelGrid Tools) und über Elementor mit dessen Shortcode-Widget verfügbar. Jeder Block erzeugt dieselbe Ausgabe wie sein passender Shortcode, und Shortcodes funktionieren weiterhin in jedem Theme.

---

Weiterführend

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

---

Brauchen Sie Hilfe?

Wenn Sie Unterstützung beim WordPress Plugin benötigen, kontaktieren Sie unser Support-Team mit Details zu Ihrer WordPress-Version, PHP-Version und etwaigen Fehlermeldungen aus den Plugin-Protokollen.