Category: Featured

Securi released a post revealing that two popular WordPress plugins had a serious vulnerability.

Theme plugin have been bundled into a number of themes. This caused a number of people to mention that one should not bundle plugins in WordPress themes.

it's not "bundling plugins bad", but "bundling libraries good". either is just code. *how* you bundle matters. dependency management!

— Andrey Savchenko (@Rarst) September 5, 2014

I agree with Rarst that there is no difference between bundling plugin, libraries or frameworks as they are both are just code. Eric wrote a few thoughts on “Dependency Management in WordPress“. WordPress is still not at the stage where dependency management can be implemented that the average user can use.

A number of themes use setting frameworks. There was once a discussion on the WordPress.org Theme Review mailing list and it was decided that theme developers should ship the themes with the integrated setting frameworks instead of installing the plugin version of the framework using something like TGM. By including the frameworks in the theme the developer is making the decision for the user and not giving him/her further options. Users find it confusing to see plugins that they do not remember installing. The settings frameworks are not the only frameworks. There are others like the metabox frameworks or theme frameworks.

One of my plugins is FluidVids for WordPress. The plugin makes it easier for people to use FluidVids from Todd. I regularly track updates and include them in the plugin. It the developers responsibility to track the updates of the libraries, frameworks or even plugins that they have bundled in their theme and update them as soon as there is an update.

Here are the slides from talk at WordCamp Switzerland 2014 on how to manage translations.

Below is the video of my presentation.

I have been asked a few times about adding responsive videos. At the time I was unable to give a good answer. Now I have taken time to do a bit of research and I able to give a number of responsive video solutions. The solutions are divided in third party services or self hosted solutions. Some of the solutions have WordPress plugins, these are marked with “WP Plugin”. Here are the solutions and resources I am going to cover.

• Cloud hosted videos
  • YouTube
  • Vimeo
  • Wistia
• Self hosted videos
  • Simple HTML5 Video
  • Simple HTML5 Video with flash fallback
  • Sublime Video
  • Flowplayer – WP Plugin
  • MediaElement.js  – WP Plugin
  • Video.js – WP Plugin
  • JW Player – WP Plugin
• Additional Information
  • Video Files and Formats
  • Solutions for iframe embeds
  • Troubleshooting

Cloud hosted videos

These video solutions are most times the simplest. They host the video for you and work on most devices. So that they are responsive you need to use some tricks when embedding them. There are even some WordPress plugins that help. Responsive Video Embeds and Advanced Responsive Video Embedder are such plugins.

YouTube

• Very easy to set up
• Needs a iframe solution so that it is responsive
• The video is hosted on YouTube
• Works easily on multiple devices and browsers
• YouTube has some developer customisation options

The easiest solution is to use YouTube. It works on multiple devices. In some countries YouTube plays an advertisement before the video. If  you upload your own video this should not be the case. At the end of the video you get a grid with other videos. If you don’t want those then when embedding YouTube make sure you uncheck the “Show suggested videos when the video finishes”.

YouTube has some advanced customisation options. You can test them out on the demo page.

YouTube Demo

Vimeo

• Very easy to set up
• Needs a iframe solution so that it is responsive
• The video is hosted on Vimeo
• Works easily on multiple devices and browsers
• Paying users can customise the player

Vimeo has a lot of the same features as YouTube but it has paid plans which give users more options for customisation.

Vimeo Demo

Wistia

• Very Simple – only one file to upload
• The code is an iframe
• Hosted on the Wistia servers
• Built in Video analytics
• Free version (3 videos / 5 GB bandwidth / branded player)
• Paid version begins at $25/mo
• Has additional features e.g. social sharing, call to action, require email to play and a few more which you can find here.

Solution 1

Wistia Demo

Solution 2

There is a solution where Wistia supports responsive videos with their own code so a JavaScript plugin is not needed. There are three ways of doing this.

The first two are documented on the Wistia DemoBin. There is the Video Foam Lab page where you can paste the embed code to make it responsive.

