From eb8730a56d5b5de8242aa5de8183f61de75de2d1 Mon Sep 17 00:00:00 2001 From: Christian Ohlsson Date: Thu, 2 Apr 2026 20:25:11 +0200 Subject: [PATCH] Gjorde en README --- README.md | 97 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) diff --git a/README.md b/README.md index e69de29..a7bfcbc 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,97 @@ +# Spotify Recent Track (OAuth) + +Ett WordPress‑plugin som visar den senast spelade låten från Spotify. +Pluginet använder Spotify OAuth 2.0 för att autentisera användaren och hämtar därefter senaste spelade låt via Spotifys Web API. +Pluginet inkluderar ett Gutenberg‑block som renderas via PHP på serversidan. + +## Funktioner + +- Fullständig Spotify OAuth‑inloggning (authorization code flow) +- Lagring av access token och refresh token i WordPress options +- Automatisk token‑förnyelse när access token har gått ut +- Hämtar senaste spelade låt från Spotify +- Visar: + - Albumomslag + - Artist och låttitel + - Tid sedan låten spelades +- Gutenberg‑block som kan infogas på vilken sida eller vilket inlägg som helst +- Enkel inställningssida i WordPress‑admin + +## Installation + +1. Packa pluginmappen i en zip‑fil: + ``` + spotify-recent-oauth.zip + ``` +2. Logga in i WordPress‑admin. +3. Gå till: + ``` + Plugins → Add New → Upload Plugin + ``` +4. Installera och aktivera pluginet. + +## Konfiguration + +1. Gå till: + ``` + Settings → Spotify Recent + ``` +2. Skapa en app på: + https://developer.spotify.com/dashboard/ + +3. Lägg till följande Redirect URI i din Spotify‑app: + + ``` + https://din-webbplats.se/wp-admin/options-general.php?page=sro&oauth=1 + ``` + +4. Kopiera in: + - Client ID + - Client Secret + i pluginets inställningssida. + +5. Klicka på "Connect Spotify". + +När du har autentiserat dig sparas access token och refresh token automatiskt, och pluginet uppdaterar token vid behov. + +## Användning + +1. Gå till en sida eller ett inlägg. +2. Lägg till blocket: + ``` + Spotify Recent Track + ``` +3. Spara och publicera. + +Blocket kommer att visa albumomslag, artist, titel och hur länge sedan låten spelades. + +## Filstruktur + +``` +spotify-recent-oauth/ +│ +├── spotify-recent-oauth.php # Huvudfil +├── admin/ +│ ├── settings.php # Admin-inställningar +│ └── oauth-handler.php # OAuth login och token-hantering +└── blocks/ + └── block.js # Gutenberg-blocket +``` + +## Krav + +- WordPress 6.0 eller senare +- PHP 7.4 eller senare +- Ett Spotify Developer‑konto +- En registrerad Spotify-app med korrekt redirect‑URI + +## Begränsningar + +- Endast senaste spelade låt hämtas (en begränsning i Spotify Web API) +- Kräver ett aktivt Spotify‑konto +- Tokenförnyelse sker automatiskt men fungerar endast om refresh token är giltigt + +## Licens + +Detta projekt är skapat för utbildnings- och utvecklingssyfte. +Du får modifiera och vidareutveckla pluginet fritt.