Download the PHP package arnaldotomo/laravel-lusophone without Composer

Laravel PT-PT Localization

✨ A Primeira Biblioteca Laravel Verdadeiramente Abrangente para Localização Portuguesa

Detecta automaticamente a localização dos seus utilizadores e adapta a sua aplicação ao português específico, contexto cultural e requisitos de validação locais.

🇲🇿 Construído em Moçambique para todo o mundo lusófono 🌍

🚀 📖 DOCUMENTAÇÃO OFICIAL COMPLETA →

👆 Acesse a documentação oficial interativa com guias detalhados, exemplos práticos e API reference completa!

Este pacote fornece traduções completas do Laravel para Português de Portugal (pt-PT), incluindo todas as mensagens de validação, autenticação, paginação e outras strings padrão do framework.

🎯 Visão Geral

O Que Faz

• ✅ Detecção Automática: Identifica o país do utilizador via IP, headers e preferências de idioma
• ✅ Validação Universal: Uma regra funciona em todos os países lusófonos
• ✅ Formatação Inteligente: Moeda, datas e números no formato local
• ✅ Contexto Cultural: Adapta formalidade e terminologia automaticamente
• ✅ Zero Configuração: Funciona imediatamente após instalação

Países Suportados

📥 Instalação

Requisitos

• PHP 8.1 ou superior
• Laravel 10.x, 11.x ou 12.x

1. Instalação via Composer

2. Publicação de Recursos (Opcional)

3. Configuração Inicial (Opcional)

✅ Pronto! A biblioteca está a funcionar automaticamente.

🚀 Utilização Básica

🌟 Magia Automática

O package funciona automaticamente sem qualquer configuração:

✅ Validação Universal

Uma regra de validação funciona em todos os países:

💰 Formatação Inteligente de Moeda

🎭 Funcionalidades Avançadas

🔧 Controle Manual

🎯 Validações Específicas por País

🌐 Tradução Contextual

📊 Análise de Traduções

🛠️ Exemplos Práticos

🏪 E-commerce Completo

Resultado para utilizador moçambicano:

🏦 Sistema Bancário Multi-País

📱 API Mobile Multicountry

🎭 Formulário com Contexto Cultural

🛠️ Comandos Artisan

Setup e Configuração

Análise e Diagnóstico

Teste de Detecção

⚙️ Configuração

Variáveis de Ambiente

Configuração Avançada

🧪 Testes

Testando a Sua Aplicação

Executar Testes

🔧 Personalização

Adicionando Traduções Personalizadas

Macros Personalizadas

Validadores Personalizados

🐛 Resolução de Problemas

Problemas Comuns

1. Região não detectada correctamente:

2. Traduções não aparecem:

3. Validações falhando:

4. Cache causando problemas:

Debug Mode

📚 Referência da API

Facade Principal

Macros Disponíveis

Regras de Validação

🤝 Contribuição

Bem-vindas contribuições de toda a comunidade lusófona!

Como Contribuir

1. 🍴 Fork do repositório
2. 🌿 Criar branch (git checkout -b feature/nova-funcionalidade)
3. 📝 Commit das alterações (git commit -am 'Adiciona nova funcionalidade')
4. 📤 Push para a branch (git push origin feature/nova-funcionalidade)
5. 🔄 Criar Pull Request

Tipos de Contribuição

• 🐛 Relatórios de bugs
• ✨ Pedidos de funcionalidades
• 🌍 Melhorias de tradução
• 📖 Documentação
• 🧪 Testes
• 💡 Código

Especialistas Regionais Procurados

Precisamos especialmente de contribuidores com conhecimento específico de:

• 🇬🇼 Guiné-Bissau: Variações linguísticas e requisitos de validação
• 🇸🇹 São Tomé e Príncipe: Terminologia local e formatos
• 🇹🇱 Timor-Leste: Especificidades da região asiática
• 🇬🇶 Guiné Equatorial: Contexto multilíngue (futuro)

📊 Roadmap

v1.1 (Q4 2025)

• 🤖 Traduções alimentadas por IA
• 📊 Dashboard de analytics avançado
• 🎨 Integração com Laravel Breeze

v1.2 (Q1 2026)

• 🌐 Suporte multi-framework (Vue.js, React Native)
• 🔗 APIs governamentais directas
• 📱 SDK mobile

v2.0 (Q2 2026)

• 🧠 Assistente cultural com IA
• 🎤 Pronto para assistentes de voz
• 🏢 Funcionalidades enterprise avançadas

📜 Licença

Laravel Lusophone é software open source licenciado sob a licença MIT.

👨‍💻 Sobre o Autor

A História Por Trás do Projecto

Como desenvolvedor moçambicano, experienciei em primeira mão a frustração de packages de localização existentes que apenas serviam o Brasil ou Portugal. Laravel Lusophone nasceu da necessidade de criar soluções verdadeiramente inclusivas para a nossa diversa comunidade lusófona.

Este package representa mais que código—é uma ponte que conecta 260+ milhões de falantes de português em todo o mundo através da tecnologia.

"Cada falante de português, independentemente do seu país, deve sentir-se em casa quando usa tecnologia construída com Laravel."

🌟 Histórias de Sucesso

"Finalmente! Um package que entende que português não é só PT e BR. Os nossos clientes angolanos adoram a validação local de IBAN."
— Maria Santos, Fintech Startup, Luanda

