{"id":8773,"date":"2020-05-17T17:12:36","date_gmt":"2020-05-17T17:12:36","guid":{"rendered":"https:\/\/manuals.qantumthemes.xyz\/vice\/?post_type=ht_kb&#038;p=8773"},"modified":"2020-05-17T17:12:36","modified_gmt":"2020-05-17T17:12:36","slug":"5-07-radio-channels","status":"publish","type":"ht_kb","link":"https:\/\/manuals.qantumthemes.xyz\/vice\/knowledge-base\/5-07-radio-channels\/","title":{"rendered":"5.07 Radio channels"},"content":{"rendered":"<p>Since\u00a0Vice 1.3.0 you can create\u00a0<strong>unlimited Radio Channels<\/strong>. A radio channel is composed of:<\/p>\n<ul>\n<li>A visible radio channel page (with its own custom post type and a custom template in the theme)<\/li>\n<li>A featured image (or logo)<\/li>\n<li>A playable stream of the radio station<\/li>\n<\/ul>\n<h2 id=\"creating-the-radio-channel\" >Creating the radio channel:<\/h2>\n<p>To simply create a radio channel page, use the title and text editors like you do for a normal page. The created page has a template in the front-end that you can copy to your child theme and customize named:\u00a0<strong>single-radiochannel.php<\/strong>.<\/p>\n<h2 id=\"creating-the-playable-channel\" ><strong>Creating the playable channel<\/strong><\/h2>\n<p>A playable channel is an entry in the playlist of the website.<\/p>\n<p>To view the radio channel in the player, you need to do two things:<\/p>\n<ol>\n<li>Compile the Radio Channel Details when you create a new radio channel.<\/li>\n<li>Have your player visible under\u00a0<strong>Appearance-&gt;Customize<\/strong><\/li>\n<\/ol>\n<h4 id=\"how-to-compile-the-radio-player-details-mp3-stream-url\" >How to compile the radio player details\u00a0MP3 Stream URL:<\/h4>\n<p><a href=\"http:\/\/qantumthemes.com\/manuals\/vice\/wp-content\/uploads\/2015\/10\/Screen-Shot-2015-10-13-at-14.11.09.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-392\" src=\"http:\/\/qantumthemes.com\/manuals\/vice\/wp-content\/uploads\/2015\/10\/Screen-Shot-2015-10-13-at-14.11.09.png\" alt=\"Screen Shot 2015-10-13 at 14.11.09\" width=\"728\" height=\"317\" \/><\/a><\/p>\n<h2 id=\"mp3-stream-url\" >Mp3 Stream URL<\/h2>\n<p>This is the address where your radio station streams the audio stream.<\/p>\n<p>To use the built-in players, you need the mp3 URL of your radio stream.<br \/>\nTo obtain the mp3 url, it is very simple:<br \/>\nUsually the web radio stations provide a file that will allow you to stream the radio on iTunes, Winamp, Windows Media Player and other players.<\/p>\n<h3 id=\"how-to-find-your-mp3-stream-url\" >How to find your MP3 Stream URL<\/h3>\n<h5 id=\"please-use-the-following-information-to-check-if-your-radio-station-is-compatible-if-you-already-know-your-mp3-stream-url-you-can-skip-this-chapter-otherwise-read-on\" >PLEASE USE THE FOLLOWING INFORMATION TO CHECK IF YOUR RADIO STATION IS COMPATIBLE.<br \/>\nIF YOU ALREADY KNOW YOUR MP3 STREAM URL, YOU CAN SKIP THIS CHAPTER OTHERWISE READ ON\u2026<\/h5>\n<p>This service is provided using a file ending in .m3u or .playlist<\/p>\n<p>You can obtain the url of the mp3 stream by using one of these files, of course use the URL\u00a0provided from your radio provider, not the ones in this example:<\/p>\n<ol>\n<li>Get the URL\u00a0of the player from your radio provider. For Wavestream users, you find this URL\u00a0in the integration tools:<\/li>\n<li>Download one of the files for the integration. It is a simple text file, masked as a different file format.<\/li>\n<li>Rename the file to\u00a0player<strong>.txt<\/strong><\/li>\n<li>Open this file with any text editor, like notepad (PC) or TextEdit (Pac)<\/li>\n<li>You will find something like this:<\/li>\n<\/ol>\n<pre>#EXTM3U\r\n#EXTINF:-1,06 AM Ibiza Underground\r\n\r\nhttp:\/\/173.192.105.231:3540\/Live\r\n\r\n<\/pre>\n<p>This URL\u00a0will be your mp3 stream, just add \u201c.mp3\u2033 in the end, like this:<\/p>\n<p>\u2026\u2026.yourUrl\/Live<strong>.mp3<\/strong><br \/>\n<strong>To be sure that your mp3 stream is valid, open it in the browser, with a modern browser it should render as a music player, and reproduce your radio stream.<\/strong><\/p>\n<p><strong>If the radio stream works correctly, you can integrate it on\u00a0your site.<\/strong><\/p>\n<h2 id=\"adding-the-radio-station-to-the-playlist\" >Adding the radio station to the playlist<\/h2>\n<p>This is the checkbox to add the radio channel to\u00a0the playlist of the theme player, that appears at the bottom of the page.<\/p>\n<p>Radio streams don\u2019t allow advancing in the player track.<\/p>\n<p>Radio stations can by default only be played in the website player, but you can hide radio stations from displaying and\u00a0<strong>you can add your own player to\u00a0the content of the radio station text.<\/strong><\/p>\n<hr \/>\n<h2 id=\"_\" ><\/h2>\n<h2 id=\"advanced-information-for-developers\" >Advanced information for developers:<\/h2>\n<ul>\n<li>To customize the radio aspect in the playlist, the template is\u00a0<strong>part-radiostations.php<\/strong><\/li>\n<li>The actual page for radio stations is\u00a0<strong>single-radiochannel.php<\/strong><\/li>\n<li>Radio stations are added via PHP in the part-radiostations.php while normal tracks are added with an ajax call<\/li>\n<li>Radio stations are added to the main playlist in\u00a0<strong>part-playlist.php<\/strong><\/li>\n<\/ul>\n","protected":false},"author":1,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht_kb_category":[868],"ht_kb_tag":[875,561,558,560,288],"class_list":["post-8773","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-05-contents","ht_kb_tag-channel","ht_kb_tag-icecast","ht_kb_tag-radio","ht_kb_tag-shoutcast","ht_kb_tag-vice"],"_links":{"self":[{"href":"https:\/\/manuals.qantumthemes.xyz\/vice\/wp-json\/wp\/v2\/ht_kb\/8773"}],"collection":[{"href":"https:\/\/manuals.qantumthemes.xyz\/vice\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/manuals.qantumthemes.xyz\/vice\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/manuals.qantumthemes.xyz\/vice\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/manuals.qantumthemes.xyz\/vice\/wp-json\/wp\/v2\/comments?post=8773"}],"version-history":[{"count":1,"href":"https:\/\/manuals.qantumthemes.xyz\/vice\/wp-json\/wp\/v2\/ht_kb\/8773\/revisions"}],"predecessor-version":[{"id":8774,"href":"https:\/\/manuals.qantumthemes.xyz\/vice\/wp-json\/wp\/v2\/ht_kb\/8773\/revisions\/8774"}],"wp:attachment":[{"href":"https:\/\/manuals.qantumthemes.xyz\/vice\/wp-json\/wp\/v2\/media?parent=8773"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/manuals.qantumthemes.xyz\/vice\/wp-json\/wp\/v2\/ht_kb_category?post=8773"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/manuals.qantumthemes.xyz\/vice\/wp-json\/wp\/v2\/ht_kb_tag?post=8773"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}