Documentação My Maps location

Introdução

Permita que seus usuários pesquisem locais e configurem a exibição como você deseja. My maps location é simplesmente a integração mais avançada do Google Maps para o Joomla.

 

My-maps-location-main

 

Principais características:

  • Pesquise por locais que você criou
  • Geolocalização automática
  • A origem do mapa pode ser o Google Maps, o Bing maps ou o Mapbox
  • Adicionar design de mapa
  • Obtenha informações de lugares do Google
  • Importar / exportar / sincronizar locais de arquivos .csv
  • Envio de localização de frontend
  • Várias integrações de extensões de terceiros

I. MY MAPS LOCATION INSTALAR E ATUALIZAR

1.1 Instale

Nosso componente é compatível com o Joomla 3.x. Todos os recursos e integrações de terceiros estão incluídos em todas as associações.
Para instalar nosso componente, você precisa baixar o arquivo .zip de extensão e usar o instalador padrão do Joomla.

 

joomla-install

 

Em seguida, clique no botão Browse> Upload and Install, componentes, módulos e plugins serão instalados ativados por padrão.

1.2 Atualização e atualizador automático

Para atualizar o My Maps location você pode instalar uma nova versão sobre a antiga baixando o arquivo ZIP do JoomUnited ou usar o atualizador automático (recomendado).

 

mml-update

 

O atualizador automático, que envia a notificação de atualização, está embutido na extensão do Joomla que você instalou. Assim, você será notificado como qualquer outra extensão no painel ou usando o menu: Extensão> Gerenciar> menu Atualizar.

 

Entre na sua conta para atualizar

Você precisa fazer o login na sua conta JoomUnited para atualizar todas as suas extensões do JoomUnited Joomla. Para acessar a configuração principal do componente, clique no botão Guia de atualização ao vivo. Na parte inferior, você encontrará um botão de login.

 

atualização ao vivo

 

Digite suas credenciais JoomUnited, o mesmo que você usa para fazer o login aqui @ www.joomunited.com

 

login-joomunited

 

O botão ficará laranja, parabéns! Agora você pode atualizar todas as extensões do JoomUnited neste site! Se sua assinatura expirar, você receberá um link de renovação e um texto explicando isso.

 

conta vinculada

 

Nota: um único login permitirá que você atualize todas as extensões do JoomUnited (referentes à sua associação). O login não expira a menos que você o desconecte.

II. LOCALIZAÇÕES E CATEGORIAS

2.1 Obtenha uma chave da API do Google Maps

Sempre que você usar as APIs do Google Maps, se o domínio tiver sido criado depois de 22 de junho de 2016, você deverá incluir uma chave para validar sua solicitação.
Obtenha uma chave e ative a API: https://developers.google.com/maps/documentation/javascript/get-api-key

Mais Informações: https://developers.google.com/maps/documentation/javascript/usage?hl=pt

O primeiro passo é cretae um projeto e, em seguida, digite o nome do projeto.

 

criar chave-api

 

