grandllama

BarkingLlama Roulette adds a simple shortcode and REST endpoint that selects a random YouTube video from a configured playlist and embeds it on your site.
Perfect for motivational cards as Shorts, “daily randomness” pages, or any curated playlist you want to keep fresh.
Features: 
* Shortcode: [llama_roulette] 
* REST endpoint: /wp-json/llama-roulette/v1/random 
* Playlist caching via transients to reduce YouTube API calls 
* Optional Privacy Enhanced Mode (youtube-nocookie embeds) 
* “Start Muted” setting for reliable autoplay
<h3>External services</h3>
This plugin uses the YouTube Data API v3 (Google) to retrieve videos from the configured YouTube playlist so it can select and display a random video.
What data is sent and when: 
* The configured playlist ID (or playlist ID parsed from a provided playlist URL) is sent when the plugin requests playlist items. 
* The configured YouTube API key is sent with those API requests for authentication. 
* These requests occur when cached playlist data is missing or expired, or when playlist data must be refreshed.
Service provider: 
* Google / YouTube Data API v3
Terms of Service and Privacy Policy: 
* Google API Services Terms of Service: https://developers.google.com/terms/ 
* YouTube API Services Terms of Service: https://developers.google.com/youtube/terms/api-services-terms-of-service 
* Google Privacy Policy: https://policies.google.com/privacy
<h3>Shortcode</h3>
Basic: 
 [llama_roulette]
Available attributes: 
* <code>button_label</code> – Custom label for the trigger button (e.g., <code>button_label="Try Luck"</code>). 
* <code>playlist</code> – Optional YouTube Playlist ID or URL to override the global setting. 
* <code>autoplay</code> – Set to <code>1</code> to auto-load/play, <code>0</code> to wait for click. 
* <code>muted</code> – Set to <code>1</code> to start muted, <code>0</code> for sound (Note: browsers block unmuted autoplay). 
* <code>show_title</code> – Set to <code>1</code> to show the video title below the player, <code>0</code> to hide. 
* <code>align</code> – <code>left</code>, <code>center</code>, or <code>right</code>. 
* <code>max_width</code> – Any CSS width value (e.g., <code>max_width="800px"</code>). 
* <code>aspect_ratio</code> – CSS aspect-ratio (e.g., <code>16/9</code>, <code>4/3</code>). 
* <code>class</code> – Append custom CSS classes.
Example: 
 [llama_roulette playlist=”PLxxxx” button_label=”Spin!” autoplay=”1″ muted=”1″ show_title=”1″]
<h3>REST API</h3>
GET /wp-json/llama-roulette/v1/random
Optional query param: 
* playlist (Playlist ID or URL) to override the configured playlist for that request
Example: 
GET /wp-json/llama-roulette/v1/random?playlist=PLabc123
<h3>License</h3>
This plugin is licensed under the GPLv2 or later.

BarkingLlama Roulette

Spin the wheel to embed a random YouTube playlist video via shortcode or REST API.

BarkingLlama Roulette vs Vimeotheque – Vimeo WordPress Plugin & Video Gallery