Using as an extension

To use as an extension, it is required to have configured, in Adobe Dreamweaver, the website in which you are currently working and saved the webpage into which the player with be inserted. Both conditions are indispensable to be able to determine the relative URL address between the webpage that will contain the audio player, with the skin that will be displayed in the player, and the relative URL address of the above mentioned webpage and the audio files for playback (in case the audio files are located in the same domain of the webpage that will host the SECURE-TSPlayer V4.5 audio player)
 
To insert SECURE-TSPlayer V4.5 into you website, click on the SECURE-TSPlayer V4.5  option in the commands menu on Adobe Dreamweaver; a window will open for the insertion and setup of the audio player. The insertion and setup of the audio player is carried out in three steps that are separated by three different screens, each of them shown with help hints for its different options.

In the First step's screen, the source for the audio files is selected (the files to be played can belong to the same domain as the webpage where the audio player will be inserted or they can belong to an external domain). If the source selected is the webpage´s own domain, a text box with a button for the choice of the mp3 containing folder is activated or visualized (the folder containing the files to be played must be located within the webpage that will be using the audio player, it is in the webpage´s own domain that the audio directory must be published, in the web server where the site is or will be hosted).

In case the selected domain is different from the webpage´s own domain, a text field to type the absolute URL address of the xml file that contains the list of files to reproduce will be activated or visualized (please remember that this XML file should comply with any of the supported standards for audio playback, RSS o XSPF), including the protocol; for this player the required protocol is HTTP (example of an absolute URL -  http://www.domainname.com/playlist.xml).

Once the source for the files has been entered, push the "next step" button which will take you into the next screen, or step, in the process of inserting and setting up the audio player. The next screen or step in the configuration is related to the files that are going to be reproduced.

If the webpage using the player and the source of audio files is under the same domain, then the second step in the configuration will allow either to eliminate or to add new audio files into the playlist and it will also allow the modification of data associated to each of the audio files for the SECURE-TSPlayer V4.5.

In the Second Step we provide a set of options related directly with the list of audio files to reproduce in the SECURE-TSPlayer V4.5, in case you selected a directory within the same domain as a source for the audio files.

In the middle zone of the screen a list of the attributes belonging to the mp3 audio files located in the selected directory are shown. These attibutes are:

Title: Title with which the audio file is going to be listed in the SECURE-TSPlayer V4.5 playlist
Location: Location of the mp3 audio files to be played, this location will be converted automatically into a web address relative to the player (note:location is the only mandatory attribute)
Information: in case it is required, this attribute must be represented  by an absolute URL address with information associated to the audio file it belongs to (an example on the use of this attribute is placing the URL address of a site containing information related to the author or performer of the song. This URL must be absolute and it must also contain the mandatory protocol, in case of SECURE-TSPlayer V4.5 audio player the admitted protocol is HTTP)
Associated image: attribute concerning an image associated to an audio file, this image should be found within the same domain of the webpage (where the audio player is inserted) and it must be published to the web server that will be or already is hosting the website.

In the second screen, or second step, there´s also the possibility of adding a new file to the list, this can be done using the button with the [+] symbol.

To eliminate any of the listed files, the target file must be selected from the list and then the button with the symbol [-] must be clicked.

Editing attributes associated with any of the audio file: for this process the row containing the file (whose attributes you want to change) must be selected and then the button with the "edit item" tag must be clicked. A new window will appear containing the associated data to be modified.
Once the process of file selection for reproduction is over, push the button with the "next step" tag. This should take you to the third and last screen for insertion and configuration of the SECURE-TSPlayer V4.5 audio player. To move on to the third step, there must be at least one audio file in the playlist.

In the third screen, or Third Step, and final part of the configuration and insertion of the SECURE-TSPlayer V4.5 audio player, a set of specific options is provided, such as:
Select skin:selects the skin that will be displayed with the audio player. The skin is a swf file located in the folder entitled Skin which is located at the same time in the SECURE-TSPlayer V4.5 directory of the website´s root folder.

Secure player: Option that increases the level of security in the playback of audio files due to the fact that it avoids the creation of temporary copies of both the mp3 audio file and the xml file with the playlist in the computer of your website´s users. For this option it is essential for the webserver, where the website is    hosted, to support Php script file language.
Password: password employed for playing audio files.
Play in Streaming: This option can be accessed only when the files to be played are under the same domain and the safety option of the audio player is disabled; this enables the file to be played as it downloads. In case that this option was determined as invalid, the audio will start running only once the file has downloaded completely.
Initial volume value: Introduce a number that can range from 0 to 100 and it will determine the volume to which the audio player will play the files once they start running. The user can change these parameters to listen to the audio files to a volume of own choice.
Show playlist: Allows for the playlist to be shown or hidden, once the audio player is running within the website.
Autoplay: a setup option that allows for the player to start reproducing any of the audio files in the playlist from the moment when the website displays it.
Active repeat playlist button: allows for default activation of the repeat reproduction button, so once all the files of the playlist have been played, the playback starts over.
Active shuffling selection button: Allows for the random choice of new audio files as each one ends.

To complete the SECURE-TSPlayer V4.5 insertion and setup process, push the button labeled "finish", which will insert the tags corresponding to an swf file within the website where the audio player is meant to be inserted, passing over the required parameters to the swf file for proper functioning. It will also create the necessary file and directory structure. This file and directory structure must be published in the web server where the website is or will be hosted.

< top

Extension generated file structure

In the folder structure created by the extension, there will be a folder called SECURE-TSPlayer, located at the root of the website. Inside this folder there will be another one called Skin with the swf file containing the skin of the audio player, the swf file SECURE-TSPlayerV3.5.swf that constitutes the audio player’s core and a folder for each time the player gets inserted into the website, this folder will contain:
The configuration.xml setup file that can be modified if you wish to change the parameters to which you initially set the audio player;
The getPlayData.php file with the script to execute in case safe reproduction has been activated or in case a source external to the website’s domain for the playlist files has been entered;
The file containing the list of elements to be played with the associated attributes in case of having the source of audio files located within the domain of the website;
The parameters transformed into the audio player’s swf are: address of the setup file and address of playlist file. The playlist can be an xml (with RSS or XSPF format) or the location of the php extension file that will allow for safe playback of the audio files.

< top

Modifying the SECURE-TSPlayer V4.5 once it is inserted into a webpage

If you wish to modify the audio player, either the playlist, skin or any of the setup options you only have to:

1.Use Adobe Dreamweaver (MX or later)to open up the webpage where the audio player is inserted.
2.Select the audio player that you wish to modify within the webpage.
3.Select the SECURE-TSPlayer option from the Adobe Dreamweaver’s commands menu.

With these three steps the same setup window shown when inserting a new player will appear again, but with the difference that all fields will appear filled with specified values that you determined at the moment of insertion into the webpage.This way the user will not have to re-enter all values but only to modify those that need to be changed, both in the playlist and in the setup as the user sees fit.

< top

Usage of SECURE-TSPlayer V4.5 directly as a swf and not as an Adobe Dreamweaver extension

Distributed as an swf

Download the compressed SECURE-TSPlayer V4.5 file from the website http://www.tsplayer.com. Unzip and copy the folder SECURE-TSPlayer to the root of the website, along with its folder structure. The SECURE-TSPlayer directory contains a file called SECURE-TSPlayer V3.5.swf that constitues the core of the audio player, a folder named skin with the skin of the audio player, an xml file called configuration.xml that contains the initial setup of the audio player, a file called playlist.xml that has the list of files to be played with each of these file´s attributes such as title, location of the mp3 file, URL address of the information related to the audio file and the address of an associated image (if any). Finally, it has a file named getPlyData.php that is in charge of safe audio playback.
All these files must be uploaded into the web server.

Steps to follow.

First step
Use Adobe Dreamweaver or any other text editor to open the configuration.xml file. This file contains all setup options required for optimal performance of the SECURE-TSPlayer V4.5 audio player. The configuration.xml file has the following structure:

where:

<skin></skin> contains the URL address of the audio player's skin. This URL address can be absolute within the same domain as the audio player (ex.http://www.mywebaddress.com/SECURE-TSPlayer/skin/skinname.swf) or relative to the webpage where the player will be inserted (ex. SECURE-TSPlayer/skin/skinname.swf, in case the SECURE-TSPlayer directory and the webpage where the player is inserted are on the same level)

<playlist></playlist> option that enables the playlist to be displayed or hidden. The permitted values are 0 or 1, zero o hide the playlist and one to display it.

<streaming></streaming> Allows the song to be listened to as it downloads, or for the song to be executed only once it has downloaded completely. The permitted values are 0 and 1, zero to disable streaming and one for enabling streaming. For audio files external to the website´s domain or when safe reproduction is desired, this option must be changed to 1.

<autoplay></autoplay> Allows the player to start running the moment it finishes its download, playing the first audio file on the playlist. The permitted values are 1, so the player starts working as soon as it is displayed or 0, in which case it only starts playing the songs on the playlist by queue of the user.

<volume></volume>  Accepts values ranging from 0 to 100 indicating the volume that the player will have by default. The volume value can be changed later by the user until a pleasant value is reached.

<repeat></repeat> This tells the player to run the elements of the playlist in a loop, this means that when all files in the list have been played, the list will start over again continuously. The permitted values for this field are 0 and 1, 0 to get the player to stop once all the elements of the playlist have been executed. 1 to make the reproduction work in a loop.

<shuffling></shuffling> Tells the player whether or not the playlist elements have to be reproduced randomly or not. The permitted values for this option are 1, so that the audio files on the list play on a random pattern or 0 to set the playlist on a sequential pattern.

Second Step
Use the Adobe Dreamweaver or any other text editor to open the playlist.xml file. This file contains the list of the mp3 files that will be reproduced and also a set of characteristics for each one of the files.

The playlist.xml file has the following structure:

where <trackList></trackList> contains the list of all the audio files that are going to be played.

<track></track> has the data of each one of the audio files in particular.

<annotation></annotation> is the title with which the audio file is going to be displayed, in the playlist shown in the SECURE-TSPlayer.

<location></location> is the location where the mp3 audio file is found
This address is relative to the webpage in which the audio player is going to be inserted in case the reproduction is not meant to be in safe mode, or relative to the getPlayData.php file if the audio is meant to be played in safe mode.

<info></info> Absolute URL (including the protocol, in this case http://) to a webpage with information associated to the audio file that it is linked to.

<image></image> Is the location of the jpg file associated to the audio file. This address is relative to the webpage where the audio player is inserted, in case safe reproduction is not desired or relative to the getPlayData.php file when safe reproduction of the files is desired.

Note: The playlist.xml is for cases in which the audio and image files
are found under the same domain of the website where the audio player is inserted.

Third Step

In case that reproduction of audio files outside of the website´s domain is required or when safe reproduction of the audio files under the same domain is desired, just open the getPlayData.php file that is located in the SECURE-TSPlayer folder and replace the line:

$playlistFile = "<playlist_source>";

<playlist_source> with the real source where the playlist.xml that is going to be reproduced is located.

Fourth step
To finish, paste the following text -nothing more than the inclusion of the audio player in the webpage- within the tag <body></body> of the webpage where you wish the SECURE-TSPlayer V4.5 to be inserted.

Where “<SECURE-TSPlayer address>” is the URL address of the SECURE-TSPlayer V4.5.swf file. This URL address can be absolute within the website or relative to the webpage where the audio player is being inserted.

Where “<configuration.xml address>” is the URL address to the configuration.xml setup file. This URL address can be absolute within the same domain where the website (with the audio player) is hosted or relative to the webpage where the player will be inserted.

Where “<playlist.xml or getPlayData.php address>”  is the URL of the playlist.xml file or the php extention file (in case reproduction is meant for audio files outside of the website's domain or that safe mode is desired for audio files under the website same Domain). This URL address can be absolute with the same domain where the audio player is hosted or it can be relative to the webpage where the player has been inserted.

< top