Como alterar o atributo Nome de um campo oculto

Introdução

Tem necessidade de alterar o atributo name de um campo oculto no seu formulário? Por padrão, o WPForms atribui um nome a cada campo do seu formulário que usa um formato padrão, como wpforms[fields][1]. Isto permite que cada campo no seu formulário permaneça único para esse ID de campo específico no seu formulário.

Por exemplo, neste formulário, adicionámos um Campo oculto e a predefinição nome atribuído é wpforms[fields][25].

por defeito, o WPForms adiciona um nome genérico a cada campo do formulário, utilizando o título wpforms como prefixo, mas também inclui o número de identificação do campo

Se precisar de alterar este nome para poder utilizar JavaScript ou CSS para direcionar estes campos específicos, pode facilmente alterar isto com um pequeno filtro PHP e nós mostramos-lhe como!

Criar o formulário

Vamos começar por criar o formulário e adicionar os nossos campos. Se precisar de ajuda sobre como criar um formulário, consulte esta documentação útil.

Para efeitos desta documentação, pretendemos alterar o nome do campo oculto, pelo que incluiremos a adição de um destes campos ao nosso formulário para utilização interna.

crie o seu formulário e adicione os seus campos, incluindo um campo oculto

Adicionar o snippet

Agora é hora de adicionar o snippet ao seu site. Se precisar de ajuda para saber como e onde adicionar snippets ao seu site, consulte este guia útil para obter mais detalhes.

Neste snippet, ele vai olhar para qualquer Campo oculto dentro do formulário 1000 e atualizar o nome atributo a ser custom_name_hidden_field.

Terá de atualizar este ID de formulário para corresponder ao seu, ou pode removê-lo completamente para que seja aplicado a todos estes tipos de campos em todos os seus formulários.

Para encontrar o número de identificação do seu formulário, consulte este artigo.

Agora, quando inspecionar a marcação na página, verá o name mudou.

E é tudo o que precisa para alterar com êxito este atributo. Gostaria de alterar também os subtítulos do campo Palavra-passe? Veja o nosso tutorial sobre Como alterar os subtítulos do campo Palavra-passe.

Referência do filtro: wpforms_field_properties

FAQ

P: Posso utilizar isto para outros tipos de campos?

A: Sim, mas evite alterar o name para campos obrigatórios como Email. O WPForms baseia-se na sua estrutura predefinida (wpforms[fields][{$field_id}]) para validação e apresentação. Substituir isto pode causar erros como falhas de validação ou data-server-error.

Em vez disso, utilize um data-* atributo. Por exemplo:

function wpf_field_properties_email( $properties, $field, $form_data ) {
  
    // Optional: Limit to a specific form ID
    if ( absint( $form_data[ 'id' ] ) !== 1000) {
        return $properties;
    }

    // Add a custom data attribute instead of modifying the name
    $properties['inputs']['primary']['attr']['data-custom-name'] = 'custom_name_email_field';

    return $properties;
}
add_filter( 'wpforms_field_properties_email', 'wpf_field_properties_email', 10, 3 );