This is a plugin for plugin developers. It empowers them to create plugins for the Mosaico e-mail editor for CiviCRM. It is one of the successors of the Wordpress Integration for CiviMail with Mosaico plugin that is now split into three separate plugins:
- CiviCRM Mosaico Plugin Interface (this plugin)
- CiviCRM Flexmailer Embed Images
- WordPress CivCRM Mosaico Integration
A new hook hook_civicrm_mosaicoPlugins
is introduced to insert/modify Mosaico configuration and/or Mosaico plugins.
The hook function receives an array with the following structure (with sample payload):
[ 'plugin-name' => [
'plugin' => 'function( vm ) { window.viewModel = vm; }',
'scripts' => [ 'some_absolute_path/some_script.js', 'some_other_absolute_path/some_other_script.js' ],
'styles' => [ 'some_absolute_path/some_style.css', 'some_other_absolute_path/some_other_style.css' ],
'config' => [ 'tinymceConfigFull' ][ 'toolbar1' ] = 'numlist'
],
'other-plugin-name' => [ ... ],
...
]
Key | Description |
---|---|
plugin-name |
Name to index the plugin/configuration block in the array |
plugin |
The Mosaico JavaScript plugin object itself |
scripts |
Array of script files to be included on Mosaico boot, usually contains your JS plugin |
styles |
Array of styles to be included |
config |
Mosaico configuration parameters |
Simply edit existing entries (Mosaico itself has the plugin-name 'mosaico') or add your own plugins/configurations to the array.
See a sample usage of the hook function at the bottom of the source of civi_mosaico_plugininterface.php
.
For a guide to Mosaico plugins, see https://github.com/voidlabs/mosaico/wiki/Mosaico-Plugins.
The extension is licensed under AGPL-3.0.
- PHP v7.2+
- CiviCRM 5.17+
- CiviCRM FlexMailer plugin (included in CiviCRM 5.28+, older versions need to download the extension)
- CiviCRM Mosaico plugin
Learn more about installing CiviCRM extensions in the CiviCRM Sysadmin Guide.
Sysadmins and developers may download the .zip
file for this extension and
install it with the command-line tool cv.
cd <extension-dir>
cv dl de.ergomation.civi-mosaico-plugininterface@https://github.com/skyslasher/de.ergomation.civi-mosaico-plugininterface/archive/master.zip
Sysadmins and developers may clone the Git repo for this extension and install it with the command-line tool cv.
git clone https://github.com/skyslasher/de.ergomation.civi-mosaico-plugininterface.git
cv en civi_mosaico_plugininterface
Use the hook in a plugin.
Currently there are no known issues.