Desenvolvedores são bem-vindos e encorajados a criar suas próprias extensões para Easy Digital Downloads (EDD) e compartilhá-las com outros lojistas. Algumas diretrizes simples mantêm sua extensão fácil de encontrar, claramente separada de nossos recursos oficiais e consistente com o restante da administração do EDD.
Este guia cobre como nomear sua extensão, usar a marca EDD e posicionar suas configurações.
Observação: Os hooks de configuração neste guia fazem parte do próprio Easy Digital Downloads. Você pode usá-los com o plugin gratuito e sem passe. Este guia é para desenvolvedores. Se você está procurando recursos para adicionar à sua própria loja, comece com os oficiais em seu menu Downloads » Extensões.
Antes de começar, certifique-se de que Easy Digital Downloads está instalado e ativado no site WordPress em que você está desenvolvendo.
Nomeando Sua Extensão
Um nome claro informa aos lojistas imediatamente que sua extensão funciona com o EDD e que ela vem de você, em vez de nós.
Nomeie extensões de terceiros usando o formato "Nome da Extensão para Easy Digital Downloads". Muitos ecossistemas de plugins usam esse mesmo padrão, então os lojistas já o reconhecem.
Por favor, não use "Easy Digital Downloads – Nome da Extensão". Esse formato é reservado para nossas extensões oficiais, e usá-lo faz com que sua extensão pareça uma das nossas.
Usando a Marca Easy Digital Downloads
Se a página, listagem ou capturas de tela da sua extensão mencionarem Easy Digital Downloads, por favor, use nossos logotipos e cores oficiais. Você os encontrará, juntamente com nossas diretrizes de marca, em nossa página Press and Brand Assets.
Essa página também cobre como escrever nosso nome. Easy Digital Downloads tem sempre 3 palavras, com E, D e D maiúsculos. Encurtar para EDD também está bom.
Seguindo as Diretrizes de Plugins do WordPress.org
Todo plugin precisa seguir as diretrizes oficiais de plugins do WordPress.org. Para extensões do EDD, a mais importante é Diretriz 17: Plugins devem respeitar marcas registradas, direitos autorais e nomes de projetos.
Essa diretriz não permite que o slug de um plugin comece com o nome de outro produto, a menos que você possua ou represente esse produto. Um slug como sua-extensao-para-easy-digital-downloads segue a regra e corresponde ao formato de nomenclatura acima.
Adicionando Suas Configurações à Aba Extensões
Os proprietários da loja esperam encontrar as configurações da extensão em um só lugar. Coloque suas configurações específicas do EDD em sua própria seção em Downloads » Configurações » Extensões, em vez de adicionar um menu ou página de configurações separada.
Cada extensão que registra configurações obtém seu próprio link na parte superior da aba Extensões. Neste exemplo, 2 extensões adicionaram suas próprias seções, chamadas Descontos Pro e Dropbox.
A aba Extensões só aparece assim que pelo menos uma extensão registrou configurações. Em uma loja sem nenhuma, você não verá a aba.
Desde a versão 3.7, o EDD registra seus próprios hooks através de classes de assinantes de eventos, e sua extensão pode fazer o mesmo. Sua classe de configurações assina 2 filtros:
edd_settings_sections_extensions: adiciona o link da sua seção à aba Extensões. Adicione uma entrada ao array, usando uma chave única e o rótulo que os proprietários da loja verão.edd_settings_extensions: adiciona suas configurações à aba. Retorne suas configurações aninhadas sob a mesma chave que você usou para a seção, para que o EDD as coloque em sua seção.
Extensões de terceiros devem colocar suas configurações específicas de EDD em Downloads → Configurações → Extensões → Nome da Sua Extensão. Para ver um exemplo de como registrar sua subseção e configurações, você pode consultar este Gist:
O EDD salva essas configurações com o restante de suas opções. Para ler um valor em seu código, use edd_get_option( 'meuext_ativar_recurso' ).
Cada configuração recebe um id, um name e um type. Tipos comuns incluem checkbox_toggle, text, textarea, select, rich_editor e header. Você também pode definir um valor padrão com std.
Para copiar ambos os arquivos, veja o exemplo Gist no GitHub.
É isso! Agora você sabe como nomear, marcar e configurar sua extensão para que ela se encaixe perfeitamente com Easy Digital Downloads. Para saber mais sobre como construir sobre o EDD, veja a Introdução do Desenvolvedor ao Easy Digital Downloads.
FAQ sobre Desenvolvimento de Extensões EDD
Abaixo, respondemos a algumas das perguntas mais comuns sobre a criação de extensões de terceiros para o EDD.
Preciso de um passe para criar uma extensão?
Não. A aba de configurações e os hooks neste guia fazem parte do plugin gratuito Easy Digital Downloads.
Por que não vejo uma aba Extensões em minhas configurações?
A aba só aparece assim que uma extensão registra pelo menos uma configuração. Depois que seu código adiciona uma seção e suas configurações, a aba Extensões aparece em Downloads » Configurações.
A equipe do EDD dará suporte à minha extensão?
Não. As extensões de terceiros são suportadas pelos desenvolvedores que as criam. Seus clientes precisam de uma maneira clara de entrar em contato com você para obter ajuda.
Posso começar o nome da minha extensão com Easy Digital Downloads?
Por favor, não. Nomes que começam com "Easy Digital Downloads" são reservados para nossas extensões oficiais. O WordPress.org também não permite que o slug de um plugin comece com o nome de outro produto. Em vez disso, use o formato "Nome da Extensão para Easy Digital Downloads".
