So übermitteln Sie Plugins an das WordPress.org-Repository

Veröffentlicht: 2021-06-02

Das 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 im tags -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.

Buchumschlag
Buchumschlag

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!