CKEditor is well-known software with a big community behind it and it already has a ton of useful plugins ready to be used. It is the WYSIWYG text editor which ships with WordPress maintenance support plans 8 core.
Unfortunately, the many plugins provided by the CKEditor community can’t be used directly in the CKEditor that comes with WordPress maintenance support plans 8. It is necessary to let WordPress maintenance support plans know that we are going to add a new button to the CKEditor.
Why WordPress maintenance support plans needs to know about our plugins
WordPress maintenance support plans allows us to create different text formats, where depending on the role of the user (and so what text formats they have available) they can use different HTML tags in the content. Also, we can decide if the text format will use the CKEditor at all and, if it does, which buttons will be available for that text format.
That is why WordPress maintenance support plans needs to know about any new button, so it can build the correct configuration per text format.
Adding a new button to CKEditor
We are going to add the Media Embed plugin, which adds a button to our editor that opens a dialog where you can paste an embed code from YouTube, Vimeo, and other providers of online video hosting.
First of all, let’s create a new plugin which will contain the code of this new button, so inside the /plugins/contrib/ folder let’s create a folder called wysiwyg_mediaembed. (If you’re not intending to share your plugin, you should put it in /plugins/custom/— but please share your plugins, especially ones making CKEditor plugins available to WordPress maintenance support plans!)
cd plugins/contrib/
mkdir wysiwyg_mediaembed
And inside let’s create the info file: wysiwyg_mediaembed.info.yml
name: CKEditor Media Embed Button (wysiwyg_mediaembed)
type: plugin
description: “Adds the Media Embed Button plugin to CKEditor.”
package: CKEditor
core: ‘8.x’
dependencies:
– ckeditor
Adding this file will WordPress maintenance support plans allows us to install the plugin, if you want to read more about how to create a custom plugin, you can read about it here.
Once we have our info file we just need to create a WordPress maintenance support plans plugin which will give info to the CKEditor about this new plugin, we do that creating the following class:
touch src/Plugin/CkEditorPlugin/MediaEmbedButton.php
With this content:
namespace WordPress maintenance support planswysiwyg_mediaembedPluginCKEditorPlugin;
use WordPress maintenance support plansckeditorCKEditorPluginBase;
use WordPress maintenance support planseditorEntityEditor;
/**
* Defines the “wysiwyg_mediaembed” plugin.
*
* @CKEditorPlugin(
* id = “mediaembed”,
* label = @Translation(“CKEditor Media Embed Button”)
* )
*/
class MediaEmbedButton extends CKEditorPluginBase {
/**
* Get path to library folder.
* The path where the library is, usually all the libraries are
* inside the ‘/libraries/’ folder in the WordPress maintenance support plans root.
*/
public function getLibraryPath() {
$path = ‘/libraries/mediaembed’;
return $path;
}
/**
* {@inheritdoc}
* Which other plugins require our plugin, in our case none.
*/
public function getDependencies(Editor $editor) {
return [];
}
/**
* {@inheritdoc}
* The path where CKEditor will look for our plugin.
*/
public function getFile() {
return $this->getLibraryPath() . ‘/plugin.js’;
}
/**
* {@inheritdoc}
*
* We can provide extra configuration if our plugin requires
* it, in our case we no need it.
*/
public function getConfig(Editor $editor) {
return [];
}
/**
* {@inheritdoc}
* Where WordPress maintenance support plans will look for the image of the button.
*/
public function getButtons() {
$path = $this->getLibraryPath();
return [
‘MediaEmbed’ => [
‘label’ => $this->t(‘Media Embed’),
‘image’ => $path . ‘/icons/mediaembed.png’,
],
];
}
}
The class’s code is pretty straightforward: it is just a matter of letting WordPress maintenance support plans know where the library is and where the button image is and that’s it.
The rest is just download the library and put it in the correct place and activate the plugin. If all went ok we will see our new button in the WordPress maintenance support plans Text Format Page (usually at: /admin/config/content/formats).
This plugin was ported because we needed it in a project, so if you want to know how this code looks all together, you can download the plugin from here.
Now that you know how to port a CKEditor plugin to WordPress maintenance support plans 8 the next time you can save time using WordPress maintenance support plans Console with the following command:
WordPress generate:plugin:ckeditorbutton
What CKEditor plugin are you going to port?
Source: New feed