Se eu quiser permitir todos os pedidos de mydomain, então o padrão a seguir é * .joomunited.com / *
Se você quiser apenas permitir domínio único, por exemplo, mydomain.com, então o padrão seria joomunited.com/*


Em um ambiente localhost, você pode colocar qualquer chave válida e ela funcionará sem qualquer referência de domínio.

 

padrão de domínio-api


A chave da API é gerada então, essa é a chave que você precisa copiar para adicionar a My Maps location.

 

criado por api

 

Adicione a chave ao My Maps Location.

De Componentes> My Maps Location> Opção, você pode adicionar uma chave na configuração.

 

configuração de mapas

 

Cole a chave.

 

add-api-key

 

Passo a passo resumé:


Então os passos que eu sigo são

  • Ir para o Google API Console
  • Crie ou selecione um projeto
  • Clique em Continuar para ativar a API e quaisquer serviços relacionados
  • Na página Credenciais, obtenha uma Chave do navegador (e defina as credenciais da API)
  • Para evitar o roubo de cotas, proteja sua chave de API seguindo essas melhores práticas

2.2 Gerenciar categorias de localização

Localização são classificados em categorias. Essas categorias podem ser exibidas como filtro no frontend ou usadas como um parâmetro predefinido em um item de menu para carregar alguns locais categorizados.
 

frontend de filtro de categoria

 

Se você tem muitos locais, é recomendável usar categorias. Você pode criar categorias e subcategorias.
Para criar uma categoria, por favor, vá em My Maps location> Category e clique em New

 

localizações de categoria

 

Então, na tela de categoria, você precisará adicionar um título e uma categoria pai, caso deseje criar uma subcategoria

 

categoria-pai

 

Você também pode definir um marcador padrão para localização na categoria usando a guia Seleção de marcadores

 

marcador-categoria

 

Nota: uma categoria é criada por padrão nomeada "Minha categoria" permitindo que você comece a adicionar locais diretamente após a instalação

2.3 Crie um local

Para criar um local, por favor, vá em My Maps location> Locais> Novo

Existem 3 campos obrigatórios:

  • Nome do local
  • Categoria do local
  • Detalhes de localização (endereço)

 

Para o endereço você tem 3 solução para adicioná-lo:

  • Use o campo de pesquisa (recomendado)
  • Navegue no mapa e use o cursor para apontar um local
  • Preencha um endereço (deve ser válido no Google Maps)

 

Para adicionar um local ao mecanismo de pesquisa, digite o nome do local que você deseja adicionar.

 

adicionar local

 

Na seleção, os campos de latitude e longitude serão preenchidos automaticamente. Meus mapas também estão integrados aos lugares do Google! Isso significa que você pode procurar por uma loja ou qualquer outra coisa que esteja registrada no Google Maps. Nosso componente receberá todas as informações do lugar.

 

Google-place

 

 

Você também pode se mover no mapa e colocar um marcador diretamente, o resultado será o mesmo e você terá uma latitude e uma longitude preenchidas automaticamente.

 

ponto de mapa

 

Tenha cuidado com o campo de endereço e CEP, se você preencher manualmente, ele deve corresponder a um endereço conhecido do Google Maps.

 

campos de endereço

 

Todas as outras informações do local (descrição, horas, ...) são exibidas na visualização detalhada do local.

O link de contato na edição de detalhes do local é a possibilidade de adicionar um link de contato, mailto ou URL por local. No frontend, um botão de contato abrirá o URL ou executará a ação mailto.

 

9

 

2.4 Outras informações de localização

Em cada local, você pode adicionar uma imagem e um marcador.

  • Imagem de localização: A imagem será exibida como uma miniatura na dica de ferramenta do local e em um tamanho maior na página de detalhes do local.
  • Use o ícone da categoria: Use o ícone que você colocou no campo de categoria dos locais do meu mapa
  • Fundo Marcador: escolha a cor do seu marcador de fundo
  • Marcador será exibido no mapa como um ícone de marcador de local. Você também tem alguns bons conjuntos de marcadores para seus locais incluídos na extensão My Maps Location.
  • Use um link personalizado substituirá o link para os detalhes do local por um URL personalizado.

 

marcador-imagem-localização

 

My Maps location está usando o recurso multilingue nativa do Joomla. Você pode definir um idioma em categorias de local e em locais. Na troca de idioma, os locais serão filtrados como qualquer outro conteúdo do Joomla para exibir o conteúdo aprovado pelo idioma.

 

língua

 

O campo de descrição de localização é um dos mais importantes.
Ele será exibido na página de detalhes do local e, dependendo do tema, como um texto de introdução do local nos resultados da pesquisa. Mais importante, a descrição é um editor WYSIWYG com todo o plugin carregado dentro, isso significa que você pode qualquer coisa que quiser nele (imagens, vídeos ...).

 

descrição da localização

 

Aqui está o texto de introdução exibido nos resultados da pesquisa de localização.

 

resultados de texto em localização

 

O campo tag é o mesmo sistema de tags do Joomla. Você pode adicionar tags e sub-tags e, em seguida, carregá-lo no frontend como filtro. Para gerenciar todas as tags, basta carregar o componente da tag Joomla: Componente de menu> Tags
No frontend, dependendo da configuração, as tags podem ser exibidas como checkbox (como abaixo) ou como uma lista suspensa.

 

filtro de tags

 

O My Maps Location tem campos adicionais para preencher as meta informações (para os mecanismos de busca). Esses campos são carregados na página de detalhes do local.

 

Meta informação

 

2.5 Exibir locais no frontend

Para exibir seus locais no frontend, você pode usar:

  • Um menu para exibir o mecanismo de pesquisa de localização, um único local ou categoria de locais
  • Um módulo para exibir um campo de pesquisa ou selecionar um conjunto de locais
  • Um botão de editor para exibir locais únicos ou múltiplos em qualquer editor

Carregar locais de um menu

Do gerenciador de menu do Joomla, adicione um elemento e selecione como tipo “Pesquisa e exibição de localização”. Ele exibirá o mecanismo de pesquisa de localização com filtros.
Selecione “Vista de detalhe da localização” para exibir um único local predefinido.

 

menu de localização

 

Se você selecionar "Pesquisa e exibição de localização" você tem alguns parâmetros de exibição. Alguns podem substituir os parâmetros padrão do componente.

 

main-menu-config

 

Na aba principal do menu você pode configurar:

  • Insira o endereço: você pode forçar um endereço padrão a ser exibido no carregamento da página. Pode ser deixado vazio
  • Distância: a distância para bloquear a pesquisa, referindo o endereço acima. Pode ser deixado como -1 (padrão)
  • Categoria: carregar uma categoria específica de localização
  • Limite de pesquisa: limitar o número de resultados da pesquisa. 10 retornará apenas os 10 primeiros resultados na pesquisa de local
  • Encomenda: ordenar resultados da pesquisa por Data, Título, Distância (padrão)

 

mml-menu-advanced

 

Então no Guia do menu My Maps Locationvocê pode configurar:

  • Selecione o componente: My Maps Location ou toda a integração de terceiros como K2, Jomsocial ...
  • ID da categoria padrão (Extensões de terceiros): Categoria padrão para carregar quando uma extensão de terceiros é usada, como K2, Hikashop ou Adsmanager, ID da lista de OCs para o criador de comunidades
  • Localizações de categoria infantil: Exibir também como locais de resultados de pesquisa de subcategorias, não apenas o selecionado acima
  • Tema: selecione um dos 3 temas padrão, largura total e barra lateral do tema de pesquisa e exibição de resultados disponíveis para o item de menu
  • Provedor do mapa: Selecione Google Maps, Bing Maps, Mapbox, OpenStreetMap ou Mapquest para estilizar seus mapas
  • Ativar tags de pesquisa: Permite que consultas de pesquisa sejam feitas usando nomes de tags de local
  • Designs: Dependendo da origem do mapa, você tem vários tipos e cores de mapas
  • Camada do mapa: Adicione alguns dados (camada) aos seus mapas. Existem as camadas KML, Traffic, Transit e Bicycling.
  • URL da camada do mapa do Google: Use a camada Dados para armazenar seus dados personalizados ou para exibir dados GeoJSON em um mapa do Google
  • Tipo de mapas do Bing: Se o Bing Maps for o seu provedor de mapa, selecione a aparência e os dados do Bing Maps
  • Tipo OpenStreetMap: Se o OpenStreetMap é o seu provedor de mapa, você pode adicionar alguns dados (camada) aos seus mapas
  • Dica de localização: No carregamento do mapa, abra automaticamente a dica de ferramenta de localização após a pesquisa de localização
  • Zoom do mapa: Definir um nível de zoom padrão no mapa
  • Opções de largura e altura dos resultados de mapa e pesquisa

 

Exibição de frontend com base no tema

 

map-search-themes

 

Resultado para uma exibição de pesquisa de local único:

bridgewater-location


Exibir locais usando um módulo

O My maps location vem com 2 módulos para locais nativos + outro para integração de terceiros (como um módulo para exibir locais de itens do K2)

O módulo do mapa permite que você exiba seus locais com os mesmos filtros do menu, mas em uma posição de módulo. Os locais serão exibidos como Mapa ou Lista. Você pode selecionar um conjunto de locais ou selecionar categorias de localização.

 

map-module

 

Mapa My Maps Location - Módulo de Pesquisa exibirá um mecanismo de pesquisa com alguns filtros como opção, como a largura do mapa ou o componente em que o local será pesquisado (procure por localização K2 apenas por amostra).

 

módulo de pesquisa

 

Módulo de exibição no frontend:

 

search-map-frontend-modules

 

 

Exibir locais usando um botão de editor


O botão do editor será carregado no seu editor Joomla (geralmente em artigos ou módulos personalizados em HTML). Você verá o botão na parte inferior do seu editor.
Ao clicar, você verá uma caixa de luz que permite selecionar um ou vários locais que você adicionou antes.

 

botão do editor de mapas

 

Em seguida, você pode selecionar um ou outro local e apertar o botão para adicioná-lo ao seu artigo. Se você não especificar nenhum nível de zoom, ele será automaticamente carregado para se ajustar à sua área de localização.
O código da tag que você verá no editor WYSIWYG será como este modelo: {mymaplocations mapid width height}

Ex: {mymaplocation id = 1 width = 58% altura = 400px zoom = 10 type = google} esse código exibirá um mapa com o ID de local = 1, com 58% de largura, 400px de altura, zoom de 10 vezes e tipo do Google. Usando a vírgula para adicionar mais de um local em um mapa. Ex: {mymaplocation id = 1 width = 58% altura = 400px zoom = 10 type = google} o ID do local = 1, 2, 3.

 

III SUBMISSÃO FRONTEND LOCATION

3.1 Adicionar e gerenciar locais

O My maps location oferece a opção de enviar e gerenciar seus próprios locais a partir do frontend. Primeiro você precisa criar um menu que permita o envio de frontend.

Do gerenciador de menu do Joomla, adicione um elemento e selecione como tipo "Adicionar locais". Em seguida, ao clicar nele, os usuários serão redirecionados, após o login, para um formulário de envio de local.
O menu "Meus locais" permite que o usuário edite os locais enviados anteriormente.

 

Adicionar-gerenciar-localização-frontend

 

Visão geral do formulário do menu frontend:

 

frente do menu

 

3.2 Limitação de acesso

O processo de submissão e edição do frontend é controlado pelo Joomla ACL. Para editar quem tem permissão para enviar e editar o local, clique em Componentes> My Maps Location> Opções> Permissões.
De lá você pode controlar o grupo de usuários Joomla bruxa é capaz de:

  • Crie locais
  • Excluir locais
  • Editar locais
  • Editar estado de publicação
  • Editar locais próprios

 

Frontend-location-submission

 

IV. IMPORTAÇÃO - LOCALIZAÇÃO DE EXPORTAÇÃO

O My Maps location recebeu uma ferramenta de importação - exportação - sincronização para localização de um arquivo .csv ou .kml (arquivo do Google Earth). Clique no menu My Maps Location> Importar / Exportar para obter acesso à interface.

 

importação-exportação-ferramenta

 

A partir desta interface você pode:

  • Importar locais de um arquivo .csv ou .kml
  • Exportar locais de um arquivo .csv ou .kml
  • Fazer uma atualização (sincronização) dos locais de um arquivo .csv ou .kml

 

Nota: o botão de sincronização também funciona quando você adicionou o local diretamente no banco de dados

V. ESTATÍSTICAS DE PESQUISA

Pode ver as estatísticas da sua pesquisa de localização, ativando o parâmetro Enable Statistics em Configurações> guia Configuração geral.

 

meses estatísticos

 

E você pode ver a lista dos principais locais abaixo, você pode Exportar com o tipo de arquivo .csv também.

 

estatística de exportação

 

VI. PARÂMETROS

6.1 Configurações

O componente tem muitas opções, algumas podem ser substituídas na visualização do menu, como vimos anteriormente. Clique no menu: My Maps Location> Opções para obter acesso à interface (canto superior direito da tela)

Tab1: configuração geral

 

Parameters1

 

  • Ativar estatísticas: Ativar estatísticas de localização
  • Pesquisa AJAX: Ative as consultas de pesquisa no AJAX, faça uma pesquisa sem recarregar a página
  • Distância de exibição: Exibe a distância do local da posição do usuário
  • Unidade de distância: Milhas ou quilômetros
  • Provedor do mapa: escolha entre mapas do Google, mapas do Microsoft Bing, Mapbox, Openstreetmap + Leaflet ou Mapquest
  • Pesquisa de preenchimento automático: Preenchimento automático de sugestões ao fazer uma pesquisa de localização. As sugestões de preenchimento automático podem vir do Google Maps, Bing Maps ou Openstreetmap, independentemente do sistema de mapas escolhido
  • Sempre que você usar as APIs do Google Maps, se o domínio tiver sido criado depois de 22 de junho de 2016, você deverá incluir uma chave para validar seu pedido.
    Mais Informações: https://developers.google.com/maps/documentation/javascript/usage?hl=pt
    Consiga uma chave: https://developers.google.com/maps/documentation/javascript/get-api-key
  • Tipo do Google Maps: tipo de mapa: Roteiro, Satélite, Híbrido ou Terreno
  • Projeto do mapa: Selecione um design padrão para seus mapas
  • Role o mapa do mouse: Ativar o zoom in / zoom out usando o mouse quando você estiver no mapa
  • Arraste o mapa: Ative para arrastar o mapa para passar por cima dele, usando o mouse
  • Abra o marcador de evento: Como os detalhes do local são abertos quando clicamos ou passamos um marcador
  • Ativar o clusterer de marcadores: Cada cluster que possui mais de um marcador mostra uma contagem do número de marcadores dentro do cluster
  • Recurso Autozoom: ajustar automaticamente o zoom para exibir todos os marcadores do mapa
  • Tipo de mapas do Bing: tipo de mapa: aérea, olho de pássaro ou estrada
  • Chave da API de mapas do Bing: colocar uma chave de API para que funcione;)

 

Parameters2

 

  • Pesquisa em qualquer lugar: adicione a opção na pesquisa radius para pesquisar em qualquer lugar do mundo
  • Pesquise em qualquer lugar por padrão: Por padrão, o seletor de raio na visualização de pesquisa será definido como Qualquer lugar
  • Formato de tag na pesquisa: exibir os filtros de tags como caixa de seleção ou lista suspensa
  • Vista da rua: Adicionar visualização de rua na pesquisa como opção
  • Mostrar rota: Exibir um link para calcular a rota da posição do usuário
  • Formato da rota: exibir a rota em My Maps location ou redirecionar para o Google
  • Link de contato no local: Adicionar um link a uma página de contato
  • Botão de contato: exibir o botão de contato
  • Alvo do link de contato: Modo de link de contato aberto
  • Zoom padrão do mapa: Nível de zoom padrão no mapa no primeiro carregamento (defina autozoom como não)
  • Tamanho do mapa: mapa e resultados da pesquisa largura e altura
  • Distância para pesquisa radius: determine os valores da lista suspensa de pesquisa de raio
    Ex. O usuário pode optar por pesquisar 10 milhas ao redor da cidade de Nova York.
  • Exibir lista de seleção de distância: opção para exibir a distância redius lista de seleção de pesquisa

 

Parameters3

 

  • Recorte do Word nos resultados da pesquisa: recorte a descrição do local em uma determinada quantidade de palavras nos resultados da pesquisa
  • Barra lateral do JQuery: altere a barra lateral padrão para uma JQuery (efeito de rolagem menor e suave)
  • Desativar geolocalização: desativar a geolocalização no site não https.
  • Desativar filtro de categoria: essa opção ativará o filtro da lista suspensa de categorias
  • Desativar filtro de estado do país: exibir um menu suspenso do estado do país na visualização de pesquisa
  • Pesquisa por código postal: Campo Pesquisar por código postal
  • Cor para o botão OU: Cor do botão "OU" no tema padrão
  • Cor do botao: "Geolocate me" cor do botão no tema padrão
  • Cor da fonte global: use essa opção para definir a cor da fonte global dos locais do Meu mapa
  • Imagem de fundo: imagem no fundo da pesquisa no tema padrão
  • Você marcador: adicione sua posição no mapa e selecione uma imagem como marcador
  • Imagem de ícone padrão: usar imagem de ícone padrão se o ícone não estiver disponível
  • Substituição do Ajudante: gerar um arquivo de substituição de layout padrão do Joomla que não será afetado por atualizações de extensão (na pasta / html)

 

6.2 Bing como fonte de mapa

Para usar o Bing Maps da Microsoft como fonte de mapa, você precisa preencher uma chave de API na configuração global do My Maps location. A página do Bing está aqui: https://www.bingmapsportal.com/

 

global-bing

 

Você precisa criar uma conta gratuita e copiar o código da chave da API da sua conta.

 

bing-key-microsoft

 

Em seguida, você poderá usar o mapa do Bing como origem do mapa a partir da configuração global (para habilitá-lo como padrão) ou a partir do item de menu.

 

bing-config

 

6.3 Mapbox como fonte de mapa

Para usar o Mapbox, a plataforma de mapeamento personalizado para desenvolvedores, como fonte de mapa, você precisa preencher uma API Mapbox no Configuração My Maps location> Provedores de Mapa.
A home page do Mapbox está aqui, você precisa criar uma conta gratuita a partir daí: https://www.mapbox.com/

 

mapbox-home

 

A partir daí, você pode criar um novo design de página ou usar o recomendado e armazená-lo na sua conta.

 

estilo de mapa

 

Para obter suas credenciais, use o conta de menu (canto superior direito):

  • API do Mapbox: use o menu Conta> tokens de acesso

Então você obtém uma chave por estilo de mapa que você criou.

 

mapbox-apikey

 

Em seguida, basta copiá-lo na configuração My Maps location para usá-lo.

 

mapbox-config