There aren't any special requirements for FV WordPress Flowplayer to work, and you don't need to install any additional plugins. This guide contains:


  1. Download and unpack zip archive containing the plugin.
  2. Upload the fv-wordpress-flowplayer directory into wp-content/plugins/ directory of your wordpress installation.
  3. Go into WordPress plugins setup in WordPress administration interface and activate FV WordPress Flowplayer plugin.
  4. Click both "Check template" and "Check videos" in the plugin settings screen in Settings -> FV WordPress Flowplayer
    fv flowplayer settings checker
    Checker reports that everything is alright with our site

    If you see a warning about missing html5.js file saying "html5.js not found in your template!" check the section below.

  5. Optionally, if you want to embed videos denoted just by their filename, you can create the /videos/ directory located directly in the root of your domain and place your videos there. Otherwise, you would have to type in a complete URL of video files.

Adding missing html5.js file

When you hit the "Check template" button, you might see a warning about "html5.js not found in your template!". This JavaScript provides HTML5 tags compatibility for old Internet Explorer browsers. So it's not absolutely required, but recommended for better compatibility.

Most modern WordPress templates already use this file, but if it's missing, you can grab it from html5shiv Google Code page. Simply hit the download link, unpack the resulting ZIP file and then copy dist/html5shiv.js into your theme folder as html5.js and add following PHP into your header.php template before the closing </head> tag:

<!--[if lt IE 9]>
<script src="<?php echo get_template_directory_uri(); ?>/html5.js"></script>

Using together with minify plugins

WP Minify

Before enabling WP Minify, we recommend that you run the template check and take care of any issues. Once you enable WP Minify, the default settings should be fine, but we recommend that you check a couple of your videos.

We don't recommend enabling "Place Minified JavaScript in footer" option of WP Minify.

wp minify default
Default WP Minify settings


As of version 1.9.4, it breaks the core WordPress wp_localize_script() calls. The thing is removes any <script> tags and moves everything to a single cached file where all JavaScript files are merged into one. wp_localize_script() creates just a simple JavaScript arrays which don't cause longer pageloads, but differ for each page of your website - in our case each player requires a different configuration.

So you need to use this tweak to make sure Autoptimize skips combine/minify of inline JavaScript: Autoptimize tweaks on GitHub

For now you just have to put it into your functions.php file. The plugin author promises to make this an option in version 2.0, so you can tell him how much you need this feature here: Autoptimize on GitHub

Server requirements

  1. You need to make sure that your video files use the correct mime types. You can simply add following into your .htaccess file:

    AddType video/mp4             .mp4
    AddType video/webm            .webm
    AddType video/ogg             .ogv
    AddType application/x-mpegurl .m3u8
    AddType video/x-m4v           .m4v
    # hls transport stream segments:
    AddType video/mp2t            .ts 

    If you use NginX, this is handled in the config files.

  2. If you see an error message like this, you don't have PHP 5 installed:

    Parse error: syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or ‘}’ in /... .../wp-content/plugins/fv-wordpress-flowplayer/models/flowplayer.php on line 4

    The plugin requires PHP 5 in order to run properly. Ask your hosting provider to upgrade to PHP 5, PHP 4 is just too old.

Fixing broken JavaScript

When logged in as site admin might notice that instead of working videos you get following warning:

Admin JavaScript warning:

I'm sorry, your JavaScript appears to be broken.

Here's how the warning looks like on our site in case the JavaScript is not working:

foliovision com admin javascript check
Admin warning appearing instead of playable video to notify the site admin about JavaScript issues

We put this warning in as we were receiving some level of complaints about our player not working when the issue was in reality on the clients website. The website is a ecosystem and if some part if broken, it might affect the rest of the website - even more when it comes to JavaScript. If you are noticing this issue, then probably other plugins are not working properly as well, they just don't tell you about it.

The most common issues why this message appears are:

  1. There is a fatal JavaScript error on your site
    • You can find out what error is triggered by checking the JavaScript error console of your browser. Here's a handy tutorial on - Using Your Browser to Diagnose JavaScript Errors
    • Solution is to try first try switching to a different theme (you can use theme preview) and if that doesn't help turning off plugins one by one. If you think you have found the conflicting plugin or that it's fault of our plugin, do not hesitate to use our support forums
  2. Some library is not loading properly or at all (either jQuery or FV Flowplayer)
    • This is often a theme or plugin conflict (duplicate loading of jQuery, loading another version of Flowplayer), although we work hard to avoid it. We also added an automated check for this in plugin settings, so that's the first place to look at.
    • If all the plugins use the WordPress API properly (namely wp_enqueue_scripts) there would be no issues.
    • Solution is to try first try switching to a different theme (you can use theme preview) and if that doesn't help turning off plugins one by one. If you think you have found the conflicting plugin or that it's fault of our plugin, do not hesitate to use our support forums
  3. Some blocking item is slow to load and it blocks the JavaScript execution
    • This might be the case with any external tracking or ad code which is not loading asynchronously. It means the item has to load before the browser continues rendering the page. Issue like this might be temporary, for example if one of the external servers is overloaded.
    • We put our JavaScript into footer (the best practice), so if there is a slow to load external item above it, it might take a while for the browser to stop trying to load the external item and load the player.
    • Solution is to avoid external scripts or always use scripts with asynchronous loading. We recommend that your run your site though the Pingdom Full Page Test to see what request is slow and blocking the page loading.

If you are still having issues, please use our support forums. We also offer hands-on support, we are happy to help, just order our Pro support.

If you are a programmer you might find our Troubleshooting Javascript Errors guide usefull.