Easy Waveform Player

February 22, 2024

Easy Waveform Player Plugin

Add Waveform players easy and fast to your WordPress.

SSL certificate is REQUIRED for the plugin to work!
Easy Waveform Player allows you to add visual waveform, generated on the fly, for an audio file.
Loads audio on request only. If multiple players are showed they will not over load all the audio at once.
Autostop other Easy Waveform Players if they are playing.

How to use:

1) Use the block from the editor you have installed(intergrated in: Gutenberb, Elementor, WPBakery Visual Builder, DIVI)
2) Run code programatically. Code example:

 global $easywaveformplayer; echo $easywaveformplayer->easywaveformplayer( array( 'audio' => 'https://link.to/audio.mp3', ) ); 

3) Write manual shortcode using examples below

Examples:

  • Load audio by libray id: [easywaveformplayer audio="6"]
  • Load audio by URL: [easywaveformplayer audio="https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3"]
  • Autoplay(this requires that user allow permission to autoplay for your page): [easywaveformplayer audio="6" autoplay="1"]
  • Add title: [easywaveformplayer audio="https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3" title="This is a title"]
  • Animated appearence of timeline: [easywaveformplayer audio="https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3" animated="true"]
  • Wave design changes: [easywaveformplayer audio="https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3" timeline_wave_color="#FF0000" timeline_progress_color="#000000"]
  • Colored timelime background(including gradient): [easywaveformplayer audio="https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3" timeline_background_color="linear-gradient(90deg, rgba(2,0,36,1) 0%, rgba(9,9,121,1) 35%, rgba(0,212,255,1) 100%)"]
  • Minimum size and adding different size then default: [easywaveformplayer audio="https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3" min="true" mini_size="100"]
  • Minimum size with progress indicator: [easywaveformplayer audio="https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3" min="true" show_progress="true"]

Parameters and default values:

  • id -> ” can be any value containing letters, numbers, _ OR – Value Added will be concatenated with: “ewfplayer_”. Eg: ewfplayer_mainplayer
  • always_play -> 0 (0 – it will stop when other player start playing, 1 – it will continue playing when other start playing)
  • autoplay -> 0 (accepted 0 or 1 values)
  • animated -> false (accepted true or false values)
  • min -> false (accepted true or false values)
  • show_progress -> false (accepted true or false values)
  • player_width -> 100% (any css width values)
  • player_position -> left (left, center, right)
  • player_background_color -> transparent (or other CSS color)
  • mini_size -> 60 (in px)
  • mini_border_size -> 2 (in px)
  • mini_border_color -> #000000 (transparent or other CSS color)
  • progress_circle_thickness -> 4 (in px)
  • progress_circle_color -> #FF0000 (transparent or other CSS color)
  • controller_size -> 40 (in px)
  • controller_color -> #000000 (transparent or other CSS color)
  • timeline_background_color -> transparent (in px)
  • timeline_wave_color -> #999999 (transparent or other CSS color)
  • timeline_progress_color -> #555555 (transparent or other CSS color)
  • timeline_cursor_width -> 1 (in px)
  • timeline_cursor_color -> #333333 (transparent or other CSS color)
  • timeline_height -> 128 (in px)
  • timeline_bar_gap -> 0 (any number, starting from 0)
  • timeline_bar_width -> 0 (any number, starting from 0)
  • timeline_bar_radius -> 0 (any number, starting from 0)

Built using library: https://wavesurfer-js.org/

SSL certificate is REQUIRED for the plugin to work!

Installation

Minimum Requirements

  • PHP version 5.6 or greater (PHP 7.1 or greater is recommended)

Automatic installation

Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t need to leave your web browser. To do an automatic install of Face Recognition, log in to your WordPress dashboard, navigate to the Plugins menu and click Add New.

In the search field type “Waveform Player” and click Search Plugins. Once you’ve found the plugin you can view details about it such as the point release, rating and description. Most importantly of course, you can install it by simply clicking “Install Now”.

Manual installation

The manual installation method involves downloading our plugin and uploading it to your webserver via your favourite FTP application OR from Admin Area -> Plugins -> Add New and choose ‘Upload Plugin’. The WordPress codex contains instructions on how to do this here.

Screenshots

  1. Plugin Settings

    Plugin Settings

  2. Waveform Player example

    Waveform Player example

  3. Waveform Player example with mini players

    Waveform Player example with mini players

FAQ

Why SSL is required?

Plugin uses parts of browser that needs SSL to run

Cache plugins

The plugin should work with any cache plugin

Integrations

The plugin is integrated with main builders by adding custom block.

Changelog

1.2.0

Removed Gutenberg support
Tested with WordPress 6.4.3

1.1.0

Added Integrations with: Gutenberg, Elementor, WPBakery Visual Builder and DIVI builder. More to come!
Added possibility to run the plugin programatically, from main class(see readme)
Bug fixes and improvements to plugin
Typos fix

1.0.0

On date 2019-10-14:
* First version pushed to WordPress

Details

  • Version: 1.2.0
  • Active installations: 80
  • WordPress Version: 5.0
  • Tested up to: 6.4.5
  • PHP Version: 7.0

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars