Ir para o conteúdo

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);

gofas_feriados_admin

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.
gofas_feriados_config

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.

  1. Renomeie o arquivo holidays.json.example localizado na pasta /modules/addons/gofasferiados/ para holidays.json
  2. 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"
            }

  3. Compare o seu arquivo com os exemplos:
    1. Clique aqui para visualizar o arquivo com a lista de feriados fornecida pela Brasil API;
    2. Clique aqui para visualizar o arquivo editado incluindo o exemplo customizado acima.

Importante:

  1. Ao definir feriados no arquivo holidays.json os feriados armazenados no banco de dados são ignorados.
  2. Lembre-se de incluir/manter na lista o ano atual e o ano seguinte;
  3. Use um validador de arquivos json antes de subir o arquivo para produção (jsonformatter.curiousconcept.com);

Informações importantes

  1. Versão mínima do WHMCS: 8.6;
  2. Versão mínima do PHP: 8.1;
  3. Dados obtidos através da Brasil API

Histórico de atualizações

Changelog

v1.0.0 (31/08/2024)

Full Changelog

Implemented enhancements:

  • Lançamento 🎉 #1

* This Changelog was automatically generated by github_changelog_generator

Deixe um Comentário

Você precisa fazer login para publicar um comentário.

Role para cima