Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Blöcke

Mit dem Gestaltungswerkzeug “Blöcke” kann man wiederverwendbare Inhalte erstellen. Sie können in einem Webseiten-Layout und dem Layout einer Ansicht mittels des PDL-Editor verwendet werden.

Blöcke können Inhalte verschiedener Inhaltstypen enthalten:

  1. BBcode
  2. HTML
  3. Markdown
  4. Text (Plaintext)
  5. Comanche-Layout
  6. PHP

Die üblichen und sinnvollen Inhaltstypen sind BBcode, HTML und Markdown.

BBcode ist für eine einfache Gestaltung von Blöcken sehr gut geeignet. Außerdem hat er den Vorteil, dass er in Hubzilla einige hubzilla-spezifische Tags nutzbar macht, die z.B. den derzeit genutzten Hub referenzieren oder auf Inhalte verweisen kann, die mittels Open Web Auth und Magic Auth auch zugriffsbeschränkte Inhalte zugänglich gemacht werden können.

Markdown bietet ähnliche Vorteile, ist aber in der Gestaltungsmöglichkeit beschränkter. Das Format bietet sich insbesondere für Textdokumente an.

Mit HTML hat man den größten Gestaltungsspielraum. Damit ist in einem Block nahezu alles möglich, was mit HTML generell machbar ist. Man kann Frameworks einsetzen (insbesondere Bootstrap, welches ohnehin in Hubzilla schon zur Verfügung steht), eigene Stylesheets inline oder mittels separater Dateien verwenden, PHP-Code inline nutzen, ebenso Javascript (selbstverständlich können auch JS-Bibliotheken genutzt werden).

Plaintext mag für spezielle Anwendungsfälle auch eine Berechtigung haben, beschränkt sich aber auf reine Textdarstellungen ohne Gestaltungsmöglichkeiten.

Commanche-Layout ist in Blöcken eher von theoretischer Natur und auf wirklich sehr spezielle Anwendungsfälle beschränkt.

Schließlich lässt sich auch PHP-Code zur Seitenerstellung nutzen. Hier sind der Fantasie kaum Grenzen gesetzt. In Verbindung mit einer Datenbank sind auch komplexe Webanwendungen möglich, ohne als Administrator zusätzliche Module für Hubzilla erstellen zu müssen.

Klicken Sie auf den Button “Erstelle”, öffnet sich der Block-Editor Dialog.

Block-Editor

Im Auswahlfeld “Art des Seiteninhalts” kann nun der Inhaltstyp ausgewählt werden.

Auswahl des Inhaltstyps

Ein Block kann optional mit einem Titel versehen werden. Dieser Titel erscheint als Überschrift im Header des dargestellten Blocks.

Ebenfalls optional und nur bei artikel-artigen Blöcken sinnvoll ist die Zusammenfassung (“Summary”) des Inhalts. Bei der ersten Darstellung des Blocks wird diese Zusammenfassung angezeigt. Darunter befindet sich der anklickbare Text “Artikel ansehen”. Klicken Sie darauf, wird der Block-Inhalt angezeigt. Über dem Inhalt erscheint der anklickbare Text “Zusammenfassung ansehen”, was zum erneuten Einklappen des Inhalts dient.

Unter dem SUmmary-Feld befindet sich das Eingabefeld für den Block-Namen. Hier ist es sinnvoll, einen passenden kurzen Namen zu vergeben. Lässt man das Feld leer, erzeugt Hubzilla einen Hash-Wert, der als Block-Name fungiert. Der Name lässt sich aber, falls man die Eingabe vergessen hat, nachträglich noch ändern, wenn man den Block editiert.

Schließlich gibt es ein Editor-Feld, in welches Sie den Inhalt des Blocks eingeben können.

Hier nun ein Beispiel-Block, der eine Karte des Kanalinhabers anzeigt.

Erstellter Beispiel-Block

Hat man die notwendigen Informationen eingegeben, kann man sich eine Vorschau des Blocks anzeigen lassen. Dafür klickt man auf das Augen-Symbol neben dem Button “Absenden”.

Vorschau des Beispiel-Blocks

Ist man mit dem Ergebnis zufrieden, klickt man auf den Button “Absenden”. Der Block wird erstellt und erscheint nun in der Liste der Blöcke.

Liste der Blöcke

Der Block kann hier durch Klick auf das Bleistift-Symbol bearbeitet werden. Danebn befindet sich ein “Download-Symbol”, welches hier aber nicht dem Download dient, sondern den Block im eigenen Kanal teilt, wodurch er föderiert, also an die Verbindungen verteilt wird. Das Mülleiner-Symbol dient dem Löschen des Blocks.

Klickt man auf den Block-Namen, wird der Block angezeigt.

Ansicht des Beispiel-Blocks

Um den Beispiel-Block nun irgendwie sinnvoll zu verwenden, können wir ihn – ebenfalls als Beispielanwendung – mit dem PDL-Editor in die Seitenleiste der Kanal-Ansicht einfügen.

Block in die Seitenleiste einfügen