FeedbackPilot

FeedbackPilot är WordPress-pluginet som förvandlar dina besökares felrapporter direkt till problem i ditt GitHub-arkiv - med en kommenterad skärmdump, sidans URL, webbläsar- och serverkontexten och de senaste konsolposterna bifogade. Du triagerar i GitHub som vanligt; dina besökare klickar bara på en liten knapp i kanten av skärmen.

Så här fungerar FeedbackPilot - i tre steg

1. Besökaren klickar på en diskret „Rapportera problem”-knapp i kanten av skärmen.
2. FeedbackPilot skapar en skärmdump av den aktuella sidan. Besökaren ritar på den var problemet är.
3. Lägg till en kort beskrivning, skicka in - och sekunder senare visas en ny fråga i ditt anslutna GitHub-arkiv.

Vem FeedbackPilot är avsedd för

• Platsoperatör, som vill ha en smidig kanal för felanmälan som inte hamnar i en e-postinkorg.
• Byråer, som underhåller kundwebbplatser och vill visa sina utvecklare verklig reproduktionskontext direkt i problemspåraren.
• Produktteam, som använder WordPress som frontend för en större applikation och som ändå hanterar sitt tekniska arbete via GitHub.

Vad som hamnar i GitHub-problemet

• Titel: „[Bugg] de första 60 tecknen i beskrivningen...” (eller „[Feedback]” för förslag).
• Beskrivning av användarna:in, citerad.
• Annoterad skärmdump som en inbäddad PNG.
• Browser-kontext: Användaragent, viewport, språk, plattform, pixelförhållande, ljus/mörk.
• Serverkontext: WordPress-version, PHP-version, aktivt tema, lista över aktiva plugins, locale.
• Konsollogg: de senaste 200 posterna (sammanfattade i ett
  -block).
• Etiketter: bugg, feedbackpilot.

Vad som medvetet inte överförs

• Inga cookies, ingen localStorage, inget formulärinnehåll.
• Inga IP-adresser, ingen spårning, inga analyspixlar.
• Inget innehåll från andra webbläsarflikar eller fönster.
• Inga tokens, inga hemligheter, inga data som endast är tillgängliga för administratörer.

Varför inte ett annat SaaS-verktyg?

Buggrapporter från besökare är en teknisk input. De hör hemma i samma inkorg som granskningar av grenar, driftsättningar och planering av färdplaner - vilket för de flesta team är GitHub. Verktyg som Marker.io, Userback eller Usersnap gör liknande saker, men är externa tjänster med egen inkorg, prenumeration och datalagring. FeedbackPilot finns kvar i de verktyg som du redan använder: WordPress på framsidan, GitHub bakom, inga nya avtal, inget extra spårningsskript på din webbplats. Koden är öppen källkod under GPL 2.0 - du kan läsa den, anpassa den och hosta den själv.

Anslutning till GitHub - med två klick

Efter installationen öppnar du Inställningar → FeedbackPilot och klicka på Anslut till GitHub. Du kommer att omdirigeras till github.com, auktorisera FeedbackPilot-appen och hamna tillbaka i WordPress-admin - med en krypterad token. Du anger sedan målarkivet (format ägare/repo) och välj de besökarroller som ska se widgeten. Nu är det klart.

Om du inte kan eller vill använda OAuth-flödet kan du alternativt klistra in en finkornig personlig access-token med „Issues: Read & Write”-behörighet på målförvaret. Båda metoderna fungerar på samma sätt.

Vad du behöver

• WordPress 6.0 eller nyare.
• PHP 7.4 eller nyare (PHP 8.0 eller högre rekommenderas).
• Ett GitHub-konto med ett arkiv där du kan skapa frågor - det räcker med GitHubs kostnadsfria plan.

Installation på mindre än två minuter

1. ZIP-fil efter nedladdning via Plugins → Installera → Ladda upp plugin att spela in.
2. Aktivera.
3. Under Inställningar → FeedbackPilot ansluta till GitHub och välja målförvaret.
4. Ange licensnyckeln - så att plugin-programmet uppdateras automatiskt i framtiden.

Vanliga frågor

Behöver jag en betald GitHub-plan?

Nej. Gratis GitHub-konton kan också skapa problem i sina egna arkiv. Pluginet fungerar identiskt i båda världarna.

Fungerar det med privata repositories?

Ja, OAuth-flödet auktoriserar FeedbackPilot-appen på de repos du väljer - inklusive privata repos. Den manuella PAT-vägen fungerar på samma sätt.

Gör widgeten min webbplats långsammare?

Nej, det enda externa biblioteket (html2canvas) laddas först när en besökare faktiskt klickar på knappen. Fram till dess är endast en liten CSS-fil och en liten JavaScript-fil aktiva. Effekten på sidhastigheten och andra viktiga webbfakta är försumbar.

Fungerar det med caching-plugins, Cloudflare eller WP Rocket?

Ja, widgetskripten är statiska och cachelagras utan problem. Konfigurationsändringar läses när sidan laddas och kräver ingen återställning av cacheminnet.

Kan jag skicka rapporter till något annat än GitHub?

I den nuvarande versionen 0.1.x är GitHub det enda målet. Om du skulle avblockera dig genom att skicka e-post, Slack eller linjära biljetter skulle vi gärna ta emot ditt förslag i GitHub-förvaret.

Var är skärmdumpen?

På din WordPress-sida under wp-content/uploads/feedbackpilot/. GitHub-bilden länkar till bilden därifrån. Den laddas inte upp till en tredjepartsleverantör.

Licens, uppdateringar och support

FeedbackPilot är fri programvara under GPL-2.0 eller senare - samma licens som WordPress själv. Nedladdningen på den här sidan är och förblir kostnadsfri. Med den licensnyckel som anges får du automatiska uppdateringar via den normala WordPress-uppdateringsmekanismen. Du hittar den fullständiga källkoden på GitHub. Frågor, buggrapporter och funktionsförfrågningar är välkomna via arkivet eller via e-post till hello@isla-stud.io.