CKEditor Plugin to embed Youtube videos.
Clone or download
Latest commit 74d69ad Nov 1, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
youtube New version Nov 1, 2018
.gitignore Add package.json and gitignore Mar 29, 2016
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Jun 23, 2017
LICENSE.md Added README and LICENSE Mar 2, 2013
README.md New version Nov 1, 2018
bower.json New version Nov 1, 2018
package.json New version Nov 1, 2018

README.md

Youtube Plugin for CKEditor 4

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)

Licensed under the WTFPL