Deweloperzy są mile widziani i zachęcani do tworzenia własnych rozszerzeń dla Easy Digital Downloads (EDD) i dzielenia się nimi z innymi właścicielami sklepów. Kilka prostych wytycznych sprawi, że Twoje rozszerzenie będzie łatwe do znalezienia, wyraźnie oddzielone od naszych oficjalnych funkcji i spójne z resztą panelu administracyjnego EDD.
Ten przewodnik obejmuje, jak nazwać swoje rozszerzenie, używać marki EDD i umieszczać swoje ustawienia.
Uwaga: Haki ustawień w tym przewodniku są częścią samego Easy Digital Downloads. Możesz na nich budować za pomocą darmowej wtyczki i bez przepustki. Ten przewodnik jest dla deweloperów. Jeśli szukasz funkcji do dodania do swojego sklepu, zacznij od oficjalnych w menu Pobieranie » Rozszerzenia.
Zanim zaczniesz, upewnij się, że Easy Digital Downloads jest zainstalowany i aktywowany na stronie WordPress, na której tworzysz.
Nazywanie Twojego Rozszerzenia
Jasna nazwa od razu informuje właścicieli sklepów, że Twoje rozszerzenie działa z EDD i pochodzi od Ciebie, a nie od nas.
Nazywaj rozszerzenia stron trzecich, używając formatu „Nazwa Rozszerzenia dla Easy Digital Downloads”. Wiele ekosystemów wtyczek używa tego samego wzorca, więc właściciele sklepów już go rozpoznają.
Proszę, nie używaj „Easy Digital Downloads – Nazwa Rozszerzenia”. Ten format jest zarezerwowany dla naszych oficjalnych rozszerzeń, a jego użycie sprawia, że Twoje rozszerzenie wygląda jak jedno z naszych.
Korzystanie z Marki Easy Digital Downloads
Jeśli strona, lista lub zrzuty ekranu Twojego rozszerzenia wspominają o Easy Digital Downloads, użyj naszych oficjalnych logo i kolorów. Znajdziesz je wraz z naszymi wytycznymi dotyczącymi marki na naszej stronie Materiały Prasowe i Markowe.
Ta strona obejmuje również, jak pisać naszą nazwę. Easy Digital Downloads to zawsze 3 słowa, z wielką literą E, D i D. Skrócenie jej do EDD jest również w porządku.
Przestrzeganie Wytycznych Wtyczek WordPress.org
Każdy plugin musi przestrzegać oficjalnych wytycznych WordPress.org dla wtyczek. Dla rozszerzeń EDD najważniejsza jest Wytyczna 17: Wtyczki muszą szanować znaki towarowe, prawa autorskie i nazwy projektów.
Ta wytyczna nie pozwala, aby ślimak wtyczki zaczynał się od nazwy innego produktu, chyba że posiadasz lub reprezentujesz ten produkt. Ślimak taki jak twoje-rozszerzenie-dla-easy-digital-downloads jest zgodny z zasadą i pasuje do powyższego formatu nazewnictwa.
Dodawanie Ustawień do Zakładki Rozszerzenia
Właściciele sklepów oczekują, że ustawienia rozszerzeń znajdą się w jednym miejscu. Umieść swoje specyficzne dla EDD ustawienia w ich własnej sekcji pod Pobrane » Ustawienia » Rozszerzenia, zamiast dodawać oddzielne menu lub stronę ustawień.
Każde rozszerzenie, które rejestruje ustawienia, otrzymuje własny link na górze karty Rozszerzenia. W tym przykładzie 2 rozszerzenia dodały swoje sekcje, zwane „Discounts Pro” i „Dropbox”.
Karta Rozszerzenia pojawia się tylko wtedy, gdy co najmniej jedno rozszerzenie zarejestrowało ustawienia. W sklepie, w którym nie ma żadnych, karta w ogóle nie będzie widoczna.
Od wersji 3.7 EDD rejestruje własne haki za pomocą klas subskrybentów zdarzeń, a Twoje rozszerzenie może zrobić to samo. Twoja klasa ustawień subskrybuje 2 filtry:
edd_settings_sections_extensions: dodaje link do Twojej sekcji na karcie Rozszerzenia. Dodaj wpis do tablicy, używając unikalnego klucza i etykiety, którą zobaczą właściciele sklepów.edd_settings_extensions: dodaje Twoje ustawienia do karty. Zwróć swoje ustawienia zagnieżdżone pod tym samym kluczem, którego użyłeś dla sekcji, aby EDD umieściło je w Twojej sekcji.
Rozszerzenia stron trzecich powinny umieszczać ustawienia specyficzne dla EDD w sekcji Pobrania → Ustawienia → Rozszerzenia → Nazwa Twojego rozszerzenia. Aby zobaczyć przykład rejestracji podsekcji i ustawień, możesz odwołać się do tego Gist:
EDD zapisuje te ustawienia wraz z resztą swoich opcji. Aby odczytać wartość w swoim kodzie, użyj edd_get_option( 'myext_enable_feature' ).
Każde ustawienie przyjmuje id, name i type. Typowe typy to checkbox_toggle, text, textarea, select, rich_editor i header. Możesz również ustawić wartość domyślną za pomocą std.
Aby skopiować oba pliki, zobacz przykładowy Gist na GitHubie.
To wszystko! Teraz wiesz, jak nazwać, oznaczyć i skonfigurować swoje rozszerzenie, aby pasowało do Easy Digital Downloads. Aby dowiedzieć się więcej o tworzeniu na EDD, zobacz Wprowadzenie dla deweloperów do Easy Digital Downloads.
FAQ dotyczące Rozwoju Rozszerzeń EDD
Poniżej odpowiadamy na najczęściej zadawane pytania dotyczące tworzenia rozszerzeń stron trzecich dla EDD.
Czy potrzebuję przepustki, aby zbudować rozszerzenie?
Nie. Zakładka ustawień i haki w tym przewodniku są częścią darmowej wtyczki Easy Digital Downloads.
Dlaczego nie widzę karty Rozszerzenia w moich ustawieniach?
Karta pojawia się tylko wtedy, gdy rozszerzenie zarejestruje co najmniej jedno ustawienie. Po tym, jak Twój kod doda sekcję i jej ustawienia, karta Rozszerzenia pojawi się pod Pobrane » Ustawienia.
Czy zespół EDD będzie wspierał moje rozszerzenie?
Nie. Rozszerzenia stron trzecich są wspierane przez deweloperów, którzy je tworzą. Twoi klienci potrzebują jasnego sposobu, aby się z Tobą skontaktować w celu uzyskania pomocy.
Czy mogę zacząć nazwę mojego rozszerzenia od Easy Digital Downloads?
Proszę, nie rób tego. Nazwy zaczynające się od „Easy Digital Downloads” są zarezerwowane dla naszych oficjalnych rozszerzeń. WordPress.org nie pozwala również, aby ślimak wtyczki zaczynał się od nazwy innego produktu. Zamiast tego użyj formatu „Nazwa Rozszerzenia dla Easy Digital Downloads”.