1. If you have an iframe, load the iframe API script in the footer and add `&videoFoam=true` at the end of the url in the iframe. e.g.  

   	<iframe src=”http://fast.wistia.net/embed/iframe/3bfl0abrog?videoFoam=true” allowtransparency=”true” frameborder=”0″ scrolling=”no” class=”wistia_embed” name=”wistia_embed” width=”640″ height=”360″></iframe>
   	<script src=’//fast.wistia.com/static/iframe-api-v1.js’></script>

   view raw Wistia responsive iframe.html hosted with ❤ by GitHub
2. If you have an API or SEO embed, just pass `videoFoam: true` in with your embed parameters, e.g. 

   	<div id=”wistia_3bfl0abrog” class=”wistia_embed” style=”width:640px;height:360px;”> </div>
   	<script charset=”ISO-8859-1″ src=”http://fast.wistia.com/assets/external/E-v1.js”></script>
   	<script>
   	wistiaEmbed = Wistia.embed(“3bfl0abrog”, {
   	videoFoam: true
   	});
   	</script>

   view raw Wistia API responsive.html hosted with ❤ by GitHub
3. To make all Wistia videos responsive on your site add this code to the header.

   	<script src=”//fast.wistia.com/static/embed_shepherd-v1.js”></script>
   	<script>
   	wistiaEmbeds.onFind(function(video) {
   	video.videoFoam(true);
   	});
   	</script>

   view raw Wistia responsive videos.html hosted with ❤ by GitHub

The Wistia WordPress plugin enables oEmbed. This allows you to just insert the special url and then the plugin does the rest so that you see a video on the front end. So that the video is responsive, add &videoFoam=true at the end of the url. e.g. http://grappler-login.wistia.com/medias/3bfl0abrog?embedType=iframe&videoWidth=640&videoFoam=true

Wistia’s own demo My Wistia demo

Self Hosted Videos

These solutions are for those people who want to host their own videos be it on their own server, uploading it through WordPress or hosting it in the cloud like with Amazon S3.

Simple HTML5 Video

• Need to create markup
• Simple setup
• Videos hosted on own site
• Different players on every browser
• IE 8 and lower are not supported

The video tag is a new standard to display videos. I have added more information then you might need. To understand it best I have split this section into two parts.

• HTML5 Markup – HTML5 Video & Source Tags
• Video Files – mp4, webm & ogg

HTML5 Markup

Here is a simple code example

So that the videos will work on multiple browser we will need multiple formats.

Here is a simple code example. I have also added a possibility to load a lower resolution video for smaller devices.

HTML5 multiple format Demo

The video Tag has the following attributes. Some of them are easy to understand.

• global attributes – standard attributes like class and id
• autoplay
• preload – none, metadata, auto
• controls
• loop
• poster – poster=”/image.jpg”
• height
• width
• mediagroup – control two media elements(videos) through the first element(video)
• muted
• src – video link

W3 Video Tag Reference

Here are the source attributes.

• global attributes
• src
• type
• media

W3 Source Tag Reference

So to have a responsive HTML5 video you need to have this CSS.

You can use a service provided by video.js to create HTML5 video markup.

You can read up more on the video files below.

Simple HTML5 Video with flash fallback

• The same points as for HTML video except with IE8 and lower support

This is how the code would look like with Flowplayer being used as the backup.

To save time you could use the Video for Everybody generator by Jonathan Neal to generate the code snippet according to your options. (FlashFox player seems to only resize if the browser is refreshed but does not change size dynamically,)

A complete explanation can be found at Kroc Camen’s site, the originator of this technique.

HTML5 with flash fallback Demo

Sublime Video

• Easy to set up with the code generator
• Need to add JavaScript code
• No need for JavaScript plugins
• Basic HTML5 code with flash fallback for IE8
• Works with self hosted videos and YouTube videos

Sublime offers a solution for your own hosted videos and YouTube videos. Chose your option and then add the link to your media or for the YouTube videos add the video id.

In the video setting the “Fit” option is very important.

At the end you can click on the “Get the Code” button at the bottom. You will then get a code like this.

The next step is to add the loader code. This add the Java Script. Every site has its own file.

Sublime Demo (YouTube video) Sublime Demo (hosted video)

Flowplayer

• No need of JavaScript Plugin
• Easy to use
• Customisable players
• WordPress plugin with video manager
• Multiple customisation options

Simply add this HTML to page or post.

