Beispielprojekt

Auf dieser Seite können Sie ein Beispielprojekt herunterladen, das u.a. folgende Themen illustriert:

• Beispielhafte Konfigurationen und Kombinationen von Tags und Parametern für die unterschiedlichen DATASOURCE-Typen
• Anwendungsfälle zur Verwendung von FS_LIST, z. B. Erstellen und Verwalten von
  • Medien-Galerien (mit Bildern, Bildbeschreibungen und Kategorisierungen),
  • einfachen Produktdatenbanken (mit Produktname, Bild, Beschreibung und Kategorisierung)
  • komplexen Produktdatenbanken (mit Mehrfachkategorisierung)
• Migration von CMS_INPUT-Eingabekomponenten zu FS_LIST
• Einfache Ausgabemöglichkeiten

Im Unterschied zu dem mit FirstSpirit standardmäßig ausgelieferten Demoprojekt "Mithras Energy" stellt dieses Beispielprojekt die Funktionalität von FS_LIST und arrondierenden FirstSpirit-Features in den Mittelpunkt. Dabei wurde auch versucht, die in den Anwendungsfällen verwendeten Datenbank-Schemata und Vorlagen möglichst einfach zu halten, um die Zusammenhänge der Funktionen besser hervorheben zu können. Die HTML-Ausgabe des Projekts ist hingegen bewusst einfach gehalten.

Dieses Beispielprojekt befindet sich aktuell in der Entwicklung und kann sich jederzeit ändern. Es erhebt keinen Anspruch auf Vollständigkeit. Es kann nach eigenen Erfordernissen individuell geändert und erweitert werden.

Das Beispielprojekt können Sie hier herunterladen:
Beispielprojekt (Version 5.1.1)

Für die Verwendung von FS_LIST im DATASOURCE-Typ SERVICE (Absatzvorlage FormDataProviderExample im Ordner Formularkonfigurationen / type="SERVICE") muss darüber hinaus das Modul "FirstSpirit FormDataProvider Example" auf dem FirstSpirit-Server installiert sein (Dateiname "fs-example_listprovider.fsm"). Dieses können Sie hier herunterladen:
Modul "FirstSpirit FormDataProvider Example" (Version 5.1.407)

Gliederung und Beschreibung des Beispielprojekts

Das Beispielprojekt ist in allen Verwaltungen adäquat und realitätsnah befüllt. Bevorzugt wurden dabei die neuen FS_-Komponenten verwendet. So werden auch vorrangig Verweise vom Typ "genericLink" verwendet. Für eine bessere Vergleichsmöglichkeit sind aber auch die entsprechenden Typen "internalLink", "externalLink" und "contentLink", die ab FirstSpirit Version 5.0 nicht mehr unterstützt werden, hinterlegt.

Das Projekt ist mehrsprachig (Deutsch und Englisch) angelegt. Als Mastersprache wurde bewusst "Englisch" gewählt, um der steigenden Internationalisierung Rechnung zu tragen. Anzeige- und Referenznamen wurden für beide Sprachen durchgehend für alle Elemente vergeben. Die Baumbeschriftung kann also im SiteArchitect über das Menü "Ansicht" / "Bevorzugte Anzeigesprache" auf die gewünschte Darstellung eingestellt werden. Für die Referenznamen wurde ein einheitliches Schema gewählt. An speziellen Punkten wurde zusätzlich mit Nummerierung gearbeitet, um eine konsistente Sortierung vorzugeben.

In dem Projekt ist eine Navigation realisiert. Diese lässt sich für jede Seite über die Radio-Buttons "Nur Inhalt" bzw. "Inhalt und Navigation" in der Inhalte-Verwaltung deaktivieren bzw. aktivieren.

Im Folgenden wird die Struktur des Projekts beschrieben. Dabei wird von den eingesetzten Vorlagen ausgegangen. Ihre Verwendung bzw. ihre Auswirkung in der Inhalte- oder Datenquellen-Verwaltung kann von dort aus einfach über "Verwendungen anzeigen" (Kontextmenü "Extras") oder Strg+U ermittelt werden.

Formularkonfigurationen

FS_LIST bietet umfangreiche Anwendungs- und Konfigurationsmöglichkeiten und ist durch die hohe Anzahl an verwendbaren Tags und Parametern recht komplex. Beispielhafte Konfigurationen und Kombinationen werden im Beispielprojekt, nach DATASOURCE-Typen geordnet, vorgestellt. Die zugehörigen Vorlagen befinden sich bei den Absatzvorlagen (Vorlagenverwaltung), Ordner "Formularkonfigurationen" (Referenzname: "form_definitions"). Zu jedem DATASOURCE-Typ sind Beispiel-Fomulare in Ordnern zusammengestellt.

