FeedbackPilot

FeedbackPilot es el plugin de WordPress que convierte los informes de errores de tus visitantes directamente en problemas en tu repositorio de GitHub, con una captura de pantalla anotada, la URL de la página, el contexto del navegador y del servidor y las últimas entradas de la consola adjuntas. Usted realiza el triaje en GitHub como de costumbre; sus visitantes sólo tienen que hacer clic en un pequeño botón en el borde de la pantalla.

Cómo funciona FeedbackPilot - en tres pasos

1. El visitante pulsa un discreto botón „Informar de un problema“ situado en el borde de la pantalla.
2. FeedbackPilot crea una captura de pantalla de la página actual. El visitante dibuja en ella dónde está el problema.
3. Añade una breve descripción, envíala y, segundos después, aparecerá una nueva incidencia en tu repositorio de GitHub conectado.

Para quién está hecho FeedbackPilot

• Operador del sitio, que desean un canal de notificación de errores poco friccionado que no acabe en una bandeja de entrada de correo electrónico.
• Agencias, que mantienen sitios de clientes y desean mostrar a sus desarrolladores el contexto real de reproducción directamente en el gestor de incidencias.
• Equipos de productos, que utilizan WordPress como interfaz de una aplicación más amplia y gestionan su trabajo de ingeniería a través de GitHub.

Lo que termina en la edición de GitHub

• Título: „[Error] primeros 60 caracteres de la descripción...“ (o „[Feedback]“ para sugerencias).
• Descripción de los usuarios:en, citado.
• Captura de pantalla comentada como PNG incrustado.
• Contexto del navegador: Agente de usuario, viewport, idioma, plataforma, proporción de píxeles, claro/oscuro.
• Contexto del servidor: Versión de WordPress, versión de PHP, tema activo, lista de plugins activos, configuración regional.
• Registro de la consola: las últimas 200 entradas (colapsadas en un bloque ).
• Etiquetas: error, feedbackpilot.

Lo que no se transfiere deliberadamente

• Sin cookies, sin localStorage, sin contenido de formularios.
• Sin direcciones IP, sin seguimiento, sin píxeles de análisis.
• Sin contenido de otras pestañas o ventanas del navegador.
• Sin tokens, sin secretos, sin datos exclusivos para administradores.

¿Por qué no otra herramienta SaaS?

Los informes de errores de los visitantes son una aportación de ingeniería. Pertenecen a la misma bandeja de entrada que las revisiones de las ramas, los despliegues y la planificación de la hoja de ruta, que para la mayoría de los equipos es GitHub. Herramientas como Marker.io, Userback o Usersnap hacen cosas similares, pero son servicios externos con su propia bandeja de entrada, suscripción y almacenamiento de datos. FeedbackPilot permanece en las herramientas que ya utiliza: WordPress por delante, GitHub por detrás, sin nuevos contratos, sin script de seguimiento adicional en su sitio. El código es abierto bajo licencia GPL 2.0 - puedes leerlo, personalizarlo y alojarlo tú mismo.

Conexión a GitHub: en dos clics

Tras la instalación, abra Ajustes → FeedbackPilot y haga clic en Conectarse a GitHub. Serás redirigido a github.com, autorizarás la aplicación FeedbackPilot y volverás al administrador de WordPress, con un token encriptado. A continuación, introduzca el repositorio de destino (formato propietario/repo) y seleccione los roles de visitante que deben ver el widget. Listo.

Si no puedes o no quieres usar el flujo OAuth, puedes alternativamente pegar un token de acceso personal de grano fino con autorización „Issues: Read & Write“ en el repositorio de destino. Ambos métodos funcionan de la misma manera.

Lo que necesitas

• WordPress 6.0 o posterior.
• PHP 7.4 o superior (se recomienda PHP 8.0 o superior).
• Una cuenta de GitHub con un repositorio en el que puedas crear incidencias: el plan gratuito de GitHub es suficiente.

Instalación en menos de dos minutos

1. Archivo ZIP después de descargarlo a través de Plugins → Instalar → Subir plugin para grabar.
2. Activar.
3. En Ajustes → FeedbackPilot conéctate a GitHub y selecciona el repositorio de destino.
4. Introduzca la clave de licencia para que el plugin se actualice automáticamente en el futuro.

Preguntas frecuentes

¿Necesito un plan de pago de GitHub?

No. Las cuentas gratuitas de GitHub también pueden crear incidencias en sus propios repositorios. El plugin funciona de forma idéntica en ambos mundos.

¿Funciona con repositorios privados?

Sí, el flujo OAuth autoriza la aplicación FeedbackPilot en los repos que seleccione, incluidos los privados. La ruta manual PAT funciona de la misma manera.

¿El widget ralentiza mi sitio?

No. La única biblioteca externa (html2canvas) sólo se carga cuando un visitante hace realmente clic en el botón. Hasta entonces, sólo están activos un pequeño archivo CSS y otro JavaScript. El efecto sobre la velocidad de la página y los elementos vitales de la web es insignificante.

¿Funciona con plugins de caché, Cloudflare o WP Rocket?

Sí, los scripts de los widgets son estáticos y se almacenan en caché sin problemas. Los cambios de configuración se leen cuando se carga la página y no requieren un restablecimiento de la caché.

¿Puedo enviar informes a otro sitio que no sea GitHub?

En la versión actual 0.1.x, GitHub es el único objetivo. Si el envío de correos electrónicos, Slack o tickets lineales te desbloqueara, estaremos encantados de recibir tu sugerencia en el repositorio de GitHub.

¿Dónde está la captura de pantalla?

En su página de WordPress en wp-content/uploads/feedbackpilot/. La imagen de GitHub enlaza la imagen desde allí. No está subida a un proveedor externo.

Licencia, actualizaciones y asistencia

FeedbackPilot es software libre bajo la GPL-2.0 o posterior - la misma licencia que el propio WordPress. La descarga en esta página es y seguirá siendo gratuita. Con la clave de licencia proporcionada, recibirá actualizaciones automáticas a través del mecanismo normal de actualización de WordPress. Puede encontrar el código fuente completo en GitHub. Se aceptan preguntas, informes de errores y solicitudes de funciones a través del repositorio o por correo electrónico a hello@isla-stud.io.