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.
Inga träffar. Prova ett annat sökord.
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.
