.crashsource

Was bewirkt das Plugin "RenHTMLTags"?

Das Wordpress-Plugin "RenHTMLTags" ist in der Lage vom Benutzer angegebene HTML-Tags durch andere Tags zu ersetzen. Manchmal ist es aus Layout-technischen Gruenden notwendig einen vom W3C spezifizierten Tag zu ersetzen und einen oder mehere andere dafuer zu benutzen. Konkrete Beispiele dazu gibt es bei den Beispielen.

Doch um diesen Effekt zu erreichen, muesste man eigentlich die gesamte Datenbank umschreiben und die Aenderungen an allen bisherigen Beitraegen direkt in der Datenbank durchfuehren. Da das sehr aufwendig und eigentlich auch nicht besonders empfehlenswert ist, habe ich das Plugin "RenHTMLTags" geschrieben. Dieses Plugin sucht nach vom Benutzer angegebenen regulaeren
Ausdruecken innerhalb eines jeden Blogeintrags und schaltet sich zwischen die Datenbankabfrage und die Darstellung auf dem Bildschirm. Damit ist es moeglich die Datenbankeintraege der Beitraege, so wie sie sind bestehen zu lassen, und man muss nicht jeden Beitrag in der Datenbank muehsam ersetzen. Dies hat den Vorteil, dass nach dem Deaktivieren des jeweiligen regulaeren Ausdrucks im Plugin oder des gesamten Plugins wieder alle Daten so wie sie in der Datenbank stehen ausgelesen werden. Das Umschreiben von HTML-Tags ist damit einfach und ohne Probleme wieder umkehrbar.

Fuer jeden Eintrag kann gesondert entschieden werden ob dieser nur die Darstellung der Beitraege im Blog manipulieren soll, oder ob die jeweilige Regel auch auf Kommentare angewendet werden soll. Diese Angaben koennen auch nach dem Erstellen der Regel einfach und komfortabel editiert werden. Mehr dazu unten.

Download

Der Download erfolgt ohne Gewaehr. Rechtliches siehe unten.
Download RenHTMLTags Version 1.0

Installation

Die Installation gestaltet sich auch erwartet einfach. Um das Plugin zu installieren muss die Datei nur entpackt und in den Pluginordner kopiert werden. Danach muss das Plugin noch im Backend unter dem Menupunkt "Plugins" aktiviert werden. Fertig - so einfach geht das!

Die Bedienung des Plugins

Standardmaessig werden vom Plugin keine Ersetzungen von HTML-Tags vorgenommen. Jeder HTML-Tag muss also individuell eingetragen werden. Die Einstellungen des Plugins findet man unter Einstellungen -> RenHTMLTags.

Um eine neue Ersetzung einzutragen traegt man die jeweilige regulaere Expression und den Ersetzungsteil unter "Neuen Eintrag hinzufügen" ein. Dabei gibt es folgendes zu beachten: Der regulaere Ausdruck muss Begrenzungszeichen enthalten (beispielsweise: #) und kann optional auch noch Modifikatoren enthalten. Weiterhin ist die Syntax die selbe, wie sie von PHP verwendet wird. Weiterhin gilt es festzulegen in welchen Bereichen die Regel greifen soll. Soll die Ausgabe von Beitraegen und Kommentaren manipuliert werden, oder nur eine der beiden Moeglichkeiten? Es ist deine Entscheidung!

Jeder Eintrag kann individuell bearbeitet werden. Dazu einfach unter "Aktive RenHTMLTags" den jeweiligen regulaeren Ausdruck und/oder die jeweilige Ersetzung bearbeiten und in der selben Zeile auf den Button "Ändern" in der Spalte "Optionen" klicken. Dann wird der Wert automatisch in der Datenbank aktualisiert. Nach dem gleichen Schema kann auch jeder Eintrag geloescht werden. Dazu reicht es aus in der jeweiligen Zeile in der Spalte "Optionen" auf "Löschen" zu klicken. Den Rest uebernimmt das Plugin.
Achtung: Geloeschte Eintraege koennen nicht wiederhergestellt werden!

Beispiele

Ersetzen des blockquote-Tags

Um den blockquote-Tag zu ersetzen bedarf es folgender regulaerer Expression:

Dabei ist "#" das von PHP benoetigte Trennzeichen und "i", "s" sowie "U" Modifikatoren, die die Suche beeinflussen.

Ersetzen wollen wir den blockquote-Tag mit einem Produkt aus mehreren div-Containern, die uns erlauben ein Header-, ein Middle- und ein Footerbild einzubinden. Dazu legen wir uns folgenden Teil fuer die Ersetzung zurecht:

Dabei wuerden wir in unserem Template natuerlich per CSS die Klassen "quote", "quote-header", "quote-middle" und "quote-footer" definieren und entsprechend mit Hintergrundbildern versehen. $1 steht uebrigens fuer den Inhalt der ersten Klammer aus dem regulaeren Ausdruck von oben.

Das Ergebnis ist nun ein ineinander geschachteltes Div-Container-Konstrukt, welches uns erlaubt individuelle Hintergrundbilder fuer den Header, den Mittelteil sowie den Footer zu vergeben.

Lizenz

Der Quellcode steht unter der Dual-Lizenz CC-by. Ich toleriere damit jegliche Veraenderungen meines Programms unter der Bedingung dass dabei mein Name genannt wird.

Featureliste in Version 1.0

• Einfache Bedienung des Plugins
• Regeln koennen einzeln ersetzt/geloescht werden
• Jede Regel kann einzeln fuer Beitraege und Kommentare gesetzt werden
• Die Manipulation der Ausgabe kann global unterbunden werden
• Prioritaetsstufen fuer die Manipulation von jeweils Beitraegen und Kommentaren koennen global gesetzt werden
• Das Deaktivieren des Plugins hinterlaesst keine Rueckstaende in der Datenbank (falls gewuenscht)

Rechtliches

Der Autor uebernimmt keinerlei Gewaehr für die Aktualitaet, Korrektheit, Vollstaendigkeit oder Qualitaet der bereitgestellten Informationen. Haftungsansprueche gegen den Autor, welche sich auf Schaeden materieller oder ideeller Art beziehen, die durch die Nutzung oder Nichtnutzung der dargebotenen Informationen bzw. durch die Nutzung fehlerhafter und unvollstaendiger Informationen verursacht wurden, sind grundsaetzlich ausgeschlossen, sofern seitens des Autors kein nachweislich vorsaetzliches oder grob fahrlaessiges Verschulden vorliegt.
Alle Angebote sind freibleibend und unverbindlich. Der Autor behaelt es sich ausdruecklich vor, Teile der Seiten oder das gesamte Angebot ohne gesonderte Ankuendigung zu veraendern, zu ergaenzen, zu loeschen oder die Veroeffentlichung zeitweise oder endgueltig einzustellen.