Documentación My Maps location

Introducción

Deje que sus usuarios busquen ubicaciones y configure la pantalla como desee. My maps location es simplemente la integración de Google Maps más avanzada para Joomla.

 

Mis-mapas-ubicación-principal

 

Principales características:

  • Buscar ubicaciones que has creado
  • Auto geolocalización
  • La fuente del mapa puede ser Google Maps, Bing maps o Mapbox.
  • Añadir diseño de mapa
  • Obtener información de los lugares de Google
  • Importar / exportar / sincronizar ubicaciones desde archivos .csv
  • Envío de ubicación de frontend
  • Muchas integraciones de extensiones de terceros

I. MY MAPS LOCATION INSTALACIÓN Y ACTUALIZACIÓN

1.1 Instalar

Nuestro componente es compatible con Joomla 3.x. Todas las características y las integraciones de terceros se incluyen en todas las membresías.
Para instalar nuestro componente, debe descargar la extensión .zip y usar el instalador estándar de Joomla.

 

joomla-install

 

Luego, haga clic en Examinar> Botón Cargar e instalar, los componentes, módulos y complementos se instalarán activados de forma predeterminada.

1.2 Actualización y actualizador automático

Para actualizar My Maps location, puede instalar una nueva versión sobre la anterior descargando el archivo ZIP de JoomUnited o usando el actualizador automático (recomendado).

 

mml-update

 

El actualizador automático, que envía la notificación de actualización, está integrado en la extensión de Joomla que ha instalado. Por lo tanto, recibirás una notificación como cualquier otra extensión en el panel o mediante el menú: Extensión> Gestionar> Actualizar menú.

 

Inicie sesión en su cuenta para actualizar

Debe iniciar sesión en su cuenta de JoomUnited para actualizar todas las extensiones de JoomUnited de Joomla. Para iniciar sesión acceda a la configuración principal del componente y haga clic en Pestaña de actualización en vivo. En la parte inferior, encontrarás un botón de inicio de sesión.

 

actualización en vivo

 

Ingrese sus credenciales de JoomUnited, las mismas que usa para iniciar sesión aquí @ www.joomunited.com

 

login-joomunited

 

El botón se pondrá naranja, felicidades! ¡Ahora puede actualizar todas las extensiones de JoomUnited en este sitio web! Si su membresía ha caducado, recibirá un enlace de renovación y un texto que lo explicará.

 

vinculado a la cuenta

 

Nota: un solo inicio de sesión le permitirá actualizar todas las extensiones de JoomUnited (con respecto a su membresía). El inicio de sesión no caducará a menos que lo desconectes.

II. UBICACIONES Y CATEGORÍAS

2.1 Obtener una clave API de Google Maps

Cada vez que use las API de Google Maps, si su dominio se creó después del 22 de junio de 2016, debe incluir una clave para validar su solicitud.
Obtenga una clave y habilite la API: https://developers.google.com/maps/documentation/javascript/get-api-key

Más información: https://developers.google.com/maps/documentation/javascript/usage?hl=es

El primer paso es crear un proyecto y luego escribir el nombre del proyecto.

 

crear-api-key

 

