Documentation

Find documentation for our Joomla extensions on this page.

Youtube engine for JoomGrabber - Grab and extract Youtube videos

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

  1. Set Source Type to "Playlist"
  2. Enter playlist ID: PL5d8ZQoaC6W5ZJ2cg1XMj9X9yQ6Od_D
  3. Set Limit to 5
  4. Click Save to fetch latest 5 videos from the playlist

Example 2: Search Within a Channel

  1. Set Source Type to "Channel"
  2. Enter channel ID: UCXuqSBlHAE6Xw-yeJA0Tunw
  3. Enter Search Query: "tutorial"
  4. Set Limit to 10
  5. Click Save to fetch 10 tutorial videos from this channel
  1. Set Source Type to "Search"
  2. Leave ID field empty
  3. Enter Search Query: "joomla tips"
  4. Set Search Order to "Relevance"
  5. Set Limit to 20
  6. 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
Cron Job Starts

We use cookies on our website. Some of them are essential for the operation of the site, while others help us to improve this site and the user experience (tracking cookies). You can decide for yourself whether you want to allow cookies or not. Please note that if you reject them, you may not be able to use all the functionalities of the site.

Ok