98 lines
2.6 KiB
Markdown
98 lines
2.6 KiB
Markdown
# 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.
|