Automatische Anzeige von Feldern

Jedes der verfügbaren Felder verfügt über eine Option mit der Bezeichnung Automatische Anzeige, die auf einen der folgenden Werte gesetzt werden kann:

  • Nach dem Titel
  • Vor dem Inhalt
  • Nach dem Inhalt
  • Nicht automatisch anzeigen

Falls der letzte dieser Einträge ausgewählt wurde, wird das Feld nicht angezeigt, es sei denn, es wird ein Template-Override erstellt, um die Anzeige selbst zu steuern. Alternativ kann in einem Beitrag eingefügt werden, um das Feld an einer beliebigen Stelle zu platzieren. Dies muss jedoch in jedem Beitrag erneut gemacht werden.

Dieses Beispiel zeigt, wie ein Template-Override für einen Kontakt erstellt wird. Die Methoden gelten ebenso für die Komponenten Inhalt und Benutzer.

Einen Template-Override erstellen

Im Administrator-Menü:

  • System / Website-Templates / Cassiopeia – Details und Dateien auswählen
  • Den Reiter Overrides erstellen auswählen.
  • com_contact im Bereich Komponenten auswählen
  • Kontakt aus der Liste der verfügbaren Ansichten auswählen. Dies ist das Layout für einen einzelnen Kontakt.

Im Bereich Editor:

  • html / com_contact / contact / default.php auswählen, die Datei, die das Gesamtlayout der Einzelkontaktseite festlegt.
  • In dieser Datei nach unten scrollen und eine Reihe von <php if (...) : ?>-Blöcken beachten. Jeder davon zeigt oder verbirgt einen Textabschnitt abhängig von den Kontakteinstellungen.
  • Die folgenden Zeilen beachten
    <?php echo $this->item->event->afterDisplayTitle; ?> (Zeile 73)
    <?php echo $this->item->event->beforeDisplayContent; ?> (Zeile 98)
    <?php echo $this->item->event->afterDisplayContent; ?> (Zeile 189)

Eine dieser Variablen, oder keine davon, wird abhängig vom Wert des Felds „Automatische Anzeige“ befüllt.

Felder im Override verwenden

Alle Felder, die zum aktuellen Eintrag gehören, sind über die Eigenschaft $this->item->jcfields zugänglich, ein Array, das für jedes Feld die folgenden Daten enthält (dieses Beispiel bezieht sich auf ein Editor-Feld):

    Array
    (
        [4] => stdClass Object
            (
                [id] => 4
                [title] => article-editor
                [name] => article-editor
                [checked_out] => 0
                [checked_out_time] => 0000-00-00 00:00:00
                [note] =>
                [state] => 1
                [access] => 1
                [created_time] => 2017-04-07 12:08:59
                [created_user_id] => 856
                [ordering] => 0
                [language] => *
                [fieldparams] => Joomla\Registry\Registry Object
                    (
                        [data:protected] => stdClass Object
                            (
                                [buttons] =>
                                [width] =>
                                [height] =>
                                [filter] =>
                            )

                        [initialized:protected] => 1
                        [separator] => .
                    )

                [params] => Joomla\Registry\Registry Object
                    (
                        [data:protected] => stdClass Object
                            (
                                [hint] =>
                                [render_class] =>
                                [class] =>
                                [showlabel] => 1
                                [disabled] => 0
                                [readonly] => 0
                                [show_on] =>
                                [display] => 2
                            )

                        [initialized:protected] => 1
                        [separator] => .
                    )

                [type] => editor
                [default_value] =>
                [context] => com_content.article
                [group_id] => 0
                [label] => article-editor
                [description] =>
                [required] => 0
                [language_title] =>
                [language_image] =>
                [editor] =>
                [access_level] => Public
                [author_name] => Super Benutzer
                [group_title] =>
                [group_access] =>
                [group_state] =>
                [value] => Bar
                [rawvalue] => Bar
            )
    )

Das Feld ausgeben

Die Funktion FieldsHelper::render() wird verwendet, um jedes Feld auszugeben. Zunächst eine use Joomla\Component\Fields\Administrator\Helper\FieldsHelper;-Anweisung zur Liste der use-Anweisungen am Anfang der Override-Datei hinzufügen:

defined('_JEXEC') or die;

use Joomla\CMS\Helper\ContentHelper;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Layout\FileLayout;
use Joomla\CMS\Layout\LayoutHelper;
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\CMS\Router\Route;
use Joomla\Component\Contact\Site\Helper\RouteHelper;
use Joomla\Component\Fields\Administrator\Helper\FieldsHelper;

Dann, an der Stelle im Template, an der die Felder angezeigt werden sollen, folgenden Code verwenden:

<?php foreach ($this->item->jcfields as $field) : ?>
    <?php echo FieldsHelper::render($field->context, 'field.render', array('field' => $field)); ?><br>
<?php endforeach ?>

Oder für einen rohen Override, der die Bezeichnung nicht übersetzt:

<?php foreach ($this->item->jcfields as $field) : ?>
    <?php echo $field->label . ':' . $field->value; ?><br>
<?php endforeach ?>

Einzelne Felder laden

Um einzelne Felder zu Ihren Inhalten hinzuzufügen, zunächst spezifische Namen für die benutzerdefinierten Felder festlegen, indem das Feld Name verwendet wird, welches zur direkten Referenzierung des Feldes im Override-Code dient. Im Tab Optionen im Feld Automatische Anzeige Nein auswählen, damit es nicht automatisch an einer der Standardpositionen angezeigt wird.

Um dann den direkten Zugriff auf benutzerdefinierte Felder über ihren Namen in einem Override zu ermöglichen, den unten stehenden Code am Anfang der Datei einfügen. Dies sollte bei jeder Override-PHP-Datei geschehen, in der einzelne benutzerdefinierte Felder platziert werden sollen.

<?php foreach($this->item->jcfields as $jcfield) {
    $this->item->jcFields[$jcfield->name] = $jcfield;
} ?>

Und schließlich sollte der Code zur Feldplatzierung an der Stelle eingefügt werden, an der die Feldbezeichnung oder der Wert angezeigt werden soll.

Um die Beschriftung des Feldes zum Override hinzuzufügen, den untenstehenden Code einfügen und name-of-field durch den Namen des Feldes ersetzen.

<?php echo $this->item->jcFields['name-of-field']->label; ?>:&nbsp;

Um den Wert des Feldes zum Override hinzuzufügen, den untenstehenden Code einfügen und name-of-field durch den Namen des Feldes ersetzen.

<?php echo $this->item->jcFields['name-of-field']->rawvalue; ?>

Dieser Code kann an beliebiger Stelle im Override eingefügt werden. Beispiele: Der Inhalt eines Divs, das src-Attribut in einem img-Tag, innerhalb eines CSS-Klassenattributs usw.