Joomla! 4.x und 5.x und wie ich ein Modul einem Menüpunkt oder Beitrag zuordne

Die Zuordnung der Module zu einem oder mehreren Menüpunkten oder Beiträgen hat sich seit Joomla! 2.5.x nicht wesentlich verändert.

Möglichkeit 1 - Registerkarte "Menüzuordnung" in der Modulverwaltung

Um ein Modul einem oder mehrere menüpunkte zuzuordnen muss man entweder direkt beim Erstellen des Moduls die Auswahl treffen oder nachträglich in der Joomla! Administration auf "Inhalt -> Site Module" klicken und dann das entsprechende Modul zum Bearbeiten öffnen.

• Modul-Zuordnung - Wählen Sie Auf allen Seiten, Keine Seiten, Nur auf den ausgewählten Seiten oder Auf allen Seiten außer den in der Liste ausgewählten.
• Menüauswahl - Wenn Sie die letzten beiden Optionen auswählen, werden alle Menüpunkte in einer Liste angezeigt. Auf diese Weise können Sie Module einigen, aber nicht allen Seiten zuordnen. Durch die Auswahl der Menülinks, mit denen das Modul verknüpft werden soll, können Sie festlegen, auf welchen Seiten Module angezeigt bzw. nicht angezeigt werden. Weitere Informationen finden Sie unter Wie kann man ein Modul bestimmten Seiten zuweisen?

Anmerkungen:

• Wenn das Modul einer Position zugewiesen wird, die in der für die Anzeige einer Seite verwendeten Template nicht vorhanden ist, wird das Modul nicht angezeigt, selbst wenn es einer bestimmten Seite zugewiesen ist. (Es sei denn, { loadmodule} oder {loadposition} werden im Artikel verwendet)
• Wenn Modul nicht veröffentlicht/aktiviert ist, erscheint es nicht, auch wenn es einer Seite zugewiesen ist.
• Man kann ein Modul nicht einem URL-Link zuweisen. Dies liegt daran, dass URL-Links keine Itemids zugewiesen werden können.
• Man kann Seiten, die nur über den Inhalt verlinkt sind (z. B. ein Link von einem Artikel zu einem anderen) oder anderen Modulen, die nicht im Menü enthalten sind (z. B. ein Link zu einem Artikel aus einem Modul), keine Module direkt zuweisen, da diese ebenfalls keine Item-IDs haben. Eine Möglichkeit, dieses Problem zu umgehen, besteht darin, ein unveröffentlichtes Menü zu erstellen, das Links zu den Artikeln enthält, die nicht im öffentlichen Menüs verlinkt werden sollen. Dadurch wird eine Artikel-ID erstellt, die in die URL, auf die Sie verlinken, aufgenommen werden kann.

Möglichkeit 2 – Plugin „Module laden“

Syntax selbst einsetzen

Normalerweise sind Module Modulpositionen zugeordnet. Diese sind auf der Webseite entsprechend den Festlegungen im Template verteilt. Manchmal ist es notwendig ein Modul in einen Beitrag einzubetten. Im Joomla! Kernsystem gibt es dazu drei Möglichkeiten: loadposition, loadmodule und loadmoduleid.

loadposition

Um ein Modul innerhalb eines Beitrags einzufügen, wird das Modul auf einer Position veröffentlicht und die Position dann folgendermaßen in den Beitrag geladen:

1. Erstellen eines Moduls und Festlegen der Modulposition auf meineposition. meineposition kann ein beliebiger Wert sein, der nicht mit anderen, bereits vorhandenen Modulpositionen des Templates in Konflikt treten sollte. Dazu wird im Feld Position ein beliebiger Wert meineposition eingetragen und danach die Return-Taste gedrückt, anstelle eines Wertes aus der Drop-Down-Liste auszuwählen.
2. Zuordnung des Moduls zu Auf allen Seiten unter Menüzuweisung. Dies stellt sicher, dass das Modul immer zu sehen ist, unabhängig davon wie der Seitenbesucher zu dem Beitrag gelangt. Das Modul wird nur angezeigt, wenn die load-Anweisung für das Modul in einem Beitrag erscheint.
3. Im Bearbeiten-Modus wird im Beitrag an die Stelle in der das Modul erscheinen soll der Text {loadposition meineposition} eingefügt. Dieser wird dann durch den Inhalt des Moduls ersetzt.

loadmodule

Eine Alternative zu "{loadposition xx}" ist die "{loadmodule yyy}" Variante, die mit gleichen Plugin umgesetzt wird.

In diesem Fall sucht das Plugin nach dem ersten Auftreten einen Moduls dessen Typ mit der Zeichenkette 'yyy' übereinstimmt. So kann man z.B. ein "mod_login" Modul laden, indem im Text eines Beitrages eingefügt wird. In manchen Fällen gibt es mehre Module des gleichen Typs, es soll aber nur eine spezifische Instanz des Moduls geladen werden. Zum Beispiel gibt es zwei Login Module (die hier Login 1 und Login 2 genannt werden). In diesem Fall verwendet man wobei mod_modType mod_login und modTitle für Ihre Instanz dieses Moduls ist. Das hieße für das obige Beispiel endet man mit {loadmodule mod_login Login 2}. Man kann den Stil, der für die Darstellung des Moduls verwendet werden soll, als dritten Parameter {loadmodule login,Login 2,xhtml} angeben. Falls kein Stil angegeben ist, wird "none" verwendet.

loadmoduleid

Seit Joomla-Version 3.9.0 gibt es neben den Alternativen {loadposition xx} und {loadmodule yyy} die Variante {loadmoduleid z}, die ebenfalls vom Plugin umgesetzt wird.

In diesem Fall sucht das Plugin nach dem Modul, dessen id der Zahl z entspricht. Man kann zum Beispiel das Modul mit der id 200 in den Beitrag einfügen, indem man in den Editor-Text den Platzhalter {loadmoduleid 200} einsetzt. Beachte dabei, dass diese Variante weitere Parameter wie style nicht "versteht".

Editor-Schaltfläche (seit Joomla!-Version 3.5)

Wenn das editor-xtd-Plugin "Schaltfläche - Modul" aktiviert ist, kannst du den Editor-Button "Modul" verwenden, um die oben beschriebenen Plugin-Tags bequemer in den Editor-Text einzufügen. Seit Joomla-Version 3.9 auch die Variante loadmouleid.

Module innerhalb von Modulen

Seit Joomla! 2.5.x ist es möglich ein Modul innerhalb eines "Eigene Inhalte (Custom HTML)"-Moduls einzufügen. Sie werden von Content-Plugins (Inhalt-Plugins) genauso verarbeitet wie Artikel.

Damit dies funktioniert muss die Option Inhalte vorbereiten aktiviert werden wie im Screenshot zu sehen ist.

Anmerkungen

• Wenn man ein Modul innerhalb eines Module einfügt sollte man daran denken, dass Formatierungsmöglichkeiten wie "chrome" (Modulstil) des "Eigene Inhalte"-Moduls das "chrome" des eingeschlossenen Moduls umschließen und so zu unerwünschten Nebeneffekten bezüglich Formatierungen und Layout führen können. Das ist der Grund, warum die Editor-Schalfläche "Modul" in diesem Modultyp nicht verfügbar ist.
• Das Plugin Inhalt - Module laden muss aktiviert sein.
• Wenn man bei der Verwendung von loadposition einen individuellen Namen als Position einträgt sollte der Name in Kleinbuchstaben geschrieben sein. Die CamelCase-Schreibweise funktioniert nicht als Name der Position.