Si quiero permitir todas las solicitudes de mydomain, entonces el patrón a seguir es * .joomunited.com / *
Si solo desea permitir un dominio único, por ejemplo, mydomain.com, el patrón sería joomunited.com/*


En un entorno localhost, puede poner cualquier clave válida y funcionará sin ningún tipo de referencia de dominio.

 

dominio-api-patrón


La clave de API se genera entonces, esta es la clave que necesita copiar para agregar a My Maps location.

 

api-created

 

Agregue la clave a My Maps Location.

Desde el Componentes> My Maps Location> Vista de opciones, puede agregar una clave en la configuración.

 

configuración de mapas

 

Pega la llave.

 

add-api-key

 

Paso a paso resumir:


Así que los pasos que sigo son

  • Ir a la consola de Google API
  • Crea o selecciona un proyecto
  • Haga clic en Continuar para habilitar la API y cualquier servicio relacionado
  • En la página de Credenciales, obtenga una Clave del navegador (y establecer las credenciales de la API)
  • Para evitar el robo de cuotas, asegure su clave API siguiendo esas mejores prácticas

2.2 Gestionar categorías de ubicación

Las ubicaciones se clasifican en categorías. Esas categorías se pueden mostrar como filtro en el frontend o usarse como un parámetro predefinido en un elemento del menú para cargar algunas ubicaciones categorizadas.
 

categoría-filtro-interfaz

 

Si tienes muchas ubicaciones, se recomienda utilizar categorías. Puede crear categorías y subcategorías.
Para crear una categoría, por favor entra My Maps location> Categoría y haga clic en Nuevo

 

ubicaciones de categoría

 

Luego, desde la pantalla de categorías, deberá agregar un título y una categoría principal en caso de que desee crear una subcategoría.

 

categoría padre

 

También puede definir un marcador predeterminado para la ubicación en la categoría utilizando la pestaña Selección de marcadores

 

categoría de marcador

 

Nota: una categoría se crea por defecto llamada "Mi categoría" Le permite comenzar a agregar ubicaciones directamente después de la instalación

2.3 Crear una ubicación

Para crear una ubicación, por favor entra My Maps location> Ubicaciones> Nuevo

Hay 3 campos obligatorios:

  • Nombre de la ubicación
  • Categoría del lugar
  • Detalles de ubicación (dirección)

 

Para la dirección tienes 3 soluciones para agregarla:

  • Utilice el campo de búsqueda (recomendado)
  • Navega por el mapa y usa el cursor para señalar una ubicación
  • Llene una dirección (debe ser Google Maps válido)

 

Para agregar una ubicación con el motor de búsqueda, escriba el nombre del lugar que desea agregar.

 

añade una ubicación

 

En la selección, los campos de latitud y longitud se rellenarán automáticamente. ¡Mis mapas también se integran con los sitios de Google! Esto significa que puede buscar una tienda o cualquier otra cosa que esté registrada en Google Maps, nuestro componente obtendrá toda la información del lugar.

 

Lugar de Google

 

 

También puedes moverte en el mapa y poner un marcador directamente, el resultado será el mismo y obtendrás una latitud y una longitud automáticamente rellenadas.

 

punto de mapa

 

Tenga cuidado con el campo de la dirección y el código postal si lo completa manualmente, debe coincidir con la dirección conocida de Google Maps.

 

campos de direccion

 

Toda la otra información de la ubicación (descripción, horas, ...) se muestra en la vista detallada de la ubicación.

El enlace de contacto en la edición de detalles de ubicación, es la posibilidad de agregar un enlace de contacto, mailto o URL por ubicación. En el frontend habrá un botón de contacto que abrirá la URL o ejecutará la acción mailto.

 

9

 

2.4 Otra información de ubicación

En cada ubicación puede agregar una imagen y un marcador.

  • Imagen de ubicación: La imagen se mostrará como una miniatura en la información sobre herramientas de la ubicación y en un tamaño más grande en la página de detalles de la ubicación.
  • Usar icono de categoría: Use el icono que coloca en el campo de categoría de mis ubicaciones de mapa
  • Fondo del marcador: elige el color para tu marcador de fondo
  • Marcador se mostrará en el mapa como icono de marcador de ubicación. También obtuvo algunos buenos conjuntos de marcadores para sus ubicaciones incluidos en la extensión My Maps Location.
  • Use un enlace personalizado anulará el enlace al detalle de la ubicación mediante una URL personalizada.

 

marcador-ubicación-imagen

 

My Maps location está utilizando la función multilingüe nativa de Joomla. Puede definir un idioma en categorías de ubicación y en ubicaciones. En el cambio de idioma, las ubicaciones se filtrarán como cualquier otro contenido de Joomla para mostrar el contenido aprobado en el idioma.

 

idioma

 

El campo de descripción de la ubicación es uno de los más importantes.
Se mostrará en la página de detalles de la ubicación y, según el tema, como texto de introducción de la ubicación en los resultados de búsqueda. Más importante aún, la descripción es un editor WYSIWYG con todo el complemento cargado en su interior, lo que significa que puede hacer lo que quiera con él (imágenes, videos ...).

 

Descripción de la ubicación

 

Aquí está el texto de introducción que se muestra en los resultados de búsqueda de ubicación.

 

resultados de texto en ubicación

 

El campo de etiqueta es el mismo sistema de etiquetas que Joomla. Puede agregar etiquetas y sub-etiquetas y luego cargarlas en la interfaz como filtro. Para administrar todas las etiquetas, simplemente cargue el componente de etiquetas de Joomla: Componente de menú> Etiquetas
En la interfaz, dependiendo de la configuración, las etiquetas pueden mostrarse como casillas de verificación (como a continuación) o como una lista desplegable.

 

filtro de etiqueta

 

My Maps Location obtuvo campos adicionales para completar la metainformación (para motores de búsqueda). Estos campos se cargan en la página de detalles de la ubicación.

 

meta informacion

 

2.5 Ubicaciones de la pantalla en el frontend

Para mostrar sus ubicaciones en la interfaz puede utilizar:

  • Un menú para mostrar el motor de búsqueda de ubicación, ubicación única o categoría de ubicaciones
  • Un módulo para mostrar un campo de búsqueda o seleccionar un conjunto de ubicaciones
  • Un botón de editor para mostrar ubicaciones únicas o múltiples en cualquier editor

Cargar ubicaciones desde un menú

Desde el administrador de menú de Joomla, agregue un elemento y seleccione como tipo “Búsqueda y visualización de ubicación”. Se mostrará el motor de búsqueda de ubicación con filtros.
Seleccionar “Vista detallada de la ubicación” para mostrar una única ubicación predefinida.

 

menú de ubicación

 

Si selecciona “Búsqueda y visualización de ubicación” Tienes algunos parámetros de visualización. Algunos pueden anular los parámetros de componentes predeterminados.

 

main-menu-config

 

Desde la pestaña principal del menú puedes configurar:

  • Ingresa la direccion: puede forzar que se muestre una dirección predeterminada en la carga de la página. Se puede dejar vacío.
  • Distancia: La distancia para bloquear la búsqueda, refiriéndose a la dirección anterior. Se puede dejar como -1 (por defecto)
  • Categoría: cargar una categoría específica de ubicación
  • Límite de búsqueda: Limitar el número de resultados de búsqueda. 10 solo devolverá los 10 primeros resultados en la búsqueda de ubicación
  • Pedidos ordene los resultados de búsqueda por Fecha, Título, Distancia (predeterminado)

 

mml-menu-advanced

 

Entonces en el Pestaña de menú My Maps Location, puedes configurar:

  • Seleccione el componente: My Maps Location o toda la integración de terceros como K2, Jomsocial ...
  • ID de categoría por defecto (Extensiones de terceros): categoría predeterminada para cargar cuando se usa una extensión de terceros, como K2, Hikashop o Adsmanager, ID de lista de CB para el creador de comunidades
  • Ubicaciones de categorías de niños: Mostrar también como ubicaciones de resultados de búsqueda de subcategorías, no solo la seleccionada anteriormente
  • Tema: seleccione uno de los 3 temas predeterminados, ancho completo y barra lateral de la búsqueda y el tema de visualización de resultados disponible para el elemento de menú
  • Proveedor de mapas: Seleccione Google Maps, Bing Maps, Mapbox, OpenStreetMap o Mapquest para personalizar sus mapas.
  • Habilitar etiquetas de búsqueda: Permite que las consultas de búsqueda se realicen utilizando nombres de etiquetas de ubicación
  • Diseños: Dependiendo de la fuente del mapa tienes varios tipos y colores de mapas.
  • Capa de mapa: Añade algunos datos (capa) a tus mapas. Hay una capa KML, una capa de tráfico, una capa de tránsito y una capa de ciclismo.
  • URL de capa de mapa de Google: Utilice la capa de datos para almacenar sus datos personalizados o para mostrar datos de GeoJSON en un mapa de Google
  • Tipo de Bing Maps: Si Bing Maps es su proveedor de mapas, seleccione la apariencia y los datos de Bing Maps
  • Tipo de OpenStreetMap: Si OpenStreetMap es su proveedor de mapas, puede agregar algunos datos (capa) a sus mapas
  • Herramienta de ubicación: En la carga del mapa, abrir automáticamente la información sobre herramientas de ubicación después de la búsqueda de ubicación
  • Zoom del mapa: Definir un nivel de zoom predeterminado en el mapa.
  • Opciones de ancho y alto de mapas y resultados de búsqueda

 

Frontend display basado en tema

 

temas de búsqueda de mapas

 

Resultado para una pantalla de búsqueda de ubicación única:

bridgewater-location


Mostrar ubicaciones usando un módulo

My maps location viene con 2 módulos para ubicaciones nativas y otro para integración de terceros (como un módulo para mostrar las ubicaciones de elementos K2)

El modulo de mapa le permite visualizar sus ubicaciones con los mismos filtros que el menú pero en una posición de módulo. Las ubicaciones se mostrarán como Mapa o Lista. Puede seleccionar un conjunto de ubicaciones o seleccionar categorías de ubicación.

 

módulo de mapa

 

Mapa My Maps Location - Módulo de búsqueda mostrará un motor de búsqueda con algunos filtros como opción, como el ancho del mapa o el componente en el que se buscará la ubicación (busque la ubicación K2 solo para el ejemplo de eje).

 

módulo de búsqueda

 

Módulo de visualización en la interfaz:

 

search-map-frontend-modules

 

 

Mostrar ubicaciones usando un botón editor


El botón del editor se cargará en su editor de Joomla (generalmente en artículos o módulos personalizados HTML). Verás el botón en la parte inferior de tu editor.
Al hacer clic, verá una caja de luz que le permite seleccionar una o varias ubicaciones que haya agregado anteriormente.

 

botón del editor de mapas

 

Luego, puede seleccionar una o alguna ubicación y presionar el botón para agregarla a su artículo. Si no especifica ningún nivel de zoom, se cargará automáticamente para adaptarse a su área de ubicación.
El código de etiqueta que verás en tu editor WYSIWYG será como este modelo: {mymaplocations mapid width height}

Ej: {id de mymaplocation = 1 anchura = 58% altura = 400px zoom = 10 tipo = google} este código mostrará un mapa con la ID de ubicación = 1, con 58% de ancho, 400 píxeles de altura, 10 veces zoom y tipo de Google. Usar la coma para agregar más de una ubicación en un mapa. Ej: {id de mymaplocation = 1 ancho = 58% altura = 400px zoom = 10 tipo = google} el ID de ubicación = 1, 2, 3.

 

III. ENVÍO DE UBICACIÓN FRONTEND

3.1 Agregar y administrar ubicaciones

My maps location ofrece la opción de enviar y administrar sus propias ubicaciones desde la interfaz. Primero deberá crear un menú que permita el envío de la interfaz.

Desde el administrador de menú de Joomla, agregue un elemento y seleccione como tipo "Añadir ubicaciones". Luego, al hacer clic en él, los usuarios serán redirigidos, después de iniciar sesión, a un formulario de envío de ubicación.
El menú "Mis ubicaciones" permite al usuario editar sus ubicaciones enviadas anteriormente.

 

agregar-administrar-ubicación-frontend

 

Resumen del formulario del menú frontend:

 

frente al menú

 

3.2 Limitación de acceso

El proceso de envío y edición de frontend es controlado por Joomla ACL. Para editar quién tiene permiso para enviar y editar la ubicación, haga clic en Componentes> My Maps Location> Opciones> Permisos.
Desde allí puede controlar que el grupo de usuarios de Joomla puede:

  • Crear ubicaciones
  • Eliminar ubicaciones
  • Editar ubicaciones
  • Editar estado de publicación
  • Editar ubicaciones propias

 

Presentación de ubicación de frontend

 

IV. IMPORTACIÓN - UBICACIONES DE EXPORTACIÓN

My Maps location obtuvo una herramienta de Importación - Exportación - Sincronización para la ubicación desde un archivo .csv o .kml (archivo de Google Earth). Haga clic en el menu My Maps Location> Importar / Exportar Para acceder a la interfaz.

 

herramienta de importación-exportación

 

Desde esta interfaz puedes:

  • Importar ubicaciones desde un archivo .csv o .kml
  • Exportar ubicaciones desde un archivo .csv o .kml
  • Realice una actualización (sincronización) de las ubicaciones desde un archivo .csv o .kml

 

Nota: el botón de sincronización también funciona cuando ha agregado una ubicación directamente en la base de datos

V. ESTADÍSTICAS DE BÚSQUEDA

Puede ver las estadísticas de su búsqueda de ubicación habilitando la opción Activar parámetros de estadísticas en Ajustes> pestaña Configuración general.

 

estadística-meses

 

Y puede ver la lista de las principales ubicaciones a continuación, puede Exportar con el tipo de archivo .csv también.

 

estadística de exportación

 

VI. Los parámetros

6.1 Configuraciones

El componente tiene muchas opciones, algunas pueden anularse en la vista del menú como hemos visto antes. Haga clic en el menu: My Maps Location> Opciones para acceder a la interfaz (arriba a la derecha de la pantalla)

Tab1: Configuración general

 

Parameters1

 

  • Habilitar estadísticas: Habilitar estadísticas de ubicación
  • Búsqueda AJAX: Habilite las consultas de búsqueda en AJAX, realice una búsqueda sin volver a cargar la página
  • Distancia de visualización: Mostrar la distancia de la ubicación desde la posición del usuario
  • Unidad de distancia: Millas o Kilómetros
  • Proveedor de mapas: elija entre Google Maps, Microsoft Bing maps, Mapbox, Openstreetmap + Leaflet o Mapquest
  • Autocompletar búsqueda: Autocompletar sugerencias al hacer una búsqueda de ubicación. Las sugerencias de autocompletado pueden provenir de Google Maps, Bing Maps o Openstreetmap, sea cual sea el sistema de mapas que haya elegido
  • Cada vez que use las API de Google Maps, si su dominio se creó después del 22 de junio de 2016, debe incluir una clave, para validar su solicitud.
    Más información: https://developers.google.com/maps/documentation/javascript/usage?hl=es
    Consigue una llave: https://developers.google.com/maps/documentation/javascript/get-api-key
  • Tipo de Google Maps: Tipo de mapa: Hoja de ruta, Satélite, Híbrido o Terreno
  • Diseño del mapa: Seleccione un diseño predeterminado para sus mapas
  • Desplazar el mapa del mouse: Habilite el zoom in / zoom out usando el mouse cuando esté sobre el mapa
  • Arrastrar mapa: Habilita el arrastre del mapa para moverte sobre él, usando el mouse
  • Marcador de evento abierto: Cómo se abre el detalle de la ubicación al hacer clic o sobre un marcador
  • Habilitar marcador de clúster: Cada grupo que tiene más de un marcador muestra un recuento del número de marcadores dentro del grupo
  • Característica Autozoom: Ajusta automáticamente el zoom para mostrar todos los marcadores del mapa.
  • Tipo de Bing Maps: Tipo de mapa: Aéreo, Ojo de pájaro o Carretera.
  • Bing map API key: poner una clave API para que funcione;)

 

Parameters2

 

  • Búsqueda en cualquier lugar: agrega la opción en la búsqueda de radio para buscar en cualquier parte del mundo
  • Buscar en cualquier lugar por defecto: de forma predeterminada, el selector de radio en la vista de búsqueda se configurará en Cualquier lugar
  • Formato de etiqueta en la búsqueda: mostrar los filtros de etiquetas como casilla de verificación o lista desplegable
  • Vista de calle: Añadir street view en búsqueda como opción
  • Ruta de visualización: Mostrar un enlace para calcular la ruta desde la posición del usuario.
  • Formato de ruta: mostrar la ruta en My Maps location o redirigir a Google
  • Contacto enlace en la ubicación: Añadir un enlace a una página de contacto
  • Botón de contacto: mostrar el botón de contacto
  • Destino del enlace de contacto: Abrir el modo de enlace de contacto
  • Zoom predeterminado del mapa: Nivel de zoom predeterminado en el mapa en la primera carga (establecer autozoom en no)
  • Tamaño de mapa: Mapa y resultados de búsqueda de ancho y alto.
  • Distancia por radio de búsqueda: determinar los valores de la lista desplegable de búsqueda de radio
    Ex. El usuario puede elegir buscar 10 millas alrededor de la ciudad de Nueva York.
  • Mostrar lista de selección de distancia: Opción para mostrar la lista de selección de búsqueda redius distancia

 

Parameters3

 

  • Recorte de palabras en los resultados de búsqueda: recortar la descripción de la ubicación a una cierta cantidad de palabras en los resultados de búsqueda
  • Barra lateral de JQuery: cambie la barra lateral predeterminada a JQuery one (efecto de desplazamiento suave y más pequeño)
  • Deshabilitar la geolocalización: Deshabilitar la geolocalización en el sitio no https.
  • Deshabilitar el filtro de categoría: esta opción habilitará el filtro de lista desplegable de categorías
  • Deshabilitar el filtro de estado del país: Mostrar un desplegable del estado del país en la vista de búsqueda
  • Búsqueda por código postal: Búsqueda por campo de código postal
  • Color para el botón OR: Color del botón "O" en el tema predeterminado
  • Color del boton: Color del botón "Geolocalizarme" en el tema predeterminado
  • Color de fuente global: use esta opción para establecer el color de fuente global de las ubicaciones de Mis mapas
  • Imagen de fondo: Imagen en el fondo de la búsqueda sobre tema por defecto.
  • Tu marcador agrega tu posición en el mapa y selecciona una imagen como marcador
  • Imagen de icono predeterminada: usar la imagen del icono por defecto si el icono no está disponible
  • Anulación del ayudante: generar un archivo de anulación de diseño estándar de Joomla que no se verá afectado por las actualizaciones de extensión (en la carpeta / html)

 

6.2 Bing como fuente de mapas

Para usar Bing Maps de Microsoft como fuente de mapas, debe completar una clave API en la configuración global de My Maps location. La página de Bing está aquí: https://www.bingmapsportal.com/

 

global-bing

 

Debe crear una cuenta gratuita desde aquí y copiar el código de clave API de su cuenta.

 

bing-key-microsoft

 

Entonces podrá usar Bing map como fuente de mapa desde la configuración global (para habilitarlo como predeterminado) o desde el elemento del menú.

 

bing-config

 

6.3 Mapbox como fuente del mapa

Para usar Mapbox, la plataforma de mapeo personalizada para desarrolladores, como fuente de mapas necesita completar una API de Mapbox en el Configuración de My Maps location> Proveedores de mapas.
La página de inicio de Mapbox está aquí, necesita crear una cuenta gratuita desde allí: https://www.mapbox.com/

 

mapbox-home

 

Desde allí puede crear un nuevo diseño de página o usar el recomendado y almacenarlo en su cuenta.

 

estilo de mapa

 

Para obtener sus credenciales use el menú cuenta (parte superior derecha):

  • Mapbox API: usa el menú Cuenta> Acceder a tokens

Así que obtienes una clave por el estilo de mapa que has creado.

 

mapbox-apikey

 

Luego simplemente cópielo en la configuración My Maps location para usarlo.

 

mapbox-config