Aktiviert man TinyMCE in Connections 6, wird dieser mit einer Reihe von Plugins ausgeliefert. In der Browser-Konsole kann man sich diese wie folgt anzeigen lassen:
> tinyMCE.editors[0].settings.plugins
"a11ychecker accessiblecodeview advcode advlist autolink autoresize casechange charmap directionality emoticons formatpainter fullscreen help hr image link linkchecker lists media mediaembed mentions pageembed permanentpen powerpaste searchreplace table textpattern tinymcespellchecker wordcount powerpaste"
Zwar können neue Plugins über den externalPlugins Array in der config.js Datei eingebunden werden. Doch wie lässt sich die Konfiguration eines bereits geladenen Plugins verändern?
Beispiel: PowerPaste-Plugin konfigurieren
Ein Beispielszenario ist das PowerPaste-Plugin. Standardmäßig blendet es beim Einfügen von formattierten Texten aus Office-Programmen ein Modal-Dialogfenster ein. Der Nutzer muss auswählen, ob er die Formatierungen behalten oder entfernen möchte.
Verantwortlich dafür ist die powerpaste_word_import Eigenschaft, welche automatisch auf promt steht. Wird sie auf clean gesetzt, entfernt das Plugin automatisch sämtliche Formatierungen – etwa Farben. Die semantische Struktur des Dokumentes (z.B. Überschriften) bleibt jedoch erhalten. Somit kann der Nutzer nicht mehr versehentlich die möglicherweise ungewollten Formatierungen übernehmen.
Überschreiben der Konfiguration
Die Lösung ist recht simpel: Wir fügen das Plugin einfach ein zweites Mal in den externalPlugins Array hinzu. Laut HCL und TinyMCE-Support wird hierbei das Plugin nicht erneut geladen, sofern der Name identisch ist. Da hier im Regelfall der Pluginname genutzt wird, ist dieser einfach aus der Doku zu ermitteln. Darüber hinaus muss als URL die lokale Adresse zur Plugin-Datei angegeben werden. Durch die Installation des EAR-Archives liegen die TinyMCE-Plugins im /connections/resources/web/tiny.editors.connections/tinymce/plugins/ Ordner.
Das settings Property erlaubt es, die Eigenschaften des Plugins anzugeben. Dies ist äquivalent zum tinymce.init() Aufruf einer Vanilla-Instanz.
externalPlugins: [
{
name: "powerpaste",
url: "/connections/resources/web/tiny.editors.connections/tinymce/plugins/powerpaste/plugin.min.js",
settings: {
powerpaste_word_import: 'clean'
}
}
]
Zur besseren Übersicht definiere ich den Plugin-Ordner meist in einer Variable, die hier zur einfacheren Darstellung entfällt. An der grundsätzlichen Funktion ändert sich nichts.
Nach dem Neustart der Common-Anwendung in der WebSphere Web-Konsole (ggf. noch Browser-Cache leeren), sollten formatierte Word-Inhalte nun bereinigt eingefügt werden:
Nicht überschreibbare Eigenschaften
Laut Support könnene auf diese Art alle Eigenschaften überschrieben werden, die nicht bereits von der Connections-Integration selbst spezifiziert wurden. Betroffen sind folgende Eigenschaften:
skin
target
height
min_height
autoresize_bottom_margin
language
directionality
convert_urls
relative_urls
remove_script_host
anchor_top
anchor_bottom
typeahead_urls
content_css
content_style
branding
statusbar
menubar
toolbar
toolbar_drawer
toolbar_sticky
formats
style_formats
font_formats
color_map
textpattern_patterns
plugins
external_plugins
theme
spellchecker_rpc_url
spellchecker_on_load
spellchecker_language
spellchecker_select_languages
spellchecker_active
linkchecker_service_url
mediaembed_service_url
mediaembed_max_width
mediaembed_inline_styles
paste_as_text
powerpaste_allow_local_images
powerpaste_block_drop
images_upload_handler
extended_valid_elements
emoticons_append
emoticons_database_url
emoticons_database_id
mentions_selector
mentions_select
mentions_fetch
mentions_menu_hover
mentions_menu_complete
permanentpen_properties
help_tabs
setup
Diese lassen sich nicht überschreiben.
Auch auf andere Plugins anwendbar
Dieses Vorgehen kann für alle Plugins angewendet werden: Bei vorhandenen Plugins wird die Konfiguration zusammengeführt. Neue Plugins lädt der Editor. Beim Überschreiben ist zu beachten, dass sich hierdurch nur die Konfiguration überschreiben lässt – nicht aber das Plugin selbst!
Besitzt Connections beispielsweise eine ältere Version eines Plugins und man fügt über die URL-Eigenschaft die Adresse einer neueren Version ein, wird nicht automatisch die neuere Version geladen. Hierzu muss das gesamte TinyMCE-Paket (durch HCL) aktualisiert werden. Zum Anpassen der Standardkonfiguration eignet sich dies jedoch hervorragend: Der Browser muss kein Plugin unnötig mehrfach laden.