This widgets serves as a container for multiple instances of other media widgets in order to display them as a gallery, p.e. with the aid of flexbox or grid layout, or as a slider/carousel, p.e. with your own implementation or one of your choice, or as whatever else comes into your mind.
This widget itself does not provide any slider/carousel functionality! It only provides a HTML structure suitable for aforementioned purposes and allows to maintain it within the editor.
The resulting HTML will be p.e.
<figure class="gallery"> <div class="content"> <figure class="image"> <img src="..." /> <figcaption> ... </figcaption> </figure> ... </div> <figcaption> ... </figcaption> </figure>
At current state this widget
- only allows figure elements as child elements (filtering takes place on
- does not offer any configuration options and
- does not offer a dialog to set custom classes or values.
This could change in one of the future versions.
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 = 'gallery';
- Download and configure all its dependencies, too.
No additional dependencies.
Note: The plugin may have additional requirements. Check the add-on page and documentation for more details.