Flowplayer Demo

Design your own player, Video attributes, Additional options

Flowplayer WordPress plugin

It is really simple to use. You upload the video files and then you add the different file formats and choose a skin and define settings. For every video you get a shortcode that you can paste in a post or page.

Flowplayer5 for WordPress Demo Flowplayer5 for WordPress

MediaElement.js

• Standard Player
• Out of the box responsive
• Supports HTML5 Video
• Automatically supports IE8 and lower
• WordPress plugin Now part of WordPress Core
• Does not need a JavaScript plugin

How to get it running on your site.

1. First you need to download the files.
2. Open the zip file and then extract the build folder
3. Move that build folder to your child theme. You can rename the folder if you want
4. Load mediaelement-and-player.min.js and mediaelementplayer.min.css
5. Load this javascript to activate the MediaElements player
   

   	// activate mediaelementplayer
   	jQuery(‘video,audio’).mediaelementplayer(/* Options */);

   view raw activate mediaelementplayer.js hosted with ❤ by GitHub
6. Then you can include the HTML video code.
   

   	<video width=”320″ height=”240″ controls preload=”metadata”>
   	<source src=”http://testing.grappler.tk/files/2013/01/trailer_1080p.webm” type=”video/webm”>
   	<source src=”http://testing.grappler.tk/files/2013/01/trailer_1080p.mp4″ type=”video/mp4″>
   	<source src=”http://testing.grappler.tk/files/2013/01/trailer_1080p.ogv” type=”video/ogg”>
   	</video>

   view raw Three video files.html hosted with ❤ by GitHub

MediaElement Demo

MediaElement.js WordPress plugin

This is very simple. Install the plugin and then add this shortcode to the post or page. Just change the links to your video.

MediaElement WordPress Plugin Demo

Video.js

• Flash Fallback
• WordPress Plugin
• Needs FitVids.js

1. Load the JavaScript and Stylesheet
2. Add the markup e.g.
   

   	<link href=”http://vjs.zencdn.net/c/video-js.css” rel=”stylesheet”>
   	<script src=”http://vjs.zencdn.net/c/video.js”></script>
   	<div class=”video-js-wrapper”>
   	<video id=”video-js-1″ class=”video-js vjs-default-skin” controls width=”960″ height=”540″ poster=”http://testing.grappler.tk/files/2013/01/trailer_1080p.jpg” preload=”auto” data-setup=”{}”>
   	<source src=”http://testing.grappler.tk/files/2013/01/trailer_1080p.mp4″ type=”video/mp4″></source>
   	<source src=”http://testing.grappler.tk/files/2013/01/trailer_1080p.webm” type=”video/webm”/></source>
   	<source src=”http://testing.grappler.tk/files/2013/01/trailer_1080p.ogv” type=”video/ogg”/></source>
   	</video>
   	</div>

   view raw video.js.html hosted with ❤ by GitHub
3. Add extra css
   

   	.fluid-width-video-wrapper .video-js {
   	position: absolute;
   	top: 0;
   	left: 0;
   	width: 100%!important;
   	height: 100%!important;
   	}

   view raw video.js.css hosted with ❤ by GitHub
