Hoppa till innehåll

Events Hjälp & Manual

Events by Heddan

Hjälp & manual

Här hittar du snabb hjälp för event, anmälningar, bokningsförfrågningar, artister/utförare, PWA, kalender och drift.

Kom igång

Grundflödet från installation till första publicerade event.

1. Kontrollera inställningar

Gå till Events by Heddan → Inställningar. Kontrollera språk, PWA, anmälningar, väntelista, e-postmallar, QR-val, onlinehjälpens synlighet och GDPR-rensning.

2. Skapa eller kontrollera standardsidor

Pluginet skapar normalt sidor för eventlista, skicka in event och hjälp. Saknas en sida kan du skapa en vanlig WordPress-sida och lägga in rätt shortcode. Se shortcode-tabellen under Events by Heddan → Guide för vilken shortcode som hör till vilken sida.

3. Testa hela flödet

Skapa ett testevent, gör en anmälan, kontrollera e-post, testa avbokningslänk, lägg till i kalender och kontrollera att eventet visas rätt i kalendern.

Sidor och shortcodes

Vilka shortcodes som ska användas på vilka sidor.

[events_by_heddan] – Eventlista

Visar kommande event som kort (grid) eller lista. Parametrar: view="list", limit="12", category="slug", type="typ".

[events_by_heddan_calendar] – Kalender

Månadskalender med klickbara dagar och navigation. Visar event med start-tid och titel i respektive dag.

[events_by_heddan_submit] – Skicka in / redigera event

Formulär för att skicka in ett nytt event (hamnar som pending för granskning). Används även som redigeringssida: länk med ?ebh_edit=ID prefylls automatiskt med eventets data. Inkluderar kategoriväljare och längre beskrivning.

[events_by_heddan_my_events] – Mina event

Visar den inloggade arrangörens egna event med statusmärken (Publicerat / Inväntar granskning / Utkast) och knappar för att visa, redigera och radera. Radering är bara möjlig för pending och draft – publicerade event kräver admin.

[events_by_heddan_dashboard] – Arrangörsdashboard

Visar egna event, anmälningsantal och privata förfrågningar för inloggade användare med eventbehörighet.

[events_by_heddan_request] – Bokningsförfrågan

Privat förfrågan till en eller flera artister/utförare. Syns inte publikt. Skapar ett ebh_event_request som kan göras om till officiellt event av admin.

[events_by_heddan_performers] – Artister och utförare

Publik lista med aktiva utförare som valt publik profil. Sökning, filtrering och detaljkort ingår.

[events_by_heddan_performer_dashboard] – Utförardashboard

Dashboard för den utförare som är kopplad till aktuell WordPress-användare. Visar egna förfrågningar och möjlighet att svara.

[events_by_heddan_help] – Onlinehjälp

Visar manualen online med live-sökning, expanderbara avsnitt och innehållsförteckning. Åtkomst styrs av inställningen Vem får läsa hjälpsidan.

Skapa och hantera event

Allt om att skapa, kategorisera, redigera och publicera event.

Skapa event i admin

Gå till Events by Heddan → Lägg till event. Fyll i titel, beskrivning, start/slut, plats, typ, kapacitet och kategori. Publicera när allt är klart.

Kategorisera event

Använd taxonomin Eventkateogorier (menyn under Events by Heddan) för att skapa och tilldela kategorier. Kategorier visas som taggar på korten och kan filtreras i eventlistan och kalendern.

Skicka in event från frontend

Om inställningen Publiga inlämningar är aktiverad kan besökare (eller inloggade) skicka in event via [events_by_heddan_submit]. Inlämnade event hamnar automatiskt som Inväntar granskning och måste godkännas av admin innan de publiceras.

Redigera eget event från frontend

En arrangör kan redigera sitt eget event via Mina event → Redigera. Redigering av ett publicerat event skickar tillbaka det till Inväntar granskning tills admin godkänner ändringen.

Duplicera event

I admin-listläget för event finns Duplicera i åtgärdsraden. Skapar en kopia som utkast med all meta, men utan anmälningar.

Återkommande event

Aktivera Återkommande event i metaboxen och välj frekvens (dagligen, veckovis, månadsvis). Pluginet skapar automatiskt kopior i förväg via cron.

