Module in Beiträgen

Einführung

In der Regel möchte man Module auf irgendeine Weise mit Beiträgen verknüpfen. Module werden üblicherweise Modulpositionen zugewiesen, und die Modulpositionen erscheinen, je nach Template, an bestimmten Stellen der Webseite. Manchmal ist es jedoch nützlich, ein Modul direkt in einen Beitrag einzubetten. Joomla verfügt dafür über ein Plugin namens Inhalt – Module laden. Wenn es aktiviert ist, kann ein Modul auf drei verschiedene Arten in einen Beitrag eingebettet werden:

    {​loadposition position,[style]}
    {​loadmodule mod_type,the title,[style]}
    {​loadmoduleid moduleId}

Dabei ist style einer der Werte für den Modulstil aus dem Reiter „Erweitert“ des Modul-Formulars, zum Beispiel html, outline, table, card oder noCard.

loadposition

Um ein Modul in einen Beitrag einzufügen, wird das Modul einer Position zugewiesen und diese Position im Beitrag wie folgt geladen:

1. Ein Modul erstellen und dessen Position auf myposition setzen. myposition kann ein beliebiger Wert sein, der nicht mit einer bestehenden Template-Position in Konflikt steht. Im Modul-Bearbeitungsformular wird die Position myposition eingetippt und mit Enter bestätigt, anstatt sie aus der Dropdown-Liste auszuwählen.
2. Das Modul Allen Menüeinträgen zuweisen. So wird sichergestellt, dass es immer erscheint, unabhängig davon, wie der Besucher zum Beitrag gelangt ist. Das Modul wird erst angezeigt, wenn der Befehl zum Laden des Moduls im Beitrag verwendet wird.
3. Den Beitrag bearbeiten und den Text {​​loadposition myposition} an der Stelle einfügen, an der das Modul erscheinen soll.

Hinweis: Ist das Plugin Inhalt – Module laden deaktiviert, wird der Text {​loadposition myposition} unverändert im Beitrag angezeigt. Außerdem sollte der Name der Position vollständig in Kleinbuchstaben geschrieben werden. CamelCapitalization führt zu einem Fehler.

loadmodule

Die Syntax {​loadmodule yyy} sucht nach dem ersten Modul, dessen Typ mit der Zeichenfolge 'yyy' übereinstimmt. So könnte ein mod_login-Modul geladen werden, indem {​loadmodule login} in den Text eingefügt wird. Der Typ ist nicht immer offensichtlich! Zum Beispiel hat der Sprachumschalter den Typ languages. Um den Typ herauszufinden, muss mit einem Dateimanager/Explorer die Liste der Modulverzeichnisse durchsucht und der Teil mod_ vom Verzeichnisnamen entfernt werden.

Soll eine bestimmte Instanz eines Moduls geladen werden, weil zum Beispiel mehrere Login-Module mit den Titeln Login 1, Login 2 usw. vorhanden sind, muss {​loadmodule mod_modType, modTitle} verwendet werden, wobei mod_modType mod_login wäre und modTitle der Name/Titel, der dieser Instanz des Moduls gegeben wurde. Im obigen Beispiel ergibt sich daraus {​​loadmodule mod_login Login 2}.

Es kann auch der Stil hinzugefügt werden, der für die Darstellung des Moduls verwendet wird. Dazu wird der Stil als dritter Parameter angegeben, wie in {​loadmodule login,Login 2,xhtml}. Wird kein Stil angegeben, wird keiner verwendet.

loadmoduleid

Die Syntax {​loadmoduleid z} sucht nach dem Modul, dessen id mit der Zahl z übereinstimmt. So könnte das Modul mit der id 200 geladen werden, indem {⁠loadmoduleid 200} in den Text eingefügt wird. Diese Variante verwendet keine zusätzlichen Parameter wie den style-Parameter.

Editor-Schaltfläche

Ist das editor-xtd-Plugin Schaltfläche – Modul aktiviert, kann die Editor-Schaltfläche Modul verwendet werden, um die oben beschriebenen Tags leichter in den Editortext einzufügen. Die Modulliste verfügt über eine Schaltfläche in der Spalte Titel, um anhand der id einzufügen, und eine Schaltfläche in der Spalte Position, um anhand der Position einzufügen.

Module innerhalb von Modulen

Es ist möglich, ein Modul innerhalb eines Benutzerdefiniertes HTML-Moduls einzubinden. Sie werden von den Inhalts-Plugins auf die gleiche Weise wie Beiträge verarbeitet.

Es können Formatierungsprobleme auftreten, da der Stil des Moduls Benutzerdefiniertes HTML den Stil des eingebundenen Moduls umschließt. Aus diesem Grund ist die Schaltfläche Modul im Editor bei Modulen vom Typ Benutzerdefiniert nicht verfügbar.