This bundle provides the Quill 2.x WYSIWYG editor integration for Pimcore. This includes the WYSIWYG for Documents, Data Objects and Shared Translations.
See Installation
Available configuration options can be found here: config options
Available themes and how to configure it can be found here: themes
wysiwyg
helper doesn't require any additional configuration options.
The following code add a second toolbar.
<section id="marked-content">
{{ pimcore_wysiwyg("specialContent", {
toolbar: [{ 'header': 1 }, { 'header': 2 }]
})
}}
</section>
A list of configuration options you can find in the Quill toolbar documentation.
The WYSIWYG editable allows us to specify the toolbar.
If you have to limit styling options (for example only basic styles like <b>
tag and lists would be allowed), just use toolbar1
option.
<section id="marked-content">
{{ pimcore_wysiwyg("specialContent", {
toolbar: [{ 'header': 1 }, { 'header': 2 }]
})
}}
</section>
Now the user can use only the limited toolbar.
You can add a Global Configuration for all WYSIWYG Editors for all documents by setting pimcore.document.editables.wysiwyg.defaultEditorConfig
.
You can add a Global Configuration for all WYSIWYG Editors for all data objects by setting pimcore.object.tags.wysiwyg.defaultEditorConfig
.
For this purpose, you can create a Pimcore Bundle and add the
configuration in a file in the Resources/public
directory of your bundle (e.g. Resources/public/js/editmode.js
).
pimcore.document.editables.wysiwyg = pimcore.document.editables.wysiwyg || {};
pimcore.document.editables.wysiwyg.defaultEditorConfig = { menubar: true };
This will show you the default menubar from Quill in all document editables.
For the data object settings, you should put them in the startup.js
in your bundle.
pimcore.registerNS("pimcore.plugin.YourQuillEditorConfigBundle");
pimcore.plugin.YourQuillEditorConfigBundle = Class.create({
initialize: function () {
document.addEventListener(pimcore.events.pimcoreReady, this.pimcoreReady.bind(this));
},
pimcoreReady: function (e) {
pimcore.object.tags.wysiwyg = pimcore.object.tags.wysiwyg || {};
pimcore.object.tags.wysiwyg.defaultEditorConfig = { menubar: true };
}
});
const YourQuillEditorConfigBundlePlugin = new pimcore.plugin.YourQuillEditorConfigBundle();
To load the editmode.js
file in editmode, you need to implement getEditmodeJsPaths
in your bundle class. Given your bundle is named
AppAdminBundle
and your editmode.js
and startup.js
created before was saved to src/AppAdminBundle/public/js/editmode.js
and src/AppAdminBundle/public/js/startup.js
:
<?php
namespace AppAdminBundle;
use Pimcore\Extension\Bundle\AbstractPimcoreBundle;
class AppAdminBundle extends AbstractPimcoreBundle
{
public function getEditmodeJsPaths(): array
{
return [
'/bundles/appadmin/js/pimcore/editmode.js'
];
}
public function getJsPaths()
{
return [
'/bundles/appadmin/js/pimcore/startup.js'
];
}
}
You can also add the file which should be loaded in editmode through an event listener to avoid having to implement a
PimcoreBundle
just for the sake of adding a file. Given you already have an App
bundle and put the JS config from above
to public/js/editmode.js
you can create an event listener to add the path to the list of loaded
files in editmode (please see Events for details on how
to implement and register event listeners):
<?php
namespace App\EventListener;
use Pimcore\Event\BundleManager\PathsEvent;
use Pimcore\Bundle\AdminBundle\Event\BundleManagerEvents;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
class EditmodeListener implements EventSubscriberInterface
{
public static function getSubscribedEvents(): array
{
return [
BundleManagerEvents::EDITMODE_JS_PATHS => 'onEditmodeJsPaths'
];
}
public function onEditmodeJsPaths(PathsEvent $event): void
{
$event->addPaths([
'/bundles/app/js/pimcore/editmode.js'
]);
}
}