YouTube engine fetches videos from YouTube and imports them into your Joomla website. This engine supports multiple sources including playlists, channels, and search results.
Engine Settings
Basic Settings
-
Source Type: Choose how you want to fetch videos:
- Playlist: Get videos from a specific YouTube playlist
- Channel: Get videos from a YouTube channel
- Search: Search YouTube for videos
-
ID Field: Enter the appropriate ID:
- For Playlist: YouTube playlist ID (starts with PL...)
- For Channel: YouTube channel ID (starts with UC...)
- For Search: Leave empty for global search or enter channel ID to search within that channel
-
Search Query: Keywords to search for videos (available for Channel and Search modes)
-
Search Order: Sort results by (only for Search mode):
- Date: Newest videos first
- Rating: Highest rated first
- Relevance: Most relevant to search query
- Title: Alphabetical order
- View Count: Most viewed first
-
Limit Items: Maximum number of videos to fetch (default: 10)
-
API Key: Your YouTube Data API v3 key (required)
Advanced Settings
Video Player Settings
- Width/Height: Size of embedded video player
- Autoplay: Start playing automatically
- Allow Fullscreen: Enable fullscreen button
- Show Captions: Display video captions
- Show Related Videos: Show related videos after playback
- Show Title: Display video title in player
- Start/End Time: Custom start and end times (in seconds)
Custom HTML
- Before/After Embed: Add custom HTML code around the video player
- Before/After Description: Add custom HTML code around the video description
Output Fields
Each fetched video provides:
- link: Direct YouTube video URL
- title: Video title
- id: YouTube video ID
- description: Full video description
- published_at: Video publication date
- default_image: Thumbnail image URL
- medium_image: Medium quality thumbnail
- high_image: High quality thumbnail
- standard_image: Standard thumbnail
- maxres_image: Maximum resolution thumbnail
- channel_title: Channel name
- channel_id: YouTube channel ID
- embed: Complete embed code for video player
Examples
Example 1: Fetch Videos from a Playlist
- Set Source Type to "Playlist"
- Enter playlist ID: PL5d8ZQoaC6W5ZJ2cg1XMj9X9yQ6Od_D
- Set Limit to 5
- Click Save to fetch latest 5 videos from the playlist
Example 2: Search Within a Channel
- Set Source Type to "Channel"
- Enter channel ID: UCXuqSBlHAE6Xw-yeJA0Tunw
- Enter Search Query: "tutorial"
- Set Limit to 10
- Click Save to fetch 10 tutorial videos from this channel
Example 3: Global YouTube Search
- Set Source Type to "Search"
- Leave ID field empty
- Enter Search Query: "joomla tips"
- Set Search Order to "Relevance"
- Set Limit to 20
- Click Save to fetch 20 most relevant Joomla tips videos
Tips and Tricks
- Getting IDs: YouTube playlist IDs usually start with "PL", channel IDs with "UC". You can find these in YouTube URLs.
- Custom Embed: Use Before/After Embed fields to add div wrappers or custom styling around videos.
- Better Search: Use quotes for exact phrases and minus sign to exclude terms (e.g., joomla -wordpress).
- Performance: Higher limits mean more API calls. Start with smaller limits to test your setup.
Troubleshooting
- No results: Check if your API key is valid and has YouTube Data API v3 enabled
- Wrong videos: Verify your search terms and channel/playlist IDs are correct
- Missing descriptions: The engine automatically fetches full descriptions for all videos