GF User Journey

WordPress-plugin som spårar besökares navigering och bifogar hela användarresan i Gravity Forms notifikationsmail samt visar den i entry detail.

Hur det fungerar

1. Spårning — Varje sidvisit lagras i localStorage (inga cookies, inga externa anrop)
2. Formulär — Vid Gravity Forms-inlämning injiceras resan som dolda fält
3. Lagring — Servern parsar och sparar journey som entry meta
4. E-post — Journey bifogas i notifikationsmail (valfritt per notifikation)
5. Admin — En meta box på entry detail-sidan visar hela resan

Funktioner

• Spårar sidtitel, URL och tid på varje sida
• Fångar externa referrers vid första besöket
• Första-touch UTM-attribution (source, medium, campaign, term, content)
• Auto-detekterar Google Ads-klick via gad_source=1 (sätter source=google, medium=cpc)
• Deduplicerar vid sidomladdning
• Stöder dynamiskt laddade formulär (popups, AJAX)
• Automatisk rensning av localStorage efter inskickat formulär (tack-sidan spåras ej)
• Server-side validering och storleksbegränsning (max 100 poster, 10 KB)
• HTML-tabell i HTML-mail, ren text i textmail
• Meta box i GF entry detail med fullständig journey
• Data sparas som entry meta — rensas automatiskt med entries
• Svenska översättningar (sv_SE) inkluderade
• Automatiska uppdateringar via GitHub Releases

Notifikationsinställningar

Varje GF-notifikation har två toggles:

• Inkludera kundresan — bifogar journey-tabellen i mailet
• Skicka kundresan enbart till BCC — skickar separat mail med journey till BCC-adresserna

Krav

• WordPress 6.5+
• PHP 7.4+
• Gravity Forms (deklarerat via Requires Plugins)

Installation

1. Ladda upp mappen gf-user-journey/ till wp-content/plugins/
2. Aktivera pluginet i WordPress-admin

Pluginet kräver ingen konfiguration — det börjar spåra direkt.

Automatiska uppdateringar

Pluginet hämtar uppdateringar direkt från GitHub Releases. Nya versioner visas i WordPress-admin under Uppdateringar.

Utveckling

Kräver Node.js och Composer.

cd gf-user-journey
npm install
composer install

Kommandon

Produktion vs debug

Pluginet laddar user-journey.min.js som standard. Sätt SCRIPT_DEBUG till true i wp-config.php för att ladda den ominifierade versionen:

define( 'SCRIPT_DEBUG', true );

Release-process

1. Bumpa version i gf-user-journey.php (header + VERSION-konstant) och package.json
2. Committa och pusha
3. git tag v1.0.X && git push origin v1.0.X
4. GitHub Actions bygger zip och skapar release automatiskt
5. WP-siter ser uppdateringen i admin

Begränsningar

• Spårar inte om localStorage är inaktiverat
• Max 100 poster och 10 KB per besökare
• Data äldre än 1 år rensas automatiskt

Licens

GPL v2 or later