Das Drupal Modul Wysiwyg API dient dazu eine benutzerfreundliche Oberfläche zum Schreiben von Text zu bieten, die sich wie ein normales Textverarbeitungsprogramm verhällt. Damit kann beliebiger Text geschrieben und frei formatiert werden, Listen und Tabellen erstellt, sowie Bilder und viele andere Elemente eingefügt werden, die ansonsten eingehende HTML-Kenntnisse erfordern.
Modul Installation
Nachfolgend werden die einzelnen Installationsschritte für das Modul Wysiwyg API beschrieben.
- Das Archiv wysiwyg-*.tar.gz in das Verzeichnis sites/all/modules/wysiwyg entpacken.
- Das Modul wysiwyg in Verwalten > Strukturierung > Module aktivieren.
- Die Konfiguration der Einstellungen wird unter Verwalten > Einstellungen > Wysiwyg vorgenommen.
Eingabeformat erstellen
Für das Schreiben von Text mit einem Wysiwyg-Editor sollte ein spezielles Eingabeformat erstellt werden. Die standardmäßig in Drupal vorhandenen Eingabeformate sind für Wysiwyg-Editoren nicht geeignet, da Text und Formatierungen verändert bzw. zerstört werden.
- In Verwalten > Einstellungen > Eingabeformate ein Eingabeformat hinzufügen.
- Als Name empfiehlt sich Rich Text zu verwenden.
- Dieses Eingabeformat sollte nur vertrauenswürdigen Rollen zugewiesen werden, da bei diesem Eingabetyp alle Filter abgeschaltet werden.
- Alle Filter deaktivieren (z.b.: HTML-Filter, HTML-Korrektor, URL-Filter, Zeilenumbruchkonverter), die den HTML-Code verändern.
Installation / Konfiguration - CKEditor (Empfohlen)
- In den Installationsanweisungen auf Verwalten > Einstellungen > Wysiwyg befindet sich der Link zu der Downloadseite des CKEditor.
- Das heruntergeladene Archiv muss in das Verzeichnis sites/all/libraries entpackt werden. Hierbei wird ein Unterverzeichnis sites/all/libraries/ckeditor und darin ein Verzeichnis sites/all/libraries/ckeditor/editor erstellt.
- Nach dem neu Laden der Seite Verwalten > Einstellungen > Wysiwyg wird angezeigt, ob die Installation erfolgreich war.
- Der CKEditor bringt von Haus aus alle verfügbaren Übersetzungen mit.
- Jetzt kann der CKEditor dem Rich Text-Eingabeformat zugewiesen und weitere Details unter Bearbeiten konfiguriert werden.
Installation / Konfiguration - TinyMCE 3.x
- In den Installationsanweisungen auf Verwalten > Einstellungen > Wysiwyg befindet sich der Link zu der Downloadseite des TinyMCE-Editors.
- Das heruntergeladene Archiv muss in das Verzeichnis sites/all/libraries/tinymce entpackt werden. Hierbei wird ein Unterverzeichnis sites/all/libraries/tinymce/jscripts erstellt.
- Nach dem neu Laden der Seite Verwalten > Einstellungen > Wysiwyg wird angezeigt, ob die Installation grundsätzlich erfolgreich war.
- Der TinyMCE-Editor bringt von Haus aus keine Übersetzungen mit. Deshalb müssen die erforderlichen Sprachpakete extra installiert werden.
- Das Sprachpaket tinymce_lang_pack.zip im Verzeichnis sites/all/libraries/tinymce/jscripts/tiny_mce entpacken.
- Jetzt kann der TinyMCE-Editor dem Rich Text-Eingabeformat zugewiesen und weitere Details unter Bearbeiten konfiguriert werden.
Hinweis: Beim TinyMCE können in der Konfiguration des Editors auch nicht installierte Sprachen ausgewählt werden, dies führt aber dazu - dass der Editor nicht geladen wird!