# WhatsApp Floating Widget

🔗 También disponible en: [Português](README.md) | [English](README.en.md) | [Español](README.es.md)

Este es un widget liviano y sencillo de botón flotante de WhatsApp, desarrollado con HTML, CSS y JavaScript puro. Permite que los visitantes de tu sitio contacten directamente vía WhatsApp con un solo clic.

## 🚀 Funcionalidades

- **Sin Dependencias**: Creado con JavaScript y CSS puro.
- **Fácil Integración**: Solo añade el script y el CSS a tu proyecto.
- **Configurable**: Define el número de teléfono, el mensaje inicial y la posición mediante atributos `data`.
- **Ícono SVG**: Ícono de WhatsApp nítido y escalable.

## 📦 Instalación vía NPM
<br>

Puedes instalar este paquete fácilmente vía npm:

```bash
npm install whatsapp-floating-widget
```

## 💻 Uso (ES Modules / Bundlers)

Ideal para proyectos React, Vue, Angular o Vanilla JS con Webpack/Vite.

1. **Importa el JS y el CSS:**

```javascript
import WhatsAppWidget from 'whatsapp-floating-widget';
// Si usas un bundler de CSS
import 'whatsapp-floating-widget/widget.css';
```

2. **Inicializa el widget:**

```javascript
WhatsAppWidget.init({
    phoneNumber: '553340420000',
    message: '¡Hola! Me gustaría más información.',
    position: 'right' // 'right' o 'left'
});
```

---

## 🚀 Uso vía Upload (Etiqueta Script)
<br>
1. Descarga `widget.js` y `widget.css` y colócalos en tu proyecto.
2. Añade la referencia al CSS dentro del `<head>` de tu HTML:

```html
<link rel="stylesheet" href="./ruta/a/widget.css">
```

3. Añade el script antes del cierre de la etiqueta `</body>`, configurando los atributos necesarios:

```html
<!-- Ejemplo -->
<script 
    src="./ruta/a/widget.js" 
    data-phone="553340420000" 
    data-message="¡Hola! Me gustaría más información." 
    data-position="right">
</script>
```

## 🚀 Uso vía CDN (jsDelivr)
<br>
1. Añade la referencia al CSS dentro del `<head>` de tu HTML:

```html
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/whatsapp-floating-widget@latest/widget.css">
```

2. Añade el script antes del cierre de la etiqueta `</body>`, configurando los atributos necesarios:

```html
<!-- Ejemplo -->
<script 
    src="https://cdn.jsdelivr.net/npm/whatsapp-floating-widget@latest/widget.js" 
    data-phone="553340420000" 
    data-message="¡Hola! Me gustaría más información." 
    data-position="right">
</script>
```

## ⚙️ Configuración

Puedes configurar el widget usando los siguientes atributos `data-` en la etiqueta `<script>`:

| Atributo | Descripción | Predeterminado / Ejemplo |
|----------|-------------|--------------------------|
| `data-phone` | El número de WhatsApp para contacto (con código de país). | `553340420000` |
| `data-message` | Mensaje inicial prellenado. | `¡Hola! Me gustaría más información.` |
| `data-position` | Posición del botón en la pantalla (`right` o `left`). | Predeterminado: `right` (si no se especifica o se usa otro valor) |

## 🤝 Contribuciones

¡Las contribuciones son bienvenidas! Si tienes sugerencias o mejoras:

1. Haz un Fork del proyecto.
2. Crea una rama para tu feature (`git checkout -b feature/TuFeature`).
3. Haz commit de tus cambios (`git commit -m 'Add feature X'`).
4. Haz push de la rama (`git push origin feature/TuFeature`).
5. Abre un Pull Request.

## 📄 Licencia

Creado por [Gigabaite Tecnologia](https://www.gigabaite.com.br) y distribuido bajo la licencia MIT. Consulta el archivo [LICENSE](LICENSE) para más detalles.

```
