Como criar esquemas adicionais para o campo de endereço

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.

pode agora selecionar os esquemas adicionais para o campo de endereço a partir do menu pendente Esquemas no campo do formulário Endereç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.

alternar o interrutor para ocultar determinados campos do Esquema de Endereçamento Internacional que não pretende visualizar

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.

Filtro de referência

wpforms_address_schemes