This is a Wordpress Plugin which allows you to easily integrate a player widget for a track, set or playlist or a pofile from hearthis.at into your Wordpress Blog by using Shortcodes.
- Wordpress, version >= 3.1.0
- PHP 5.3+.
- httpful / php http client already included, but you may update it by your self
Use it in your blog post or pages by adding this Shortcode to your content:
[hearthis]http://hearthis.at/LINK_TO_TRACK_SET_OR_ARTIST/[/hearthis]
.
The Plugin also supports optional parameters. By now these are width, height and params. The "params" parameter will pass the given options on to the player widget. The hearthis player accepts the following parameter options:
- theme = you can choose between these 2 options transparent (default) or transparent_black
- width = define the width of the widget (integer value or % value or empty string '', default is 100%)
- height = define the height of the widget (integer value or empty string '', default is 145)
- profile_height = define the height of the profile view (integer value or %, default is 400)
- multi_height = define the height of the playlist view (integer value or empty string '', default is 450)
- color2 = highlight color for the waveform (not set or a hex color string with prependig #)
- color = button and passed time color for the waveform (not set or a hex color string with prependig #)
- cover = hides the cover img (values not set, 1 or 0)
- autoplay = starts with autoplay (values not set, 1 or 0)
- style = style 1 or 2
- waveform = hide the waveform (values not set, 1 or 0)
- background = shows the background if set (values not set, 1 or 0, if is 1 the height is 400px)
- digitized_space = size of the spaces between the waveform blocks (integer, steps from 1 to 10, works only if style is set to 2)
- liststyle = only aviable on playlists and will also works only with 'single' as value
Embed a single track without params.
[hearthis]https://hearthis.at/shawne/shawne-pornbass-12-06042013-2300-0200-uhr/[/hearthis]
Embed a playlist or set without params.
[hearthis]https://hearthis.at/crecs/set/tbase-feat-charlotte-haining-oscar-michael-unspoken-words-ep/[/hearthis]
Embed a user without color params and autostart.
[hearthis color="#ff5c24" color2="#33fd11" autostart="1"]http://hearthis.at/djforce/[/hearthis]
Embeds a track with a black theme and a bachground image (if set).
[hearthis theme="transparent_black" background="1" ]https://hearthis.at/djforce/baesser-forcesicht-dnbmix/[hearthis]
Embeds a track player with 300px width and a green button color.
[hearthis width="300" color="#33fd11"]https://hearthis.at/crec/maverick-krl-c-recordings-guestmix/[/hearthis]
Embeds a playlist or set with 400px height.
[hearthis height="400"]https://hearthis.at/set/51-7/[/hearthis]
I embeds a hook so if you have a playlist and do set the liststyle="single" option, it will parse all tracks from this set as single tracks.
[hearthis liststyle="single"]https://hearthis.at/crecs/set/tbase-feat-charlotte-haining-oscar-michael-unspoken-words-ep/[/hearthis]
Download the Plugin and extract the content. You should see a folder named hearthisat. Move or upload this folder to your Wordpress installation plugins directory. By default the wordpress plugin folder is under /wp-content/plugins/.
After you done this go to your Wordpress Backend and activate the Plugin. Now you are ready to go and can insert the hearthis Shortcodes.
I have to write this :)
This is how the player widget will looks like:
latest version is 0.6.3
version 0.6.3
- add a shortcode option as a hook to parse all tracks from a playlist as single tracks
version 0.6.2
- the plugin was originaly written by Benedikt Groß the founder of hearthis.at and this release fixes old or wrong options and bug so that you can use it with the latest wordpress version and you will have the full controll of all original hearthis paramsn
thx and support hearthis.at