Der Name der Absatzvorlage weist auf die Art der Konfiguration hin. Er ist nach folgendem Schema gebildet:
Basisbeschreibung (Aspekt) [Parameter]

So weist "CONTENTLIST → FS_LIST (MediaMode)" beispielsweise auf eine Konfiguration von FS_LIST als Ersatz für CMS_INPUT_CONTENTLIST (DATASOURCE-Typ DATABASE) mit dem MEDIAMODE-Tag hin (siehe auch Medien-Galerien). Darüber hinaus sind verschiedene Layout-Varianten realisiert (z. B. CONTENTLIST → FS_LIST (StackedView) [Selection: PopUp] oder CONTENTLIST → FS_LIST (SimpleView) [Alignment: right]).

Medien-Galerie

Im Beispielprojekt ist eine Medien-Galerie realisiert. Die zugrundeliegenden Tabellenvorlagen für die Galerie- und die Medien-Tabelle befinden sich unterhalb des Datenbank-Schemas "Mediengalerien" (Vorlagen-Verwaltung, Knoten "Datenbank-Schemata").

Die Medien-Galerie-Funktion kann auch in der Inhalte-Verwaltung eingesetzt werden. Dazu wird die absatzvorlagen-basierte Variante verwendet: Absatzvorlage "CONTENTLIST → FS_LIST (MediaMode)" in der Vorlagen-Verwaltung, Knoten "Absatzvorlagen", Ordner "Formularkonfigurationen", Ordner "type="DATABASE"".

Der Arbeitsablauf, mit dem Medien-Galerien und die ausgewählten Medien gleichzeitig freigegeben werden können, ist bei den Arbeitsabläufen im Projekt abgelegt und hat den Namen "Medienabhängige Inhaltsfreigabe (Datenquellen-Verwaltung)" (Referenzname "media_dependent_content_release"). Das dazu erforderliche und eingebundene Skript ("Medienabhängige Inhaltsfreigabe (Skript)") befindet sich im Ordner "Arbeitsabläufe" unterhalb des Knotens "Skripte".

Weiterführende Informationen zur Erstellung und Verwendung von Medien-Galerien siehe separates Kapitel.

Produktdatenbank

Die Produktdatenbank stammt ursprünglich aus dem Demoprojekt "Mithras Energy", ist aber auf exemplarische Funktionen, die eine solche Datenbank mindestens benötigt, reduziert. Das zugehörige Datenbank-Schema sowie die Tabellenvorlagen und Abfragen befinden sich unterhalb des Datenbank-Schemas "Produkte" (Vorlagen-Verwaltung, Knoten "Datenbank-Schemata").

Komplexe Produktdatenbank

Unterhalb des Knotens "Attributierte Beziehungen" in den Datenbank-Schemata ist eine komplexe Produktdatenbank realisiert. In einer zentralen Tabelle (Datenquelle "Produkt") können hier Produktdaten gepflegt werden, für die auf Informationen aus jeweils zwei anderen Tabellen, die jeweils über eine 1:N-Fremdschlüsselbeziehung verknüpft sind, zugegriffen werden kann. Auf diese Weise können Mehrfachkategorisierungen vorgenommen werden.

Migration

FS_LIST kann die Eingabekomponenten

• CMS_INPUT_CONTENTAREALIST,
• CMS_INPUT_LINKLIST,
• CMS_INPUT_SECTIONLIST,
• CMS_INPUT_CONTENTLIST und
• CMS_INPUT_TABLIST

ersetzen und wird diese Eingabekomponenten voraussichtlich ab FirstSpirit Version 5.0 ablösen. Daher empfiehlt es sich, die CMS_INPUT-Komponenten durch FS_LIST zu ersetzen.

Im Ordner "Migration" unterhalb des Absatzknoten-Ordners in der Vorlagen-Verwaltung befinden sich Vorlagen, anhand derer die Verwendung dieser CMS_INPUT-Eingabekomponenten und der FS_LIST-Komponente gegenübergestellt wird, jeweils in der Standard-/Minimalkonfiguration sowie weiteren typischen Konfigurationen. Dabei kann in der Inhalte-Verwaltung (Ordner "Migration") von jeder dieser CMS_INPUT-Komponenten per Register zur entsprechend konfigurierten FS_LIST-Komponente gewechselt werden.

Neben der Gegenüberstellung der Formulare kann auch eine Gegenüberstellung der HTML-Ausgabe vorgenommen werden: Standardmäßig werden sowohl die in den FS_LIST- als auch in den entsprechenden CMS_INPUT-Formularen eingegebenen und gespeicherten Werte bei der Ausgabe berücksichtigt. Nur die in FS_LIST-Komponenten gespeicherten Werte können dargestellt werden, indem die Option "Werte von veralteten Eingabekomponenten ausgeben" in den Projekteinstellungen (Globale Einstellungen) deaktiviert wird.