Directorio de Academias - Plugin de WordPress

Directorio de Academias es un plugin personalizado para WordPress desarrollado para administrar, geolocalizar y visualizar academias de danza y ballet. Permite a los administradores gestionar una base de datos de academias y mostrarla en el frontend mediante un mapa interactivo de Google Maps y una lista filtrable.

📋 Características Principales

Panel de Administración

• Gestión CRUD: Añadir, editar y eliminar academias fácilmente desde el panel de WordPress.
• Geolocalización Automática: Al ingresar una academia, se pueden buscar coordenadas automáticamente o arrastrar un pin en el mapa para definir la latitud y longitud exactas.
• Base de Datos de Ubicaciones: Carga automática de Departamentos y Ciudades de Colombia (integración con datos.gov.co) para facilitar la selección en los formularios.
• Validación de API: Interfaz para ingresar y validar la clave API de Google Maps directamente desde el admin.

Frontend (Público)

• Buscador Avanzado: Filtrado por Departamento, Ciudad y búsqueda por Nombre de la academia.
• Geolocalización del Usuario: Botón "Usar mi ubicación" que detecta la posición del usuario y muestra las academias cercanas dentro de un radio ajustable (slider de km).
• Mapa Interactivo: Integración completa con Google Maps, marcadores personalizados y ventanas de información (InfoWindows) con detalles de contacto.
• Diseño Responsivo:
  • Vista de pestañas en móviles (alternar entre Lista y Mapa).
  • Diseño de grilla en escritorio.
• Integración Social: Botones directos a WhatsApp, Instagram y sitio web.

⚙️ Requisitos Previos

1. WordPress: Versión 5.0 o superior.
2. PHP: Versión 7.4 o superior.
3. Google Maps API Key: Debes tener una clave de API válida de Google Cloud Platform con los siguientes servicios habilitados:
   • Maps JavaScript API
   • Places API
   • Geocoding API
4. HTTPS: Para que la función "Usar mi ubicación" funcione correctamente en el navegador, el sitio debe tener certificado SSL.

🚀 Instalación

1. Descarga la carpeta del plugin pluginacademias.
2. Sube la carpeta al directorio /wp-content/plugins/ de tu instalación de WordPress.
3. Ve al panel de administración de WordPress > Plugins.
4. Busca Directorio de Academias y haz clic en Activar.
   • Nota: Al activar, el plugin creará automáticamente las tablas necesarias en la base de datos y poblará la lista de departamentos y ciudades.

🔧 Configuración

1. Configurar Google Maps

Para que el mapa se muestre, es obligatorio configurar la API Key:

1. Ve al menú Directorio de Academias en el panel lateral del admin.
2. Verás la sección "Configuración de Google Maps".
3. Pega tu API Key.
4. Haz clic en el botón Validar. Si la llave es correcta, aparecerá un mapa de prueba.
5. Haz clic en Guardar API.

2. Agregar Academias

1. En la misma pantalla del plugin, haz clic en "Agregar Academia".
2. Diligencia los datos (Nombre, Redes, Dirección).
3. Usa el buscador del mapa o arrastra el pin para establecer la ubicación exacta.
4. Guarda los cambios.

💻 Uso (Shortcode)

Para mostrar el directorio en cualquier página o entrada, utiliza el siguiente shortcode:

[mostrar_academias]