Anmälningar och kapacitet

Hantering av anmälningar, väntelista, bekräftelser och avbokningar.

Aktivera anmälningar

Aktivera Anmälningar globalt i Inställningar och sedan per event i metaboxen. Ange kapacitet för att begränsa antalet platser.

Väntelista

När kapaciteten är full erbjuds besökare väntelisteplats om inställningen är aktiverad. Admin kan godkänna väntelistanmälningar manuellt. Anmälaren notifieras via e-post.

Avbokning

Bekräftelsemejlet innehåller en personlig avbokningslänk. Avbokningslänkar är tokeniserade och kräver inte inloggning. Konfigurera om avbokning ska vara möjlig och eventuell deadline i Inställningar.

Exportera anmälningar

Under Events by Heddan → Anmälningar finns en knapp för att exportera anmälningar som CSV. Fälten är nonce-skyddade mot formel-injektion.

Antal lediga platser

Visas på eventkort och på eventsidan. Hämtas i en samlad databas-fråga för hela listan (inga N+1-frågor).

Notifikationer

In-app bell-ikon, automatiska triggers och vad varje notis betyder.

Bell-ikonen i adminbaren

🔔-ikonen visas i WP-adminbaren för alla inloggade med Events by Heddan-behörighet, både i WP-admin och på frontend (om adminbaren är aktiv). Klicka för att öppna panelen med de senaste 30 notiserna.

Automatiska triggers
  • Nytt event inlämnat – admin notifieras när en arrangör skickar in ett nytt event.
  • Event redigerat – admin notifieras när ett publicerat event skickas tillbaka för granskning.
  • Event godkänt – arrangören notifieras när admin publicerar ett pending-event.
  • Event avslaget – arrangören notifieras när admin skickar ett pending-event till utkast.
Markera som läst

Klicka på Markera alla som lästa i notis-panelen. Enskilda notiser markeras automatiskt som lästa när panelen stängs (planerat i nästa version).

Uppdateringsintervall

Bell-ikonen och oläst-räknaren uppdateras var 90:e sekund via en bakgrundsfråga när panelen är stängd.

Privata bokningsförfrågningar

För preliminära bokningar som bara bokare, uppdragsgivare och utförare ska se.

När ska förfrågan användas?

Använd [events_by_heddan_request] när ett datum ska kontrolleras med artist/utförare innan det blir officiellt. Förfrågan syns inte i publik kalender, REST API, iCal eller PWA-cache.

Svara på förfrågan

Artist/utförare får en privat tokenlänk och kan acceptera, neka eller föreslå nytt datum. Kopplad utförare kan också se sina förfrågningar via dashboard.

Gör officiellt event

När uppdraget är bekräftat kan behörig admin/redaktör välja Gör till officiellt event. Då skapas ett vanligt event från förfrågan.

Artister och utförare

Registret kan vara både intern bokningsbank och publik presentationssida.

Skapa profil

Skapa profil under Artister & utförare. Fyll i typ, kontaktuppgifter, hemort, region, kompetenser/genrer och eventuell kopplad WordPress-användare.

Visa på hemsidan

En profil visas publikt först när den är markerad som Aktiv och Visa på hemsidan / publik profil. Använd [events_by_heddan_performers] på hemsidan.

Importera artister & utförare

Använd Events by Heddan → Importera utförare för CSV-import. Stöder namn, typ, e-post, text, kort presentation, kategorier och bild-URL. Bilden sparas i mediabiblioteket. Importen körs i bakgrunden i batchar med förloppsindikator – stora filer riskerar inte timeout.

Förfrågan till flera

I förfrågningsformuläret kan bokaren välja en eller flera registrerade utförare och även lägga till extra e-postmottagare.

Intern profil

En aktiv men ej publik profil används i bokningsflödet men syns inte på hemsidan. Passar interna resurser, tekniker, konsulter eller utförare som inte ska marknadsföras publikt.

Incheckning

QR-/tokenbaserad incheckning för entré och deltagarhantering.

Hur incheckning fungerar

Varje godkänd anmälan kan checkas in via tokeniserad länk. Den som checkar in måste vara inloggad och ha rollen Events Check-in by Heddan.

