BbCode Erweiterung 2
Aus DeDi-Help
(Unterschied zwischen Versionen)
| Version vom 09:09, 30. Nov. 2005 (bearbeiten) Dedian (Diskussion | Beiträge) (→features) ← Zum vorherigen Versionsunterschied |
Version vom 09:19, 1. Dez. 2005 (bearbeiten) (Entfernen) Mika (Diskussion | Beiträge) K Zum nächsten Versionsunterschied → |
||
| Zeile 1: | Zeile 1: | ||
| =Einleitung= | =Einleitung= | ||
| - | bbCode ist eine Methode, Texte auch ohne HTML-Kenntnisse zu formatieren. Dabei wird eine begrenzter Satz an HTML-hnliche Formatierungselementen angeboten, welche ber einfache Parameter gesteuert werden knnen. Zusammen mit dem [[Dokumentation_ContentFlex|ContentFlex]]- oder [[Dokumentation_DeDi-Flex|DeDiFlex-Modul]] bietet die bbCode-Erweiterung eine alternative zum hufig verwendeten [[Dokumentation_WYSIWYG|WYSIWYG-Editor]]. | + | bbCode ist eine Methode, Texte auch ohne HTML-Kenntnisse zu formatieren. Dabei wird eine begrenzter Satz an HTML-hnliche Formatierungselementen angeboten, welche ber einfache Parameter gesteuert werden knnen. Zusammen mit dem [[Dokumentation_ContentFlex|ContentFlex]]- oder [[Dokumentation_DeDi-Flex|DeDiFlex-Modul]] bietet die bbCode-Erweiterung eine Alternative zum hufig verwendeten [[Dokumentation_WYSIWYG|WYSIWYG-Editor]]. |
| - | Es gab bereits eine bbCode-Erweiterung fr DeDi, diese hatte jedoch einige entscheidende Nachteile gegenber dem WYSIWYG. Vorallem fehlten Formulare zum einfachen erstellen Von links - man musste jedemal die SeitenID manuell eingeben. Darum gibt es nun eine komplett neue bbCode-Erweiterung, welche diese Nachteile auszugleichen versucht. | + | Es gab bereits eine bbCode-Erweiterung fr DeDi, diese hatte jedoch einige entscheidende Nachteile gegenber dem WYSIWYG. Vor allem fehlten Formulare zum einfachen Erstellen von links - man musste jedemal die SeitenID manuell eingeben. Darum gibt es nun eine komplett neue bbCode-Erweiterung, welche diese Nachteile auszugleichen versucht. |
| - | Wenn sie mit mir kontakt aufnehmen wollen knnen sie mich [http://forum.der-dirigent.de/index.php?act=Msg&CODE=4&MID=989 per PM] oder [mailto:koerner-familie@t-online.de per Mail] benachrichtigen oder mir ein Feedback geben. Fr Bugs und allgemeinere Fragen posten sie bitte im Diskussionsthread: http://forum.der-dirigent.de/index.php?act=ST&f=30&t=4605 | + | Wenn Sie mit mir Kontakt aufnehmen wollen, knnen Sie mich [http://forum.der-dirigent.de/index.php?act=Msg&CODE=4&MID=989 per PM] oder [mailto:koerner-familie@t-online.de per Mail] benachrichtigen oder mir ein Feedback geben. Fr Bugs und allgemeinere Fragen posten Sie bitte im Diskussionsthread: http://forum.der-dirigent.de/index.php?act=ST&f=30&t=4605 |
| =Download & Installation= | =Download & Installation= | ||
| Downloaden kann man die aktuelle Version ('''v0.4dev''') der bbCode-Erweiterung hier: http://forum.der-dirigent.de/index.php?act=Attach&type=post&id=40062 | Downloaden kann man die aktuelle Version ('''v0.4dev''') der bbCode-Erweiterung hier: http://forum.der-dirigent.de/index.php?act=Attach&type=post&id=40062 | ||
| - | Um die Erweiterung zu Installieren, entpacken sie einfach das komplette Archiv kopieren sie den Ordner ''backend'' per FTP in den Ordner der DeDi-Installation. Vorhandenen Dateien mssen berschrieben werden. | + | Um die Erweiterung zu installieren, entpacken Sie einfach das komplette Archiv und kopieren Sie den Ordner ''backend'' per FTP in den Ordner der DeDi-Installation. Vorhandene Dateien mssen berschrieben werden. |
| =Anwendung & Konfiguration= | =Anwendung & Konfiguration= | ||
| - | Die bbCode-Erweiterung ist ein Core-Hack - Sie erweitert die Funktionen des [[Referenz_DeDi-Tags#a_.3Cdedi:mod_type.3D.22textarea.22.2F.3E|textarea-dedi:mod-Tags]] um die Mglichkeit, mittels bbCode formatiert zu werden. Angewendet kann diese Technik daher in jedem Modul, dass eine Textarea einsetzt. | + | Die bbCode-Erweiterung ist ein Core-Hack - Sie erweitert die Funktionen des [[Referenz_DeDi-Tags#a_.3Cdedi:mod_type.3D.22textarea.22.2F.3E|textarea-dedi:mod-Tags]] um die Mglichkeit, mittels bbCode formatiert zu werden. Angewendet werden kann diese Technik daher in jedem Modul, das eine Textarea einsetzt. |
| Um eine Textarea mit bbCode-Funktionalitt auszustatten, muss im dedi:mod-Tag der Parameter ''transform'' auf ''bbcode'' gesetzt sein. Dies ist eine funktionsfhige bbCode-Textarea: | Um eine Textarea mit bbCode-Funktionalitt auszustatten, muss im dedi:mod-Tag der Parameter ''transform'' auf ''bbcode'' gesetzt sein. Dies ist eine funktionsfhige bbCode-Textarea: | ||
| <dedi:mod | <dedi:mod | ||
| Zeile 16: | Zeile 16: | ||
| transform = "bbcode" | transform = "bbcode" | ||
| /> | /> | ||
| - | Mit dieser Konfiguration verwendet die bbCode-Erweiterung Standardeinstellungen, allerdings lassen sich diese beliebeig verndern. Alle Konfigurationen werden ber Parameter im dedi:mod-Tag festgelegt. Folgende Parameter sind mglich: | + | Mit dieser Konfiguration verwendet die bbCode-Erweiterung Standardeinstellungen. Allerdings lassen sich diese beliebig verndern. Alle Konfigurationen werden ber Parameter im dedi:mod-Tag festgelegt. Folgende Parameter sind mglich: |
| ==nl2br== | ==nl2br== | ||
| Zeile 25: | Zeile 25: | ||
| handleparagraphs = "true|false" - Standard: false | handleparagraphs = "true|false" - Standard: false | ||
| (De-)Aktiviert die Absatzbehandlung. Ist die Absatzbehandlung aktiviert wird [[#a_nl2br|nl2br]] deaktiviert, da sich diese beiden Optionen gegenseitig ausschlieen. Bei aktivierter Absatzbehandlung werden Textteile, welche als eigenstndiger Absatz erkannt werden, automatisch mit <p></p> umschlossen. | (De-)Aktiviert die Absatzbehandlung. Ist die Absatzbehandlung aktiviert wird [[#a_nl2br|nl2br]] deaktiviert, da sich diese beiden Optionen gegenseitig ausschlieen. Bei aktivierter Absatzbehandlung werden Textteile, welche als eigenstndiger Absatz erkannt werden, automatisch mit <p></p> umschlossen. | ||
| - | Zu einem Absatz zusammengefasst werden Zeilen, wenn sie nur einen Zeilenumbruch enthalten. Ist eine Leerzeile zwischen zwei Zeilen, werden diese in getrente Abtze gepackt. | + | Zu einem Absatz zusammengefasst werden Zeilen, wenn sie nur einen Zeilenumbruch enthalten. Ist eine Leerzeile zwischen zwei Zeilen, werden diese in getrennte Abtze gepackt. |
| Dies ist ein Absatz | Dies ist ein Absatz | ||
| - | der immernoch wetergeht | + | der immer noch weiter geht |
| Hier beginnt dann ein neuer | Hier beginnt dann ein neuer | ||
| Dies wrde zu folgendem HTML-Code: | Dies wrde zu folgendem HTML-Code: | ||
| <p>Dies ist ein Absatz | <p>Dies ist ein Absatz | ||
| - | der immernoch wetergeht</p> | + | der immer noch weiter geht</p> |
| <p>Hier beginnt dann ein neuer</p> | <p>Hier beginnt dann ein neuer</p> | ||
| Zeile 38: | Zeile 38: | ||
| htmltags = "convert|allow|strip" - Standard: convert | htmltags = "convert|allow|strip" - Standard: convert | ||
| Gibt an, wie mit HTML-Tags verfahren werden soll, die innerhalb der Textarea eingegeben wurden. | Gibt an, wie mit HTML-Tags verfahren werden soll, die innerhalb der Textarea eingegeben wurden. | ||
| - | * ''convert'': HTML-und PHP-Tags werden in Darstellbaren HTML-Code umgewandelt. Nheres dazu unter [http://de2.php.net/manual/de/function.htmlspecialchars.php PHP-Manual: htmlspecialchars()]. | + | * ''convert'': HTML-und PHP-Tags werden in darstellbaren HTML-Code umgewandelt. Nheres dazu unter [http://de2.php.net/manual/de/function.htmlspecialchars.php PHP-Manual: htmlspecialchars()]. |
| * ''stript'': HTML- und PHP-Tags werden, wenn mglich, aus dem eingegebenen Code entfernt. Mehr Informationen unter [http://de2.php.net/manual/de/function.strip-tags.php PHP-Manual: strip_tags()]. | * ''stript'': HTML- und PHP-Tags werden, wenn mglich, aus dem eingegebenen Code entfernt. Mehr Informationen unter [http://de2.php.net/manual/de/function.strip-tags.php PHP-Manual: strip_tags()]. | ||
| - | * ''allow'': HTML-Tags werden erlaubt, sodass sie den Text sowohl mit HTML-Tags als auch mit bbCode gestallten knnen. PHP-Code jedoch wird weiterhin umgewandelt. Die Ausfhrung von PHP-Code ist nur innerhalb von [[#a_source|[source]]] mglich. | + | * ''allow'': HTML-Tags werden erlaubt, sodass Sie den Text sowohl mit HTML-Tags als auch mit bbCode gestallten knnen. PHP-Code wird jedoch weiterhin umgewandelt. Die Ausfhrung von PHP-Code ist nur innerhalb von [[#a_source|[source]]] mglich. |
| ==features== | ==features== | ||
| Zeile 47: | Zeile 47: | ||
| anchor, ilink, link, filelink, list, code, hr, | anchor, ilink, link, filelink, list, code, hr, | ||
| striptags, charmap, help" | striptags, charmap, help" | ||
| - | Mit diesem Parameter steuern sie, welche Funktionen erlaubt und welche Verboten sind. Sie knnen den Parameter weglassen oder ''true'' als Wert angeben, um alle Features zu aktivieren. Wenn sie nur bestimmte Features aktivieren wollen, knnen sie dieses kommasepariert angeben. Dabei sind folgende Besonderheiten zu beachten: | + | Mit diesem Parameter steuern Sie, welche Funktionen erlaubt und welche verboten sind. Sie knnen den Parameter weglassen oder ''true'' als Wert angeben, um alle Features zu aktivieren. Wenn Sie nur bestimmte Features aktivieren wollen, knnen Sie dieses kommasepariert angeben. Dabei sind folgende Besonderheiten zu beachten: |
| *Wird link angegeben, ist automatisch auch ilink aktivert, da man ohne Schwierigkeiten auch als ber externen Link auf interne Seiten verweisen knnte. | *Wird link angegeben, ist automatisch auch ilink aktivert, da man ohne Schwierigkeiten auch als ber externen Link auf interne Seiten verweisen knnte. | ||
| - | *Damit anchor verwendet werden kann, muss link oder ilink angegeben sein. Wenn sie nur auf Anker verlinken wollen ohne eigene erstellen zu wollen, knnen sie ainfach ''#ankername'' als Linkziel angeben. | + | *Damit anchor verwendet werden kann, muss link oder ilink angegeben sein. Wenn Sie nur auf Anker verlinken wollen ohne eigene erstellen zu wollen, knnen Sie einfach ''#ankername'' als Linkziel angeben. |
| - | Nhre Informationen zu den einzelnen Funktionen finden sie unter [[#a_Dokumentation_der_Codes|Dokumentation der Codes]] und [[#a_Weitere_Funktionen|Weitere Funktionen]]. Die Liste kann auch ber Mehrere Zeilen verteilt sein. | + | Nhere Informationen zu den einzelnen Funktionen finden Sie unter [[#a_Dokumentation_der_Codes|Dokumentation der Codes]] und [[#a_Weitere_Funktionen|Weitere Funktionen]]. Die Liste kann auch ber mehrere Zeilen verteilt sein. |
| ==notarget== | ==notarget== | ||
| notarget = "false|true" | notarget = "false|true" | ||
| - | Gibt an, dass im Link-Dialog das Target-Feld ausgeblendet werden soll. Auerdem wird in der Frontendausgabe die Ausgabe des target-Attrbutes unterdrckt. | + | Gibt an, dass im Link-Dialog das Target-Feld ausgeblendet werden soll. Auerdem wird in der Frontendausgabe die Ausgabe des target-Attributes unterdrckt. |
| ==notext== | ==notext== | ||
| notext = "true|false" | notext = "true|false" | ||
| - | Gibt an, dass in den Formularen zu [[#a_.5Bemail.5D|[email]]], [[#a_.5Banchor.5D|[anchor]]], [[#a_.5Blink.5D|[link]]] und [[#a_.5Bfilelink.5D|[filelink]]] eine Checkbox 'Kein Text' angezeigt wird, die die bbCode-Erweiterung dazu veranlasst, die bbCode-Tags in der Form <nowiki>[link]http://www.google.de[/link]</nowiki> einzufgen, welche den code sauberer hlt, jedoch keinen Linktext ermglicht. Diese form ist identisch zu [link=http://www.google.de][/link]. Dieser Schalter hat nur Auswirkung auf die (nicht-)anzeige der Checkbox, die Tags werden trotzdem interpretiert. | + | Gibt an, dass in den Formularen zu [[#a_.5Bemail.5D|[email]]], [[#a_.5Banchor.5D|[anchor]]], [[#a_.5Blink.5D|[link]]] und [[#a_.5Bfilelink.5D|[filelink]]] eine Checkbox 'Kein Text' angezeigt wird, welche die bbCode-Erweiterung dazu veranlasst, die bbCode-Tags in der Form <nowiki>[link]http://www.google.de[/link]</nowiki> einzufgen, welche den Code sauberer hlt, jedoch keinen Linktext ermglicht. Diese Form ist identisch zu [link=http://www.google.de][/link]. Dieser Schalter hat nur Auswirkung auf die (nicht-)Anzeige der Checkbox. Die Tags werden trotzdem interpretiert. |
| ==filelinktpl== | ==filelinktpl== | ||