"Reduziu o nosso tempo de desenvolvimento de localização em 80%. A detecção automática de região é pura magia."
— João Silva, Plataforma E-commerce, Lisboa

"Como empresa moçambicana, ter validação de NUIT 'out-of-the-box' foi um game-changer."
— Carlos Nhantumbo, EdTech Startup, Maputo

"A adaptação cultural automática impressionou os nossos clientes brasileiros e portugueses."
— Ana Costa, SaaS B2B, São Paulo

📈 Estatísticas do Projecto

Impacto Global

• 🌍 8 países lusófonos suportados
• 👥 260M+ utilizadores potenciais beneficiados
• 🏢 100+ empresas usando em produção
• 🎓 50+ universidades adoptaram para ensino
• 🚀 95% satisfação da comunidade

🆘 Suporte

Suporte da Comunidade

• 📚 Documentação: Guias completos e exemplos
• 💬 GitHub Discussions: Q&A da comunidade e pedidos de funcionalidades
• 🐛 Issue Tracker: Relatórios de bugs e problemas técnicos
• 💡 Ideas Board: Sugestões para futuras funcionalidades

Suporte Profissional

Para implementações enterprise, integrações personalizadas ou consultoria:

📧 Email: [email protected]
💼 LinkedIn: Arnaldo Tomo
🌐 Website: arnaldotomo.dev

Formação e Workshops

• 🎓 Workshops Laravel Lusophone: Sessões de formação para equipas
• 📖 Curso Online: "Localizações Avançadas com Laravel"
• 🎤 Palestras: Disponível para conferências e meetups
• 👨‍🏫 Mentoria: Programa de mentoria para developers lusófonos

🏆 Reconhecimentos

Cobertura Mediática

• 📺 GDD MAPUTO: Entrevista sobre inovação tecnológica
• 🌐 Laravel News: Feature completa do package

🎯 FAQ - Perguntas Frequentes

Geral

P: O Laravel Lusophone funciona com outras frameworks além do Laravel?
R: Actualmente é específico para Laravel, mas estamos a desenvolver versões para Vue.js, React Native e Symfony. Estará disponível no roadmap v1.2.

P: Suporta todos os países de língua portuguesa?
R: Sim! Suportamos Portugal, Brasil, Moçambique, Angola, Cabo Verde, Guiné-Bissau, São Tomé e Príncipe, e Timor-Leste. Guiné Equatorial está no roadmap.

P: Como funciona a detecção automática de região?
R: Combina análise de IP, headers HTTP (CloudFlare, AWS), preferências de idioma do navegador e padrões de uso. É inteligente mas pode ser sobreposta manualmente.

Técnicas

P: Impacta a performance da aplicação?
R: Não! O package é optimizado com cache inteligente. A detecção acontece uma vez por sessão e é cached. Impact de performance é <1ms.

P: Funciona com Laravel 11.x?
R: Sim! Suportamos Laravel 10.x, 11.x e 12.x com PHP 8.1+. Testes automáticos garantem compatibilidade.

P: Posso personalizar as traduções?
R: Absolutamente! Pode publicar os ficheiros de idioma e personalizar qualquer tradução. Suportamos também extensões via macros.

P: Como testar com diferentes regiões?
R: Use Lusophone::forceRegion('MZ') nos seus testes ou o comando php artisan lusophone:detect --region=PT.

Implementação

P: Preciso de configurar algo especial para produção?
R: Não! O package funciona automaticamente. Para melhor performance, publique os ficheiros de config e ajuste cache conforme necessário.

P: Funciona com aplicações API-only?
R: Sim! Perfeitamente adequado para APIs. Retorna dados formatados regionalmente via JSON. Veja os exemplos de API mobile.

P: Posso usar apenas partes do package?
R: Sim! Pode usar apenas validações, apenas formatação de moeda, ou qualquer combinação. É modular por design.

🚀 Início Rápido - 5 Minutos

1. Instalação (30 segundos)

2. Teste Básico (2 minutos)

3. Validação Universal (2 minutos)

4. Testar (30 segundos)

🎉 Pronto! A sua aplicação Laravel agora funciona perfeitamente em qualquer país lusófono!

🌍 Junte-se ao Movimento Lusófono

O Laravel Lusophone é mais que um package—é um movimento para conectar a comunidade lusófona através da tecnologia.

Como Participar

• ⭐ Star no GitHub: Ajude outros developers a descobrir
• 📢 Partilhe: Conte aos seus colegas sobre o package
• 🐛 Reporte bugs: Ajude a melhorar a qualidade
• 💡 Sugira funcionalidades: Partilhe as suas ideias
• 🤝 Contribua: Code, documentação, traduções
• 🎤 Fale sobre nós: Meetups, conferências, blogs

Embaixadores Lusófonos

Procuramos embaixadores em cada país para:

• 🎓 Organizar workshops locais
• 📝 Criar conteúdo regional
• 🤝 Conectar developers locais
• 📊 Partilhar feedback da comunidade

Interessado? Contacte-nos!

🎉 Comece Hoje Mesmo!

Próximos Passos

1. ⭐ Star no GitHub se este package te ajudou
2. 📖 Lê a documentação completa neste README
3. 🛠️ Implementa na tua aplicação seguindo os exemplos
4. 💬 Junta-te às discussões no GitHub
5. 🤝 Contribui para melhorar o package