Entwickler sind willkommen und ermutigt, ihre eigenen Erweiterungen für Easy Digital Downloads (EDD) zu erstellen und sie mit anderen Shop-Betreibern zu teilen. Ein paar einfache Richtlinien sorgen dafür, dass Ihre Erweiterung leicht zu finden ist, klar von unseren offiziellen Funktionen getrennt ist und mit dem Rest der EDD-Administration konsistent ist.
Diese Anleitung beschreibt, wie Sie Ihre Erweiterung benennen, die EDD-Marke verwenden und Ihre Einstellungen platzieren.
Hinweis: Die Einstellungs-Hooks in dieser Anleitung sind Teil von Easy Digital Downloads selbst. Sie können sie mit dem kostenlosen Plugin und ohne Pass darauf aufbauen. Diese Anleitung ist für Entwickler. Wenn Sie nach Funktionen suchen, die Sie Ihrem eigenen Shop hinzufügen möchten, beginnen Sie mit den offiziellen in Ihrem Menü Downloads » Erweiterungen.
Stellen Sie vor Beginn sicher, dass Easy Digital Downloads auf der WordPress-Seite, auf der Sie entwickeln, installiert und aktiviert ist.
Benennung Ihrer Erweiterung
Ein klarer Name teilt Shop-Betreibern sofort mit, dass Ihre Erweiterung mit EDD funktioniert und dass sie von Ihnen und nicht von uns stammt.
Benennen Sie Drittanbieter-Erweiterungen im Format "Erweiterungsname für Easy Digital Downloads". Viele Plugin-Ökosysteme verwenden dieses Muster, sodass Shop-Betreiber es bereits erkennen.
Bitte verwenden Sie nicht "Easy Digital Downloads – Erweiterungsname". Dieses Format ist für unsere offiziellen Erweiterungen reserviert, und die Verwendung lässt Ihre Erweiterung wie eine unserer eigenen aussehen.
Verwendung der Easy Digital Downloads Marke
Wenn die Seite, Listung oder Screenshots Ihrer Erweiterung Easy Digital Downloads erwähnen, verwenden Sie bitte unsere offiziellen Logos und Farben. Sie finden sie zusammen mit unseren Markenrichtlinien auf unserer Seite Presse- und Marken-Assets.
Diese Seite behandelt auch, wie unser Name geschrieben wird. Easy Digital Downloads sind immer 3 Wörter, mit einem großen E, D und D. Die Abkürzung EDD ist auch in Ordnung.
Befolgen der WordPress.org Plugin-Richtlinien
Jedes Plugin muss die offiziellen Richtlinien für Plugins von WordPress.org befolgen. Für EDD-Erweiterungen ist die wichtigste davon Richtlinie 17: Plugins müssen Marken, Urheberrechte und Projektnamen respektieren.
Diese Richtlinie erlaubt es nicht, dass ein Plugin-Slug mit dem Namen eines anderen Produkts beginnt, es sei denn, Sie besitzen oder vertreten dieses Produkt. Ein Slug wie ihre-erweiterung-fuer-easy-digital-downloads folgt der Regel und entspricht dem obigen Namensformat.
Hinzufügen Ihrer Einstellungen zum Erweiterungs-Tab
Shop-Besitzer erwarten, die Einstellungen der Erweiterung an einem Ort zu finden. Platzieren Sie Ihre EDD-spezifischen Einstellungen in einem eigenen Abschnitt unter Downloads » Einstellungen » Erweiterungen, anstatt eine separate Menü- oder Einstellungsseite hinzuzufügen.
Jede Erweiterung, die Einstellungen registriert, erhält einen eigenen Link oben im Tab Erweiterungen. In diesem Beispiel haben 2 Erweiterungen ihre eigenen Abschnitte hinzugefügt, genannt Rabatte Pro und Dropbox.
Der Tab Erweiterungen erscheint erst, wenn mindestens eine Erweiterung Einstellungen registriert hat. In einem Shop ohne Erweiterungen sehen Sie den Tab überhaupt nicht.
Seit Version 3.7 registriert EDD seine eigenen Hooks über Event-Subscriber-Klassen, und Ihre Erweiterung kann dasselbe tun. Ihre Einstellungsklasse abonniert 2 Filter:
edd_settings_sections_extensions: fügt Ihren Abschnittslink zum Tab Erweiterungen hinzu. Fügen Sie einen Eintrag zum Array hinzu, verwenden Sie einen eindeutigen Schlüssel und die Bezeichnung, die Shop-Besitzer sehen werden.edd_settings_extensions: fügt Ihre Einstellungen zum Tab hinzu. Geben Sie Ihre Einstellungen verschachtelt unter demselben Schlüssel zurück, den Sie für den Abschnitt verwendet haben, damit EDD sie in Ihrem Abschnitt platziert.
3rd-Party-Erweiterungen sollten Ihre EDD-spezifischen Einstellungen unter Downloads → Einstellungen → Erweiterungen → Ihr Erweiterungsname platzieren. Um ein Beispiel dafür zu sehen, wie Sie Ihre Untersektion und Einstellungen registrieren können, können Sie sich auf diesen Gist beziehen:
EDD speichert diese Einstellungen zusammen mit seinen übrigen Optionen. Um einen Wert in Ihrem Code zu lesen, verwenden Sie edd_get_option( 'myext_enable_feature' ).
Jede Einstellung benötigt eine id, einen name und einen type. Gängige Typen sind checkbox_toggle, text, textarea, select, rich_editor und header. Sie können auch einen Standardwert mit std festlegen.
Um beide Dateien zu kopieren, siehe das Beispiel-Gist auf GitHub.
Das ist alles! Sie wissen jetzt, wie Sie Ihre Erweiterung benennen, branden und einrichten, damit sie perfekt zu Easy Digital Downloads passt. Um mehr über das Erstellen auf EDD zu erfahren, siehe die Einführung für Entwickler in Easy Digital Downloads.
FAQ zur EDD-Erweiterungsentwicklung
Unten beantworten wir einige der häufigsten Fragen zum Erstellen von Drittanbieter-Erweiterungen für EDD.
Benötige ich einen Pass, um eine Erweiterung zu erstellen?
Nein. Der Einstellungs-Tab und die Hooks in dieser Anleitung sind Teil des kostenlosen Easy Digital Downloads Plugins.
Warum sehe ich keinen Tab „Erweiterungen“ in meinen Einstellungen?
Der Tab erscheint erst, wenn eine Erweiterung mindestens eine Einstellung registriert. Nachdem Ihr Code einen Abschnitt und seine Einstellungen hinzugefügt hat, wird der Tab „Erweiterungen“ unter Downloads » Einstellungen angezeigt.
Wird das EDD-Team meine Erweiterung unterstützen?
Nein. Drittanbieter-Erweiterungen werden von den Entwicklern unterstützt, die sie erstellen. Ihre Kunden benötigen einen klaren Weg, um Sie um Hilfe zu erreichen.
Kann ich den Namen meiner Erweiterung mit Easy Digital Downloads beginnen lassen?
Bitte nicht. Namen, die mit „Easy Digital Downloads“ beginnen, sind für unsere offiziellen Erweiterungen reserviert. WordPress.org erlaubt es auch nicht, dass ein Plugin-Slug mit dem Namen eines anderen Produkts beginnt. Verwenden Sie stattdessen das Format „Name der Erweiterung für Easy Digital Downloads“.
