HTML-Text

Das Symbol für das HTML-Text-Element in der Objektpalette

Das HTML-Text-Element ist für längere Textpassagen gedacht - zB. Produktbeschreibungen oder auch ganze Webseiten. Der Text kann in diesem Element mittels HTML formatiert werden. Der HTML Code kann entweder "per Hand" eingegeben werden, oder mit Hilfe eines der unterstützten in-browser HTML-Editoren "TinyMCE", "RTE" oder "FCKeditor".

Dieses WebYep Element wird durch folgenden PHP Code repräsentiert:

<?php webyep_richText("Feldname", false, "../stile.css", true); ?> Details...

Parameter der PHP Funktion webyep_richText():
(siehe auch "Eigenschaften des HTML-Text-Elementes" weiter unten)

"Feldname": Ein Text – der Name für dieses Element.
true/false: Ein boolscher Wert – der Gültigkeitsbereich dieses Elementes.
true wenn das Element in allen Seiten den selben Inhalt haben soll (global).
false wenn es auf jeder Seite, auf der es platziert ist, andere Inhalte haben soll.
"../stile.css": Ein Text – der URL einer CSS Datei die innerhalb des WYSIWYG Editors verwendet werden soll - dieser URL ist relativ zum aktuellen Dokument anzugeben.
true/false: Ein boolscher Wert – gibt an, ob E-Mail-Links im Text kodiert werden sollen.
true wenn E-Mail-Links im Text mittels JavaScript kodiert werden sollen.
false wenn sie als normaler HTML Link ausgegeben werden sollen.

Das HTML-Text-Element in Aktion - durch Klicken auf den Bearbeiten-Knopf ("Beschreibung bearbeiten")
öffnet sich das Text-Bearbeiten-Fenster

Das HTML-Text-Bearbeiten-Fenster, unter Verwendung des TinyMCE HTML-Editors

Auswahl eines in-browser WYSIWYG HTML-Editors

Im einfachsten Fall wird im HTML-Text-Bearbeiten-Fenster ein einfaches Text-Feld zur Eingabe von HTML-Code angezeigt. Durch Installation eines der unterstützten WYSIWYG Editoren kann der HTML-Code aber grafisch erstellt werden, wie in einem Textverarbeitungs- oder Webdesign-Programm.

Unterstützt werden die verbreiteten Editoren "TinyMCE", "RTE" und "FCKeditor". Sie werden nicht vorinstalliert, sondern können von der entsprechenden Website heruntergeladen werden und durch einfaches Hochladen in den "opt" Unterordner des webyep-system/programm Verzeichnisses installiert werden. WebYep erkennt dann automatisch die Präsenz des Editors und verwendet ihn im HTML-Text-Bearbeiten-Fenster.

TinyMCE kann, zum Zeitpunkt der Erstellung dieser Dokumentation, unter der folgenden Adresse heruntergeladen werden:
http://tinymce.moxiecode.com/

RTE kann, zum Zeitpunkt der Erstellung dieser Dokumentation, unter der folgenden Adresse heruntergeladen werden:
http://www.kevinroth.com/rte/

FCKeditor kann, zum Zeitpunkt der Erstellung dieser Dokumentation, unter der folgenden Adresse heruntergeladen werden:
http://www.fckeditor.net/

Laden Sie das gewünschte Paket (ZIP- oder TAR-Archiv) von der entsprechenden Website herunter. Nach dem Entpacken des Archivs (extrahieren der ZIP- bzw. TAR-Datei) entsteht bei TinyMCE ein Ordner namens "tinymce", bei RTE ein Ordner namens "rte" und beim FCKeditor ein Ordner namens "fckeditor". Laden Sie diesen Ordner in den "opt" Unterordner des webyep-system/programm Verzeichnisses am Server.

Wenn Sie dann das nächste mal das HTML-Text-Bearbeiten-Fenster öffnen, wird der so installierte WYSIWYG Editor verwendet.

Hinweis: Webbrowser-Unterstützung
Bitte beachten Sie, dass unterschiedliche Webbrowser von TinyMCE, RTE bzw. FCKedit unterstützt werden. Welche Webbrowser unterstützt werden, ist aktuell den jeweiligen Websites der editoren zu entnehmen.

Übernahme der Daten von einem herkömmlichen Text Element

Wenn Sie ein herkömmliches Text-Element (Fließtext) durch ein HTML-Text-Element ersetzen, können Sie die Text-Daten übernehmen, wenn Sie folgende Punkte beachten:

