Extension Docs

User Guide: SJ Video Player

Details
Category: SJ Video Player

This guide will take you through the entire process of setting up the SJ Video Player, from installation to advanced customization. Follow these steps to create a professional video playlist for your audience.

Table of Contents

1. Requirements & Compatibility

Before installing, ensure your environment meets the following criteria to guarantee a smooth performance:

  • Joomla Version: Compatible with Joomla 4.x, Joomla 5.x., Joomla 6.x.
  • PHP Version: PHP 7.4 or higher (PHP 8.x recommended).
  • Browser Support: Modern browsers (Chrome, Firefox, Safari, Edge).
  • Video Formats: Local files must be in .mp4 (H.264) for maximum compatibility.

2. Installation & Updates

2.1. Installation

Log in to your Joomla Administrator area. Navigate to System → Install → Extensions. Upload the mod_sj_video_player.zip file. Once finished, go to Content → Site Modules to open the module and begin configuration.

2.2. Performing Updates

To update the module, simply install the newest version over the existing one. Your settings and playlists are stored in the database and will not be lost during this process.

Using the Joomla update system:

  1. Navigate to: System > Manage > Extensions
  2. Click on the Check for Updates button
  3. Select the module from the list and press Update button

2.3. License Key

  1. Navigate to: System > Update Sites
  2. Find the extension 
  3. Click on the name of the extension
  4. In the field Download Key insert your Key
  5. The Key is the order reference.

3. Initial Setup & Global Settings

Before adding videos, define how the player sits on your page. These settings ensure the player matches your site's layout.

  • Module Position: Assign the module to a template position (e.g., "Main Content" or "Sidebar").
  • Menu Assignment: Choose which pages should display the player.
  • Player Dimensions: Set the Max Width (e.g., 100% for full width or 800px ) and Alignment.

4. Adding Content: Manual vs. Folder Mode

The module offers two ways to populate your playlist. You can choose your mode in the Content Mode dropdown.

4.1. Manual Mode (The "Hand-Picked" Approach)

Use this mode if you want to mix sources like YouTube, Vimeo, and specific local files. You add each video row manually.

  • Adding Rows: Click "Add New" to create a row.
  • Sources: Paste a direct link or select a file from the Media Manager.
  • Poster: Select a custom image. You can store this on your server or you can place a link to another location. (eg: https://i.ytimg.com/vi/t6a37J87bew/mqdefault.jpg )
  • Video Title: Add a title for the video
  • Description: Add a description for the video. This field supports html markup.

4.2. Folder Mode (The "Automation" Approach)

This is the fastest method for local MP4 files. The module "reads" your folder and builds the playlist for you.

  1. The Folder: Select a folder from your /images directory.
  2. Scan & Sync: Click the "Scan & Sync Folder" button. The module identifies every .mp4 file in that folder.
  3. Automatic Titles: The module automatically cleans the file names (e.g., 01_intro_video.mp4 becomes Intro Video).
  4. Automatic Posters: If an image in that folder has the same name as the video, it is automatically assigned as the cover.
  5. Description: Add a description for the video. This field supports html markup.

5. Organizing Your Playlist

Control the flow of your content to improve user experience.

  • Ordering Options: Select between Alphabetical, By Date (Newest first), or Manual order.
  • Playlist Height: If you have many videos, set a Max Height (e.g., 600px). This keeps the player compact and adds a professional scrollbar to the list.

6. Customizing the Design

This is where you make the module yours. No coding is required; just use the intuitive interface.

6.1. Colors & Branding

Match your brand using the color pickers for the Accent Color (buttons/progress), Playlist Background, and Text Color.

6.2. Visual Effects

Enable Box Shadows to make the player "pop" off the page. Adjust Hover Styles to change the color of a playlist item when a user moves their mouse over it.

6.3. Descriptions

Choose the font size and the height for the video description area. Clear descriptions help users understand what they are about to watch.

7. Troubleshooting & FAQ

If you encounter issues, check these common solutions:

  • Video doesn't play: Ensure the file is an .mp4 and the filename has no spaces or special characters.
  • YouTube error: Verify that "Embedding" is allowed in the video settings on YouTube.
  • Module is missing: Confirm the module is Published and assigned to the correct Menu Item.
  • Update fails with the mesage:
    Failed to download package. Download it and install manually from https://extensionspot.com/extensions_update/php/sj_video_player_update.php?jver=J6&ext=EX022&es_key=123&msg=Enter_key_or_update_subscription.
    • Check if the update key is correct or the support period has ended

8. Support & Feedback

We provide full support for our users. If you have questions that aren't answered here:

  • Official Tickets: Open a support ticket on our website.
  • Bug Reports: We appreciate technical feedback to help us improve the module for everyone.

Thank you for choosing SJ Video Player!