Introdução
Você precisa alterar o atributo de nome de um campo oculto em seu formulário? Por padrão, o WPForms atribui um nome a cada campo em seu formulário que usa um formato padrão, como wpforms[fields][1]
. Isso permite que cada campo em seu formulário permaneça exclusivo para aquele ID de campo específico em seu formulário.
Por exemplo, neste formulário, adicionamos um Campo oculto e o padrão nome atribuído é wpforms[fields][25]
.

Se você precisar alterar esse nome para poder usar JavaScript ou CSS para direcionar esses campos específicos, poderá alterar isso facilmente com um pequeno filtro PHP e mostraremos como!
Criando o formulário
Vamos começar criando o formulário e adicionando nossos campos. Se precisar de ajuda sobre como criar um formulário, consulte esta documentação útil.
Para os fins desta documentação, queremos alterar o nome do Hidden Field, portanto, incluiremos a adição de um desses campos ao nosso formulário para uso interno.

Adicionando 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 examinará qualquer Campo oculto dentro do formulário 1000 e atualizar o nome atributo a ser custom_name_hidden_field
.
Você precisará atualizar esse ID de formulário para que corresponda ao seu, ou pode removê-lo completamente para que seja aplicado a todos esses tipos de campos em todos os seus formulários.
Agora, ao inspecionar a marcação na página, você verá o name
mudou.

E isso é tudo o que você precisa para alterar esse atributo com sucesso. Você gostaria de alterar também os subtítulos do campo Password? Dê uma olhada em nosso tutorial sobre Como alterar os subtítulos do campo Password.
Relacionado
Referência do filtro: wpforms_field_properties
PERGUNTAS FREQUENTES
P: Posso usar isso para outros tipos de campo?
A: Sim, mas evite alterar o name
para campos obrigatórios como E-mail. O WPForms se baseia em sua estrutura padrão (wpforms[fields][{$field_id}]
) para validação e envio. Substituir isso pode causar erros como falhas de validação ou data-server-error
.
Em vez disso, use 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 );