4. Activate FitVids.js for Video.js
   

   	// FitVids
   	jQuery(document).ready(function(){
   	// Target your #container, #wrapper etc.
   	jQuery(“#wrapper”).fitVids({ customSelector: “div[class^=’video-js-wrapper’]”});
   	});

   view raw video.js-FitVids.js hosted with ❤ by GitHub

Video.js Demo

Options Documentation

Video.js WordPress plugin

The plugin does make it a bit easier to host the files. Install and activate the plugin. On a page you will find a button to open a form to create the shortcode.

This is the code that this form will generate.

Videos.js WordPress Plugin Demo Video.js WordPress Plugin

JW Player

• Popular
• Only from Version 6 responsive out of the box
• Extra work for every video

JW Player 6

As of JW Player 6 responsive videos are supported. JW Player has a guide on how to enable responsive videos.

The following snippet is an example.

JW Player 6 Demo

JW Player 5

For JW Player 5 you will need to use some hacks. Below are a few of options.

Standard embed with responsive CSS Solution

I have found another way of making JWPlayer responsive. This should be a bit easier.

1. Add this code to the page or post
   

   	<script type=”text/javascript” src=”//cdn.jsdelivr.net/jwplayer/5.10/jwplayer.js”></script>
   	<div id=”player_1″></div>
   	<script type=”text/javascript”>// <![CDATA[
   	jwplayer(‘player_1’).setup({
   	file: “http://testing.grappler.tk/files/2013/01/trailer_1080p.mp4”,
   	width: “100%”,
   	height: “100%”,
   	stretching: “fill”,
   	flashplayer:”//cdn.jsdelivr.net/jwplayer/5.10/player.swf”
   	});
   	// ]]></script>

   view raw JW Player 5 embed.html hosted with ❤ by GitHub
2. Change the div id so that is different for every video. Make sure it matches the code in the JavaScript.
3. Add this css
   

   	#player_1_wrapper {
   	width: 100%;
   	position: relative;
   	padding: 0;
   	padding-bottom: 56.25%;
   	}
   	#player_1_wrapper object {
   	position: absolute;
   	top: 0;
   	left: 0;
   	width: 100%;
   	height: 100%;
   	}

   view raw JWPlayer.css hosted with ❤ by GitHub
   
   You will need to add this css for every video.
4. So that the video keeps its proportion you will need to change the padding-bottom percentage. This is calculated video height / width x 100. E.g. 540 / 960 x 100 = 56.25%.

JW Player 5 wo/ iframe Demo

iframe Solution

The solution that I have for JW Player is a hack that Ethan from Longtailvideo sent me. Here is how to do it.

1. Download the files
2. Copy jwplayer folder to your child theme using a ftp client
3. Create a html file in the child theme
4. Paste this code in
   

   	<!DOCTYPE HTML>
   	<html>
   	<head>
   	<title>
   	JW Player Reponsive Video
   	</title>
   	<script type=”text/javascript” src=”//cdn.jsdelivr.net/jwplayer/5.10/jwplayer.js”>
   	</script>
   	<style type=”text/css”>
   	html, body {
   	height: 100%;
   	width: 100%;
   	padding: 0;
   	margin: 0;
   	}
   	#player {
   	height: 100%;
   	width: 100%;
   	padding: 0;
   	}
   	</style>
   	</head>
   	<body>
   	<div id=”player”>
   	</div>
   	<script type=”text/javascript”>
   	jwplayer(“player”).setup({
   	file: “http://testing.grappler.tk/files/2013/01/trailer_1080p.mp4”,
   	image: “http://testing.grappler.tk/files/2013/01/trailer_1080p.jpg”,
   	height: “100%”,
   	width: “100%”,
   	stretching: “exactfit”,
   	flashplayer:”//cdn.jsdelivr.net/jwplayer/5.10/player.swf”
   	});
   	</script>
   	</body>
   	</html>

   view raw JW Player iframe video.html hosted with ❤ by GitHub
5. Change four links – Change the location of jwplayer.js, jwplayer.flash.swf, the video link and either update the image link or remove it.
6. Then add an iframe with the link pointing to the newly created html file.
   

   <iframe width=”940px” height=”540px” src=”http://grappler.tk/wp-content/themes/responsive-testing/jwplayer-iframe.html” frameborder=”0″ allowfullscreen=””></iframe>

   view raw JWPlayer iframe.html hosted with ❤ by GitHub
7. Then we have to make sure that FitVids.js will work with this iframe. More on this here.

JW Player 5 iframe Demo

JW Player Documentation

JW Player WordPress Plugin

The WordPress plugin supports both JW Player 5 and 6. You can switch between the two. You need JW Player 6 for responsive support. You define the ratio per player.

JW Player WordPress Plugin Demo JW Player WordPress Plugin

Additional Information

Here are a few things that you might need to know when working with responsive videos.

Video Files and Formats

There are three main video files.

Format	Video Encoding	MIME-type
MP4	H264	video/mp4
WebM	VP8	video/webm
Ogg	Theora	video/ogg

Not every browser supports all formats that is why we include all of them in the html.

Flowplayer,  SublimeVideo and JW Player have documentation on encoding, video formats and sizes.

