Es kommt vor, dass du die Ausgabe im Frontend für einen Menüpunkt individuell gestaltest. Hierzu benötigst du eine Variable. In diesem Teil des Tutorials fügen wir eine Textvariable zum Menüpunkt hinzu und nutzen diese für die Anzeige im Frontend.
Für Ungeduldige
Sieh dir den geänderten Programmcode in der Diff-Ansichtgithub.com/astridx/boilerplate/compare/t4...t5 an und übernimm diese Änderungen in deine Entwicklungsversion.
Schritt für Schritt
In der nachfolgenden Übersicht sind die neu hinzugekommenen Dateien mit einem Hintergrund versehen und die geänderten umrandet.
Neue Dateien
In diesem Kapitel kommt keine neue Datei hinzu. Wir ändern ausschließlich.
Geänderte Dateien
components/com_foos/ src/Model/ FooModel.php
Im Model änderst du die Methode, in der Text für die Ausgabe berechnet wird. Lösche den folgenden Eintrag:
components/com_foos/ src/Model/FooModel.php
...
if (!isset($this->message))
{
$this->message = 'Hello Foo!';
}
...Füge die nachfolgenden Zeilen an der Stelle hinzu:
...
$app = Factory::getApplication();
$this->message = $app->input->get('show_text', "Hi");
...Zusammen sieht das in der Diff-Ansicht wie folgt aus:
components/com_foos/ src/Model/FooModel.php
\defined('_JEXEC') or die;
use Joomla\CMS\Factory;
use Joomla\CMS\MVC\Model\BaseDatabaseModel;
/**
*/
public function getMsg()
{
if (!isset($this->message))
{
$this->message = 'Hello Foo!';
}
$app = Factory::getApplication();
$this->message = $app->input->get('show_text', "Hi");
return $this->message;
}Soweit, so gut. Es fehlt noch die Möglichkeit, den Wert für show_text beim Menüpunkt zu konfigurieren. Dies implementieren wir in der Datei default.xml.
components/com_foos/ tmpl/foo/default.xml
Du speicherst einen Wert über den Menüpunkt im Inputelement, indem du die XML-Datei erweiterst:
components/com_foos/ tmpl/foo/default.xml
<![CDATA[COM_FOOS_FOO_VIEW_DEFAULT_DESC]]>
</message>
</layout>
<!-- Add fields to the request variables for the layout. -->
<fields name="request">
<fieldset name="request">
<field
name="show_text"
type="text"
label="COM_FOOS_FIELD_TEXT_SHOW_LABEL"
default="Hi"
/>
</fieldset>
</fields>
</metadata>Teste deine Joomla-Komponente
- Installiere deine Komponente in Joomla Version 4, um sie zu testen:
Kopiere die Dateien im components Ordner in den components Ordner deiner Joomla 4 Installation.
Eine neue Installation ist nicht erforderlich. Verwende die aus dem vorhergehenden Teil weiter.
- Wechsele in den Menü Manager und öffne den erstellen Menüpunkt oder erstelle einen neuen. Hier siehst du jetzt ein Textfeld, in das du einen beliebigen Text einfügst.
- Wechsele jetzt in die Frontendansicht. Überzeuge dich davon, dass der von dir beim Menüpunkt eingegebene Text im Frontend in der richtigen Variante ausgegeben wird.
Ich entschuldige mich für meine Einfallslosigkeit. Dir fallen sicher lustigere oder sinnvollere Beispiele ein. Der Sinn und die Funktion der Variablen werden aber klar, oder?
Erstelle mehrere Menüpunkte, die jeweils einen anderen Text enthalten. Gibt nicht lediglich den Text im Frontend aus, gestalte die Ausgabe mithilfe von bedingten Anweisungen. Ein beliebter Anwendungsfall ist es, das Design der Ausgabe mithilfe von Variablen zu beeinflussen. Über die Variable fragst du beispielsweise ab, ob der Inhalt in einer Liste oder in einer Tabelle auszugeben ist.