Geben Sie dem HTML-Text-Element den gleichen Feldnamen wie dem zuvor verwendeten herkömmlichen Text-Element.
Stellen Sie das "Inhalte"-Attribut ebenfalls gleich ein ("in diesem Dokument" / "in allen Dokumenten").
Wenn Sie im Text des herkömmlichen Text-Elementes eigene CSS-Stile verwendet haben, stellen Sie sicher, dass dem HTML-Text-Element im "CSS"-Attribut eine CSS-Datei (Stylesheet) übergeben wird, die Definitionen für diese Stile beinhaltet.

Wenn Sie diese Punkte beachten, wird das HTML-Text-Element die Daten das zuvor verwendeten Text-Elementes übernehmen. Es wird solange auf diese (alten) Daten zugreifen, bis im HTML-Text-Element-Bearbeiten-Fenster einmal "Speichern" geklickt wurde. Ab dann verwendet das HTML-Text-Element seine eigene Daten-Datei.

Platzierung des HTML-Text-Elementes

Beachten Sie bitte, dass das HTML-Text-Element HTML-Code generiert (wie Tabellen oder Listen). Daher ist es wichtig innerhalb welches HTML-Tags sie das HTML-Text-Element platzieren!

Am sichersten ist es, wenn Sie es in einen <DIV>-Tag platzieren. Problematisch kann hingegen zB. das Setzen in einen <P>-Tag (Absatz) werden, da Listen (<UL>) oder Tabellen (<TABLE>) in einem Absatz laut HTML-Spezifikation nicht erlaubt sind.

Um zu ermitteln, innerhalb welchen Tags sich ein WebYep HTML-Text-Element befindet, selektieren Sie es im Dreamweaver und betrachten Sie dann den Tag-Selektor (am linken unteren Fensterrand): Die Reihe von dort gelisteten Tags gibt an, in welche Tags das Element eingebettet ist. Lautet der letzte in der Reihe <p>, so sollten Sie diesen mit der rechten Maustaste anklicken, "Tag bearbeiten" wählen und aus dem <p> ein <div> machen.

Eigenschaften des HTML-Text-Elementes

Das Eigenschaftsfenster für das HTML-Text-Element

Feldname

Eine Bezeichnung für das Text-Element. Der Feldname wird in der Webseite im "Bearbeiten"-Modus angezeigt, damit die BenutzerInnen bei der Eingabe die verschiedenen Text-Elemente unterscheiden können.

Inhalte

Ist hier "in diesem Dokument" eingestellt, so ist dieses Text-Element von den Text-Elementen anderer Seiten unabhängig, auch wenn diese den gleichen Feldnamen aufweisen. Wenn Sie möchten, dass die Text-Elemente mit diesem Feldnamen auf allen Seiten den gleichen Inhalt aufweisen, ist dieses Popupmenü auf "in allen Dokumenten" zu setzen.

CSS

Damit das Schriftbild im installierten WYSIWYG HTML-Editor (TinyMCE oder RTE) dem in der Seite entspricht, können Sie hier den URL einer CSS-Datei angeben, die im Editor-Fenster verwendet werden soll.

Üblicherweise wird diese CSS-Datei eine reduzierte Fassung der CSS-Datei(en) der Seite sein. Die in dieser Datei definierten CSS Klassen werden im Editor dann auch als Stile angeboten.

Der URL der CSS Datei ist relativ zum aktuellen Dokument anzugeben.

E-Mail-Links kodieren

E-Mail-Links ("mailto:"-Links), die von den BenutzerInnen in ein WebYep-HTML-Text-Element eingegeben werden, zeigt WebYep als E-Mail-Links in der Seite an. Dies könnte (zB. von SPAM-Spidern) dazu missbraucht werden, diese E-Mail-Adressen zum Zwecke des Versendens von SPAMs zu sammeln.

Um das zu verhindern, können Sie diese Option auf "Ja" stellen - damit werden die eingefügten E-Mail-Links weiter als Links dargestellt, aber mittels JavaScript verschlüsselt, sodass sie kaum mehr missbraucht werden können.

Da diese Verschlüsselung aber auf JavaScript basiert, können die E-Mail-Adressen bei den wenigen BesucherInnen der Website, die JavaScript deaktiviert haben, nur in der Form:

name(_AT_)adresse.com

angezeigt werden.

Damit WebYep die eingefügten E-Mail-Links erkennen kann, müssen sie einen "mailto"-URL aufweisen und die E-Mail-Adresse als Link-Text verwendet werden.