README

Copyright © 2017 Jonnas Fonini jonnasfonini@gmail.com.

This work is free. You can redistribute it and/or modify it under the terms of the Do What The Fuck You Want To Public License, Version 2, as published by Sam Hocevar. See the LICENSE file for more details.

This plugin allow you to insert Youtube videos using embed code or just the video URL.

Installation

With NPM

1. npm install ckeditor-youtube-plugin

2. Add the plugin to CKEditor (config.js):

   CKEDITOR.plugins.addExternal('youtube', '../node_modules/ckeditor-youtube-plugin/youtube/');
   
   config.extraPlugins = 'youtube';

   You may need to adjust the plugin path. The example is assuming that you have the following directory structure:

   project
   └───ckeditor
   │   └───config.js
   └───node_modules
       └───ckeditor-youtube-plugin
   

Manual

Follow these steps:

1. Download the latest version of the plugin from Github.

2. Extract the downloaded file into the CKEditor's plugins folder.

3. Enable the plugin by changing or adding the extraPlugins line in your configuration (config.js):

   config.extraPlugins = 'youtube';

Configuration

The default options can be overriden on config.js.

Video width:

config.youtube_width = '640';

Video height:

config.youtube_height = '480';

Make responsive (ignore width and height, fit to width):

config.youtube_responsive = true;

Show related videos:

config.youtube_related = true;

Use old embed code:

config.youtube_older = false;

Enable privacy-enhanced mode:

config.youtube_privacy = false;

Start video automatically:

config.youtube_autoplay = false;

Show player controls:

config.youtube_controls = true;

Disable the change of settings. The elements on the list will be disabled (but still visible). See the available element list below.

config.youtube_disabled_fields = ['txtEmbed', 'chkAutoplay'];

List of UI elements

• txtEmbed
• txtUrl
• txtWidth
• txtHeight
• chkResponsive
• chkNoEmbed
• chkRelated
• chkOlderCode
• chkPrivacy
• chkAutoplay
• txtStartAt
• chkControls

How to use

If everything is ok, a Youtube icon should appear on the CKEditor toolbar. Click it, paste your embed code or video URL and the video will be inserted.

Translators

Thanks to those who helped translate the plugin

• Eyed Farra (ar)
• N. Petkov (bg)
• Lukáš Říha (cs)
• Sven Jansen (de)
• Dimitris Kotsakis (el)
• Victor (pollin14) (es)
• Kevin Rudissaar (et)
• Asier Iturralde Sarasola (eu)
• Jami Pietilä (fi)
• BiomanRouge (fr)
• Moshe Simantov (he)
• Karmacsi Gábor (hu)
• Francesco Zanoni (it)
• Yayoshi Nobuhide (ja)
• MinSoo Kim (ko)
• Holger Lockertsen (nb, nn)
• Patrick van Lier (nl)
• Michał Zalewski, Wirek (pl)
• Samuel Diogo (pt-br)
• Alexander Ustimenko (ru)
• ivanbarlog (sk)
• Çağdaş Yiğit (tr)
• Mykola Pukhalskyi (uk)
• Vu Thao (vi)
• trowa (zh)