Sie haben ein Premium-Theme auf ThemeForest gekauft, Ihre Website gestartet, alles funktioniert. Ein halbes Jahr vergeht, und im Admin-Bereich erscheint eine Benachrichtigung: Das Theme ist veraltet, zusammen mit ein paar kritischen Sicherheitslücken. Das manuelle Aktualisieren per ZIP-Download von ThemeForest, Hochladen und Ersetzen der Dateien ist ein Szenario, das wirklich frustriert. Besonders, wenn Sie mehr als ein Theme betreiben.

Bisher gab es dafür das Envato WordPress Toolkit, ein kleines Plugin, das Ihre Käufe von ThemeForest abrief und Themes mit wenigen Klicks aktualisierte. Envato hat es jedoch offiziell durch das Envato Market-Plugin ersetzt, das moderner ist und auf OAuth-Token-Authentifizierung statt auf veralteten API-Schlüsseln basiert. Das alte Toolkit wanderte ins GitHub-Archiv und wird nicht mehr unterstützt.

Diese Anleitung beschreibt die schrittweise Einrichtung von Envato Market von Grund auf: von der Erstellung eines persönlichen Tokens bis hin zu automatischen Theme-Updates, einschließlich Besonderheiten für diejenigen, die vom alten Toolkit umsteigen.

💡 Kurzer Überblick:

• Erstellen Sie einen persönlichen Envato-Token in Ihren ThemeForest-Kontoeinstellungen
• Laden Sie das Envato Market-Plugin aus dem offiziellen GitHub-Repository herunter und installieren Sie es
• Geben Sie Token und Benutzernamen ein, und das Plugin ruft automatisch alle gekauften Themes ab
• Aktualisieren Sie Themes mit einem Klick direkt aus dem WordPress-Adminbereich

Was mit dem alten Envato Toolkit geschah

Falls Sie noch das Envato WordPress Toolkit verwenden, ist es Zeit für einen Wechsel. Das Plugin wurde aus der offiziellen Unterstützung genommen: Sein GitHub-Repository wurde nach envato-archive verschoben, und der von ihm genutzte API-Schlüssel-Mechanismus wurde als unsicher eingestuft. Envato ist vollständig auf persönliche Token per OAuth umgestiegen, die an einen bestimmten Berechtigungssatz gebunden sind, jederzeit widerrufen werden können und nicht wie die alten Schlüssel über Server-Logs „durchsickern".

Das neue Plugin, Envato Market, befindet sich in einem aktiven Repository und erhält regelmäßig Updates. Es sieht ähnlich aus: dieselbe Integration in den Admin-Bereich, dieselbe Kaufliste. Unter der Haube stecken jedoch eine moderne Authentifizierung und ein zuverlässigerer Mechanismus zur Update-Prüfung.

Erstellung eines persönlichen Envato-Tokens

Ein persönlicher Token ist der neue Envato-API-Authentifizierungsstandard, der die alten 32-stelligen Schlüssel ersetzt. Sie müssen ihn vor der Installation des Plugins erstellen: Das Envato-System verarbeitet neue Token nicht sofort, und das Plugin erkennt ihn in den ersten Minuten möglicherweise nicht.

Gehen Sie zu build.envato.com, melden Sie sich mit Ihrem ThemeForest-Konto an und klicken Sie auf Create a token. Geben Sie dem Token einen aussagekräftigen Namen, zum Beispiel „Auto-Update Themes auf Kunden-Website", und setzen Sie die Berechtigungen:

• View and search Envato sites, erforderlich
• View your Envato account username, erforderlich
• View your purchases, erforderlich
• Verify purchases, optional, aber nützlich für Themes mit Lizenzsystemen
• Lassen Sie die übrigen Berechtigungen deaktiviert

Kopieren Sie den Token nach der Erstellung. Anders als der alte API-Schlüssel wird der Token nur einmal angezeigt. Wenn Sie den Tab schließen, verlieren Sie den Zugriff darauf. Speichern Sie ihn in einem Passwort-Manager.

