Atenção!

Este artigo contém código PHP e destina-se a programadores. Oferecemos este código como cortesia, mas não prestamos suporte para personalizações de código ou desenvolvimento de terceiros.

Para orientação adicional, consulte o tutorial da WPBeginner sobre como adicionar código personalizado.

Ignorar

Descrição

O filtro wpforms_display_submit_spinner_src é acionado apenas se Ativar submissão AJAX do formulário estiver ativado nas definições do formulário e o formulário for submetido.

Parâmetros

$src
(string) A origem (URL) da imagem utilizada para o spinner
$form_data
(array) Configurações/dados do formulário processados, preparados para serem usados posteriormente.

Origem

wpforms/src/Frontend/Frontend.php

Mais Informações

O filtro wpforms_display_submit_spinner_src pode ser utilizado para alterar o ícone/imagem que é exibido enquanto o formulário está a ser submetido, quando o AJAX está ativado nas definições do formulário.

Ativar ou Desativar AJAX no separador Geral do ecrã de Definições do construtor de formulários

Exemplo

Este exemplo alteraria a origem do spinner para todos os formulários.

/**
 * Filter for changing the spinning loader icon shown as the form is submitted.
 *
 * @link    https://wpforms.com/developers/wpforms_display_submit_spinner_src/
 *
 * @param   string  $src        Source of the image used for the spinner.
 * @param   array   $form_data  Processed form settings/data, prepared to be used later.
 *
 * @return  string
 */

function custom_wpforms_display_submit_spinner_src(  $src ) {
  
    return 'https://yoursite.com/your-image.svg';
}

add_filter( 'wpforms_display_submit_spinner_src', 'custom_wpforms_display_submit_spinner_src', 10, 2 );

Neste exemplo, estamos a direcionar um formulário específico. O ID do formulário 42

/**
 * Filter for changing the spinning loader icon shown as the form is submitted for a specific form.
 *
 * @link    https://wpforms.com/developers/wpforms_display_submit_spinner_src/
 *
 * @param   string  $src        Source of the image used for the spinner.
 * @param   array   $form_data  Processed form settings/data, prepared to be used later.
 *
 * @return  string
 */

function custom_wpforms_display_submit_spinner_src( $src, $form_data ) {

    if ( $form_data[ 'id' ] === '42' ) {

        $src = 'https://yoursite.com/your-image.svg';

    }

    return $src;
}
add_filter( 'wpforms_display_submit_spinner_src', 'custom_wpforms_display_submit_spinner_src', 10, 2 );

O tamanho recomendado da imagem é 26×26. Pode alternativamente usar CSS para definir o tamanho, direcionando a classe CSS .wpforms-submit-spinner, mas qualquer CSS adicionado necessitaria do uso de !important para sobrescrever o estilo inline padrão.

Referência do Artigo: Como Alterar o Ícone de Pré-Carregamento na Submissão