Módulo Feriados Brasileiros para WHMCS
Garante que o vencimento das faturas não caiam em finais de semana ou feriados
Principais funcionalidades
✓ Vencimento Perfeito: Atualiza automaticamente as datas de vencimento das faturas para evitar coincidências com finais de semana e feriados nacionais.
✓ Calendário Completo: Armazena o calendário anual de feriados nacionais do ano atual e do próximo, diretamente no banco de dados do WHMCS.
✓ Atualização Automática: Obtém e atualiza dados de feriados da Brasil Api quando o módulo é ativado, e atualiza a listagem de feriados anualmente.
✓ Personalização: Adicione sua própria lista de feriados customizada com facilidade. (saiba mais);
Documentação
Instalação do módulo no WHMCS
- Copie a pasta
/modules/addons/gofasferiados/
para dentro do diretório padrão de módulos addons do WHMCS:/whmcs/modules/addons/
. - Ative o Addon em
Opções > Módulos Addons
; - Insira a chave de licença, salve e pronto. Agora mais nenhuma fatura terá a data de vencimento em finais de semana e feriados.
Editar lista de feriados (avançado/opcional)
A lista com todos os feriados nacionais do ano atual e do próximo ano é obtida através de um serviço externo gratuito fornecido pela Brasil API, mas opcionalmente, você pode definir sua própria lista de feriados. Caso deseje evitar que o vencimento das as faturas caia em feriados estaduais, municipais ou qualquer outra data de sua preferência. Siga os passos a seguir para editar a lista de feriados.
- Renomeie o arquivo
holidays.json.example
localizado na pasta/modules/addons/gofasferiados/
paraholidays.json
- Edite adicionando um novo bloco aos dois anos listados no arquivo
holidays.json
mantendo o seguinte formato (a ordem da lista não importa):
{
"2024":[
{
"date":"2024-09-18",
"name":"Aniversário da minha cidade",
"type":"national"
} - Compare o seu arquivo com os exemplos:
Importante:
- Ao definir feriados no arquivo holidays.json os feriados armazenados no banco de dados são ignorados.
- Lembre-se de incluir/manter na lista o ano atual e o ano seguinte;
- Use um validador de arquivos json antes de subir o arquivo para produção (jsonformatter.curiousconcept.com);
Informações importantes
- Versão mínima do WHMCS:
8.6
; - Versão mínima do PHP:
8.1
; - Dados obtidos através da Brasil API
Histórico de atualizações
v1.0.0 (31/08/2024)
Implemented enhancements:
- Lançamento 🎉 #1
* This Changelog was automatically generated by github_changelog_generator