QR-kod

QR-koder genereras per anmälan under Events by Heddan → Anmälningar. Extern QR-rendering är avstängd som standard – om den aktiveras skickas endast incheckningslänken till QR-tjänsten, inte namn eller e-post.

PWA och appinstallation

Gör eventdelen installerbar som app på mobil och desktop.

Krav

PWA kräver HTTPS. Kontrollera att /events-by-heddan-manifest.json, /events-by-heddan-sw.js och /events-by-heddan-offline svarar med rätt Content-Type och inte blockeras av cache, säkerhetsplugin eller serverregler.

Installera på Android och Chrome

En Installera app-knapp visas automatiskt i Chromium-baserade webbläsare (Chrome, Edge, Samsung Internet) när villkoren för installation uppfylls. Klicka för att installera.

Installera på iPhone och iPad (Safari)

Safari stöder inte automatisk installationsdialog. En Lägg till på hemskärmen-knapp visas istället. Tryck på den för instruktioner: tryck på Dela-ikonen i webbläsaren och välj Lägg till på hemskärmen.

Offline-läge

Service workern cachar app-skalet (CSS, JS, ikoner, kalender- och hjälpsidan) direkt vid installation. Eventuell ny data hämtas online och cachas automatiskt. Utan nätverksuppkoppling visas cachade sidor och en offline-sida som fallback.

Cache och CDN

Cachea inte URL:er med ebh_cancel, ebh_checkin, ebh_request eller admin-post-actions. Privata tokenlänkar ska aldrig sidcacheas publikt.

Kalender, iCal och Google

Kalenderexport och tidszoner.

Lägg till i kalender

Varje event har .ics-export och Google Calendar-länk. Tiderna tolkas i sajtens WordPress-tidszon och exporteras korrekt.

Kalenderprenumeration

Det publika flödet finns på /events-by-heddan.ics. Om det ger 404, spara om permalänkar under Inställningar → Permalänkar.

SEO och schema.org

Single event skriver schema.org/Event med start/slut, plats och arrangör. Kontrollera med Googles testverktyg för strukturerad data vid skarp lansering.

GDPR, drift och säkerhet

Det viktigaste för säker drift över tid.

Personuppgifter

Anmälningar och privata förfrågningar kan innehålla personuppgifter. Ställ in samtyckestext, rensningsperiod och om gamla anmälningar ska anonymiseras eller raderas i Inställningar → GDPR.

Eventindex

Eventlistor och kalender läser från en separat, indexerad tabell (ebh_event_index) som synkroniseras automatiskt. Om filter eller kalender visar fel uppgifter efter en manuell databas-operation: klicka på Bygg om eventindex under Events by Heddan → Översikt.

WordPress cron

GDPR-rensning och återkommande event körs via WordPress cron. På lågtrafikerade sajter bör server-cron anropa WP-cron regelbundet: */5 * * * * wget -q -O - https://din-sajt.se/wp-cron.php?doing_wp_cron >/dev/null 2>&1

Backup och staging

Ta alltid backup av databas och filer före uppdatering. Testa uppdateringar på staging med samma PHP-version, tema, cache och viktiga plugin som produktion.

Roller och behörigheter

Ge inte administratörsroll i onödan. Använd hellre Events Admin, Events Editor eller Events Check-in beroende på arbetsuppgift.

Vanliga frågor

Snabba svar på de vanligaste frågorna.

Varför syns inte mitt event?

Kontrollera att eventet är publicerat, har startdatum, inte filtreras bort av kategori/typ och att datumet inte passerat om listan visar kommande event.

Varför fungerar inte PWA?

Kontrollera HTTPS, permalänkar och att manifest/service worker inte blockeras av cache, säkerhetsplugin eller serverregler. Testa i Chrome DevTools → Application.

Varför kommer inga mail?

Testa WordPress wp_mail() med ett SMTP-plugin (t.ex. WP Mail SMTP). Kontrollera även SPF, DKIM och DMARC för domänen. Kolla skräppost-mappen.

Varför syns inte bell-ikonen?

