Ontwikkelaars zijn welkom en worden aangemoedigd om hun eigen extensies voor Easy Digital Downloads (EDD) te bouwen en deze te delen met andere winkelbeheerders. Een paar eenvoudige richtlijnen zorgen ervoor dat uw extensie gemakkelijk te vinden is, duidelijk gescheiden is van onze officiële functies en consistent is met de rest van de EDD-admin.
Deze handleiding behandelt hoe u uw extensie een naam geeft, het EDD-merk gebruikt en uw instellingen plaatst.
Opmerking: De instellingshooks in deze handleiding maken deel uit van Easy Digital Downloads zelf. U kunt erop voortbouwen met de gratis plugin en zonder pas. Deze handleiding is voor ontwikkelaars. Als u op zoek bent naar functies om aan uw eigen winkel toe te voegen, begin dan met de officiële functies in uw Downloads » Extensies menu.
Zorg ervoor dat Easy Digital Downloads is geïnstalleerd en geactiveerd op de WordPress-site waarop u ontwikkelt, voordat u begint.
Uw extensie een naam geven
Een duidelijke naam vertelt winkelbeheerders meteen dat uw extensie werkt met EDD, en dat deze van u komt in plaats van van ons.
Geef extensies van derden een naam met het formaat "Extensienaam voor Easy Digital Downloads". Veel plugin-ecosystemen gebruiken dit zelfde patroon, dus winkelbeheerders herkennen het al.
Gebruik alsjeblieft niet "Easy Digital Downloads – Extensienaam". Dat formaat is gereserveerd voor onze officiële extensies, en het gebruik ervan zorgt ervoor dat uw extensie op een van de onze lijkt.
Het Easy Digital Downloads-merk gebruiken
Als de pagina, vermelding of screenshots van uw extensie Easy Digital Downloads vermelden, gebruik dan onze officiële logo's en kleuren. U vindt ze, samen met onze merkrichtlijnen, op onze Pers- en merkassets-pagina.
Die pagina behandelt ook hoe u onze naam schrijft. Easy Digital Downloads bestaat altijd uit 3 woorden, met een hoofdletter E, D en D. Het afkorten tot EDD is ook prima.
De richtlijnen voor WordPress.org-plugins volgen
Elke plugin moet de officiële richtlijnen van WordPress.org voor plugins volgen. Voor EDD-extensies is de belangrijkste Richtlijn 17: Plugins moeten handelsmerken, auteursrechten en projectnamen respecteren.
Die richtlijn staat niet toe dat de slug van een plugin begint met de naam van een ander product, tenzij je dat product bezit of vertegenwoordigt. Een slug zoals your-extension-for-easy-digital-downloads volgt de regel en komt overeen met het bovenstaande naamgevingsformaat.
Uw instellingen toevoegen aan de Extensies-tab
Winkel eigenaren verwachten instellingen voor extensies op één plek te vinden. Plaats je EDD-specifieke instellingen in hun eigen sectie onder Downloads » Instellingen » Extensies, in plaats van een aparte menu- of instellingenpagina toe te voegen.
Elke extensie die instellingen registreert, krijgt een eigen link bovenaan het tabblad Extensies. In dit voorbeeld hebben 2 extensies hun eigen secties toegevoegd, genaamd Kortingen Pro en Dropbox.
Het tabblad Extensies verschijnt pas zodra er ten minste één extensie instellingen heeft geregistreerd. In een winkel zonder extensies zie je het tabblad helemaal niet.
Sinds versie 3.7 registreert EDD zijn eigen hooks via event subscriber classes, en jouw extensie kan hetzelfde doen. Jouw instellingenklasse abonneert zich op 2 filters:
edd_settings_sections_extensions: voegt je sectielink toe aan het tabblad Extensies. Voeg een item toe aan de array, met een unieke sleutel en het label dat winkel eigenaren zullen zien.edd_settings_extensions: voegt je instellingen toe aan het tabblad. Geef je instellingen terug genesteld onder dezelfde sleutel die je voor de sectie hebt gebruikt, zodat EDD ze in je sectie plaatst.
3rd-party extensies moeten uw EDD-specifieke instellingen plaatsen onder Downloads → Instellingen → Extensies → Uw Extensienaam. Om een voorbeeld te zien van hoe u uw subsectie en instellingen kunt registreren, kunt u dit Gist raadplegen:
EDD slaat deze instellingen op met de rest van zijn opties. Om een waarde in je code te lezen, gebruik je edd_get_option( 'myext_enable_feature' ).
Elke instelling heeft een id, een name en een type. Veelvoorkomende types zijn checkbox_toggle, text, textarea, select, rich_editor en header. Je kunt ook een standaardwaarde instellen met std.
Om beide bestanden te kopiëren, zie de voorbeeld Gist op GitHub.
Dat is alles! Je weet nu hoe je je extensie kunt benoemen, branden en instellen zodat deze naadloos aansluit bij Easy Digital Downloads. Om meer te leren over bouwen op EDD, zie de Introductie voor ontwikkelaars van Easy Digital Downloads.
Veelgestelde vragen over EDD-extensieontwikkeling
Hieronder beantwoorden we enkele van de meest gestelde vragen over het bouwen van 3rd-party extensies voor EDD.
Heb ik een pas nodig om een extensie te bouwen?
Nee. De instellingentab en hooks in deze handleiding maken deel uit van de gratis Easy Digital Downloads plugin.
Waarom zie ik geen tabblad Extensies in mijn instellingen?
Het tabblad verschijnt pas zodra een extensie ten minste één instelling registreert. Nadat je code een sectie en de bijbehorende instellingen heeft toegevoegd, verschijnt het tabblad Extensies onder Downloads » Instellingen.
Ondersteunt het EDD-team mijn extensie?
Nee. Extensies van derden worden ondersteund door de ontwikkelaars die ze bouwen. Uw klanten hebben een duidelijke manier nodig om u te bereiken voor hulp.
Kan ik de naam van mijn extensie laten beginnen met Easy Digital Downloads?
Alsjeblieft niet. Namen die beginnen met "Easy Digital Downloads" zijn gereserveerd voor onze officiële extensies. WordPress.org staat ook niet toe dat de slug van een plugin begint met de naam van een ander product. Gebruik in plaats daarvan het formaat "Naam extensie voor Easy Digital Downloads".
