WP Manifestindependent plugin directory
manifest / forms / gf-user-journey

GF User Journey self-updates

WordPress plugin: Tracks visitor navigation and appends the full user journey to Gravity Forms notifications

by Digiwise · github.com/landerss0n/gf-user-journey

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/landerss0n/gf-user-journey/archive/refs/heads/main.zip

Ships its own WordPress updater (Plugin Update Checker), so new versions show up under Dashboard → Updates.

Readme github.com/landerss0n/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

Kommando Beskrivning
npm run lint Kör ESLint
npm run lint:fix Kör ESLint med autofix
npm run build Minifierar JS med Terser
npm run dev Lint + build
npm run phpcs Kör PHP CodeSniffer
npm run phpcbf Kör PHPCBF autofix
npm run package Lint + build + skapa zip

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