Gjorde en README
This commit is contained in:
97
README.md
97
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.
|
||||||
|
|||||||
Reference in New Issue
Block a user