Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
104 changes: 104 additions & 0 deletions .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
# PHPay - Manual de Contribuição

Seja bem-vindo(a) à nossa área de contribuição para o projeto PHPay! Estamos felizes por você estar interessado(a) em colaborar com nosso projeto open source. Suas contribuições são extremamente importantes para o crescimento e evolução do PHPay.

## ❓ Como contribuir?

1. Antes de começar
Leia a documentação: Familiarize-se com o código e os objetivos do projeto.
Respeite o Código de Conduta: Certifique-se de seguir as diretrizes de comportamento, promovendo um ambiente colaborativo e inclusivo.
Verifique as Issues: Dê uma olhada nas issues abertas para encontrar algo que você possa resolver ou melhorar.
2. Passo a passo para contribuir
🍴 Faça um fork do repositório

No repositório do PHPay, clique no botão Fork no canto superior direito.
🎋 Clone o repositório para sua máquina local

```bash
git clone https://github.com/seu-usuario/phppay.git
cd phpay
```

🎋 Crie uma branch para sua contribuição

Use um nome descritivo para a branch que reflete a feature ou correção que você está implementando:

```bash
git checkout -b feature/nome-da-feature
```

🗒️ Implemente sua contribuição

Mantenha o código limpo e organizado.
Siga as convenções de código do projeto.
Escreva testes para validar suas alterações sempre que possível.

🗒️ Faça commit das suas alterações

Escreva mensagens de commit claras e descritivas:

```bash
git commit -m "feat: [descrição da feature]"
```

✏️ Envie suas alterações para o repositório do fork

```bash
git push origin feature/nome-da-feature
```

✈️ Abra um Pull Request

No repositório original do PHPay, clique em Pull Requests e, em seguida, clique em New Pull Request.
Escolha a branch que você criou no seu fork e compare-a com a branch principal do repositório original.
Adicione uma descrição detalhada do que sua contribuição resolve ou melhora.

## 3. Revisão e Feedback

Sua contribuição será revisada por um dos mantenedores do projeto.
Caso necessário, serão solicitadas alterações ou melhorias antes da aprovação.
Após a aprovação, sua contribuição será integrada ao projeto principal.

🎉Diretrizes de Contribuição

- Certifique-se de que seu código seja compatível com as versões do PHP suportadas pelo projeto.

- Escreva testes unitários para novas funcionalidades ou correções de bugs.

- Mantenha uma boa documentação do código, incluindo comentários e exemplos de uso.

- Evite commits grandes e difíceis de revisar.

- Divida suas alterações em partes menores e mais específicas.

## 💻 Ambiente de Desenvolvimento

Certifique-se de configurar corretamente o ambiente de desenvolvimento local:

Requisitos básicos:

- PHP ^8.1
- Composer.

## 🏗️ Instalando as dependências:

```bash
composer install
```

## 🖥️ Configuração do ambiente:

Renomeie o arquivo credentials.example.php para credentials.php e configure suas chaves de do seu gateways.

## Rodando os testes:

```bash
composer tests
```

## ✉️ Entre em contato

Caso tenha dúvidas ou precise de ajuda, sinta-se à vontade para abrir uma issue ou entrar em contato com a equipe de mantenedores.

Agradecemos desde já por suas contribuições. 💙
Juntos podemos tornar o PHPay ainda melhor!
22 changes: 10 additions & 12 deletions .github/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,14 +50,16 @@ $phpay
- Domínios ✅
- Documentação 🕑
- Site 🕛
- Asaas.
- Gateways ✍️

- Asaas.

- Cobranças ✅
- Clientes ✅
- Webhook ✅
- Pix 🕥

- Efí.
- Efí.

- Autorização ✅
- Cobranças ✅
Expand All @@ -69,21 +71,17 @@ $phpay

## 🌟 Contribuindo

Contribuições são muito bem-vindas!
Para começar:

- 🍴 Faça um fork do projeto.
- 🎋 Crie uma branch para sua feature (git checkout -b feature/nova-feature).
- 🗒️ Faça commit das alterações (git commit -m 'Adicionei nova feature').
- ✏️ Envie sua branch (git push origin feature/nova-feature).
- ✈️ Abra um pull request para análise.
Para contribuir com o PHPay, implementando melhorias e novos gateways de pagamento,
leia nosso manual de contribuição. [MANUAL DE CONTRIBUIÇÃO PHPAY](./CONTRIBUTING.md)

## 📄 Licença

Este projeto está licenciado sob a MIT License. Consulte o arquivo [LICENSE](./LICENSE) para mais detalhes.

🤝 Contato
## 🤝 Contato

💻 GitHub: [Mário Lucas](https://github.com/mariolucasdev)
📧 Email: mariolucasdev@gmail.com

📧 Email: hi@phpay.io

🎉 Comece a usar o PHPay e simplifique suas integrações com gateways de pagamento!