Manual de Uso Plugin API Netimóveis WordPress

1 - 01. Introdução

Obrigado por utilizar o plugin Netimóveis para WordPress! Para que o plugin funcione, os seguintes plugins precisam estar instalado no seu WordPress:

• Advanced Custom Fields (plugin gratuíto);
• Plugin Diogenes Componentes (enviado junto com os arquivos do plugin);

Esse plugin foi desenvolvido com parceria com a VERTI Netmóveis.

Obrigado Fábio Sousa pelo apoio (e paciência).

Qualquer dúvida, sugestão ou orçamento: falecom@diojr.me

2 - 02. Instalação e configuração inicial

3 - 03. Shortcodes para listagem de imóveis e filtros

No vídeo abaixo demonstro como usar os shortcodes básicos para listagem de imóveis e filtros:

Para realizar um filtro através de parâmetros na URL, você pode usar algo como:

www.nomedominio.com.br/?consulta=sim&quantidadeRegistro=10&pagina=1&transacao=1&estado=sao-paulo&cidade=osasco

Onde o nomedominio.com.br deve ser substituido pelo domínio em que seu WordPress está instalado. As parte em negrito é obrigatória ser preenchida. A lista completa de filtros, você pode consultar nessa URL https://wcfservices.netimoveis.com/docs/#!/Imovel/Imovel_Get_0_1_2_3. Você pode alterar os parâmetros obrigatórios para os valores que quiser, desde que a quantidadeRegistro seja maior que 3 e menor que 50, e os nomes do estado e cidade com todas as letras minusculas, sem acentos, e com os espaços transformados em "-" (hífen).

4 - 04. Usando gatilhos para paginar, filtrar e outros comportamentos

Nesse tópico vamos aprender a utilizar gatilhos:

Alguns exemplos demonstrados no vídeo acima:

• Criando um botão para paginar:

• Outros tipos de gatilhos:

Lembrando que você pode adicionar novos parâmetros ou usar esses gatilhos em botões ou tags "a" do seu HTML ou estrutura do Elementor e outros PageBuilders.

5 - 05. Criando um formulário de pesquisa

No vídeo abaixo demonstro como criar um formulário de pesquisa de imóveis, que pode ser um simples ou avançado com vários campos de critério:

Exemplo de formulário usado no vídeo:

6 - 06. Editando os detalhes do imóvel

Vamos ver agora como criar/editar a página de detalhe do imóvel:

Shortcodes:

Para o shortcode de [imovel_informacao] o atributo "dado" pode ser preenchido com todos os campos presentes conforme listado nesse link. Porém, vários deles são inúteis ou não retornam nenhuma informação, por causa disso eu criei uma lista resumida com os campso que são mais úteis e interessantes, que pode ser acessada nesse link.

Como vimos no vídeo, caso o campo que selecionou não existe, ou esteja vazio (sem nenhuma informação), o shortcode irá retornar o valor "N/A";

7 - 07. Editando o CSS

8 - 08. Atualização 1.2.0

Uma dúvida comum sobre o item 03. é como criar links com resultados pré-determinados (filtro). Como exemplo, como seria a URL da consulta de um imóvel que seja Apartamento, Venda, com 1 quarto e bairro da Consolação?

URLSITE/?consulta=sim&quantidadeRegistro=10&pagina=1&transacao=1&estado=sao-paulo&cidade=sao-paulo&bairro=consolacao&quartos=1&tipo=apartamento

Alguns pontos sobre a consulta acima:

• A API da Netimóveis não trabalha com filtros para todas as regiões, mesmo qeu você colocasse o parâmetro "regiao=consolacao" a API não retornará imóveis;
• O número de quartos a API não considera como número absoluto e sim como número mínimo, exemplo se você colocar "quartos=3", ela irá exibir imóveis com 3, 4, 5, etc quartos, irá excluir apenas os imóveis que tenham uma quantidade menor que o número informado;
• Para determinar se quer Venda ou Locação, é só informar no campo "transacao" a palavra "venda" ou a palavra "locação", para ambos, informe o número 1;

Outras atualizações da versão:

• Substituímos a informação do código do imóvel (REF) pela informação do campo imovelSan_Id. e a palavra REF foi subtituída pela palavra COD;
• Nas listagens de imóveis foi adicionada a informação sobre a quantidade de banheiros no imóvel;
• Nas listagens de imóveis foi adicionada a informação do campo "Descrição do Imóvel" (válido tanto para listagem comum como para listagem carrossel);
•  Criamos um novo shortcode para exibir as características gerais do imóvel formatadas dentro de uma caixa HTML. O shortcode é [imovel_detalhe_lista_html] (Funciona apenas para as páginas de detalhe do imóvel);