Descripción
Bawbab Interactive Maps le permite crear mapas digitales intuitivos y explorables para campus, complejos residenciales, instalaciones comerciales y parques empresariales. Vaya más allá de las imágenes estáticas y permita a los visitantes buscar ubicaciones, explorar la distribución de los espacios y consultar al instante información detallada sobre edificios o servicios.
El plugin se integra a la perfección con WordPress, permitiendo a los administradores gestionar el contenido del mapa mediante herramientas del panel de control que ya les resultan familiares. Evite duplicar tareas vinculando directamente páginas existentes de WordPress con elementos del mapa para reutilizar su contenido de forma automática.
Features
- Explorable Interface: Search locations and view detailed building or amenity data.
- WordPress Integration: Manage all map content within your own website using standard WordPress tools. You own the data 100% in Bawbab Interactive Maps.
- Zero Duplication: Link existing pages directly to map markers to sync content.
- Highly Customizable: Complete control over installation, styling, and administration.
- External Links: A direct link at the bottom of the information panel routes users to the corresponding full WordPress page for deeper exploration.
- Fully Responsive: The interface fluidly adapts layout, menus, and controls across desktops, laptops, tablets, and phones.
- Future Roadmap: Planned updates include advanced campus routing, multi-floor indoor navigation, and native Google Maps directions integration.
External Services
Este plugin depende de la API de JavaScript de Google Maps (de terceros) para funcionar. A continuación, se presenta la información obligatoria sobre los datos transmitidos, su finalidad y los acuerdos legales aplicables.
- Service Name: Google Maps JavaScript API
- Provider: Google LLC
- Purpose: This service is used to render interactive maps, geocode addresses, and handle map configurations within both the WordPress admin dashboard (block editor / admin screens) and on the public-facing frontend of your website.
- Data Transmitted: When a map is loaded, the user’s browser connects directly to Google’s servers. This transmits the user’s IP address, browser user-agent string, the URL of the page where the map is embedded, and any API keys configuration details.
- When Data is Sent: Data is sent automatically whenever a user interacts with the map block editor in the WordPress dashboard, or visits a webpage on the frontend that displays an interactive map generated by this plugin.
- Condiciones del servicio: Leer
- Política de privacidad: Leer
User Guide
1. Data Importing & Maintenance
- How to Import: Select your target layer (Parcels, Buildings, Roads, or Land Use), choose your local GeoJSON file, and click import.
- Safe Updates: Re-importing updated GeoJSON files is non-destructive. It refreshes geometries and identifiers while preserving your custom descriptions, images, and linked pages.
- Clearing Layers: Warning! The «Clear Layer» button permanently wipes all geographic features and custom metadata linked to that specific layer.
2. Advanced Map Configuration
- Visual Styling: Toggle the global background map style (Road Map, Satellite, or Hybrid) and select an interface highlight accent color (Green, Blue, or Yellow).
- Google API Credentials: The plugin requires a Google Maps API Key and a Map ID. Generating your own via the Google Cloud Console offers independent quota management, usage tracking, and domain restriction security.
3. The Feature Editor (Edit Tools)
Gestione los metadatos de cada elemento mediante un panel de control de pantalla dividida que incluye un directorio con función de búsqueda a la izquierda y un formulario de edición a la derecha.
* Organización inteligente: Los elementos del mapa se clasifican dinámicamente en grupos de diseño personalizados (p. ej., planos de apartamentos específicos, modelos de estudio o estilos de cabañas).
* Filtrado avanzado: Acote la selección de sus activos mediante barras de búsqueda o filtros de atributos para aislar tipos de unidades específicos al instante.
* Sincronización con páginas de WordPress: Vincule cualquier elemento del mapa directamente a una página de WordPress existente. El plugin sincroniza automáticamente el título de la página, el texto, las galerías de imágenes y los vídeos incrustados para evitar actualizaciones de contenido duplicado.
* Filtrado de contenido: El plugin depura automáticamente el contenido sincronizado de WordPress. Elimina elementos que sobrecargan el diseño, como tablas, botones, formularios, scripts e iframes, para mantener limpio y enfocado el panel lateral del mapa interactivo.
* Personalización de visualización: Personalice los títulos de forma independiente para la interfaz del mapa sin modificar el nombre de la página principal de WordPress vinculada.
* Metadatos de la propiedad: Introduzca datos personalizados de la unidad, como la superficie en pies cuadrados, opciones de chimenea, disponibilidad de solárium y número exacto de baños, para mostrarlos en las ventanas emergentes del mapa.
* Personalización avanzada de medios: Aunque los parámetros de Advanced Custom Fields (ACF) recuperan los medios automáticamente, los administradores pueden forzar manualmente rutas de vídeo personalizadas, sustituir planos específicos desde la Biblioteca de medios o desactivar por completo la visibilidad de los medios para marcadores individuales.
* Descripciones dinámicas: Elija si el resumen personalizado de un marcador sobrescribe totalmente el texto de la página de WordPress sincronizada o si se añade limpiamente en la parte superior para promociones temporales y notas sobre renovaciones.
* Procesamiento por lotes: Edite varias ubicaciones, ajuste los campos de unidades individuales y previsualice en tiempo real los marcadores de ubicación en un mapa incrustado en miniatura antes de publicar los cambios mediante un único guardado masivo.
4. Shortcode & Block Integration
- Classic Editor Integration: Adds a dedicated «Map» utility icon directly into the tinyMCE editor toolbar to auto-inject your map shortcode configuration instantly.
- Layout Scaling: Maps display out-of-the-box at 100% available container width with an adjustable default viewport canvas profile height of 640px.
- Gutenberg Compatibility: Fully supports modern Block Editor placements alongside the legacy shortcode engine for seamless multi-theme integration.
5. Visitor Front-End Experience
El mapa interactivo ofrece un diseño moderno y adaptable (*responsive*) que funciona en equipos de escritorio, tabletas y dispositivos móviles. En lugar de navegar por múltiples páginas web, los visitantes pueden explorar visualmente sus instalaciones y consultar datos en tiempo real sobre edificios o servicios.
* Búsqueda mediante varios métodos: Los visitantes pueden buscar directamente por nombre utilizando la barra de búsqueda superior para centrar automáticamente el mapa, o bien explorar elementos agrupados en categorías personalizadas (p. ej., unidades residenciales, servicios, instalaciones).
* Controles de mapa intuitivos: Admite las funciones estándar de desplazamiento, zoom y selección.
* Protección mediante geocercas: Incluye límites geográficos integrados para evitar que los usuarios se desplacen o amplíen la vista fuera del área designada del recinto.
* Edificios de varias plantas: El selector de plantas integrado permite a los usuarios cambiar de nivel mediante botones o la rueda del ratón para filtrar los elementos específicos de cada piso.
* Gestión de capas: Los visitantes pueden activar o desactivar capas (edificios, carreteras, uso del suelo, marcadores) y ajustar la transparencia para centrarse en datos específicos.
* Leyenda desplegable: Explica los símbolos y el código de colores del mapa sin saturar la pantalla.
* Estilos de mapa: Los usuarios pueden alternar libremente entre mapas de carreteras estándar y vistas por satélite.
* Integración con Google: Compatibilidad integrada con las funciones nativas de zoom, brújula y Street View.
6. The Information Panel Side-Drawer
Al seleccionar cualquier elemento del mapa, se abre un panel de información detallada que combina datos cartográficos personalizados con páginas de WordPress sincronizadas:
* Galería multimedia: Admite fotografías a pantalla completa, planos de planta y vídeos promocionales.
* Especificaciones rápidas: Muestra metadatos clave de la propiedad, como la superficie, el número de habitaciones o las comodidades específicas.
* Descripciones dinámicas: Integra a la perfección notas específicas del mapa con contenido importado de WordPress.
Technical Details
Este plugin se ha desarrollado siguiendo los estándares modernos de creación de bloques para WordPress y utilizando motores avanzados de renderizado GIS. Emplea las siguientes bibliotecas y tecnologías fundamentales:
* WordPress Block Editor (@wordpress/block-editor): Gestiona la interfaz de usuario, las configuraciones de los bloques y los controles del panel lateral de inspección dentro de Gutenberg.
* WordPress Element (@wordpress/element): Proporciona la capa de abstracción de React utilizada para integrar sin problemas las configuraciones de mapas y los motores de vista previa en tiempo real.
* WordPress Scripts (@wordpress/scripts): Gestiona el empaquetado de recursos, la agrupación de archivos CSS/JS, el análisis de código (linting) y la automatización del sistema de compilación.
* Google Maps JavaScript API: Impulsa el diseño dinámico del lienzo en el front-end, el renderizado de polígonos vectoriales, la superposición de capas y las vistas a pie de calle (Street View).
* Ver en GitHub
* Informar de problemas
* Seguir al codesarrollador: Marcel Oketch
* Seguir al codesarrollador: Corentin Sanchez
Para configuraciones técnicas avanzadas, consulte la guía para desarrolladores al final de esta documentación.
Developer Guide
Siga estos pasos para configurar, modificar y ejecutar este entorno de plugin localmente.
Prerequisites
Asegúrate de tener instalado lo siguiente en tu equipo:
* Node.js (se recomienda la versión LTS)
* NPM (incluido con Node.js)
* Un entorno de desarrollo local de WordPress (p. ej., LocalWP, DevKinsta o wp-env)
* Una clave de API de Google Maps JavaScript y un ID de mapa válidos, configurados para pruebas a nivel de dominio
Dev Installation & Setup
- Clone or move this plugin folder into your local WordPress installation directory:
/wp-content/plugins/bawbab-interactive-maps - Abre tu terminal y navega hasta el directorio raíz del plugin:
cd /path/to/wp-content/plugins/bawbab-interactive-maps - Instala las dependencias de desarrollo y las herramientas de empaquetado necesarias:
npm install
Development Workflow
- Iniciar servidor de desarrollo local: Ejecuta el script de vigilancia (*watch script*) para rastrear y compilar automáticamente los cambios en el código en tiempo real mientras editas los archivos fuente de los bloques.
- Compilación para producción: Minifica las distribuciones de la compilación, optimiza las hojas de estilo y prepara el paquete de producción de tu plugin para el despliegue.
npm run build - Formato de código: Corrige automáticamente las estructuras de formato de los scripts para que se ajusten estrictamente a los estándares de estilo principales de WordPress.
npm run format
- Lint de JavaScript y CSS: Analiza tus módulos de código en busca de advertencias, errores lógicos e infracciones de estilo antes de publicar actualizaciones.
npm run lint:js
npm run lint:css
Testing Changes
- Activa el plugin a través del panel de administración local de WordPress.
- Añade tus credenciales de Google Maps en Map Settings Settings.
- Dirígete a la pestaña Importador y realiza una carga de prueba utilizando un archivo de bloque GeoJSON de ejemplo estándar.
- Abre una entrada o página en el editor Gutenberg, abre el insertador de bloques y busca «Bawbab Interactive Map» para comprobar la renderización de la vista previa en el lienzo.
Bloques
Este plugin proporciona 1 bloque.
- BawBab Interactive Map Widget BawBab Interactive Maps Widget to add your interactive map on your sitefront.
Instalación
- Ve a Plugins Añadir nuevo en tu escritorio de WordPress.
- Haz clic en Subir plugin en la parte superior de la página.
- Selecciona el archivo ZIP del plugin proporcionado por nuestro equipo.
- Haz clic en Instalar ahora y activa el plugin.
Seguridad en la gestión de plugins
- Desactivación: Deshabilitar el plugin impide que el mapa se visualice públicamente, pero conserva de forma segura todos los datos del mapa, la configuración y los diseños personalizados.
- Desinstalación: ¡Advertencia! Eliminar el plugin desde el escritorio de WordPress borra permanentemente todos los datos de mapas y configuraciones importados. Esta acción no se puede deshacer.
FAQ
-
Mis cambios no se ven en el sitio web.
-
Esto suele deberse a la caché. Si las actualizaciones no aparecen al instante, prueba los siguientes pasos:
1. Fuerza la recarga del navegador usando Ctrl + F5 (Windows) o Cmd + Shift + R (Mac).
2. Borra completamente la caché local del navegador.
3. Vacía la caché de tu plugin de WordPress o la caché del servidor.
4. Elimina cualquier caché persistente a nivel de servidor del proveedor de alojamiento.
Si los problemas persisten, contacta con nuestro equipo de soporte. -
Puedo actualizar los metadatos importando un nuevo GeoJSON?
-
No. El importador actualiza las geometrías espaciales (contornos, trazados, límites) sin afectar a las entradas personalizadas de la base de datos de WordPress. Los cambios en los metadatos dentro de un nuevo archivo GeoJSON no sobrescribirán el contenido existente en el sitio. Para reemplazar completamente los metadatos, primero debe utilizar la opción «Borrar capa» (Clear Layer), la cual elimina de forma permanente todas las personalizaciones existentes para dicha capa.
-
Eso sucede cuando se añaden nuevos edificios al GeoJSON?
-
El plugin detecta y crea automáticamente cualquier elemento nuevo presente en el conjunto de datos. Por su parte, los elementos existentes se actualizan con las nuevas geometrías estructurales, conservando intactas sus descripciones personalizadas, enlaces y archivos multimedia.
-
¿Cómo preparo los datos GeoJSON para su importación?
-
Los archivos deben cumplir con las especificaciones estándar de GeoJSON. Cada elemento requiere un identificador único (FID), así como atributos de capa como nombre, categoría, código y coordenadas. Los campos de gestión de contenidos —tales como galerías, vídeos y descripciones— se administran directamente en WordPress y deben omitirse del archivo GIS. Es posible exportar archivos GeoJSON compatibles directamente desde programas como QGIS o ArcGIS.
-
Ya tengo archivos shapefile. ¿Puedo utilizarlos?
-
Sí. Puede utilizar software SIG estándar para exportar sus archivos ESRI Shapefile al formato GeoJSON. Es posible que deba ajustar los nombres de las columnas de atributos para que coincidan con las propiedades que espera el complemento antes de ejecutar la herramienta de importación.
-
No tengo datos SIG. ¿Puede crearlos para mí?
-
Sí. Nuestro equipo ofrece servicios integrales de digitalización. Podemos mapear desde cero sus edificios, los límites del campus, las vías de circulación y los puntos de interés, y entregar archivos GeoJSON listos para su importación.
-
Todavía necesito ayuda.
-
Para la resolución de problemas técnicos, configuración manual, digitalización SIG o solicitudes de nuevas funcionalidades, contacte directamente a nuestro equipo de soporte principal por correo electrónico:
* Corentin Sanchez Trenado: corentins@bawbab.com
* Marcellus Oketch: oketchmarcellus@bawbab.com
Reseñas
No hay valoraciones para este plugin.
Colaboradores y desarrolladores
«Bawbab Interactive Maps» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
ColaboradoresTraduce «Bawbab Interactive Maps» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
0.1.0
- Initial release.
- Added support for custom vector layer maps (Parcels, Buildings, Roads, Land Use).
- Implemented live-sync mechanics linking core WordPress pages to interactive map sidebar frames.
- Integrated
@wordpress/block-editorand@wordpress/elementmodules for administration setup modules.
