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