Bell-ikonen kräver att WP-adminbaren är aktiv och att användaren är inloggad med Events by Heddan-behörighet. Kontrollera att Visa adminbar är aktiverat i användarens profilinställningar.

Varför kan jag inte redigera mitt event?

Redigeringsläget kräver inloggning och att du är skapare av eventet. Publicerade event kan redigeras men skickas tillbaka för granskning. Kontakta administratören om knappen saknas.

Kan pluginet användas för annat än spelningar?

Ja. Eventtyperna är breda och passar kurser, workshops, konferenser, idrott, föreningar, kommuner, internverksamhet, mässor och privata bokningsflöden.

Checklista före produktion

Kort lista för sista kontrollen innan kunddrift.

Teknisk kontroll
  • Backup tagen.
  • Staging testad.
  • Permalänkar sparade.
  • HTTPS aktivt.
  • Mail testat via SMTP/wp_mail.
  • WordPress tidszon kontrollerad.
  • Eventindex byggt (Översikt → Bygg om eventindex).
Funktionskontroll
  • Eventlista, filter och kalender fungerar.
  • Anmälan, väntelista och avbokning fungerar.
  • iCal och Google Calendar visar rätt tid.
  • Frontend-inlämning, redigering och Mina event fungerar.
  • Notis skickas till admin vid nytt inlämnat event.
  • Arrangör får notis vid godkänt/avslaget event.
  • Privat förfrågan syns inte publikt.
  • Artist-/utförarregister visar bara publika profiler.
  • Incheckning fungerar med rätt roll.
  • PWA installerbar i Chrome och via Dela-menyn i Safari.

Innehållsregler

Automatisk granskning av inskickade event – vad som flaggas, vad som blockeras och hur du ändrar reglerna.

Så fungerar granskningen

Varje inskickat event kontrolleras automatiskt mot sju kategorier: kriminell verksamhet, våldsbejakande innehåll, hat och trakasserier, religiös förkunnelse, partipolitik, sexuellt innehåll och droger.

Varje kategori har tre lägen. Av stänger av kontrollen helt. Flagga släpper igenom eventet men markerar det för manuell granskning. Blockera stoppar publiceringen och meddelar den som skickade in.

Kontrollen sker både när någon skickar in via formuläret på webbplatsen och när ett event sparas i admin.

Ändra regler och ordlistor

Gå till Events → 🛡 Innehållsregler. Där sätter du läge per kategori och redigerar ordlistan som hör till varje kategori.

Ordlistorna är avsiktligt korta. Långa listor ger fler falska träffar än de fångar verkliga problem, och varje falsk träff kostar dig manuellt arbete.

Undantagslistan – varför den behövs

Kyrkor är bland de vanligaste konsertlokalerna i Sverige. Utan undantag skulle en julkonsert i en kyrka fastna i kategorin religiös förkunnelse.

Undantagslistan innehåller därför uttryck som julkonsert, kyrkokonsert och bröllop. Matchar eventet ett undantag släpps det igenom även om ett annat ord gav träff.

Formulera villkoren aktivitetsbaserat

Diskrimineringslagen skyddar religion när varor och tjänster erbjuds allmänheten. Ett villkor som utestänger en grupp människor är därför riskabelt.

Skriv i stället villkoren utifrån aktivitet: "inga religiösa förrättningar eller förkunnelse" i stället för formuleringar som pekar ut vilka som får delta. Därför står religion som standard på Flagga och inte Blockera.

Detta är en beskrivning av hur pluginet är byggt, inte juridisk rådgivning. Stäm av villkoren med jurist innan du publicerar dem.

AI-bedömning

Om en API-nyckel för Anthropic är angiven i kärnans inställningar kan en AI-bedömning komplettera ordlistorna och fånga sådant som formuleras om för att undvika nyckelord.

Svarar API:et inte, eller returnerar fel, släpps eventet igenom till manuell granskning. Ett tekniskt fel ska aldrig tysta en arrangör.

När ett event blockerats felaktigt

Sänk kategorin från Blockera till Flagga, eller lägg till det aktuella uttrycket i undantagslistan. Ändringen gäller direkt för nya inskick.

Ett redan blockerat event ligger kvar som utkast och kan publiceras manuellt under Events.

Enkel eventinlämning