If you have a MP4 file you can use firefogg.org (a firefox extension). It is very simple to use but if you need help you can follow this guide.

You can also use an online service like encoding.com, Amazon Elastic Transcoder (beta) or Zencoder.

The easiest way to get your video in the different formats on your computer is to use Miro converter. It is very simple to use but if you need help you can follow this guide.

• Mozilla Firefox – WebM, Ogg
• Google Chrome – MP4, WebM, Ogg
• Opera – WebM, Ogg
• Safari – MP4
• Internet Explorer 9+ – MP4
• Internet Explorer 6-8 – No HTML5, Flash Only!

To test it your self

Video Format Test HTML5 multiple format Demo

Further reading.

WordPress does not support webm at the moment and for that reason you will need to add the following code to your themes functions.php. If you are running a multisite you will need to check the list of allowed files.

Solutions for iframe embeds

Embed Responsively

This solution is useful if you only have one or a few videos on your site and you are able to make the iframe responsive.

This then outputs html code like this.

---

So that the video doesn’t distort  and has the correct aspect ratio the JavaScript calculates the aspect ration. This is calculated by dividing the height by the width in the html code. That is why it is important the width and height is correct.

FluidVids.js

FluidVids.js is a standalone JavaScript for fluid YouTube/Vimeo iframe embeds. You can easily add more custom/responsive players easily with the options script.

FluidVids for WordPress demo FluidVids for WordPress

FitVids.js

FitVids.js is a lightweight, easy-to-use jQuery plugin for fluid width video embeds. FitVids.js makes iframe embed responsive on the fly. There is a WordPress plugin FitVids for WordPress.

Here are a couple of important things to know about FitVids.js.

The current version of FitVids.js conflicts with Video.js and MediaElement.js. That is why I would recommend using my version. It can be found on GitHub.

When adding iframes from other sources then it is necessary to add selectors. So that I can add an iframe from this site I would use this JavaScript. It is also important to check if www is used or not.

FitVids for WordPress

Troubleshooting

Here are two links to help with troubleshooting the video setup

Multimedia Troubleshooting, longtailvideo.com

In my previous post I mentioned that one of the issues of using @import in the child theme is that the JavaScripts that help media queries in IE8 and lower so not work.

So there  are three solutions.

When using @import copy the media queries from the parent theme and paste in the child theme stylesheet.

Pro

• Simple and easy to do

Con

• For the rest of the browsers you have the media queries twice which makes debugging complicated
• The media queries needs to be updated if there are any changes in the parent theme

Use the solution of using functions.php that I presented in my previous post.

Pro

• Improves the loading speed of the stylesheets
• The media queries are only in one place and thus do not need to be updated

Con

• This is a bit more complicated and perhaps not so easy to understand for beginners

Theme authors add the media queries in a separate file and have the file always loaded from the parent theme

Pro

• The user is not confronted by this issue

Con

• An extra file is load just for the media queries

The prefered method in the codex and with plugins that generate child theme is to load the parent stylesheet by using @import in the child themes stylesheet.

@import url("../twentytwelve/style.css");

There are a few problems with this.

Speed

Using CSS @import in an external stylesheet can add additional delays during the loading of a web page.

Media Query support in IE

Media Queries are not supported in IE8 or lower. So to support media queries on IE 8 and lower JavaScript is using like css3-mediaqueries-js and respond.js.

Note: Doesn’t work on @import’ed stylesheets (which you shouldn’t use anyway for performance reasons). Also won’t listen to the media attribute of the <link> and <style> elements.

 

@import rules are not supported by respond.js

A solution to this could be to copy the media queries from the parent theme and include them in the child theme but this does not make it easy when there are changes in the media queries.

More Flexibility

This is not really a huge thing but it does make it easier to disable loading the parent stylesheet.

Solution

Now for the solution. Instead of using @import just add this PHP code to the functions.php of your Child Theme. If you don’t have one, simply create new file and name it functions.php

Here is a variation that add the current parent theme version to the stylesheet url.

There might be in some themes where the child theme stylesheet will load before parent theme style sheet. Those themes will have the code like this in the header

For those cases add this PHP code to the functions.php in the child theme.

In the perfect world the parent themes would load the stylesheet like _s does.