Este guia é destinado a usuários que desejam personalizar o comportamento de um módulo através da inserção de código JavaScript em pontos específicos do processo de envio (chamados "eventos" ou "hooks").

---

Guia: Ativar ou Desativar Eventos JavaScript Avançados (Hooks)

Os eventos JavaScript permitem executar código personalizado em momentos específicos da interação do usuário com o formulário (por exemplo, antes do envio dos dados ou após um erro de validação).

ATENÇÃO CRÍTICA:

A área de gerenciamento dos eventos JavaScript é destinada a usuários com conhecimentos de programação.

> Aviso Importante (do sistema):

> As seguintes configurações requerem noções de JavaScript para serem utilizadas; caso o código não funcione corretamente, todo o funcionamento do site pode ser comprometido.

---

Procedimento Passo a Passo

Siga estes passos para ativar, desativar ou modificar o código associado a um evento JavaScript.

1. Acessar a Seção JavaScript

1. Abra o módulo que deseja modificar.

2. No painel de edição do módulo, navegue até a etapa intitulada Javascript.

2. Gerenciar o Evento Desejado

Na seção Javascript, você encontrará uma lista de todos os eventos disponíveis. Cada evento está apresentado em um quadro separado.

1. Localize o quadro do evento que deseja gerenciar (por exemplo, form-submit-pre).

2. Para ativar o evento:

• Clique no botão Ativar (azul) que está no canto superior direito do quadro.
• O quadro ficará ativo.

3. Para desativar o evento (e ignorar o código dentro dele):

• Clique no botão Desativar (vermelho).
• O quadro voltará ao estado inativo.

3. Inserir o Código JavaScript

Se você ativou um evento, deve inserir o código que deseja executar.

1. Dentro do quadro do evento ativado, você encontrará uma área de texto (editor de código) entre dois blocos cinza de código (<code>).

• O bloco superior mostra a definição da função (ex.: $('form').on('event-id', function($form, {data.variavel}) {).
• O bloco inferior mostra o fechamento da função (});).

2. Insira seu código JavaScript personalizado na área de texto, certificando-se de que esteja corretamente delimitado pelas chaves da função.

Informações Adicionais sobre o Evento

Dependendo do evento que você está modificando, pode encontrar avisos úteis:

• Se você vê um aviso azul (alert-info):

> Retornando um array form_data modificado é possível passar o novo array com os valores alterados para os eventos seguintes.

(Isso significa que você pode modificar os dados do formulário antes que sejam processados).

• Se você vê um aviso amarelo (alert-warning):

> Definindo um return false; ao final da função bloqueará todos os eventos subsequentes.

(Isso permite interromper o processo de envio do formulário).

4. Salvar as Alterações

1. Após ativar o evento e inserir o código, prossiga salvando o módulo.

2. Clique no botão de salvar (normalmente localizado no final ou no rodapé da página de edição) para aplicar as alterações.

> Nota: Se ocorrerem erros de sintaxe no código JavaScript, o sistema pode alertá-lo durante a gravação, mas o código será salvo mesmo assim. Sempre certifique-se de que o código inserido seja válido para evitar mau funcionamento do formulário.