Download the PHP package lbcdev/livewire-map-component without Composer
On this page you can find all versions of the php package lbcdev/livewire-map-component. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package livewire-map-component
Livewire Map Component
Un componente Livewire flexible e interactivo para mapas usando Leaflet.js.
Características
- 🗺️ Mapas interactivos con Leaflet.js
- 📍 Marcadores arrastrables
- 🎯 Click en el mapa para colocar marcadores
- 📋 Entrada manual de coordenadas
- 🎨 Soporte para modo claro/oscuro
- 🔒 Modo de solo lectura opcional
- ⚡ Eventos Livewire para integración con otros componentes
Requisitos
- PHP 8.1 o superior
- Laravel 10.x o superior
- Livewire 3.x
Instalación
1. Instalar el paquete via Composer
2. Incluir Leaflet.js en tu layout
Agrega estos scripts en el <head> de tu layout principal (antes de @livewireStyles):
3. (Opcional) Publicar las vistas
Si deseas personalizar las vistas del componente:
Las vistas se publicarán en resources/views/vendor/lbcdev-map/.
Uso Básico
Uso simple
Con coordenadas iniciales
Modo de solo lectura
Con todas las opciones
Propiedades
| Propiedad | Tipo | Default | Descripción |
|---|---|---|---|
latitude |
?float |
null |
Latitud inicial del marcador |
longitude |
?float |
?null |
Longitud inicial del marcador |
interactive |
bool |
true |
Permite interacción con el mapa |
showLabel |
bool |
true |
Muestra etiqueta con coordenadas |
showPasteButton |
bool |
false |
Muestra botón para pegar coordenadas |
height |
int |
400 |
Altura del mapa en píxeles |
zoom |
int |
15 |
Nivel de zoom inicial |
Integración con Formularios
Usando en un formulario Livewire
Vista del formulario
Eventos
Eventos que emite el componente
map-coordinates-updated
Se emite cuando las coordenadas cambian (click en mapa, arrastrar marcador, o entrada manual):
Eventos que escucha el componente
fly-to-coordinates
Anima el mapa hacia unas coordenadas específicas:
Personalización
Estilos personalizados
El componente utiliza clases de Tailwind CSS. Puedes personalizar los estilos publicando las vistas y modificándolas según tus necesidades.
Coordenadas por defecto
Por defecto, si no se proporcionan coordenadas, el mapa se centrará en:
- Latitud: 36.9990019
- Longitud: -6.5478919
Puedes modificar estas coordenadas editando las constantes en el componente después de publicar las vistas.
Ejemplos Avanzados
Selector de ubicación para direcciones
Múltiples mapas en una página
Desarrollo y Contribución
Publicar una nueva versión
Para publicar una nueva versión del paquete en GitHub y Packagist, sigue estos pasos:
1. Actualizar el código
Realiza todos los cambios necesarios y asegúrate de que todo funciona correctamente.
2. Actualizar el CHANGELOG (opcional pero recomendado)
Documenta los cambios en un archivo CHANGELOG.md:
3. Commit de los cambios
4. Crear un tag con la versión
5. Subir los cambios y el tag a GitHub
6. Crear un Release en GitHub (opcional)
- Ve a tu repositorio en GitHub
- Click en "Releases" → "Create a new release"
- Selecciona el tag que acabas de crear (v1.0.1)
- Añade un título: "v1.0.1 - Correcciones de namespace"
- Describe los cambios en el release
- Click en "Publish release"
7. Actualización automática en Packagist
Si tu paquete está registrado en Packagist con el webhook de GitHub configurado, se actualizará automáticamente. Si no:
- Ve a packagist.org
- Busca tu paquete
- Click en "Update" para forzar la actualización
Versionado Semántico
Este paquete sigue Semantic Versioning:
- MAJOR (1.x.x): Cambios incompatibles con versiones anteriores
- MINOR (x.1.x): Nueva funcionalidad compatible con versiones anteriores
- PATCH (x.x.1): Correcciones de bugs compatibles con versiones anteriores
Ejemplos:
Ver tags existentes
Eliminar un tag (si cometiste un error)
Soporte
Si encuentras algún problema o tienes sugerencias:
Licencia
Este paquete es software de código abierto licenciado bajo la Licencia MIT.
Créditos
- Desarrollado por Tu Nombre
- Utiliza Leaflet.js para los mapas
- Construido con Livewire
All versions of livewire-map-component with dependencies
illuminate/support Version ^10.0|^11.0|^12.0
livewire/livewire Version ^3.0