So übermitteln Sie Plugins an das WordPress.org-Repository
Veröffentlicht: 2021-06-02Das Hosten eines Plugins im WordPress.org-Repository ist eine der beliebtesten (und effektivsten) Möglichkeiten, ein erfolgreiches Freemium-Geschäft zu starten. Wenn Sie zum ersten Mal ein Plugin an das Repository senden, können einige der Schritte unklar oder verwirrend sein, weshalb ich den Prozess skizziert habe, um Sie zu führen. Ich würde auch empfehlen, diese Seite mit einem Lesezeichen zu versehen, wenn Sie in Zukunft darauf verweisen müssen.
Vorbereitung für die Einreichung
Zunächst einmal müssen Sie die Genehmigung des Plugin-Überprüfungsteams einholen, um Ihr Produkt im Repository zu hosten. Dazu benötigen Sie ein Konto auf WordPress.org. Sie haben keine? Keine Sorge – hier können Sie sich anmelden.
Erstellen der Readme.txt-Datei des Plugins
Als Nächstes müssen Sie eine readme.txt-Datei im Markdown-Format erstellen, die für die Auflistungsseite Ihres Plugins auf WordPress.org verwendet wird. Es muss folgende Informationen enthalten:
- Plugin-Name
- Mitwirkende (Ihre WordPress.org-Benutzer-ID)
- Plugin-Tags
- Benötigt mindestens (WordPress-Version)
- Getestet bis (WordPress-Version)
- Stable-Tag (Plugin-Version)
- Lizenz (GPLv2 oder höher)
- Lizenz-URI: www.gnu.org/licenses/gpl-2.0.html
- Beschreibung (vollständige Beschreibung Ihres Plugins)
- Häufig gestellte Fragen
- Screenshots
- Änderungsprotokoll
Als Referenz finden Sie hier eine standardmäßige readme.txt-Dateivorlage.
Um sicherzustellen, dass Sie die readme.txt-Datei Ihres Plugins korrekt formatiert und strukturiert haben, verwenden Sie den WordPress Readme Validator.
Wählen Sie Ihren Plugin-Namen sorgfältig aus
Es ist wichtig, dass Sie sich vor der ersten Einreichung die Zeit nehmen, den „richtigen“ Plugin-Namen auszuwählen, da er sich auf die Auflistungs-URL Ihres Plugins auswirkt, was sich auf die SEO Ihres WordPress.org-Eintrags und schließlich auf die organische Präsenz und das Wachstum des Plugins auswirkt.
Hier ist der relevante Abschnitt, der die Auswirkungen des Namens auf der Plugin-Einreichungsseite behandelt:
Die URL Ihres Plugins wird basierend auf dem Wert des Plugin Name
in Ihrer Haupt-Plugin-Datei (derjenigen mit den Plugin-Headern) ausgefüllt. Wenn Sie Ihren als Plugin Name: Boaty McBoatface
dann lautet Ihre URL https://wordpress.org/plugins/boaty-mcboatface
und Ihr Slug ist beispielsweise boaty-mcboatface
. Wenn es ein bestehendes Plugin mit Ihrem Namen gibt, dann sind Sie boaty-mcboatface-2
und so weiter. Es verhält sich genau wie WordPress-Beitragsnamen.
Wenn Sie also den ursprünglichen Namen wählen, denken Sie daran, ihn eher für SEO als für Branding zu optimieren. Fragen Sie sich, auf welche Keywords Sie abzielen möchten, und extrapolieren Sie den Namen daraus. Einige Namenstipps finden Sie hier.
Denken Sie daran, dass Sie den Namen des Plugins nach der ersten Übermittlung jederzeit ändern können – selbst wenn Sie einen Namen wählen, der Ihnen nicht gefällt, können Sie ihn später ändern (und so oft Sie möchten). Was Sie nicht ändern können, ist der Slug des Plugins, daher ist die anfängliche Benennung wichtig.
Beachten Sie auch, dass der Slug aus dem Plugin-Namen in Ihrer Haupt-Plugin-Datei erstellt wird, der sich vom Wert des Plugin-Namens in der readme.txt-Datei unterscheiden kann.
Übermittlung Ihres Plugins
Sobald Sie sich für einen guten SEO-Namen entschieden haben – und Ihr Plugin und Ihre readme.txt-Datei fertig sind – gehen Sie zur Seite Add Your Plugin und reichen Sie es zur Überprüfung ein.
Der Überprüfungsprozess ist manuell und kann zwischen 1 und 10 Tagen dauern, abhängig von der Überprüfungswarteschlange und der Komplexität Ihres Plugins. Wenn Probleme gefunden werden, erhalten Sie eine E-Mail, in der diese Probleme detailliert beschrieben werden und wie Sie sie beheben können.
Sobald die Probleme behoben sind (falls vorhanden), erhalten Sie eine Genehmigung per E-Mail. Ihr Plugin ist zu diesem Zeitpunkt nicht öffentlich, aber Sie können trotzdem Dateien über die Befehlszeile oder einen SVN-Client hochladen, bearbeiten und löschen.
Tipp: Um sicherzustellen, dass Sie keine wichtigen E-Mails verpassen, empfehle ich, [email protected] auf die Whitelist zu setzen, die E-Mail-Adresse, die vom WordPress.org-Plugin-Überprüfungsteam für die Kommunikation mit Plugin-Entwicklern verwendet wird.
Hochladen des Plugins
Nachdem Ihnen nun Zugriff auf das SVN-Repository gewährt wurde, besteht der nächste Schritt darin, Ihr Plugin in das WordPress.org-Repository hochzuladen. Bevor Sie dies tun, empfehlen wir Ihnen, sich mit den Grundlagen der Verwendung von Subversion mit WordPress vertraut zu machen.
Ich verwende für dieses Tutorial die Befehlszeilenschnittstelle. Wenn Sie kein Fan davon sind und lieber mit einem visuellen Client arbeiten, ziehen Sie TortoiseSVN für Windows und Cornerstone für Mac in Betracht.
Bevor Sie die Plugin-Dateien in das SVN-Repository hochladen können, müssen Sie einen lokalen Ordner erstellen, in dem die Dateien und Assets gespeichert werden. Dieser Befehl erstellt ein lokales Verzeichnis:
$ mkdir my-awesome-plugin
Aus Konsistenzgründen empfiehlt es sich, den Ordner und die Haupt-PHP-Datei des Plugins nach dem Slug zu benennen, der Ihnen nach der ersten Übermittlung zugewiesen wurde. In diesem Beispiel gehe ich davon aus, dass der Name Ihres Plugins My Awesome Plugin
und Ihr genehmigter Slug my-awesome-plugin
ist.
Nun, um das vorgefertigte Repository anzuzeigen und herunterzuladen:
$ svn checkout https://plugins.svn.wordpress.org/my-awesome-plugin local/path/to/my-awesome-plugin
Dies ergibt die folgende Rückgabe:
A my-awesome-plugin/branches A my-awesome-plugin/tags A my-awesome-plugin/trunk Checked out revision #####
Hier bedeutet A
, dass die Verzeichnisse aus dem zentralen Repository zum lokalen Ordner hinzugefügt wurden. Als nächstes müssen Sie die Dateien und Ordner Ihres Plugins in den trunk
kopieren:
$ rsync -r local/path/to/wordpress/wp-includes/plugins/my-awesome-plugin/* local/path/to/my-awesome-plugin/trunk
Und fügen Sie sie dem Repository hinzu.
$ svn add trunk/*
Im Gegenzug werden Sie aufgefordert, sich zu authentifizieren. Sobald Sie eingeloggt sind, erhalten Sie eine Antwort, die in etwa so aussehen wird:
A trunk/my-awesome-plugin.php A trunk/readme.txt
Wichtig: WordPress.org behandelt den trunk
als Ordner der obersten Ebene deines Plugins. Kopieren Sie daher nicht den gesamten Plugin-Ordner wie er ist, der trunk
sollte nur den Inhalt des Plugins enthalten.
Vermeiden Sie dies: trunk/my-awesome-plugin/my-awesome-plugin.php
Nachdem Sie alle Dateien hinzugefügt haben, übertragen Sie die Änderungen zurück in das zentrale Repository:
$ svn commit -m 'My first plugin version'
Dies gibt die folgende Antwort zurück:
Adding trunk/my-awesome-plugin.php Adding trunk/readme.txt Transmitting file data. Committed revision 9999999.
Um ein Plugin-Symbol, Banner und Screenshots hochzuladen, können Sie einen neuen Assets-Ordner in Ihrem lokalen SVN-Repository erstellen:
$ mkdir local/path/to/my-awesome-plugin/assets
Hier erfahren Sie, wie Plugin-Assets funktionieren.
Sobald Sie Ihre Assets bereit haben, fügen Sie die Plugin-Assets zum SVN-Repository hinzu:
$ svn add assets/*
Übernehmen Sie die Änderungen erneut:
$ svn commit -m 'Assets upload'
Das ist es! Ihr Plugin steht jetzt zum Download bereit und Sie können damit beginnen, es zu bewerben.
Veröffentlichen einer Neuerscheinung
Für die nächste Update-Version Ihres Plugins sind die Schritte etwas anders. Aktualisieren Sie vor der Veröffentlichung der neuen Version das Feld Stable Tag
in der trunk/readme.txt file
und die Versionsnummer im Header-Kommentar des Plug-ins. Sobald Sie Ihre Plugin-Dateien bereit haben, kopieren Sie sie in einen Unterordner von /tags und setzen Sie den Namen des Unterordners auf die neue Version, z. B. 1.0.1 .
$ svn copy trunk tags/1.0.1 A tags/1.0.1
Übernehmen Sie die Änderungen.
$ svn commit -m 'Version 1.0.1 release' Adding tags/1.0.1 Adding tags/1.0.1/my-awesome-plugin.php Adding tags/1.0.1/readme.txt Committed revision 999999.
Und schon ist die neue Version Ihres Plugins fertig!
Tipps zum Release-Management
- Ab dem Zeitpunkt der Veröffentlichung einer neuen Version und dem Zeitpunkt, an dem sie auf Ihrer WordPress.org-Plug-in-Listenseite zum Download verfügbar ist, kann es zu Verzögerungen kommen. Warten Sie ein paar Stunden, und wenn Sie es immer noch nicht sehen, können Sie eine E-Mail an [email protected] senden, da das System von Zeit zu Zeit Probleme hat.
- Als Faustregel zur Reduzierung von Synchronisierungsproblemen wird empfohlen, dass die Plugin-Version in Ihrem
trunk
mit der Plugin-Version in Ihrer neuesten Version imtags
-Ordner identisch ist.
Was kommt als nächstes?
Entwickler von kostenlosen Plugins sind von Natur aus motiviert und leidenschaftlich dabei, Dinge beizutragen, die für die Welt nützlich sind. Wir möchten vor allem, dass unsere Produkte spezifische Probleme lösen, die Menschen möglicherweise haben. Aber unabhängig davon, wie großartig Ihr Plugin ist, wird es nicht viel helfen, wenn die Leute es nicht finden können.
Ein guter nächster Schritt zur Verbesserung der Sichtbarkeit Ihres kostenlosen Plugins besteht darin, die readme.txt-Datei für SEO zu optimieren, was wir hier untersuchen.
Wenn Sie mit Ihrem Plugin Geld verdienen möchten, reicht es nicht aus, Ihr Produkt kostenlos online zu haben – Sie möchten, dass die Leute es entdecken, verwenden, lieben und (hoffentlich) auf Ihre kostenpflichtige Version upgraden! Heutzutage trägt ein WordPress-Entwickler viele Aufgaben, vom Produkthersteller über den Geschäftsinhaber bis hin zum Vermarkter, und um Ihr Plugin von den richtigen Leuten sehen zu lassen, müssen Sie Ihre Marketingfähigkeiten entwickeln und verfeinern.
Das ist ein Thema, das wir mit unserem Marketing-Handbuch für WordPress-Produkthersteller eingehend untersuchen. Ich empfehle auch dringend, sich den folgenden Spickzettel für den Verkauf von WordPress-Plugins und -Themen anzusehen – es ist eine prägnante, umsetzbare Roadmap für den Aufbau eines erfolgreichen WordPress-Geschäfts, von der Idee über den Start bis hin zum Wachstum.
Holen Sie sich ein kostenloses Exemplar unserer
Spickzettel für den Verkauf von Themes und Plugins
Eine Wachstums-Roadmap mit prägnanten, umsetzbaren Tipps für jeden Meilenstein der WordPress-Produktentwicklung.
Teilen Sie mit einem Freund
Geben Sie die E-Mail-Adresse Ihres Freundes ein. Wir schicken ihnen nur dieses Buch per E-Mail, Scout's Ehre.
Ich danke Ihnen für das Teilen
Super – eine Kopie von „Cheat Sheet for Selling Themes and Plugins“ wurde gerade an gesendet . Möchten Sie uns helfen, das Wort noch mehr zu verbreiten? Los, teilen Sie das Buch mit Ihren Freunden und Kollegen.
Danke fürs Abonnieren!
- wir haben gerade Ihre Kopie von 'Cheat Sheet for Selling Themes and Plugins' an gesendet .
Haben Sie einen Tippfehler in Ihrer E-Mail? Klicken Sie hier, um die E-Mail-Adresse zu bearbeiten und erneut zu senden.
Planen Sie, ein Plugin im WordPress.org-Repository einzureichen? Denken Sie darüber nach, das Freemium-Geschäftsmodell zu nutzen? Ton aus in den Kommentaren unten!