Beschreibung

Das Modul mpDynamicContent erlaubt das Einbinden von beliebigen Content-Typen (z. B. CMS_HTMLHEAD, CMS_HTML, CMS_IMGEDITOR, usw.) in einen Container.

Damit lassen sich dynamisch mehrere Inhalte basierend auf Content-Typen in einem Layout ausgeben. Die Konfiguration kann direkt über die Editor-Ansicht des Artikels vorgenommen werden.

Standardmäßig werden alle vorhandenen Content-Typen unterstützt, Ausnahmen gibt es für CMS_IMG, CMS_IMGDESCR, CMS_LINK, CMS_LINKTARGET, CMS_LINKDESCR. Dafür gibt es die neuen Content-Typen CMS_IMGEDITOR und CMS_LINKEDITOR, die die bekannte Funktionalität übernehmen.

Es ist auch möglich, zu jedem Content-Typ ein Template auszuwählen.

Installation:

Die im Modulpackage enthaltenen Dateien/Sourcen sind wie im Folgenden beschrieben zu installieren. Die Pfade zu den Sourcen (CSS, JS und Templates) können von Projekt zu Projekt unterschiedlich sein und sind bei Bedarf anzupassen.
Bei der Installationsbeschreibung wird davon ausgegangen, dass CONTENIDO in das DocumentRoot-Verzeichnis eines Webservers installiert wurde und das Mandantenverzeichnis "cms/" ist.

1.) Modulinstallation:
Den Modulordner "mp_dynamic_content" samt aller Inhalte in das Modulverzeichnis des Mandanten "cms/data/modules" kopieren.
Danach sollte man im Backend die Funktion "Module synchronisieren" unter "Style -> Module" ausführen.

2.) Einrichten des Moduls:
Dieses Modul in einer Artikelvorlage einrichten.
Einen Artikel erstellen, welches auf die Vorlage basiert.
In der Artikelkonfiguration die gewünschten Optionen setzen.

a.) Mandanten- oder Systemeinstellungen:
Mit folgender Mandanten- oder Systemeinstellung kann man die unterstützten Content-Typen konfigurieren. Mehrere Werte sind mit Komma zu trennen:

Typ:  mp_dynamic_content
Name: supported_content_types
Wert: CMS_HEAD,CMS_HTML,CMS_HTMLHEAD,CMS_IMGEDITOR,CMS_LINKEDITOR


Ist die Einstellung nicht gesetzt, so wird dafür per default folgender Wert verwendet:

CMS_HEAD,CMS_HTML,CMS_HTMLHEAD,CMS_IMGEDITOR,CMS_LINKEDITOR

b.) Basiseinstellungen (im Popup Dialog):

  • Container-Nummer: Die Container-Nummer die zum Erstellen der Inhalte verwendet werden soll. Die eingegebene Nummer sollte nicht im Layout vergeben sein und es sollte ausreichend Puffer zur nächsten im Layout verwendeten Container-Nummer sein, da das Modul die angegebene Container-Nummer für jeden konfigurierten Content-Typen hochzählt, z. B. Container-Nummer = 500, 5 Content-Typen, benötigter Container-Nummer Bereich = 500 - 505.

c.) Content-Typ Einstellungen (im Popup Dialog):
Jeder Content-Typ Eintrag enthält 4 konfigurierbare Felder.

  • Beschreibung: Angabe der Beschreibung zum Content-Typ, wenn angegeben wird es im Backend in der Editor-Ansicht als label-Element dargestellt
  • Content-Typ: Auswahl des zu verwendenden Content-Typen
  • Template: Auswahl des Templates, in dem der Inhalt des Content-Typ gerendert werden soll. Mitgeliefert werden 5 verschiedene Templates. Damit ein Content-Typ Template erkannt und korrekt im Auswahlfeld erscheint, muss es folgende Kriterien erfüllen.
    • Das Template muss im Modulverzeichnis im Ordner template liegen
    • Der Dateiname des Templates muss mit dem Präfix "type." beginnen
    • Die Erste Zeile des Templates sollte eine das Template beschreibende kurze Kommentarzeile sein
  • Zusätzlicher Text: Dieses benutzerdefiniertes Feld kann für den eigenen Bedarf verwendet werden, z. B. für Ausgabe als reiner Text oder auch als Wert für ein class-Attribut. Im Template hat man Zugriff auf den Wert mit "$content.userdefined".
  • Aktionen:
    • Online Status: Content-Typ lassen sich online/offline stellen, dabei werde die Elemente mit dem Status offline bei der Ausgabe ausgelassen. Diese Inhalte können aber immer noch über die Suche im Frontend gefunden werden.

Changelog:

  • 2019-11-12 mpDynamicContent 0.1.3 (für CONTENIDO 4.9.x - 4.10.x)
    • bugfix: Mehrfachen Aufruf des Con.Loader callbacks unterbinden
    • change: Verwendung von unterstützten default Content-Typen, wenn Einstellung nicht gesetzt
  • 2013-12-05 mpDynamicContent 0.1.2 (für CONTENIDO 4.9.x. Nachtrag: Die Version 0.1.2 funktioniert auch unter CONTENIDO 4.10.x)
    • bugfix: Besseres Handling für das Laden von jQuery UI im Backend
    • bugfix: Anzeige des ausgewählten Bildes im Backend in der Editor-Ansicht
    • change: Laden und Ausgabe der benötigten Styles nur einmal pro Seite
    • new: Sortierung für Templates
  • 2013-12-02 mpDynamicContent 0.1 (für CONTENIDO 4.9.x)
    • Erste Veröffentlichung des mpDynamicContent Moduls

mpDynamicContent Modul Links