This plugin allows the easy insertion of HTML5 audio players.Features
- Creates a HTML5 audio tag for your audio. You can:
- Use an audio file that is hosted on another website using its URL.
- Use an audio file that is already on your server.
- Upload an audio file to your server and use it.
- You can choose the alignment of the HTML5 audio player. Available options:
- Center (default)
- You can choose whether to play the audio automatically or not (since version 1.3.0). Default is no.
- You can change the position of the HTML5 audio player by dragging and dropping it.
- You can change the properties of an existing player using the context menu (since version 1.1.0) or double clicking on it.
- Easy to use. The user interface is similar to the enhanced image plugin.
- Available in multiple languages: Basque, Bulgarian, Chinese, English, Farsi (Persian), French, German, Greek, Russian, Spanish, Ukrainian, and Uzbek.
- If you are installing this plugin in GNU/Linux make sure that its folders and files have the right permissions otherwise you might get errors.
By default CKEditor does not include a file browser or uploader. The "Browse server" and "Upload" tabs need server side code to work so they don't appear if there is no file browser or uploader.
To fix the problem you can install CKFinder and integrate it with CKEditor. There are how-to guides in the documentation:
Take into account that most (all?) mobile browsers disable the autoplay option and don't play the audio without user interaction.
We want to thank all the people who helped translate this plugin:
- Bulgarian: N. Petkov
- Chinese: 郑东武
- Farsi (Persian): Mohammad Hossein Rabiee
- French: Simon Georget
- German: Mischa Sameli
- Greek: Dimitris Kritsotakis
- Russian: smartcorestudio
- Ukrainian: Sensetivity
- Uzbek: Bahriddin Abdiev
More translations are welcome and will be included in future releases. If you want to use this plugin in your language feel free to translate it. If you know how to use git and github you can follow these steps, otherwise add the translation of these strings as a comment indicating which language it is and we will take care of it:
Insert HTML5 audio
Audio source URL is missing.
Send it to the server
The recommended way to install all CKEditor add-ons is to create a custom build by using Online builder. To do that, click the Add to my editor button on the plugin page. When you are done, click the Build my editor button on the right side of the page to go to Online builder.
Note: This add-on is already selected to be a part of your current build.
Add-on installation instructions
If you want to add the plugin manually, you will need to:
- Extract the downloaded plugin
pluginsfolder of your CKEditor installation. Example:
- Enable the plugin by using the
extraPluginsconfiguration setting. Example:
config.extraPlugins = 'html5audio';
- Download and configure all its dependencies, too.
Note: The plugin may have additional requirements. Check the add-on page and documentation for more details.
|Plugin versions||CKEditor versions|
Added Bulgarian translation. Thank you very much N. Petkov!
Added an option to disable download. Code contributed by Nour Akalay. Thanks!
Added Uzbek translation. Thank you very much Bahriddin Abdiev!
Added French translation. Thank you very much Simon Georget!