Title: Fluid Player
Author: fluidplayer
Published: <strong>April 18, 2017</strong>
Last modified: October 18, 2023

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/fluid-player.svg)

# Fluid Player

 By [fluidplayer](https://profiles.wordpress.org/fluidplayer/)

[Download](https://downloads.wordpress.org/plugin/fluid-player.zip)

 * [Details](https://pcd.wordpress.org/plugins/fluid-player/#description)
 * [Reviews](https://pcd.wordpress.org/plugins/fluid-player/#reviews)
 *  [Installation](https://pcd.wordpress.org/plugins/fluid-player/#installation)
 * [Development](https://pcd.wordpress.org/plugins/fluid-player/#developers)

 [Support](https://wordpress.org/support/plugin/fluid-player/)

## Description

This plugin is a wrapper around the html5 video player [Fluid Player](https://www.fluidplayer.com)

Once the plugin is installed and activated, you’ll only need to use the any of the[
fluid-player] or [fluid-player-extended] shortcodes at the desired location in your
page or post. The plugin comes with a default sample video, vast file and thumbnail
previews. If no shortcode parameters are provided, the plugin will fallback to the
previously listed values.

For issues please refer to the main Fluid Player repository https://github.com/fluid-
player/fluid-player

## Installation

This section describes how to install the plugin and get it working.

 1. Upload the plugin files to the `/wp-content/plugins/fluid-player` directory, or
    install the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the ‘Plugins’ screen in WordPress
 3. Include any of the the [fluid-player] or [fluid-player-extended] shortcodes on 
    your website pages/posts. Below is the list of accepted parameters:

 * video : path to actual video to be used by the player. If no value is passed 
   it will fall back to the plugin sample video.
 * vast_file : path to vast file (optional)
 * vtt_file : path to VTT file (optional)
 * vtt_sprite : path to VTT sprites file (optional)
 * layout : the following skins are provided with the player: default/browser, if
   no value is passed it will fall back to ‘default’
 * responsive : toggle responsive behavior, defaults to false
 * auto-play : toggle video autoplay, defaults to false
 * playback-speed-control : Toggle playback speed widget on the control bar, defaults
   to false
 * poster-image : Poster image to be displayed before video playback starts. Video
   screenshot is used most commonly
 * allow-download : Toggle Download button on the control bar, defaults to false
 * logo : Logo url
 * logo-position: logo positioning, default value “top right”
 * logo-opacity : logo opacity, default value 1
 * logo-hyperlink: URL which will open in an new tab when the logo is clicked
 * ad-text : Ad text visible in the top right corner of the video
 * ad-cta-text : CTA hyperlink visible in the bottom left corner of the video
 * html-on-pause-block-width : html banner width, default null
 * html-on-pause-block-height : html banner height, default null

To further customize the video player, you will need to follow the docs at https://
docs.fluidplayer.com/
 You can use [fluid-player-ad-list] to add multiple ad rolls
with different configurations, or you can totally overwrite the plugin parameters
by using [fluid-player-options].

Using [fluid-player-options] is our recommended approach, since it will enable more
compatibility with newer versions of Fluid Player.

Simple shortcode example:

    ```
    [fluid-player
        video="foo.mp4"
        vast_file="vast.xml"
        vtt_file="thumbs.vtt"
        vtt_sprite="thumbs.jpg"
        layout="default"

        auto-play="true"
        allow-download="true"
        playback-speed-control="true"

        responsive="true"
    ]
    ```

Extended shortcode example:

    ```
    [fluid-player-extended vast_file="https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=" responsive="true" layout="default" auto-play="false" allow-download="true" playback-speed-control="true" poster-image="https://www.fluidplayer.com/images/valerian-thumbnail.jpg" logo="https://placekitten.com/64/64" logo-position="top right" logo-opacity=".8" logo-hyperlink="https://www.fluidplayer.com/" ad-text="adText" ad-cta-text="adCTAText" html-on-pause-block-width="100" html-on-pause-block-height="100"]

        [fluid-player-multi-res-video]
            [
                {"label": "720", "url": "https://cdn.fluidplayer.com/videos/valerian-720p.mkv"},
                {"label": "480", "url": "https://cdn.fluidplayer.com/videos/valerian-480p.mkv"}
            ]
        [/fluid-player-multi-res-video]

        [fluid-player-html-block]
            <div>
                <img src="https://placekitten.com/100/100" />
            </div>
        [/fluid-player-html-block]

    [/fluid-player-extended]
    ```

Extended shortcode example with custom adList:

    ```
    [fluid-player-extended responsive="true" layout="default" auto-play="false" allow-download="true" playback-speed-control="true" poster-image="https://www.fluidplayer.com/images/valerian-thumbnail.jpg" logo="https://placekitten.com/64/64" logo-position="top right" logo-opacity=".8" logo-hyperlink="https://www.fluidplayer.com/" ad-text="adText" ad-cta-text="adCTAText"]

        [fluid-player-ad-list]
            [
                { roll: 'preRoll', vastTag: 'https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=' },
                { roll: 'midRoll', timer: '15', vastTag: 'https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/nonlinear_ad_samples&sz=480x70&cust_params=sample_ct%3Dnonlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=' },
                { roll: 'postRoll', vastTag: 'https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_preroll_skippable&sz=640x480&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=' },
                { roll: 'onPauseRoll', vastTag: 'https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/nonlinear_ad_samples&sz=480x70&cust_params=sample_ct%3Dnonlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=' },
            ]
        [/fluid-player-ad-list]

        [fluid-player-multi-res-video]
            [
                {"label": "720", "url": "https://cdn.fluidplayer.com/videos/valerian-720p.mkv"},
                {"label": "480", "url": "https://cdn.fluidplayer.com/videos/valerian-480p.mkv"}
            ]
        [/fluid-player-multi-res-video]

    [/fluid-player-extended]
    ```

Extended shortcode example with custom configuration:

    ```
    [fluid-player-extended]

        [fluid-player-options]
        {
            layoutControls: {
                primaryColor:           false,
                playButtonShowing:      true,
                playPauseAnimation:     true,
                fillToContainer:        true,
                autoPlay:               false,
                preload:                false,
                mute:                   false,
                doubleclickFullscreen:  true,
                subtitlesEnabled:       false,
                keyboardControl:        true,
                layout:                 'default',
                allowDownload:          false,
                playbackRateEnabled:    false,
                allowTheatre:           true,
                title:                  false,
                loop:                   false,
                logo: {
                    imageUrl:           null,
                    position:           'top left',
                    clickUrl:           null,
                    opacity:            1
                },
                controlBar: {
                    autoHide:           true,
                    autoHideTimeout:    3,
                    animated:           true,
                    playbackRates:      ['x2', 'x1.5', 'x1', 'x0.5']
                },
                timelinePreview:        {},
                htmlOnPauseBlock: {
                    html:               null,
                    height:             null,
                    width:              null
                },
                playerInitCallback:     (function() {}),
                miniPlayer: {
                    enabled: true,
                    width: 400,
                    height: 225
                }
            },
            vastOptions: {
                adList:                     [
                    { roll: 'preRoll', vastTag: 'https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=' }
                ],
                skipButtonCaption:          'Skip ad in [seconds]',
                skipButtonClickCaption:     'Skip ad <span class="skip_button_icon"></span>',
                adText:                     null,
                adTextPosition:             'top left',
                adCTAText:                  'Visit now!',
                adCTATextPosition:          'bottom right',
                vastTimeout:                5000,
                showPlayButton:             false,
                maxAllowedVastTagRedirects: 1,
                vastAdvanced: {
                    vastLoadedCallback:       (function() {}),
                    noVastVideoCallback:      (function() {}),
                    vastVideoSkippedCallback: (function() {}),
                    vastVideoEndedCallback:   (function() {})
                }
            }
        }
        [/fluid-player-options]

        [fluid-player-multi-res-video]
            [
                {"label": "720", "url": "https://cdn.fluidplayer.com/videos/valerian-720p.mkv"},
                {"label": "480", "url": "https://cdn.fluidplayer.com/videos/valerian-480p.mkv"}
            ]
        [/fluid-player-multi-res-video]

    [/fluid-player-extended]
    ```

## Reviews

![](https://secure.gravatar.com/avatar/b7afd1b0efb4f0fc49801cdc747cd4df3dad1b2dd95bd99553fe4464743050ca?
s=60&d=retro&r=g)

### 󠀁[Gracias por hacer algo tan bueno](https://wordpress.org/support/topic/gracias-por-hacer-algo-tan-bueno/)󠁿

 [abelhoyos](https://profiles.wordpress.org/abelhoyos/) April 17, 2023

5 Estrellas para su buen trabajo, los felicito. Muchas gracias. Saludos desde Peru.

![](https://secure.gravatar.com/avatar/1fcc1e2aea9e9b92442b949c4bf8de840fcd9a0c540941aa56ed15072d7951e4?
s=60&d=retro&r=g)

### 󠀁[the best video player plugin](https://wordpress.org/support/topic/the-best-video-player-plugin/)󠁿

 [lleeandra98](https://profiles.wordpress.org/lleeandra98/) March 4, 2021

This plugin really great, and open source can do anything what i needed, i wanna
change this plugin to default media player in wordpress but i haven’t seen people
doing about it before

![](https://secure.gravatar.com/avatar/a428efe4198e3fede33acb9e0221d8b75426f84763c76afacae57896856ce885?
s=60&d=retro&r=g)

### 󠀁[کارش عالیه](https://wordpress.org/support/topic/%da%a9%d8%a7%d8%b1%d8%b4-%d8%b9%d8%a7%d9%84%db%8c%d9%87/)󠁿

 [mr.nosrati](https://profiles.wordpress.org/mrnosrati/) May 10, 2019

واقعا عالیییییییییییییییییییییییییی

![](https://secure.gravatar.com/avatar/711a77396d959afa587f83911c2626594349954b1876efe71d305e89583e8208?
s=60&d=retro&r=g)

### 󠀁[Needs Improvements](https://wordpress.org/support/topic/needs-improvements-8/)󠁿

 [marcojoelmirschutz](https://profiles.wordpress.org/marcojoelmirschutz/) March 
1, 2018 3 replies

It needs several improvements to be well evaluated.

![](https://secure.gravatar.com/avatar/e98f5368d0f918f67142baa90b20816f354ea27f715df18f3cc34c5823c18eaa?
s=60&d=retro&r=g)

### 󠀁[Works great](https://wordpress.org/support/topic/works-great-4208/)󠁿

 [jinyus](https://profiles.wordpress.org/jinyus/) August 2, 2017 1 reply

It is a bit barebones but functions well. Html blobk on pause would be a great feature.
And it looks crammed on mobile devices.

 [ Read all 5 reviews ](https://wordpress.org/support/plugin/fluid-player/reviews/)

## Contributors & Developers

“Fluid Player” is open source software. The following people have contributed to
this plugin.

Contributors

 *   [ fluidplayer ](https://profiles.wordpress.org/fluidplayer/)
 *   [ florintudor ](https://profiles.wordpress.org/florintudor/)

[Translate “Fluid Player” into your language.](https://translate.wordpress.org/projects/wp-plugins/fluid-player)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/fluid-player/), check
out the [SVN repository](https://plugins.svn.wordpress.org/fluid-player/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/fluid-player/) by
[RSS](https://plugins.trac.wordpress.org/log/fluid-player/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 3.0

 * Introduces fluid-player-ad-list shortcode
 * Introduces fluid-player-options shortcode
 * Updates Fluid Player to v3

#### 2.0

 * Bringing plugin inline with version V2 of Fluid Player

## Meta

 *  Version **3.0.0**
 *  Last updated **2 years ago**
 *  Active installations **400+**
 *  WordPress version ** 4.6 or higher **
 *  Tested up to **6.3.8**
 *  PHP version ** 5.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/fluid-player/)
 * Tags
 * [HTML5 video player](https://pcd.wordpress.org/plugins/tags/html5-video-player/)
   [thumbnails](https://pcd.wordpress.org/plugins/tags/thumbnails/)[VAST](https://pcd.wordpress.org/plugins/tags/vast/)
 *  [Advanced View](https://pcd.wordpress.org/plugins/fluid-player/advanced/)

## Ratings

 4.6 out of 5 stars.

 *  [  4 5-star reviews     ](https://wordpress.org/support/plugin/fluid-player/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/fluid-player/reviews/?filter=4)
 *  [  1 3-star review     ](https://wordpress.org/support/plugin/fluid-player/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/fluid-player/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/fluid-player/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/fluid-player/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/fluid-player/reviews/)

## Contributors

 *   [ fluidplayer ](https://profiles.wordpress.org/fluidplayer/)
 *   [ florintudor ](https://profiles.wordpress.org/florintudor/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/fluid-player/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](http://example.com/)