Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mikelgoig/nova-spotify-track-field
A Spotify track field to use in your Laravel Nova apps 🎧
https://github.com/mikelgoig/nova-spotify-track-field
laravel nova package spotify
Last synced: about 2 months ago
JSON representation
A Spotify track field to use in your Laravel Nova apps 🎧
- Host: GitHub
- URL: https://github.com/mikelgoig/nova-spotify-track-field
- Owner: mikelgoig
- License: mit
- Created: 2018-11-15T16:40:30.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2018-11-26T23:51:52.000Z (about 6 years ago)
- Last Synced: 2024-11-07T18:01:32.323Z (3 months ago)
- Topics: laravel, nova, package, spotify
- Language: JavaScript
- Homepage: https://packagist.org/packages/mgoigfer/nova-spotify-track-field
- Size: 296 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Laravel Nova Spotify Track Field
[](https://packagist.org/packages/mgoigfer/nova-spotify-track-field)
[](https://travis-ci.org/mgoigfer/nova-spotify-track-field)
[](https://scrutinizer-ci.com/g/mgoigfer/nova-spotify-track-field)
[](https://packagist.org/packages/mgoigfer/nova-spotify-track-field)
This [Nova](https://nova.laravel.com/) package adds a Spotify track field. Under the hood it uses the [mgoigfer/laravel-spotify-wrapper](https://github.com/mgoigfer/laravel-spotify-wrapper) and [mgoigfer/nova-spotify-auth-tool](https://github.com/mgoigfer/nova-spotify-auth-tool) packages.
You can add tracks from the [Spotify Web API](https://developer.spotify.com/documentation/web-api/) to your database.
## Installation
First, you must install [mgoigfer/laravel-spotify-wrapper](https://github.com/mgoigfer/laravel-spotify-wrapper) and [mgoigfer/nova-spotify-auth-tool](https://github.com/mgoigfer/nova-spotify-auth-tool) into your Laravel app.
Next, you can install this package via [Composer](https://getcomposer.org/):
```bash
composer require mgoigfer/nova-spotify-track-field
```
## Use
Register the field in your resource's `fields` method:
```php
/**
* Get the fields displayed by the resource.
*
* @param \Illuminate\Http\Request $request
* @return array
*/
public function fields(Request $request)
{
return [
...
\Mgoigfer\SpotifyTrackField\SpotifyTrackField::make('Name')
->spotifyAccessToken()
->extraAttributes([
'id' => 'spotify_id',
'artist_name' => 'artist',
'duration_ms' => 'duration_ms',
'popularity' => 'popularity',
'preview_url' => 'preview_url',',
]),
...
];
}
```
You must use the following methods:
* `spotifyAccessToken`: to request a Spotify `access token` from the `refresh token` stored in the database (see [mgoigfer/nova-spotify-auth-tool](https://github.com/mgoigfer/nova-spotify-auth-tool)).
* `extraAttributes`: a key-value array that indicates which track attributes you would like to store (keys), and the column name in your database where they may be stored (values).
### List of track attributes:
* `id`: The Spotify ID for the track.
* `name`: The name of the track.
* `artist_id`: The Spotify ID for the artist.
* `artist_name`: The name of the artist
* `duration_ms`: The track length in milliseconds.
* `popularity`: The popularity of the track. The value will be between 0 and 100, with 100 being the most popular.
* `preview_url`: A link to a 30 second preview (MP3 format) of the track. Can be `null`.
* `first_letter`: The first letter of the track (e.g. in `Tail Lights` will be `T`).
More info in the [Spotify Web API](https://developer.spotify.com/documentation/web-api/reference/tracks/get-track/).
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
## Credits
- [Mikel Goig](https://github.com/mgoigfer)
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.