Frontend Submissions (FES) é uma das extensões mais populares para Easy Digital Downloads porque dá aos proprietários de lojas a capacidade de aceitar envios de produtos de fornecedores. Isso significa que os clientes se beneficiarão não apenas dos produtos do proprietário da loja, mas também da comunidade ao redor.
A natureza dessa funcionalidade, no entanto, pode apresentar um desafio para os proprietários de lojas, pois eles andam em uma linha tênue entre o controle do fornecedor sobre os produtos enviados versus o controle deles próprios.
Os fornecedores devem poder definir seus próprios preços? E quanto ao limite de download de arquivos, quem define o valor? Essas e muitas outras perguntas são o que tornam cada instalação do FES única.
Neste artigo, vou mostrar como alavancar a funcionalidade do FES para dar aos seus fornecedores a exata quantidade de controle que você deseja que eles tenham.
Metadados de Download
A primeira coisa que precisamos abordar é como as informações são vinculadas diretamente às entradas de download (produtos individuais em sua loja).
Usaremos uma das configurações básicas de download do EDD como exemplo. Se você for criar uma nova entrada de download ou editar uma existente, verá uma caixa de metadados "Configurações de Download" na barra lateral da tela de edição.
Digamos que você, o proprietário da loja, tivesse um sistema exclusivo de estoque para seus produtos e fosse importante que cada entrada de download em seu site tivesse um SKU (unidade de manutenção de estoque) específico. A menos que seus fornecedores tenham a capacidade de criar valores de SKU ao enviar seus produtos, você terá que defini-los para cada produto. Com cenários suficientes como esse, eventualmente começaria a parecer que dar aos fornecedores a capacidade de enviar produtos estava criando mais trabalho para você em vez do contrário.
A configuração de SKU mostrada na captura de tela acima é uma configuração que não possui um campo FES pronto que você possa colocar em seu Formulário de Envio FES. No entanto, há uma maneira para seus fornecedores usarem a configuração.
No WordPress, entradas individuais de Post ou Página podem ter o que é chamado de "metadados" conectados a elas. Metadados são nada mais do que informações armazenadas que são conectadas diretamente a essa entrada. E como os Downloads do EDD são essencialmente a mesma coisa que Posts e Páginas, eles também suportam metadados.
Metadados são organizados por identificadores exclusivos chamados chaves de metadados, dessa forma cada informação pode ser gerenciada por si só. Neste caso particular, a chave de metadados para a configuração de SKU é edd_sku.
Como proprietário da loja criando um novo produto, tudo o que você precisa fazer para salvar um valor no metadado de download edd_sku é digitar seu valor no campo de texto fornecido. Da mesma forma, você pode editar o envio de um produto de um fornecedor para inserir um valor de SKU se você não lhes der a capacidade de fazer isso por conta própria.
Com este entendimento de metadados, chaves de metadados e conhecimento básico de como adicionar campos ao Formulário de Envio FES, mostrarei como dar aos seus fornecedores mais controle e reduzir sua carga de trabalho.
Chaves de Metadados de Campo de Formulário de Envio
Criar seu Formulário de Envio no FES é bastante simples. Tudo o que você precisa fazer é adicionar os campos que deseja que seus fornecedores preencham ou, pelo menos, tenham a opção de preencher.
Campos que seus produtos exigirão, como título e descrição, não precisam de muita configuração e são incluídos automaticamente no Formulário de Envio.
Outros campos como “Preços e Arquivos de Download” são criados para servir a um propósito específico. Portanto, embora não seja um campo obrigatório por padrão, as configurações são muito específicas para o propósito do campo.
A maioria dos campos, no entanto, são mais como ferramentas baseadas no tipo de campo, não no propósito do campo. Isso significa que um campo de Texto geral pode ser usado de qualquer maneira que você achar adequada. No meu exemplo, um campo de Texto é o que vamos usar para permitir que os fornecedores definam seu próprio valor de SKU.
Tendo em mente o que você aprendeu sobre metadados e o fato de que cada peça de metadado tem uma chave de metadado única para identificação, o que temos que fazer é conectar nosso campo FES diretamente à chave de metadado que queremos que os fornecedores controlem... e é muito fácil de fazer.
Como você pode ver na imagem acima, os campos de Texto têm configurações e campos muito gerais. Neste caso, o campo mais importante é “Chave de Metadados”. Como eu o configurei para corresponder à chave de metadados da configuração real no EDD, agora estamos dando aos fornecedores um campo que edita diretamente a configuração de SKU para o produto.
Com este campo salvo no formulário de envio e obrigatório, os proprietários da loja nunca precisam se preocupar em definir o valor do SKU ou dar aos fornecedores acesso de back-end ao site para defini-lo eles mesmos. Eles podem fazer isso diretamente do painel do fornecedor FES ao enviar ou editar seus próprios produtos. Incrível.
Usando Estas Informações No Mundo Real
Por mais simples que isso pareça, você ainda terá que fazer um pouco de lição de casa para configurá-lo em cada caso. As chaves de metadados não são apenas exibidas ao lado das configurações em uma página de Adicionar/Editar Download. Portanto, encontrá-las pode ser um desafio.
Uma maneira fácil de encontrar a chave de metadados para uma configuração simples é usar o inspetor do seu navegador. Ao inspecionar o elemento de campo real da configuração à qual você precisa dar acesso aos seus fornecedores, você pode frequentemente ver o valor da chave de metadados no atributo “name” do elemento de entrada que controla a configuração.
Na imagem acima, você pode ver que “edd_sku” é a chave de metadados necessária para conectar seu campo de entrada do formulário de envio a essa configuração.
Isso pode ser um pouco mais difícil em outros casos. Primeiro, deve-se entender que algumas configurações são muito complexas para serem controladas a partir de um Formulário de Envio FES. Da mesma forma, algumas extensões já estão integradas com o FES e criam seus próprios campos de formulário de envio FES para as configurações que adicionam à tela Adicionar/Editar Download.
Quando o anterior não se aplica, mas você ainda não tem a chave de metadados de que precisa, é hora de mergulhar no código. Não há limite para a quantidade de metadados que podem ser adicionados a um download através das configurações. Portanto, se você tiver várias extensões do EDD instaladas, ou talvez outros plugins que não têm nada a ver com o EDD, você pode ter mais configurações a considerar.
O que você precisa fazer aqui é olhar o código-fonte do plugin/script/etc. que adiciona a configuração ao download. Cada configuração que recebe e salva a entrada do usuário (você) na tela Adicionar/Editar Download lida com funções de metadados de postagem do WordPress como add_post_meta() ou update_post_meta(). Ambas as funções podem ser usadas para criar uma nova configuração e ambas exigem que você especifique a chave de metadados para essa configuração. Portanto, se você puder encontrar essas funções no código, poderá encontrar as chaves de metadados.
A estrutura básica do código será muito semelhante a esta:
add_post_meta( $post_id, $meta_key, $meta_value, $unique );
Nesse código, $meta_key representa o valor que você precisará para a chave de metadados do seu campo FES.
Observação: Em alguns casos únicos, o código pode ser um pouco mais complexo e incluir coisas como variáveis PHP como chave de metadados. Se for esse o caso, pode ser hora de começar a procurar um desenvolvedor personalizado.
Chaves de Metadados de Configurações de Download Úteis
Existem algumas configurações padrão do EDD que não estão conectadas aos campos de formulário FES. Abaixo estão os nomes dessas configurações e suas chaves de metadados correspondentes que podem ser usadas em campos de formulário FES apropriados.
Limite de Download de Arquivo – _edd_download_limit
Notas de Download – edd_product_notes
Exibir Botão de Compra – _edd_hide_purchase_link
A Conclusão
Como você provavelmente notou, não há um único trecho de código que atenda a todas as suas necessidades aqui. Mais ainda, o FES simplesmente não pode ser integrado a todas as configurações do seu site. Mas uma compreensão básica de metadados de download, chaves de metadados e campos FES pode levá-lo longe.
Pense cuidadosamente sobre o nível de controle que os vendedores da sua loja precisam e trabalhe para otimizar o processo o máximo possível para melhorar a experiência do usuário. Vendedores são considerados proprietários da loja em seu marketplace. Implementar o que você aprendeu neste artigo beneficia ambas as pontas da parceria.