Herunterladen und Installieren des Envato Market-Plugins

Anders als übliche Plugins ist Envato Market nicht im Katalog von wordpress.org gelistet. Es wird ausschließlich über GitHub vertrieben. Gehen Sie zu envato.github.io/wp-envato-market und laden Sie die ZIP-Datei aus dem docs/-Ordner herunter.

Wichtig: Klicken Sie nicht auf „Download ZIP" auf der Hauptseite des GitHub-Repositorys. Das Archiv heißt dann wp-envato-market-master, und WordPress erkennt es nicht als Plugin. Besorgen Sie sich die ZIP-Datei speziell aus dem docs/-Ordner, die korrekt gepackt ist.

Fahren Sie dann mit der Standardinstallation fort:

• Gehen Sie im WordPress-Adminbereich zu Plugins → Installieren.
• Klicken Sie auf Plugin hochladen und wählen Sie die heruntergeladene ZIP-Datei aus.
• Klicken Sie auf Jetzt installieren, dann auf Aktivieren.

Nach der Aktivierung erscheint der Menüpunkt Envato Market im Seitenleistenmenü des Adminbereichs.

Konfiguration: Verknüpfung des Tokens mit Ihren Käufen

Öffnen Sie Envato Market im Adminbereich. Sie sehen zwei Felder: Envato-Benutzername und persönlicher Token. Fügen Sie den im vorherigen Schritt kopierten Token ein, geben Sie Ihren ThemeForest-Login ein und klicken Sie auf Änderungen speichern.

Das Plugin fragt die Envato-API ab und zeigt eine Liste aller mit diesem Konto gekauften Themes und Plugins an. Ist die Liste leer, warten Sie 10 bis 15 Minuten und aktualisieren Sie die Seite. Envato benötigt Zeit, um einen frischen Token durch seine Infrastruktur „einzubrennen". Hilft das nicht, überprüfen Sie, ob der Token die Berechtigung „View your purchases" aktiviert hat und ob Sie mit genau dem Konto angemeldet sind, mit dem Sie die Themes gekauft haben.

Ein Hinweis für Betreiber mehrerer Websites: Sie können einen separaten Token für jede Domain oder einen globalen Token erstellen. Ein globaler ist bequemer: Fügen Sie ihn auf allen Websites ein, und jedes Theme erkennt seine Lizenz. Wenn Sie die Website jedoch an einen Kunden übergeben, ist es besser, den globalen Token zu widerrufen und einen eingeschränkten für die spezifische Domain auszustellen.

Automatische Theme-Updates

Nach der Verknüpfung des Tokens zeigt der Tab Themes eine Liste der gekauften Themes mit ihren aktuellen Versionen an. Ist für ein Theme ein Update verfügbar, erscheint daneben die Schaltfläche Update verfügbar.

Klicken Sie darauf, und WordPress führt den Standard-Update-Mechanismus aus: lädt die aktuelle ZIP-Datei von den Envato-Servern herunter, entpackt sie und ersetzt die Theme-Dateien.

Vor dem Update gibt es einen wichtigen Punkt bezüglich Anpassungen. Wenn Sie Theme-Dateien direkt bearbeitet haben (Styles, Templates, functions.php), werden diese durch das Update überschrieben, und alle Änderungen gehen verloren. Dies betrifft nicht die Einstellungen, die Sie über den WordPress Customizer oder das Theme-Options-Panel vorgenommen haben: Diese sind in der Datenbank gespeichert und bleiben erhalten.

Der korrekte Ansatz ist ein Child-Theme. Verlagern Sie alle Code-Änderungen dorthin und fassen Sie das Parent-Theme nie an. Dann wird die Schaltfläche „Update verfügbar" sicher, und Sie können sie ohne Angst vor dem Verlust Ihrer Anpassungen anklicken.

