Os aplicativos modernos da web exigem funcionalidades inteligentes e baseadas na localização. Plataformas de eCommerce precisam calcular taxas de envio internacionais, enquanto sites de conteúdo devem exibir notícias personalizadas por região. A geolocalização pode transformar sites estáticos do WordPress em experiências dinâmicas e personalizadas. No entanto, pode ser difícil implementar essa funcionalidade, especialmente se você não contar com um provedor de hospedagem adequado.
Este guia abrangente explora como adicionar recursos avançados de geolocalização no WordPress. Além disso, destaca as funcionalidades integradas da Kinsta, que eliminam muitos dos obstáculos comuns ao implementar geolocalização em seu site.
Entendendo geotargeting e geolocalização
Os aplicativos com reconhecimento de local se concentram em dois termos principais: geotargeting e geolocalização. Eles estão relacionados, mas cada um tem uma finalidade distinta em seu kit de ferramentas do WordPress:
- A geolocalização aponta a localização de seus visitantes.
- O geotargeting fornece conteúdo ou experiências específicas com base nesses dados.
A Netflix demonstra isso de forma eficaz: quando você viaja para o exterior, o serviço de streaming determina seu país atual por meio da geolocalização e, em seguida, ajusta sua biblioteca de conteúdo por meio da segmentação geográfica para atender aos contratos de licenciamento regionais. Essa combinação cria uma experiência perfeita e, ao mesmo tempo, mantém a conformidade com os direitos de mídia internacionais.
Há dois métodos principais para detectar a localização do visitante:
- A detecção de localização baseada em IP depende de bancos de dados que mapeiam endereços IP para regiões geográficas. Ela funciona universalmente sem exigir permissão do usuário. A maioria das soluções de geolocalização do lado do servidor usa isso, incluindo os recursos integrados da Kinsta.
- A detecção baseada em GPS acessa o hardware de localização de um dispositivo por meio de APIs do navegador. Ela fornece coordenadas precisas, mas exige o consentimento explícito do usuário. Essa funcionalidade está por trás das pesquisas de localização “Perto de mim” ou de aplicativos meteorológicos que precisam de posicionamento exato.
Geolocalização e geotargeting funcionam em conjunto, mas dentro da primeira, existem diferentes tecnologias para cada caso de uso. Nenhuma delas é melhor que a outra — cada uma oferece vantagens específicas dependendo da necessidade do site.
O caso de uso da geolocalização para negócios
Implementar a geolocalização em qualquer site pode trazer benefícios tangíveis tanto para o seu negócio quanto para os usuários. Primeiro, a personalização impulsiona o engajamento. Se o seu site puder personalizar a experiência para cada usuário, mais deles poderão fazer negócios com você.
A Amazon é um exemplo de como você pode colher os benefícios. Seu site de compras pode exibir os prazos de entrega de cada produto com base na sua localização:
Dependendo da sua localização, você também pode ver horários relevantes para eventos do Amazon Prime, como jogos esportivos:
Você pode ver isso em toda a web, por exemplo, como os sites de meteorologia exibem automaticamente sua previsão local. Independentemente da implementação, a personalização reduz o atrito na experiência do usuário e pode melhorar significativamente as taxas de conversão.
A conformidade regulatória também depende do reconhecimento da localização. O GDPR na Europa, o CCPA na Califórnia e muitas outras regiões exigem requisitos específicos para o tratamento de dados do usuário. A implementação adequada da geolocalização ajuda você a atender a esses requisitos para cada visitante.
Por fim, o conteúdo localizado gera confiança. Pesquisas demonstram que os usuários concluem as compras com mais frequência quando os preços são exibidos na moeda local e as informações de envio permanecem claras. Por exemplo, um estudo da Common Sense Advisory mostra que três quartos dos consumidores preferem comprar produtos em seu idioma nativo.
Como integrar a geolocalização ao WordPress
A arquitetura flexível do WordPress significa que há várias abordagens se você quiser adicionar reconhecimento de localização ao seu site. A escolha da hospedagem do site, o uso de plugins, o conhecimento de codificação e outros fatores influenciarão a abordagem que você preferir. No entanto, o trabalho com os dados em si pode ser feito de algumas maneiras.
Trabalhando com dados geográficos no WordPress
Embora o núcleo do WordPress inclua muitas funcionalidades fundamentais, isso não inclui a geolocalização integrada. Não há nada no núcleo do WordPress que registre dados de localização, embora ele ofereça suporte ao armazenamento e ao processamento de dados de localização de várias maneiras.
O banco de dados do WordPress
Por exemplo, o banco de dados do WordPress pode armazenar coordenadas e dados de localização por meio de campos personalizados ou tabelas dedicadas a localização.
Ele também pode gerenciar taxonomias baseadas em localização. Isso funciona bem para localizadores de lojas ou serviços de listagem imobiliária que operam com um banco de dados de localizações personalizadas. No entanto, o WordPress não armazena dados de geolocalização por padrão — ele apenas permite que isso seja feito.
A API REST do WordPress
A API REST do WordPress também suporta o trabalho com dados de geolocalização, embora não inclua endpoints dedicados. Você precisaria criar suas próprias extensões de endpoint para criar aplicativos com reconhecimento de localização que se comunicam com serviços externos ou aplicativos para dispositivos móveis. Aqui está um exemplo:
add_action('rest_api_init', function() {
// Create a custom namespace for your geolocation endpoints
register_rest_route('your-site-geo/v1', '/location', [
'methods' => 'GET',
'callback' => 'handle_location_request',
'permission_callback' => function() {
return true;
}
]);
});
function handle_location_request($request) {
// Access geolocation data (example using Kinsta's implementation)
$location = [
'country' => $_SERVER['GEOIP_COUNTRY_CODE'] ?? null,
'city' => $_SERVER['GEOIP_CITY'] ?? null,
'latitude' => $_SERVER['GEOIP_LATITUDE'] ?? null,
'longitude' => $_SERVER['GEOIP_LONGITUDE'] ?? null
];
return new WP_REST_Response($location, 200);
}Isso cria um novo endpoint em /wp-json/your-site-geo/v1/location que retorna dados de localização para qualquer consumidor da API.
O código usa your-site-geo como um namespace personalizado. Seu namespace deve ser específico para suas necessidades a fim de evitar conflitos com outros plugins ou códigos personalizados. É recomendável que você siga as diretrizes de namespace do WordPress:
- Use um prefixo específico do fornecedor ou do pacote para evitar conflitos.
- Inclua um número de versão (como
v1). - Mantenha os endpoints específicos e focados.
Você também pode registrar dados de localização para endpoints existentes:
add_action('rest_api_init', function() {
register_rest_field('post', 'location_data', [
'get_callback' => function($post) {
return get_post_meta($post['id'], 'location_data', true);
},
'update_callback' => function($value, $post) {
update_post_meta($post->ID, 'location_data', $value);
},
'schema' => [
'type' => 'object',
'properties' => [
'latitude' => ['type' => 'number'],
'longitude' => ['type' => 'number'],
'country' => ['type' => 'string'],
'city' => ['type' => 'string']
]
]
]);
});Em muitos casos, a API REST será o primeiro local em que você recorrerá para criar a funcionalidade de geolocalização, o que significa que ter essa flexibilidade será uma vantagem.
Tipos de artigos personalizados
Talvez você também use tipos de artigos personalizados no WordPress. Nesse caso, os novos tipos de conteúdo que você criar poderão incluir metadados de localização. Isso permite que você organize o conteúdo usando informações geográficas, sem a necessidade de modificações complexas no banco de dados.
A primeira etapa é registrar o tipo de artigo no WordPress:
register_post_type('store_location', [
'public' => true,
'label' => 'Store Locations',
'supports' => [
'title',
'editor',
'Custom-fields' // Enables custom fields and meta
]
]);Você também deve criar uma meta box personalizada para armazenar as coordenadas coletadas e gerar o HTML para ela:
<?php
add_action('add_meta_boxes', function() {
add_meta_box(
'store_location_coordinates',
'Store Coordinates',
'render_location_meta_box',
'Store_location' // The post type where this meta box should appear
);
});
function render_location_meta_box($post) {
// Get existing coordinates if they exist
$latitude = get_post_meta($post->ID, 'latitude', true);
$longitude = get_post_meta($post->ID, 'longitude', true);
// Output the form fields
?>
<label>Latitude:
<input type="number"
step="any"
name="latitude"
value="<?php echo esc_attr($latitude); ?>">
</label>
<label>Longitude:
<input type="number"
step="any"
name="longitude"
value="<?php echo esc_attr($longitude); ?>">
</label>
<?php
}A parte principal é salvar os dados de localização assim que você publicar ou salvar o artigo no WordPress:
add_action('save_post_store_location', function($post_id) {
// Verify if this is an autosave
if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
return;
}
// Save latitude if it exists
if (isset($_POST['latitude'])) {
update_post_meta(
$post_id,
'latitude',
sanitize_text_field($_POST['latitude'])
);
}
// Save longitude if it exists
if (isset($_POST['longitude'])) {
update_post_meta(
$post_id,
'longitude',
sanitize_text_field($_POST['longitude'])
);
}
});Criar uma função para buscar localizações próximas pode ter várias abordagens. Aqui está um exemplo básico de uma função que (em teoria) recupera a latitude e a longitude de uma localização:
function get_nearby_locations($lat, $lng, $radius = 10) {
$locations = get_posts([
'post_type' => 'store_location',
'posts_per_page' => -1
]);
$nearby = array_filter($locations, function($location) use ($lat, $lng, $radius) {
$store_lat = get_post_meta($location->ID, 'latitude', true);
$store_lng = get_post_meta($location->ID, 'longitude', true);
return calculate_distance($lat, $lng, $store_lat, $store_lng) <= $radius;
});
return $nearby;
}A escolha entre essas opções depende das suas necessidades específicas. Por exemplo, você pode usar campos personalizados para armazenar metadados de localização simples ou estender a API REST para implementações headless. Se o conteúdo for altamente baseado em localização, tipos de artigos personalizados podem ser a melhor solução.
A abordagem de plugins para geolocalização
O WordPress oferece suporte a plugins para quase tudo, e também há várias soluções para adicionar reconhecimento de local ao seu site. Por exemplo, o If-So Geolocation ou o Geolocation IP Detection têm ótimas avaliações e classificações, com atualizações frequentes e suporte ativo:
Esses plugins oferecem diversas funcionalidades comuns em um formato simples e familiar. Eles trazem algumas vantagens quando você precisa implementar geolocalização no seu site:
- Você obtém uma implantação rápida e oferece uma implementação rápida sem a necessidade de código personalizado.
- Você não precisa fazer manutenção, pois o desenvolvedor do plugin cuida disso (juntamente com as atualizações).
- Geralmente, há suporte e documentação da comunidade para ajudar se você precisar.
Para o tipo de desenvolvimento que você deseja realizar, um plugin pode não ser a melhor opção. Para começar, você depende da qualidade desse plugin para sua funcionalidade. Se você oferece produtos personalizados para WordPress, essa também pode não ser uma parceria que você queira. Cada plugin virá com sua própria implementação do banco de dados de localização, e a qualidade pode variar tanto quanto os outros recursos.
Os plug-ins são excelentes para usuários finais ou proprietários de sites que precisam adicionar reconhecimento de local a um site existente. No entanto, a possibilidade de conflitos com outros plugins, a carga adicional do servidor e a flexibilidade limitada para implementações personalizadas significam que você pode querer uma opção mais robusta.
Aplicativos do mundo real da geolocalização do WordPress
Você não precisa ir muito longe para encontrar exemplos de produtos WordPress que usam a geolocalização em sua base de código. Por exemplo, o WooCommerce inclui geolocalização integrada para cálculos de impostos e regras de envio.
Ela usa o banco de dados GeoIP2 da MaxMind para detectar automaticamente as localizações dos clientes, o que ajuda a garantir preços e opções de entrega precisos desde o primeiro carregamento da página.
Outros plugins também oferecerão suporte para geolocalização. Um plugin de formulário como o complemento Gravity Geolocation do Gravity Forms é um caso de uso típico. Ele permite que os usuários insiram sua localização em um formulário, ao qual o Gravity Forms atribuirá um conjunto de coordenadas e outros dados relevantes.
Isso se mostra particularmente valioso para a geração de leads e formulários de solicitação de serviços. E o mais importante é que você tem a flexibilidade de adaptar a necessidade de reconhecimento de localização ao seu caso de uso específico.
A vantagem da Kinsta: recursos nativos de geolocalização
Se você é um cliente Kinsta, não precisa de soluções extravagantes e deselegantes para implementar a geolocalização. O painel MyKinsta suporta detecção de localização robusta sem a sobrecarga de plugins adicionais do WordPress.
Entendendo o sistema de geolocalização da Kinsta
A implementação de geolocalização da Kinsta aproveita duas tecnologias poderosas:
- O módulo de geolocalização nativo do NGINX fornece detecção de localização eficiente em nível de servidor.
- O banco de dados GeoIP2 do MaxMind garante um mapeamento de localização preciso e atualizado.
Essa integração no painel MyKinsta oferece várias vantagens em relação a uma solução baseada em código ou plugin:
- Como a detecção de localização ocorre no nível do servidor, há um impacto mínimo no desempenho em relação a outras abordagens.
- A Kinsta realiza a manutenção regular da funcionalidade, o que significa que você obtém uma geolocalização atualizada.
- Você tem reconhecimento e detecção de localização confiáveis para o seu site sem a necessidade de JavaScript ou permissões de navegador.
- Você também tem integração adicional com o sistema Edge Caching da Kinsta.
A ferramenta de geolocalização de IP da Kinsta inclui integração com o WordPress e pode oferecer a você uma funcionalidade de estreia com bom desempenho e adaptável. Isso se deve à forma como a Kinsta expõe as informações de localização e as transmite para o restante de sua pilha.
Dados de localização disponíveis
O WordPress usa PHP, e a ferramenta de geolocalização de IP passa algumas informações centradas no local para a variável PHP $_SERVER.
Há vários endpoints e variáveis disponíveis para você que retornam diferentes conjuntos de dados:
// Basic geographical data
$country_code = $_SERVER['GEOIP_COUNTRY_CODE']; // Two-letter country code (such as "US" or "GB")
$country_name = $_SERVER['GEOIP_COUNTRY_NAME']; // Full country name
$region = $_SERVER['GEOIP_REGION']; // State/province code
$city = $_SERVER['GEOIP_CITY']; // City name
$postal_code = $_SERVER['GEOIP_POSTAL_CODE']; // Local postal or ZIP code
// Precise location data
$latitude = $_SERVER['GEOIP_LATITUDE']; // Decimal latitude
$longitude = $_SERVER['GEOIP_LONGITUDE']; // Decimal longitude
Há mais variáveis para você usar, como vários formatos de código de país e cidade. Independentemente disso, todas as variáveis expostas oferecem a você uma maneira de codificar PHP personalizado com base na funcionalidade da Geolocalização de IP da Kinsta.
Implementando a geolocalização por meio do MyKinsta
Como acontece com grande parte da funcionalidade do MyKinsta, a configuração da geolocalização por meio do painel de controle é simples. O primeiro ponto de partida é a tela Ferramentas de qualquer um de seus sites:
Clicar no botão Habilitar no cartão Geolocalização exibirá uma caixa de diálogo modal que solicita que você escolha definir a geolocalização para o nível do país ou para o país e a cidade.
Em alguns casos, você também verá um aviso se usar o Edge Caching. Isso ocorre porque ele não suporta variações de cache de geolocalização de “escopo estreito” – perto de fronteiras, por exemplo. Em vez disso, o cache é salvo em cada local do Ponto de Presença (PoP) com base em onde o primeiro visitante da página mora.
Depois que você escolher uma configuração de geolocalização e clicar no botão Habilitar, o MyKinsta configurará tudo nos bastidores. Após alguns instantes, você verá o painel Ferramentas ser atualizado com novas opções:
Você tem a opção de desativar a geolocalização no menu “kebab”. Clicar em Modificar simplesmente traz a caixa de diálogo modal de escolha de geolocalização de volta para você ajustar. Por fim, se você quiser ativar o bloqueio geográfico – que restringe o acesso ao seu site com base na localização – a equipe de suporte da Kinsta pode fazer isso para você, pois não está disponível no painel MyKinsta.
Criando aplicativos com reconhecimento de localização: exemplos práticos
Você tem praticamente todas as ferramentas e funcionalidades disponíveis por meio das implementações de geolocalização do NGINX e do MyKinsta. Isso significa que você tem muito espaço para usar os trechos de código e os recursos integrados da Kinsta para configurar uma solução para suas necessidades.
Para uma solução sem código, a funcionalidade de redirecionamento da Kinsta será ideal.
Redirecionamentos com base geográfica
Uma das principais facetas da ferramenta de geolocalização de IP da Kinsta é como você pode aplicar condições baseadas em localização por meio de roteamento de tráfego sofisticado.
Se você fosse usar código para uma configuração como essa, precisaria de muito trabalho:
class GeographicRedirects {
public function __construct() {
add_action('template_redirect', [$this, 'handle_redirects']);
}
public function handle_redirects() {
$country_code = $_SERVER['GEOIP_COUNTRY_CODE'] ?? null;
if ($country_code) {
$redirect_url = $this->get_redirect_url($country_code);
if ($redirect_url) {
wp_redirect($redirect_url, 301);
exit;
}
}
}
private function get_redirect_url($country_code) {
$redirects = [
'DE' => 'https://de.example.com',
'FR' => 'https://fr.example.com',
'ES' => 'https://es.example.com'
];
return $redirects[$country_code] ?? null;
}
}
new GeographicRedirects();
Em vez disso, o MyKinsta permite que você use o painel Redirecionamentos, que inclui campos para escolher um país e uma cidade.
Essa é uma forma poderosa de combinar a geolocalização da Kinsta com regras de redirecionamento. Basta preencher as URLs de origem e destino, escolher um domínio, selecionar um país e cidade, definir o código de status e, ao clicar no botão Adicionar Regra de Redirecionamento, a Kinsta aplicará a configuração ao seu servidor NGINX.
Integração de mapas interativos
Um localizador de lojas dinâmico pode exibir a localização do visitante e as lojas mais próximas. Isso é ideal para negócios com várias filiais distribuídas por diferentes regiões.
Você pode criar uma experiência interativa semelhante usando as variáveis de geolocalização de IP da Kinsta e a API do Google Maps. Para fazer isso, você precisa de uma chave API do Google Maps e de um conhecimento básico da API JavaScript do Google Maps. Além disso, você precisará dos dados de localização de todas as lojas. Essas informações podem vir de um tipo de post personalizado ou de um banco de dados.
Para a implementação, é prática comum adicionar o código ao arquivo functions.php do seu tema ou a um plugin personalizado. Depois de configurar sua chave API do Google Maps, você pode configurar a estrutura de dados de localização da loja:
// Register the store locations post type
add_action('init', function() {
register_post_type('store_location', [
'public' => true,
'label' => 'Store Locations',
'supports' => ['title', 'editor', 'custom-fields'],
'show_in_rest' => true
]);
// Register custom fields for location data
register_meta('post', 'latitude', [
'type' => 'number',
'single' => true,
'show_in_rest' => true
]);
register_meta('post', 'longitude', [
'type' => 'number',
'single' => true,
'show_in_rest' => true
]);
});
Para importar as localizações das lojas, você pode usar a interface de administração do WordPress, criar um tipo de post personalizado, adicionar latitude e longitude nos campos personalizados e incluir detalhes adicionais. Também é possível realizar uma importação programática:
function import_store_locations($stores) {
foreach ($stores as $store) {
$post_id = wp_insert_post([
'post_type' => 'store_location',
'post_title' => sanitize_text_field($store['name']),
'post_status' => 'publish'
]);
if (!is_wp_error($post_id)) {
update_post_meta($post_id, 'latitude', floatval($store['lat']));
update_post_meta($post_id, 'longitude', floatval($store['lng']));
update_post_meta($post_id, 'address', sanitize_text_field($store['address']));
update_post_meta($post_id, 'phone', sanitize_text_field($store['phone']));
}
}
}
// Example usage:
$stores = [
[
'name' => 'Downtown Store',
'lat' => 40.7128,
'lng' => -74.0060,
'address' => '123 Main St',
'phone' => '(555) 123-4567'
]
// Add more stores...
];
import_store_locations($stores);
Para implementar o localizador, você precisará de algumas linhas de código e as variáveis da Kinsta:
class StoreLocator {
private $visitor_location;
private $google_maps_key;
public function __construct($google_maps_key) {
$this->google_maps_key = $google_maps_key;
$this->visitor_location = $this->get_visitor_location();
add_action('wp_enqueue_scripts', [$this, 'enqueue_maps_scripts']);
}
private function get_visitor_location() {
// Use Kinsta's geolocation data
if (isset($_SERVER['GEOIP_LATITUDE'], $_SERVER['GEOIP_LONGITUDE'])) {
return [
'lat' => floatval($_SERVER['GEOIP_LATITUDE']),
'lng' => floatval($_SERVER['GEOIP_LONGITUDE'])
];
}
// Fallback to country center
if (isset($_SERVER['GEOIP_COUNTRY_CODE'])) {
return $this->get_country_center($_SERVER['GEOIP_COUNTRY_CODE']);
}
// Default to New York
return ['lat' => 40.7128, 'lng' => -74.0060];
}
private function get_nearby_stores($radius = 50) {
return get_posts([
'post_type' => 'store_location',
'posts_per_page' => 10,
'meta_query' => [
[
'key' => 'latitude',
'value' => [
$this->visitor_location['lat'] - ($radius / 111),
$this->visitor_location['lat'] + ($radius / 111)
],
'type' => 'NUMERIC',
'compare' => 'BETWEEN'
]
]
]);
}
…
A partir daqui, você pode adicionar o mapa ao seu template usando $store_locator->render_map().
Entrega de conteúdo dinâmico
A personalização de conteúdo, preços e promoções com base na localização do visitante é uma aplicação essencial da geolocalização. Isso permite que seu site adapte automaticamente os elementos conforme a região do usuário.
Para implementar isso, você precisa definir as variações de conteúdo para as regiões-alvo e criar um sistema confiável para armazenar os dados de localização e gerar chaves de cache, garantindo eficiência na entrega:
private function get_location_context() {
// Create unique cache keys based on location data
$context = [
'country' => $_SERVER['GEOIP_COUNTRY_CODE'] ?? null,
'region' => $_SERVER['GEOIP_REGION'] ?? null,
'locale' => get_locale()
];
// Add currency and timezone data if needed
if ($this->requires_currency_handling) {
$context['currency'] = $this->get_country_currency($context['country']);
}
return $context;
}
Isso cria a base para decisões baseadas em localização e para o processamento de conteúdo, permitindo a personalização de preços e adaptações regionais de forma eficiente.
private function process_dynamic_content($content, $context) {
// Handle pricing with currency conversion
if (strpos($content, '{price:') !== false) {
$content = preg_replace_callback(
'/{price:([0-9]+.?[0-9]*)}/',
fn($matches) => $this->format_price(
floatval($matches[1]),
$context['currency']
),
$content
);
}
// Process regional content blocks
if (strpos($content, '[region:') !== false) {
$content = preg_replace_callback(
'/[region:([^]]+)](.*?)[/region]/s',
function($matches) use ($context) {
$regions = array_map('trim', explode(',', $matches[1]));
return in_array($context['country'], $regions) ? $matches[2] : '';
},
$content
);
}
return $content;
}
Isso permite que você use marcadores simples em seu conteúdo que se adaptam automaticamente à localização do visitante. Por exemplo:
[region:US,CA]
<p>Free shipping on orders over {price:50}!</p>
[/region]
[region:GB,DE,FR]
<p>Free shipping on orders over {price:45}!</p>
[/region]
Com uma implementação básica configurada, você pode otimizá-la para melhorar o desempenho. Esse é um detalhe que pode passar despercebido, mas um sistema de cache eficiente ajuda a manter a performance do seu conteúdo adaptado à localização do usuário. Os modelos de cache da Kinsta são ideais para essa finalidade.
Preenchimento automático e validação de formulários
A criação de formulários com reconhecimento de local envolve a manipulação de diferentes formatos de endereço, códigos postais e números de telefone entre regiões. Por isso, é importante que você defina as regras de validação e formatação para essas diferentes regiões:
private $format_patterns = [
'US' => [
'postal' => [
'pattern' => '^(?=.{5,10}$)d{5}(-d{4})?$',
'transform' => fn($value) => strtoupper(trim($value))
],
'phone' => [
'pattern' => '^+1[2-9]d{2}[2-9]d{2}d{4}$',
'transform' => fn($value) => '+1' . preg_replace('/D/', '', $value)
]
],
'GB' => [
'postal' => [
'pattern' => '^(?=.{6,8}$)[A-Z]{1,2}[0-9][A-Z0-9]? ?[0-9][A-Z]{2}$',
'transform' => fn($value) => preg_replace(
'/^(.+?)([0-9][A-Z]{2})$/',
'$1 $2',
strtoupper(trim($value))
)
]
]
];
Esses padrões lidam com variações comuns de códigos postais e números de telefone em diferentes países. Entretanto, países diferentes têm requisitos de formato de endereço diferentes. Você pode usar uma abordagem sistemática para lidar com essas variações:
private function get_address_format($country_code) {
$formats = [
'US' => [
'required' => ['street', 'city', 'state', 'postal'],
'order' => ['street', 'street2', 'city', 'state', 'postal'],
'state_label' => 'State',
'state_type' => 'select'
],
'GB' => [
'required' => ['street', 'city', 'postal'],
'order' => ['street', 'street2', 'city', 'county', 'postal'],
'state_label' => 'County',
'state_type' => 'text'
]
];
return $formats[$country_code] ?? $formats['US'];
}
Em seguida, observe a validação de campo. Você deve implementar uma validação que respeite os requisitos de formato regional:
private function validate_field($field, $value, $country_code) {
if (!isset($this->format_patterns[$country_code][$field])) {
return true; // No specific validation needed
}
$pattern = $this->format_patterns[$country_code][$field]['pattern'];
$transform = $this->format_patterns[$country_code][$field]['transform'];
// Transform value before validation
$value = $transform($value);
return (bool)preg_match("/$pattern/", $value);
}
Um pequeno snippet reúne tudo isso:
// Validate a postal code
if (!$this->validate_field('postal', $_POST['postal_code'], 'GB')) {
$errors[] = 'Invalid postal code format';
}
Essa implementação se adaptará automaticamente ao local do visitante, lidará com variações regionais nos formatos de endereço, fornecerá validação adequada para campos específicos do local e manterá a integridade dos dados em diferentes regiões.
Resumo
A implementação da geolocalização do WordPress por meio da infraestrutura da Kinsta permite que você crie aplicativos poderosos com reconhecimento de localização. Habilitar a ferramenta de geolocalização de IP da Kinsta, você pode aproveitar uma solução robusta, eficiente e fácil de usar no nível do servidor. Além disso, a ferramenta é focada na privacidade e está em conformidade com os regulamentos de proteção de dados.
Você tem alguma dúvida sobre a geolocalização do WordPress e como implementá-la em seus projetos? Fale conosco na seção de comentários abaixo!
Steve Bonisteel é um Editor Técnico na Kinsta que começou sua carreira de escritor como jornalista impresso, cobrindo ambulâncias e caminhões de bombeiros. Ele tem coberto tecnologia relacionada à Internet desde o final dos anos 1990.
