News Extension: Tipps und Tricks für Integratoren

Sie sollten immer ein Dummy-Image (Auch Fallback Bild genannt) einsetzen. Denn falls ein Redaktuer für einen Newsbeitrag vergisst, ein Bild anzugeben, kann es unter Umständen unschön aussehen oder sogar zu fehlern kommen.

Mit dieser SETUP Anweisung können Sie Dummy Bilder aktivieren und den Pfad für ein eigenes Bild angeben:

plugin.tx_news.settings {
  displayDummyIfNoMedia = 1
  list.media.dummyImage = EXT:myExtension/Resources/Public/Images/News/MyPreviewImage.png
}

Ein Bild sagt mehr als tausend Worte - genau deshalb ist es wichtig, wenn Sie einen Beitrag schreiben, Bilder hinzuzufügen. Natürlich sollten die Bilder klein sein, aber bei Möglichkeit vergrößert werden können.

In TYPO3 ist dies mit den Image/Media Elementen möglich, allerdings nicht direkt bei tx_news.

Hierfür müssen wir im SETUP folgende Anpassungen vornehmen:

plugin.tx_news.settings.detail.media {
  image {
    lightbox {
        enabled = 1
        class = fancybox
        rel = fancybox[myImageSet]
    }
  }
}

In unserem Beispiel sehen Sie, dass wir die Klasse "fancybox" hinzufügen. Sollten Sie eine andere Lightbox verwenden, kommt dort die Klasse rein.

Falls Sie noch keine Lightbox Funktion haben, empfehlen wir die umfangreiche Lightbox Extension von NITSAN, die bereits vorkoniguriert und schnell einsatzbereit ist.

Sollten Sie kein Sitepackage haben, oder grundsätzlich Ihre Übersetzungen per TypoScript pflegen wollen, können Sie für jede Extension die jeweilige Übersetzung anlegen. Wir zeigen Ihnen in diesem Tutorial auch nur, wie das per TypoScript geht, da für XLIFF Translation eine .xlf Datei in der jeweiligen Sprache vorhanden sein muss.

Um z.B. tx_news in die gewünschte Sprache zu übersetzen, müssen natürlich die Sprachen Ihrer Seite richtig eingestellt werden.

Tragen Sie diesen Beispielcode in Ihr SETUP ein und passen Sie die vorgegebenen Beispieltexte an:

tx_news {
        _LOCAL_LANG {
            de {
                more-link = Mehr lesen
                author = von %s
                search-subject = Beiträge finden
                search-start = Suchen
                paginate_previous = Zurück
                paginate_next = Weiter
                search-text = %1$s Ergebnisse für "%2$s" gefunden:
                search-noresult = Keine Ergebnisse gefunden.
            }
        }       
    }

Sollten Parameter mit angegeben werden, können Sie diese per %s verwenden. In diesem Beispiel werden auch mal 2 Parameter übergeben. Diese sind in der Reihenfolge zu beachten und werden %1$s benannt. Wobei %1 der erste Paramter und $s der Typ Text bedeutet.

Damit Ihr News-Datum nicht einfach nur "2023/01/22" ist, empfehlen wir die Anpassung des Formats über die Translation. Entweder Sie nutzen dafür XLIFF in Ihrem Sitepackage, oder Sie passen die Translation an.

Wie im obigen Tipp, können Sie auch das Datumsformat über die TypoScript Translation anpassen. Im Fluid ist der Translation-Key:

<f:format.date format="{f:translate(key:'dateFormat')}">{newsItem.datetime}</f:format.date>

Um diesen per TypoScript also anzupassen, müssen Sie folgendes Eintragen:

tx_news {
 _LOCAL_LANG {
    de {
      dateFormat = %d. %b %Y
    }
 }
}

Halten Sie sich bei den Format-Parametern an die DateTime::format/date_format Klasse von PHP. Sollten Sie PHP 8.0 oder älter nutzen, können Sie strftime benutzen. Wir empfehlen aber, es gleich richtig zu machen, dann sparen Sie für die Zukunft den Upgrade-Aufwand.

Da dieser Beitrag sonst zu lang wird, empfehlen wir die Dokumentation zu den RouteEnhancer BestPractices zu lesen. Damit können Sie die URLs Ihrer Beiträge, Tags und sogar die Übersetzung der Parameter konfigurieren.

Ein komplett fertiges Beispiel haben wir hier einmal verlinkt, welches Sie einfach per Copy&Paste in Ihre site.yaml einfügen können.