Benutzer-Werkzeuge

Webseiten-Werkzeuge


cookbook:droplets

Dies ist eine alte Version des Dokuments!


Droplets

Die Idee der Droplets stammt noch aus Website Baker. Hiermit wurde eine flexible Möglichkeit geschaffen, kleine Codeschnipsel an beliebigen Stellen unterzubringen - etwa Datum und Uhrzeit der letzten Änderung einer Seite irgendwo im Template, oder ein kleiner Kalender mitten im Fließtext (WYSIWYG-Modul) einer Seite.

Wo ist der Haken dabei?

Dieser Text wurde aus der Dokumentation des Moduls DropletsExtension übernommen:

Die Platzhalter für die Droplets werden unmittelbar vor der Anzeige einer Webseite herausgefiltert, der Code des Droplets ausgeführt und das Ergebnis des Mini-Programms an Stelle des Platzhalters auf der Seite eingefügt und die fertige Webseite danach im Browser angezeigt:

  • Nichts von dem, was ein Droplet berechnet, bei einer Datenbank abfragt und anzeigt wird von der WebsiteBaker oder LEPTON CMS Suchfunktion berücksichtigt - Droplets werden vollständig und sehr konsequent ignoriert.
  • Droplets haben keinen Einfluss auf den Seitentitel sowie auf die im Dateiheader enthaltene Kurzbeschreibung (description) und die aufgelisteten Schlüsselwörter (keywords), selbst dann nicht, wenn Sie den Inhalt einer Seite vollständig bestimmen.
  • Droplets können im Unterschied zu Seitenmodulen Cascading Stylesheets (CSS) nicht automatisch laden, der verantwortliche Webmaster muss den erforderlichen CSS Code von Hand im Stylesheet der Website einbinden.

Diese Einschränkungen gelten für BlackCat CMS nicht, denn wir haben die Grundlagen der DropletsExtension in den Core übernommen. Es ist also nicht notwendig, das Modul DropletsExtension in BlackCat CMS zu installieren!

Grundlagen

BlackCat CMS bringt alle erforderlichen Funktionen im Droplet-Helper bereits mit. Da dieser auf dem DropletsExtension-Modul basiert, gelten viele der dortigen Grundlagen auch für unseren Helper.

Soll ein Droplet in der Lage sein, Seitentitel und -beschreibung zu verändern, muß eine Datei droplet.extension.php existieren. Diese definiert eine Funktion <module_directory>_droplet_header($page_id), wobei <module_directory> durch den Verzeichnisnamen des Moduls ersetzt wird, in dem die Datei droplet.extension.php residiert. Diese Funktion liefert ein assoziatives Array mit folgenden Informationen zurück:

$result = array(
  'title'       => $title,       // Seitentitel
  'description' => $description, // Kurzbeschreibung
  'keywords'    => $keywords     // Schluesselwoerter
);

cookbook/droplets.1411381260.txt.gz · Zuletzt geändert: 2014/09/22 00:00 (Externe Bearbeitung)