A extensão Git Download Updater suporta tanto GitHub quanto BitBucket.
Conectando ao BitBucket
Para conectar seu site Easy Digital Downloads à sua conta Bitbucket, você precisará criar um APP dentro da sua conta Bitbucket e, em seguida, adicionar a Senha do APP e seu nome de usuário Bitbucket nas configurações da extensão.
Para criar uma senha de aplicativo, siga as etapas abaixo:
- No ícone da engrenagem no canto superior direito, selecione Configurações Pessoais do Bitbucket.
- Selecione Senhas de aplicativos em Gerenciamento de acesso.
- Selecione Criar senha de aplicativo.
- Dê um nome à senha do aplicativo que o ajudará a lembrar para que ela é usada.
- Na seção Permissões, marque as caixas para:
- Conta > E-mail e Leitura
- Associação de Workspace > Leitura
- Projetos > Leitura
- Repositórios > Leitura
- Copie a senha gerada em um local seguro por enquanto. A senha só é exibida desta vez.
Aqui está uma imagem de todas as permissões necessárias descritas na etapa 5 acima:
Mais detalhes sobre senhas de aplicativos (incluindo uso e revogação) podem ser encontrados na documentação do Bitbucket.
Assim que tiver a nova senha de aplicativo, adicione-a à página Downloads > Configurações > Extensões > Git Updater.
O campo Nome de usuário é o seu nome de usuário real do Bitbucket (não confunda com o e-mail da conta). Você pode encontrá-lo facilmente nesta página: https://bitbucket.org/account/settings/ na seção “Configurações do perfil Bitbucket”.
Conectando ao GitHub
Para usar o GitHub, navegue até Downloads > Configurações > Extensões > Git Updater. Siga as instruções lá para se conectar ao GitHub.
Configurando um Download com o Git Updater
Definindo Seus Arquivos de Download
Depois de conectar seu site ao GitHub ou Bitbucket, você pode adicionar arquivos aos seus produtos de Download.
1. A caixa de metadados “Arquivos de Download” na tela de edição do download agora terá uma caixa de seleção rotulada “Buscar download de um repositório git.”
2. Após um ou dois minutos, um novo conjunto de campos aparecerá, permitindo que você selecione um repositório.
3. Procure o nome do repositório e, em seguida, selecione a tag que você deseja usar.
Observação: A Tag de Versão usada no Git Updater deve ser uma tag git nativa. Ela não analisa versões do seu arquivo readme. Para saber mais sobre como usar o recurso de tag no git, você pode visitar este guia.
4. Clique em “Buscar Agora”. Quando seu download for importado com sucesso do repositório git, o botão dirá “Buscado”.
5. Agora você pode editar o nome do arquivo e/ou zip, se desejar, ou deixá-los como padrão. Seu arquivo zip está pronto!
Quando estiver pronto para lançar uma nova versão, basta selecionar a tag que deseja usar e clicar em buscar. Após a conclusão da busca, atualize seu produto.
Perguntas Frequentes e Solução de Problemas
Como excluir ou remover arquivos antes que o zip seja gerado?
O Git Download Updater usa o recurso 'export' do Git para construir o arquivo a ser entregue. Você pode usar o arquivo `.gitattributes` para determinar quais arquivos deseja ignorar durante a exportação. Aqui está um exemplo de como o usamos para o EDD Core.
Para mais detalhes sobre como usar atributos git para excluir arquivos, veja este tutorial.
Conflito de atualização entre a versão gratuita e a paga
Existem duas maneiras diferentes de resolver este problema:
- Altere o nome e/ou slug da versão pro. Devido a uma nuance com a API de atualização do WordPress, o WordPress não consegue distingui-los como plugins separados.
- Adicione "wp_override" ao terceiro parâmetro da classe EDD_SL_PLugin_Updater quando ela for instanciada, assim:
// set up the updater
$edd_updater = new EDD_SL_Plugin_Updater( EDD_SAMPLE_STORE_URL, __FILE__, array(
'version' => '1.0', // current version number
'license' => $license_key, // license key (used get_option above to retrieve from DB)
'item_id' => EDD_SAMPLE_ITEM_ID, // name of this plugin
'author' => 'Easy Digital Downloads', // author of this plugin,
'wp_override' => true
)
);Observação: isso requer a v1.6.4 da classe de atualização de plugin.
