Gostaria de personalizar os formatos de endereço para diferentes países? O WPForms permite-lhe adicionar esquemas de endereços personalizados para além dos formatos predefinidos dos EUA e Internacional.
Este guia mostrar-lhe-á como criar novos esquemas de endereços para países como o Canadá, a Austrália ou qualquer formato personalizado de que necessite.
Configuração de esquemas de endereços
Para começar, terá de adicionar um fragmento de código ao seu site. Se não tiver a certeza de como adicionar código personalizado, consulte o nosso guia sobre como adicionar fragmentos de código ao seu site.
Eis um excerto de código para criar um formato de endereço canadiano :
/**
* Add new address field scheme for Canada
*
* @link https://wpforms.com/developers/create-additional-schemes-for-the-address-field
*/
function wpf_dev_new_address_scheme( $schemes ) {
$my_form_id = 1000; // Replace with your form ID
$schemes['canada'] = array(
'label' => 'Canada',
'address1_label' => 'Address Line 1',
'address2_label' => 'Address Line 2',
'city_label' => 'City',
'postal_label' => 'Code Postal',
'state_label' => 'Province',
'states' => array(
'BC' => 'British Columbia',
'ON' => 'Ontario',
'QC' => 'Quebec',
'AB' => 'Alberta',
'MB' => 'Manitoba',
'NB' => 'New Brunswick',
'NL' => 'Newfoundland and Labrador',
'NT' => 'Northwest Territories',
'NS' => 'Nova Scotia',
'NU' => 'Nunavut',
'PE' => 'Prince Edward Island',
'SK' => 'Saskatchewan',
'YT' => 'Yukon',
),
);
return $schemes;
}
add_filter( 'wpforms_address_schemes', 'wpf_dev_new_address_scheme', 10, 1 );
Para um formato de endereço australiano , utilize este código:
/**
* Add new address field scheme for Australia
*
* @link https://wpforms.com/developers/create-additional-schemes-for-the-address-field
*/
function wpf_dev_new_address_scheme( $schemes ) {
$schemes['australia'] = array(
'label' => 'Australia',
'address1_label' => 'Address Line 1',
'address2_label' => 'Address Line 2',
'city_label' => 'City',
'postal_label' => 'Postal',
'state_label' => 'State / Territory',
'states' => array(
'NSW' => 'New South Wales',
'VIC' => 'Victoria',
'QLD' => 'Queensland',
'WA' => 'Western Australia',
'SA' => 'South Australia',
'TAS' => 'Tasmania',
'ACT' => 'Australia Capital Territory',
'NT' => 'Northern Territory',
),
);
return $schemes;
}
add_filter( 'wpforms_address_schemes', 'wpf_dev_new_address_scheme', 10, 1 );
Utilizar o novo esquema de endereços
Depois de ter adicionado o código, crie um novo formulário ou edite um já existente. Adicione um campo Endereço ao formulário e, em seguida, procure o menu pendente Esquema nas definições do campo. O seu novo esquema de endereços aparecerá como uma opção.
Com um (ou ambos) dos snippets acima, já adicionou novos esquemas de endereço adicionais. Gostaria de saber como alterar os sub-rótulos no campo de endereço? Experimente o nosso artigo sobre Como alterar os subtítulos do campo de endereço.
Perguntas mais frequentes
P: Posso criar um esquema de endereços personalizado e listar todos os países?
R: Sem dúvida! Para criar o seu próprio esquema de endereços exclusivo e listar todos os países, deve utilizar o seguinte fragmento de código. Basta personalizá-lo de acordo com as suas necessidades.
P: Como é que posso ocultar campos específicos nos esquemas de endereços?
R: Para esquemas dos EUA e internacionais, pode ocultar os campos Linha de endereço 2, Código postal e País utilizando o separador Avançadas no criador de formulários.
Se precisar de ocultar outros campos, pode utilizar CSS direcionado para o seu formulário específico e IDs de campo. Por exemplo:
input#wpforms-41-field_6-state,
label[for="wpforms-41-field_6-state"] {
visibility: hidden;
}
O exemplo mostra que estamos a ocultar o campo Estado e a etiqueta para o ID de formulário 41 e o ID de campo (para o campo Endereço ) 6. Terá de atualizar estes IDs para corresponderem aos seus próprios IDs. Se precisar de ajuda para saber onde encontrar estes IDs, consulte este guia prático.
Se o campo Endereço for um campo obrigatório, não recomendamos a ocultação de quaisquer campos com CSS, uma vez que o campo de endereço falharia a validação.
É isso mesmo! Agora já sabe como criar esquemas adicionais para o campo de endereço. De seguida, gostaria de saber como personalizar as etiquetas do campo de endereço? Consulte o nosso guia sobre como alterar os sub-rótulos do campo de endereço para obter mais informações.