Archived
145 lines
4.8 KiB
Plaintext
145 lines
4.8 KiB
Plaintext
=== Spotify Embed ===
|
|
Contributors: ocean90
|
|
Tags: Spotify, WP Embed, Embed, Music, Spotfiy Play Button
|
|
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=VR8YU922B7K46
|
|
Requires at least: 2.9
|
|
Tested up to: 3.5
|
|
Stable tag: 0.2.1
|
|
License: GPLv2 or later
|
|
License URI: http://www.gnu.org/licenses/gpl-2.0.html
|
|
|
|
Easily embed Spotify playlists, albums and tracks into your posts through the new Spotify Play Button.
|
|
|
|
== Description ==
|
|
|
|
Spotify Embed is based on the new [API by Spotify](https://developer.spotify.com/technologies/spotify-play-button/), better known as the Spotify Play Button.
|
|
With Spotify Embed you can easily share your favored music tracks, albums and playlists with other Spotify users.
|
|
|
|
= What's your part? =
|
|
Just place a Spotify link into your posts. It can be a link to your favored track or album, but also music playlists are possible.
|
|
**By default no shortcodes are necessary, just a link!**
|
|
And that was about your part. Easy, isn't it?
|
|
|
|
= What does the plugin? =
|
|
The plugin will fetch your links of your music and will convert it to a sexy Spotify Play Button.
|
|
|
|
= Some usage examples =
|
|
To embed a simple Track just embed a link like this:
|
|
`https://open.spotify.com/track/4IJUii1lg0IRLBs0yG1w2p`
|
|
|
|
To embed an album just embed a link like this:
|
|
`http://open.spotify.com/album/4pT0rlFvHYc46KyEhmCy88`
|
|
|
|
Or to embed a complete playlist just embed a link like this:
|
|
`http://open.spotify.com/user/sonymusic/playlist/1BVPSd4dynzdlIWehjvkPj`
|
|
|
|
For more examples please vist the [FAQ section](http://wordpress.org/extend/plugins/spotify-embed/faq/).
|
|
|
|
**Sounds pretty good? Install now!**
|
|
|
|
= Coming soon =
|
|
* Support for Spotify URLs like `spotify:album:4pT0rlFvHYc46KyEhmCy88`.
|
|
|
|
|
|
*Spotify Embed is not associated in any way with Spotify by Spotify Ltd.*
|
|
|
|
|
|
= Feedback =
|
|
If you want, you can drop me a line @[ocean90](http://twitter.com/ocean90) on Twitter or @[Dominik Schilling](https://plus.google.com/101675293278434581718/) on Google+.
|
|
|
|
|
|
|
|
= More =
|
|
If you want, you can try also some of my [other plugins](http://profiles.wordpress.org/users/ocean90) or visit my site [wpGrafie.de](http://wpgrafie.de/).
|
|
|
|
|
|
|
|
|
|
== Frequently Asked Questions ==
|
|
|
|
= Can I embed the light theme instead of the dark theme? =
|
|
Yes, you can. Just wrap your link into the `[embed][/embed]` shortcode and add the keyword 'light'.
|
|
Example:
|
|
`[embed light]http://open.spotify.com/user/spotify/playlist/3Yrvm5lBgnhzTYTXx2l55x[/embed]`
|
|
|
|
|
|
= I want to show the cover art, is that possible? =
|
|
Yes. Just wrap your link into the `[embed][/embed]` shortcode and add the keyword 'coverart'.
|
|
Example:
|
|
`[embed coverart]http://open.spotify.com/user/spotify/playlist/3Yrvm5lBgnhzTYTXx2l55x[/embed]`
|
|
|
|
|
|
= Where does the plugin get it's default height and width settings? =
|
|
Therefor take a look at the Media settings under `Settings > Media > Embed`.
|
|
|
|
|
|
= Can I customize the size of the embed box? =
|
|
Yes. Just wrap your link into the `[embed][/embed]` shortcode and add the keywords 'height' and/or 'width'.
|
|
(Note: Take also a look at the [Spotify documentation](https://developer.spotify.com/technologies/spotify-play-button/documentation/))
|
|
Example:
|
|
`[embed height="600" width="450"]http://open.spotify.com/user/spotify/playlist/3Yrvm5lBgnhzTYTXx2l55x[/embed]`
|
|
|
|
Another option is the use of the `size` keyword. You can use `size="compact"` (80x250px) or `size="large"` (720x640px).
|
|
Example:
|
|
`[embed size="compact"]http://open.spotify.com/user/spotify/playlist/3Yrvm5lBgnhzTYTXx2l55x[/embed]`
|
|
|
|
|
|
= Can I combine all these keywords? =
|
|
Yes. (But don't try to combine the size keywords, or the sky will fall on your head)
|
|
|
|
|
|
|
|
|
|
== Screenshots ==
|
|
|
|
1. An example of an embed track.
|
|
2. Here you can get the HTML link of your track, album or playlist, which you can insert into your content.
|
|
|
|
|
|
|
|
|
|
== Installation ==
|
|
|
|
Note: There will be NO settings page.
|
|
|
|
For an automatic installation through WordPress:
|
|
|
|
1. Go to the 'Add New' plugins screen in your WordPress admin area
|
|
1. Search for 'Spotify Embed'
|
|
1. Click 'Install Now' and activate the plugin
|
|
|
|
|
|
For a manual installation via FTP:
|
|
|
|
1. Upload the `spotify-embed` directory to the `/wp-content/plugins/` directory
|
|
1. Activate the plugin through the 'Plugins' screen in your WordPress admin area
|
|
|
|
|
|
To upload the plugin through WordPress, instead of FTP:
|
|
|
|
1. Upload the downloaded zip file on the 'Add New' plugins screen (see the 'Upload' tab) in your WordPress admin area and activate.
|
|
|
|
|
|
|
|
|
|
== Changelog ==
|
|
= 0.2.1 =
|
|
* Removes one unused matching group to increase performance, thanks to Sergej Müller.
|
|
|
|
= 0.2.0 =
|
|
* Performance boost by reducing to only one regular expression, thanks to Jens Tautenhahn.
|
|
* New keyword: `size`. (Use `size="compact"` or `size="large"`.)
|
|
|
|
= 0.1.0 =
|
|
* First release.
|
|
|
|
|
|
|
|
|
|
|
|
== Upgrade Notice ==
|
|
|
|
= 0.2 =
|
|
Performance boost and a new keyword for default size. You can use size="compact" or size="large" now.
|
|
|