How to install and use SJ Video Player

1. Quick install

After you downloaded your Joomla extension, just go to Extensions -> Extension Manager -> select the Upload Package File from the top tabs -> click on the Choose File button and select the Spot Featured Articles zip file -> click on the Upload & Install blue button.

Your module will now appear in the Module Manager section.

In the Extensions -> Module Manager section, find your Spot Featured Article module and click on it to acess the module's setup section.

You can find all the module's options right in the first window that opens.

First, from the right side of the page change the Status of the module into Published, put it into the desired Position and, if you want your module to be displayed with a title, select from the right Show at the Show Title section. Last, give your module the title that you want it to be displayed with.

Also, don't forget to set the display for your module on the pages you want it to be shown: Module Assignment section.

2. Setup SJ Video Player

2.1. Upload videos and thumbnails

Using your FTP user and password, login on your server.
Navigate to images/
Create a folder for videos here (aka. myvideos), and another one for thumbnails (aka. mythumbs).
Upload the video files in .mp4 and .ogv or .ogg file format in "myvideos" folder (also .webm can be used), and thumbnails into "mythumbs" folder.

Down there it is table with the compatibility of HTML5 video formats.

2.2. Setup the component

I. Create a playlist

There are two ways to create a playlist:

First one is to go through Components -> SJ Video Player -> Add new playlist, the following will open

Give your playlist a name (eg. Playlist1), then Save&Close. Publish the playlist.

The second way is through Components -> SJ Video Player -> Manage playlists and the following will open:

Give your playlist a name (eg. Playlist1), then Save&Close. Publish the playlist.

II. Add videos to playlist

There are two ways to add a new video to a playslist.

The first way is via Components -> SJ Video Player -> Add new video. The following will open:

Give your video a name.

Select it's source. If is a youtube video select Youtube and if is a local file select Local

URL/Youtube id 

If the video is from youtube the id must be inserted here. The id is the code after the ?v= from  the youtube link.
ex: If the link is https://www.youtube.com/watch?v=xJ_gZ-h2X9Y the id will be xJ_gZ-h2X9Y

If the video is a local file the path to the local file must be inserted starting from images. 
ex: images/myvideos/big_buck_bunny_trailer

Do not specify the extension in the name of the file. The different file formats must have same name.
ex: if we have the video big_buck_bunny_trailer on the ftp we must have the following files: 
big_buck_bunny_trailer.mp4
big_buck_bunny_trailer.ogv
big_buck_bunny_trailer.webm

Poster image 

For youtube videos the poster image field will not be present and it will complete automatically with the image that youtube is using for that video.

For local files select the image you want to use from the images/mythumbs folder that you have created earlyer.

Description

Here you can add description to your video. The field supports HTML tags, so you can create any structure here. (like you can use h1 tags for titles)
ex: <h1>My video</h1>
<h3>Subtitle</h3>
<p>My desc goes here</p>

Is NOT mandatory to use html tags but helps sometimes. Theese tags can be styled in the module under the CSS field.

Playlist 

Select the playlist in which you want the video to be.

Save & Close

Remember to publish the video.

Another way to add new videos to your playlist is via Components -> SJ Video Player -> Manage videos. It will look like below:

The Video Manager that will open is the same one with the previous presented one. Fill all the fields according the setup from above.

2.3. Setup the module

The module does not support multiple instances for now.
Select Extensions -> Module Manager from the top menu and click SJ Video Player in the list.

I. Player options

Select playlist.
Select from the playlists you have made in the component part. The videos from that playlist will populate the player. 
Here will display only published playlists and will play only the published videos.
Set your player size (with and height)

II. Playlist options

Set width and height of the playlist in pixels.
Set the image with in procent and the image margin-top to arrange your image. Same for the Playlist text
Choose your colors.
Playlist repeat - If you need the playlist to repeat after end select yes here.
Order By and Type - The playlist can be ordered after Id, Name, Source and even Description, ascendent or descendent

III. CSS - a custom css are has been added to easely overwrite any of the css bits.

For eg. if you want to use a H1 tag into your description here you can style that just for the video player part.

Classes and id's used:

sjvideoplayerpl1 - the videoplayer wrapper div id
videoarea - the html5 video element class
youtubepl1 - the youtube iframe div holder class
descriptionpl1 - the description div class
playlistpl1 - the playlist ul id
plitempl1 - the playlist item class
vpactivepl1 - the active playlist item class

Usage example:

.descriptionpl1 h1{
font-size:2em;
}
#playlistpl1{
display:none;
}

Tweet