Installer Sam manuelt (alle nettsteder)
Hvis nettstedet ditt ikke passer noen av de andre installasjonsveiledningene våre — et egenbygd nettsted, en statisk nettstedsgenerator som Hugo eller 11ty, et internt CMS — er dette den universelle metoden.
Forutsetninger
- Redigeringstilgang til nettstedets HTML (eller maler)
- En Sam-konto på viasam.app
- Ditt Sam API-token
Snippeten
Lim dette inn i nettstedets HTML, rett før den avsluttende </body>-taggen, på alle sider der du vil at widgeten skal vises:
<script src="https://cdn.viasam.app/v1/widget.js" data-api-key="YOUR_API_KEY" defer></script>Erstatt YOUR_API_KEY med ditt faktiske token (kopier fra Sam-dashbordet ditt → Widgets → Installer widgeten din → Annet / manuell).
Hvor du plasserer den
| Nettstedstype | Plassering |
|---|---|
| Statisk HTML | Rett før </body> på alle sider (eller den felles layout-/bunntekstfilen) |
| Hugo / Jekyll / 11ty | Inne i _layouts/default.html (eller nettstedets layoutmal) før </body> |
| Express / Next.js / Remix / Nuxt | I rotlayoutkomponenten din, rett før </body> |
| Django / Rails / Laravel | I nettstedets master-/basismals bunntekstblokk |
| React SPA uten SSR | Legg til <script>-taggen direkte i public/index.html |
defer-attributtet gjør at widgeten lastes etter sideinnholdet ditt — den blokkerer aldri sideinnlastingen.
Verifiser
Åpne nettstedet ditt i en ny fane. Sam-widgeten skal vises i hjørnet du konfigurerte.
Gjør den ikke det, åpne nettleserens utviklerverktøy (F12), gå til Console, last siden på nytt og se etter feil som nevner widget.js eller cdn.viasam.app.
Feilsøking
Widgeten vises én gang men ikke ved påfølgende navigasjoner (SPA). Hvis du har en enkeltsideapp med klientrouting, lastes skriptet bare én gang ved første sidelasting. Widgeten håndterer ruteendringer automatisk — du trenger ikke injisere skriptet på nytt.
Widgeten lastes men sier «Ugyldig API-nøkkel». Dobbeltsjekk at data-api-key-verdien stemmer overens med Sam-dashbordet ditt. Token er 40 alfanumeriske tegn.
Content Security Policy blokkerer skriptet. Tillat https://cdn.viasam.app i script-src-direktivet. Widgeten vil også forsøke å hente fra https://viasam.app/api/widget/config/..., så tillat https://viasam.app i connect-src også.
Widgeten vises i feil hjørne. Posisjon konfigureres per widget i Sam-dashbordet ditt, ikke i snippeten. Åpne widgetinnstillingene og endre posisjonen der — du trenger ikke re-deploye.
Trenger du hjelp?
Send e-post til support@viasam.app med en lenke til nettstedet ditt, så tar vi en titt.