Download the PHP package lukehowland/helpdeskwidget without Composer
On this page you can find all versions of the php package lukehowland/helpdeskwidget. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package helpdeskwidget
🎫 Helpdesk Widget para Laravel
Widget embebible para integrar el sistema de tickets de Helpdesk en proyectos Laravel externos.
✨ Características
- 🔐 Autenticación automática/manual con Helpdesk
- 📱 Widget responsive embebido en iframe
- 🎨 Compatible con AdminLTE v3
- 🔧 Comando de instalación incluido
- 📐 Altura dinámica via postMessage
📋 Requisitos
- PHP 8.2+
- Laravel 11.x o 12.x
- Guzzle HTTP Client
🚀 Instalación
1. Instalar el paquete
2. Ejecutar el instalador
Este comando:
- ✅ Publica
config/helpdeskwidget.php - ✅ Crea
resources/views/helpdesk.blade.php - ✅ Agrega ruta
/helpdeskaroutes/web.php - ✅ Muestra instrucciones para AdminLTE
3. Configurar variables de entorno
Añade estas líneas a tu archivo .env:
Nota: El API Key es proporcionado por el administrador de Helpdesk cuando registra tu empresa.
4. Limpiar caché
5. ¡Listo!
Visita /helpdesk en tu navegador.
🛠️ Opciones del Instalador
📦 Uso Manual (sin instalador)
En cualquier vista Blade
Publicar configuración manualmente
🎨 Integración con AdminLTE v3
El instalador crea automáticamente la vista y la ruta, pero debes agregar manualmente el enlace en el sidebar.
Paso 1: Agregar "Centro de Soporte" al sidebar
Abre config/adminlte.php y busca el array 'menu' => [. Al final del array (antes del cierre ]), agrega:
Paso 2: Limpiar caché
¡Listo! Ahora verás "Centro de Soporte" en el sidebar de AdminLTE.
⚙️ Configuración Avanzada
Archivo: config/helpdeskwidget.php
🔄 Flujo de Autenticación
- Usuario detectado: Lee
auth()->user()para obtener email y nombre - Verificación: Consulta a Helpdesk si el usuario ya tiene cuenta
- Login automático: Si existe, obtiene token JWT
- Registro: Si no existe, muestra formulario para crear contraseña
- Widget: Muestra la interfaz de tickets
🔧 Personalización del Modelo User
El componente busca automáticamente estos atributos en tu modelo User:
Si tu modelo tiene atributos diferentes, puedes extender el componente:
🐛 Solución de Problemas
"API Key inválida"
- Verifica que
HELPDESK_API_KEYesté en tu.env - Confirma que tu empresa esté registrada en Helpdesk
"Widget no carga"
- Ejecuta
php artisan config:clear - Verifica la URL en
HELPDESK_API_URL
"Error de CORS"
- El servidor Helpdesk debe permitir tu dominio
- Contacta al administrador de Helpdesk
"X-Frame-Options error"
- El servidor Helpdesk necesita permitir iframes
- Esto se configura en el servidor, no en tu proyecto
📄 Licencia
MIT License - Ver LICENSE
🤝 Soporte
- 📧 Email: [email protected]
- 🐛 Issues: GitHub Issues
All versions of helpdeskwidget with dependencies
illuminate/support Version ^11.0|^12.0
illuminate/console Version ^11.0|^12.0
guzzlehttp/guzzle Version ^7.0