PORTAL und PPS Knowledge Base

Ablage des BBCode-Textes in der Datenbank

Owned by
Franziska Franz
, created
Last updated: 2024-02-09 by
Kathrin Janka
6 min read

Beim Speichern eines Inhalts und der damit verbundenen Übertragung in die Datenbank werden die eingegebenen BBCodes teilweise in HTML konvertiert, bevor der Text in der Datenbank abgelegt wird.

Diese Dokumentation beschreibt, welche BBCodes wie konvertiert und dann ausgegeben werden. Sie dient damit als Implementierungshilfe für interne und ggf. externe Entwickler.

Übersicht über die Ablage des BBCode-Textes in der Datenbank

  • Auflistung der Konvertierungen von

    • unterstützten Textformatierungen

    • Social-Media-, Karten- und Video-Embeds

    • Einbettungen von internen Inhalten

    • Markierung der Lesebeschränkung bei Premium-Inhalten

Inhaltsverzeichnis

Allgemeine Beschreibung

Beim Speichern eines Inhalts wird dessen Text konvertiert und in der Datenbank abgelegt. Die vom Editor unterstützten Textformatierungen (z. B. Zwischenüberschrift, Fett, Kursiv, etc.) werden in HTML-Tags konvertiert.

Bei Einbettungen (Embeds) von internen Elementen (z. B. eingebettete Aktionen, eingebettete Code) sowie bei Einbettungen von externen Diensten (z. B. https://peiq.atlassian.net/wiki/spaces/PUPKB/pages/216662017) wird entweder

  1. der eingegebene BBCode als Platzhalter beibehalten

  2. oder ein HTML-Platzhalter ( <div> )generiert.

Beim Aufruf der PORTAL-Seite werden die BBCode- bzw. die HTML-Platzhalter (<div> ) der eingebetteten Elemente über verschiedene Workflows durch den tatsächlichen HTML-Embed-Code ersetzt.

Bei den verschiedenen Export-Formaten wird im Feld des Inhalttextes der Text so ausgegeben, wie er in der Datenbank abgelegt wird. Das führt dazu, dass bei verschiedenen Export-Workflows eine Mischung aus HTML-Tags, HTML-Platzhaltern ( <div> ) und BBCode-Platzhalter ausgegeben wird.

Beispielsweise:

Konvertierung von über den Editor eingegebene Texte

Im Folgenden wird aufgelistet, welche BBCodes wie konvertiert und in der Datenbank abgelegt werden.

Unterstützte Textformatierungen

Die folgenden BBCodeS werden beim Speichervorgang zu HTML-Tags konvertiert:

BBCode-Tag

Beschreibung

Ablage in der Datenbank

BBCode-Tag

Beschreibung

Ablage in der Datenbank

[h2]

Zwischenüberschrift

<h2> -Tag (HTML)

[b]

Fett

<b> -Tag (HTML)

[i]

Kursiv

<i> -Tag (HTML)

[u]

Unterstrichen

<u> -Tag (HTML)

[sup]

Hochgestellt

<sup> -Tag (HTML)

[sub]

Tiefgestellt

<sub> -Tag (HTML)

[list][*]

Ungeordnete Liste

Beispiel: [list][*]Eins[/*][*]Zwei[/*][*]Drei[/*][/list]

<ul><li> -Tag (HTML)

<ul><li>Eins</li><li>Zwei</li><li>Drei</li></ul>

[list=1][*]

Geordnete Liste

Beispiel: [list=1][*]Eins[/*][*]Zwei[/*][*]Drei[/*][/list]

<ol><li> -Tag (HTML)

[quote]

Zitat

<quote> -Tag (HTML)

[url]

Hyperlink

<a> -Tag (HTML)

[urlnt]

Hyperlink, der in einem neuen Fenster öffnet.

<a> -Tag (HTML)

Social-Media-, Karten- und Video-Embeds

Einbettungen von externen Plattformen werden als BBCode abgespeichert. Der BBCode wird erst beim Ausspielen durch ein entsprechendes <div> ersetzt. Details siehe:

BBCode-Tag

Beschreibung

Ablage in der Datenbank

BBCode-Tag

Beschreibung

Ablage in der Datenbank

[video]

Einbettung von Videos. Unterstützt werden Youtube, Vimeo und APA. Innerhalb der Tags muss die URL des Videos stehen.

[map]

Einbettung von iFrame-Karten. Unterstützt werden Google Maps, Google My Maps und OpenStreetMap. Innerhalb der Tags muss die iFrame-src-URL der Karte stehen.

[twitter]

Einbindung eines Twitter-Posts.

[instagram]

Einbindung eines Instagram-Posts.

[facebook]

Einbindung eines Facebook-Posts.

[tumblr]

Einbindung eines Tumblr-Posts.

Einbettungen von internen Inhalten

Ein Teil der Einbettungen von internen Inhalten werden als Platzhalter-<div> abgespeichert. Der Platzhalter wird erst beim Ausspielen durch den entsprechenden Embed-Code ersetzt. Ein anderer Teil der BBCodes werden auch als BBCode abgespeichert. Auch in diesem Fall wird der BBCode-Platzhalter beim Ausspielen durch ein entsprechendes <div> ersetzt.

BBCode-Tag

Beschreibung

Ablage in der Datenbank

BBCode-Tag

Beschreibung

Ablage in der Datenbank

[eimg]

Ein am Beitrag hochgeladenes Bild, welches im Text des Beitrags eingebettet wurde.

[earticle]

Eingebetteter Teaser auf einen Beitrag.

 

[eimagepost]

Eingebetteter Teaser auf einen Schnappschuss.

[eeventitem]

Eingebetteter Teaser auf eine Veranstaltung.

[paevent]

Eingebettete Aktion. Weitere Informationen zu Aktionen finden sich hier.

 

[embedcode]

Code, der über die Code-Einbetten-Funktion im Text eingefügt wurde. Weitere Informationen zur Funktion finden sich hier.

Markierung der Lesebeschränkung bei Premium-Inhalten

Die Markierung der Lesebeschränkung bei Premium-Inhalten wird als HTML-Tag ausgegeben

BBCode-Tag

Beschreibung

Ablage in der Datenbank

BBCode-Tag

Beschreibung

Ablage in der Datenbank

[pcrm]

Markierung der Lesebeschränkung bei Premium-Inhalten. Weitere Informationen zur Lesebeschreänkung finden sich hier.

Beispiel für einen konvertierten Text:

Anzeige im BBCode-Editor

 

Konvertierter Text in der Datenbank

 

Importe

Das Verhalten für Importe ist hier beschrieben:

Textauszeichnungen müssen als HTML-Tag übergeben werden, für Einbettungen muss BBCode verwendet werden.

Verwandte Seiten

 

Impressum