Das Plugin fügt außerdem eine automatische Update-Prüfung hinzu: WordPress fragt regelmäßig die Envato-API ab und zeigt Benachrichtigungen über neue Versionen direkt im üblichen Update-Bereich an.

⁉️🤔 Häufig gestellte Fragen

Wie unterscheidet sich ein persönlicher Token vom alten API-Schlüssel?

Ein persönlicher Token funktioniert über OAuth. Sie legen spezifische Berechtigungen fest, können den Token jederzeit widerrufen, und er erscheint nicht in URL-Anfragen. Der alte API-Schlüssel war eine einzelne, dauerhafte Zeichenkette ohne granulare Rechte. Envato hat die Generierung neuer Schlüssel eingestellt, und alle neuen Integrationen funktionieren nur noch über Token.

Kann ich das alte Envato Toolkit weiterverwenden?

Technisch ja, wenn Sie es bereits installiert haben und es funktioniert. Aber das Plugin wurde seit 2021 nicht mehr aktualisiert, sein Repository ist archiviert, und Envatos Infrastruktur stellt die Unterstützung alter API-Schlüssel schrittweise ein. Früher oder später wird das Toolkit keine Käufe mehr abrufen. Es ist besser, jetzt umzusteigen, solange es noch funktioniert, als in Panik zu geraten, wenn ein Theme nicht mehr aktualisiert wird.

Das Envato Market-Plugin zeigt meine Käufe nicht an. Was soll ich tun?

Der häufigste Grund ist, dass der Token unter einem anderen Envato-Konto erstellt wurde (viele Leute haben mehrere Konten für verschiedene Marktplätze). Überprüfen Sie, ob Sie mit genau dem Konto angemeldet sind, mit dem Sie die Themes gekauft haben. Der zweite Grund: Ein frischer Token wurde noch nicht verarbeitet. Warten Sie 15 bis 30 Minuten. Der dritte Grund: Der Token hat die Berechtigung „View your purchases" nicht aktiviert.

Muss ich Envato Market auf jeder Website separat installieren?

Ja, das Plugin arbeitet pro Website, und jede Website benötigt ihre eigene Aktivierung. Sie können denselben Token auf allen Websites verwenden (er ist an das Konto gebunden, nicht an die Domain), aber das Plugin wird auf jeder Website unabhängig installiert und konfiguriert.

Was passiert mit Theme-Anpassungen nach einem automatischen Update?

Die Dateien des Parent-Themes werden vollständig überschrieben. Einstellungen aus dem Customizer und dem Theme-Options-Panel bleiben erhalten, da sie in der Datenbank liegen. Code-Änderungen, die direkt in Theme-Dateien vorgenommen wurden, gehen verloren. Nutzen Sie ein Child-Theme für jegliche Code-Änderungen. Dies ist eine Best Practice, nicht nur eine Empfehlung.

Sollten Sie jetzt vom Envato Toolkit umsteigen

Wenn Sie noch das alte Toolkit verwenden, steigen Sie noch heute um. Der Vorgang dauert 10 Minuten: Deaktivieren Sie das Toolkit, installieren Sie Envato Market, fügen Sie den Token ein. Das Erstellen eines Tokens dauert eine Minute, die Installation des Plugins ein paar weitere Minuten, und alles funktioniert.

Der Hauptvorteil ist nicht, dass „das Alte noch funktioniert". Der Vorteil ist, dass das neue Plugin eine Infrastruktur nutzt, die Envato aktiv entwickelt und unterstützt. Das alte Toolkit ist eine Sackgasse, und die Frage ist nicht „ob es kaputtgeht", sondern „wann". Das passiert meist im ungünstigsten Moment, wenn ein Theme-Update veröffentlicht wird, das eine Sicherheitslücke schließt, und Sie nicht aktualisieren können.

Nehmen Sie sich 10 Minuten Zeit, installieren Sie Envato Market und vergessen Sie manuelle Theme-Updates für immer.