Content Mask vs WP YouTube Live

Read More & View Demos Here Embed Any Content†‡ Into Your WordPress Website Content Mask allows you to embed any external content onto your own WordPress Pages, Posts, and Custom Post Types. The end result is fairly similar to setting up a Domain Mask, but the content is embedded into the front end of your website and is fully contained inside your WordPress permalink ecosystem. Example: If you built a landing page on landing-page-builder.com/your-landing-page/, you can simply create a new Page on your website at your-site.com/landing-page/ and paste in the URL of your landing page. The Content Mask plugin will then download and cache of copy of your landing page directly on your website, so any visitors that come to your-site.com/landing-page/ will see the landing page you built. This allows you to keep all of your links integrated into your WordPress Website. † Do not use Content Mask to embed any content that you do not own or do not otherwise have license to share, embed, frame, or distribute. Simple 2-Step UI With a simple 2-Step UI, you can embed any external content into your website without any complicated URL Forwarding, DNS Records, or .htaccess rules to mess with. Just enable the Content Mask on any Page, Post, or Custom Post type by clicking on the check mark. Then put in the URL that contains the content you want to embed. It’s that simple! Powerful Embedding and Redirect Options Using the Download method (default) will fetch the content from the Content Mask URL, cache it on your website, and replace the current page request with that content. By default, this cache lasts 4 hours – but it can be changed anywhere from “Never Cache” all the way up to “Cache for 4 Weeks”. Caching prevents the need for additional requests that slow down your site. Using the Iframe method will replace the current page request with a full width/height, frameless iframe containing the host URL. This method is ideal if the URL you want to embed won’t serve scripts, styles, or images to other URLs or IP Addresses. If you use the Download Method, and links or images look broken, you can try the Iframe method instead. Using the Redirect (301) method will simply redirect the visitor to the host URL. Simple Integrated Vistor Tracking In the Content Mask admin panel, you can enable tracking for Content Masked pages. This will allow you to see how many visitors are viewing these links. This is ideal for when you need to track acquisition, such as on a Landing Page. [Views] shows how many times that Content Mask page has been viewed by anybody (even logged in users) [Non-User] shows how many times it’s been viewed by visitors that are not logged in to the website. [Unique] shows how many times it’s been viewed by unique IP addresses. Note: IP addresses are one-way hashed and are not identifiable in any way. Creating a Content Masked Page Using the Content Mask Admin Panel Notes: Do NOT use Content Mask on any content you aren’t explicitly authorized to share or use. Please confirm you’re allowed to utilize and embed the content before embedding any particular URL. Content embedded using the Download method is cached using the WordPress Transients API for 4 hours by default. If the content on the external URL is updated and you would like a fresh copy, you may just click the “Update” button on the Page, Post, or Custom Post Type to refresh the transient, or click the “Refresh” link in the Content Mask Admin panel. You may also change the cache expiration timer per page anywhere from “Never” to “4 weeks”. You may use the Transients Manager plugin to manage transients stored with the Download method. All Content Mask related transients contain the prefix “content_mask-” plus a stripped version of the Content Mask URL, such as “content_mask-httpxhynkcom”. ‡ Your site may be prevented from processing page requests for any reason; Reasons include, but are not limited to: masking unauthorized content, at the request of the masked URL site owner, masking hateful content, masking illegal content, circumventing IP bans, etc. A dual one-way encrypted hash of your masking URL may be used to check for infraction. No identifying information will be used for this check, and no information is saved other than as a transient to prevent unnecessary duplicate checks per site Read More About Content Mask

Displays the current YouTube live video from a specified channel via the shortcode [youtube_live]. Setup Notes Your YouTube livestream must be set to “Public” or it will not work. This is a security feature of YouTube’s API and unfortunately there’s no way to work around it. In addition, your live stream must be set to allow embedding on third-party sites. If that feature is unavailable, you may need to enable monetization for your account. See YouTube documentation for more information or help with allowing embedding. How It Works If no live video is available, you can display a specified video or a “channel player” showing all your recent videos. You can also enable auto-refresh to automatically check for a live video every 30 seconds (warning: will increase server load, so use with caution). By default, the server will check YouTube’s API and then cache that response for 15 minutes before checking the API again (you may change this value in the admin settings). If auto-refresh is enabled, clients will check against your server every 30 seconds and likely will hit that cache as well, so it can potentially take up to 16 minutes before a client will get a live video. The length of both caches can be changed using the wp_youtube_live_transient_timeout filter (see below for more information). If no live video is available when a page is loaded, several fallback options are available: “Show a custom HTML message” allows you to specify a custom message to show “Show scheduled live videos” will show a player and countdown until your next live video “Show last completed live video” will show your most recently-completed live video “Show recent videos from my channel” will show a playlist of recent videos from your channel “Show a specified playlist” will show a specified playlist “Show a specified video” will show a specified video “Show nothing at all” will show nothing at all When a video ends, users’ browsers will check your server again to see if a live video is available. If so, it will load that; if not, it will fall back as set in your options. Shortcode Options width: player width in pixels; defaults to what you set on the settings page height: player height in pixels; defaults to what you set on the settings page autoplay: whether or not to start playing immediately on load; defaults to false auto_refresh: (either true or false) overrides the auto-refresh setting on the settings page fallback_behavior: choose from the following: upcoming, completed, channel, playlist, video, message, no_message upcoming: the next upcoming scheduled video on the specified channel playlist: a specified playlist (shortcode must also include the fallback_playlist attribute) video: a specified video (shortcode must also include the fallback_video attribute) message: a specified message no_message: nothing at all fallback_playlist: a playlist URL to show when there are no live videos fallback_video: a video URL to show when there are no live videos fallback_message: a message to show when there are no live videos js_only: (either true or false) workaround for some caching issues; if a caching plugin (W3 Total Cache, WP Super Cache, etc.) or proxy (CloudFlare, etc.) caches the HTML while a video is live, visitors may continue to see an old live video even if it has ended. If set js_only is set to true, the server never displays the player code in the initial request and instead sends it in response to uncached ajax requests. This may also result in the video player being slightly delayed on page load due to the extra request, depending on the clients’ bandwidth and latency. Example shortcode: [youtube_live width="720" height="360" autoplay="true"] Filters The filter wp_youtube_live_no_stream_available will customize the message viewers see if there is no live stream currently playing, and takes effect after the fallback_message shortcode attribute is parsed (if fallback_message="no_message" is set in a shortcode, it will override the filter). For example, add this to your theme’s functions.php file: add_filter( 'wp_youtube_live_no_stream_available', 'my_ytl_custom_message' ); function my_ytl_custom_message( $message ) { $message = ' Please check back later or subscribe to our YouTube channel . Check again '; return $message; } The filter wp_youtube_live_transient_timeout is available to customize the cache timeout length in seconds. For example, add this to your theme’s functions.php file to set the cache length to 15 seconds instead of the default 900: add_filter( 'wp_youtube_live_transient_timeout', 'my_ytl_custom_timeout' ); function my_ytl_custom_timeout( $timeout ) { return 15; } Event Listener When a live stream is loaded, the wpYouTubeLiveStarted event is fired; you can use this to create custom front-end features on your site by adding an event listener: window.addEventListener('wpYouTubeLiveStarted', function() { /* your code here */ console.log('stream started'); /* your code here */ }); Development of this plugin is done on GitHub. Pull requests are always welcome.