Det förenklade formuläret för arrangörer som lägger upp sitt första event.

Lägg formuläret på en sida

Skapa en sida och lägg in kortkoden:

[events_by_heddan_enkel]

Det räcker. Formuläret hämtar kategorier, orter och inställningar från huvudpluginet automatiskt.

Tre steg i stället för ett långt formulär

Formuläret delar upp inlämningen i Vad, När & var och Vem.

Första steget är sex knappar: konsert, klubb och DJ, teater och scen, seminarium, kurs, samt annat. Valet styr vilka fält som visas längre fram, så arrangören slipper fält som inte gäller.

Är arrangören inloggad och har en utförarprofil förifylls kontaktuppgifterna.

Styr vem som får skicka in

Kortkoden tar attributet krav med tre värden.

  • auto – följer inställningen i huvudpluginet. Detta är standard.
  • inloggad – kräver konto oavsett vad kärnan säger.
  • oppen – tillåter inlämning utan konto.

Exempel:

[events_by_heddan_enkel krav="oppen" visa_mina="nej"]

Attributet visa_mina styr om användarens egna event listas under formuläret. Standard är ja.

Biljettlänk i stället för betalning

Fyller arrangören i en biljettlänk stängs anmälningsfunktionen av för det eventet automatiskt, och besökaren skickas vidare till biljettleverantören.

Det gör att du slipper hantera pengaflöden, och att arrangören kan fortsätta använda den biljettjänst hen redan har.

Fungerar i mobilen och utan JavaScript

Alla klickytor är minst 48 pixlar, vilket är den storlek som fungerar med tumme på en telefon.

Formuläret fungerar även om JavaScript är blockerat – stegen blir då vanliga sidladdningar i stället.

Platsdata

Koordinater och ortsnamn – grunden för att kunna söka på avstånd i stället för på kommun.

Varför koordinater behövs

En besökare i Ängelholm bryr sig inte om kommungränsen. Konserten i Höganäs ligger närmare än den i norra delen av den egna kommunen.

För att kunna svara på "vad händer inom tre mil härifrån" måste varje event ha latitud och longitud. Tillägget hämtar dem automatiskt från OpenStreetMap utifrån adress och ort.

Kontrollera täckningen

Gå till Events → 📍 Platsdata. Där ser du hur många av dina event som har koordinater, hur många som väntar i kö och hur många som inte gick att slå upp.

Efter en nyinstallation: tryck Fyll kön och sedan Geokoda kön nu. Ett event i sekunden är den takt OpenStreetMap tillåter, så tusen event tar ungefär tjugo minuter.

Ingen cron behövs

Kön betas av efter att sidan skickats till webbläsaren, varje gång du arbetar i admin. Du märker ingenting, och inget är beroende av att webbhotellets schemaläggning fungerar.

Det är därför tillägget finns: huvudpluginets egen geokodning använder WP-Cron, som inte kör tillförlitligt på alla webbhotell. Tillägget kopplar bort den och tar över, så att inget event geokodas två gånger.

Normaliserade ortsnamn

"Ängelholm", "Ängelholms kommun" och "Ängelholm, Skåne" är samma plats men tre olika texter. Utan normalisering blir de tre skilda orter i filtret, och dedupliceringen mellan importkällor missar att det är samma event.

Tillägget skriver därför ett rensat ortsnamn vid sidan av arrangörens egen text. Arrangörens formulering ändras aldrig – den visas som den skrevs.

Orter som själva slutar på s hanteras särskilt. Det heter Höganäs kommun, inte Höganäss kommun, så det s:et hör till namnet och får inte strykas. Sådana orter finns i en undantagslista som kan utökas.

När en adress inte hittas

Efter tre misslyckade försök slutar tillägget försöka och listar eventet under "Kunde inte hittas". Annars skulle en felstavad adress fortsätta belasta uppslagstjänsten i all evighet.

Vanligaste orsakerna är stavfel, saknad ort eller en lokal som inte finns i OpenStreetMap. Rätta adressen, tryck Nollställ försöksräknare och fyll kön igen.

Rena onlineevent geokodas aldrig – de har ingen plats att slå upp.

Hittade du inte svaret?