Feeds

REDAXO Feed Aggregator

Features

• Abruf von YouTube-, Vimeo- und RSS-Streams.
• Dauerhaftes Speichern der Beiträge
• Speicherung des Hauptmediums Im data-Ordner des AddOns
• Nachträgliche Aktualisierung der Beiträge (z.B. nach einem Update / einer Korrektur)
• Erweiterbar durch eigene Feed-Provider
• Feeds können in Watson gesucht werden feed suchbegriff
• Abruf aller oder einzelner Feeds per Cronjob

Migration zu Namespaces (REDAXO 6 Vorbereitung)

Das Feeds-AddOn wurde für REDAXO 6 vorbereitet und nutzt jetzt moderne PHP-Namespaces. Die alten rex_ Klassen sind weiterhin verfügbar, werden aber als deprecated markiert.

Neue Namespace-Struktur

Alle Klassen wurden in den FriendsOfRedaxo\Feeds Namespace migriert:

Alte Klasse	Neue Klasse
rex_feeds_stream	FriendsOfRedaxo\Feeds\Stream
rex_feeds_item	FriendsOfRedaxo\Feeds\Item
rex_feeds_stream_abstract	FriendsOfRedaxo\Feeds\Stream\AbstractStream
rex_cronjob_feeds	FriendsOfRedaxo\Feeds\Cronjob
rex_feeds_helper	FriendsOfRedaxo\Feeds\Helper

Stream-Implementierungen befinden sich im FriendsOfRedaxo\Feeds\Stream Namespace:

• rex_feeds_stream_rss → FriendsOfRedaxo\Feeds\Stream\Rss
• rex_feeds_stream_youtube_playlist → FriendsOfRedaxo\Feeds\Stream\YoutubePlaylist
• rex_feeds_stream_youtube_channel → FriendsOfRedaxo\Feeds\Stream\YoutubeChannel
• rex_feeds_stream_ics → FriendsOfRedaxo\Feeds\Stream\Ics
• rex_feeds_stream_vimeo_pro → FriendsOfRedaxo\Feeds\Stream\VimeoPro

Sanfte Migration

Die alten Klassennamen funktionieren weiterhin, sind aber als deprecated markiert:

// ✅ Funktioniert weiterhin (deprecated)
$stream = rex_feeds_stream::get($stream_id);

// ✅ Moderne Schreibweise (empfohlen)
$stream = \FriendsOfRedaxo\Feeds\Stream::get($stream_id);

Empfehlung: Migrieren Sie Ihren Code schrittweise zu den neuen Namespace-Klassen. Die alten Klassen werden in zukünftigen Versionen entfernt.

Installation

Im REDAXO-Backend unter Installer abrufen und installieren

Verwendung

Einen neuen Feed einrichten

1. Im REDAXO-Backend AddOns > Feeds aufrufen,
2. dort auf das +-Symbol klicken,
3. den Anweisungen der Stream-Einstellungen folgen und
4. anschließend speichern.

Hinweis: Ggf. müssen zusätzlich in den Einstellungen von Feeds Zugangsdaten (bspw. API-Schlüssel) hinterlegt werden, bspw. bei Vimeo und YouTube.

Feed aktualisieren

Die Feeds können manuell unter AddOns > Feeds abgerufen werden, oder in regelmäßigen Intervallen über einen Cronjob abgerufen werden:

1. Im REDAXO-Backend unter AddOns > Cronjob aufrufen,
2. dort auf das +-Symbol klicken,
3. als Umgebung z.B. Frontend auswählen,
4. als Typ Feeds: Feeds abrufen auswählen,
5. den Zeitpunkt festlegen (bspw. täglich, stündlich, ...) und
6. mit Speichern bestätigen.

Jetzt werden Feeds-Streams regelmäßig dann abgerufen, wenn die Website aufgerufen wird. Weitere Infos zu REDAXO-Cronjobs.

Feed ausgeben

Um ein Feed auszugeben, können die Inhalte in einem Modul oder Template per SQL oder mit nachfolgender Methode abgerufen werden, z.B.:

<?php 
use FriendsOfRedaxo\Feeds\Stream;

$stream_id = 1;
// Mediamanager Typ mit feeds als erster Effekt
$media_manager_type = 'feeds_thumb';

// Moderne Schreibweise (empfohlen)
$stream = Stream::get($stream_id);
// Alternativ: $stream = rex_feeds_stream::get($stream_id); // Weiterhin möglich, aber deprecated

$items = $stream->getPreloadedItems(); // Standard gibt 5 Einträge zurück, sonst gewünschte Anzahl übergeben
    foreach($items as $item) {
        // Titel ermitteln und alles verlinken
        print '<a href="'. $item->getUrl() .'" title="'. rex_escape($stream->getTitle()) .'">';
        // Bild ausgeben
        if($item->getMediaFilename()) {
        print '<img src="'.rex_media_manager::getUrl($media_manager_type,$item->getId() .'.feeds').'"  alt="'. rex_escape($item->getTitle()) .'" title="'. rex_escape($item->getTitle()) .'">';
        }
       print '<p>'.rex_escape($item->getContent()).'</p>';
       print '</a>';
    }
?>

Bilder ausgeben mit dem Media Manager

Die Bilder eines Feeds werden im AddOn-Data-Ordner unter data/addons/feeds/media gespeichert. Für die Ausgabe der Bilder stehen zwei gleichwertige Möglichkeiten zur Verfügung.

1. Methode des Feed-Items

Neu seit 5.0.0

// Mit Media Manager Effekt
$media_url = $item->getMediaManagerUrl('feeds_thumb');
echo '<img src="'.$media_url.'" alt="Mein Bild">';

Ermitteln der Medien-Infos:

$mediaInfo = $item->getMediaInfo('mein_media_type'); 
if ($mediaInfo) {
    echo "Breite: " . $mediaInfo['width'];
    echo "Höhe: " . $mediaInfo['height'];
    echo "Format: " . $mediaInfo['format'];
}

2. Direkt über den Mediamanager

Dies ist die traditionelle Methode zur Ausgabe des Mediums. Wichtig hierbei die Endung .feeds.

// $item ist ein rex_feeds_item Objekt
$media_url = rex_media_manager::getUrl('feeds_thumb', $item->getId() .'.feeds');
echo '<img src="'.$media_url.'" alt="Mein Bild">';

Komplettes Beispiel

<?php 
use FriendsOfRedaxo\Feeds\Stream;

$stream_id = 1;
// Media Manager Typ wo der Feeds-Effekt als erster Effekt eingerichtet ist
$media_manager_type = 'feeds_thumb';

// Moderne Schreibweise (empfohlen)
$stream = Stream::get($stream_id);
// Alternativ: $stream = rex_feeds_stream::get($stream_id); // Weiterhin möglich, aber deprecated

$items = $stream->getPreloadedItems(); // Standard gibt 5 Einträge zurück

foreach($items as $item) {
    // Titel ermitteln und verlinken
    echo '<a href="'. $item->getUrl() .'" title="'. rex_escape($stream->getTitle()) .'">';
    
    // Variante 1: Klassische Methode
    echo '<img src="'.rex_media_manager::getUrl($media_manager_type, $item->getId() .'.feeds').'" 
              alt="'. rex_escape($item->getTitle()) .'">';
              
    // ODER Variante 2: Neue Methode
    echo '<img src="'.$item->getMediaManagerUrl($media_manager_type).'" 
              alt="'. rex_escape($item->getTitle()) .'">';
    
    echo '<p>'.rex_escape($item->getContent()).'</p>';
    echo '</a>';
}
?>

Media Manager Effekt einrichten

1. Im REDAXO-Backend unter Media Manager einen neuen Typ anlegen
2. Als ersten Effekt "Datei: Aus Feeds einlesen" auswählen
3. Weitere gewünschte Effekte wie Resize, Crop etc. hinzufügen

Wichtig: Der Feed-Effekt muss immer als erster Effekt in der Effektkette eingerichtet sein.

Hinweis: Beide Methoden der Bildausgabe sind in ihrer Funktionalität identisch. Die klassische Methode wird aus Gründen der Abwärtskompatibilität weiterhin unterstützt.

Einträge entfernen

Über das Cronjob-Addon lässt sich ein PHP-Cronjob ausführen, um nicht mehr benötigte Einträge aus der Datenbank zu entfernen. Dazu diese Codezeile ausführen und ggf. die Werte für stream_id und INTERVAL anpassen.

<?php rex_sql::factory()->setQuery("DELETE FROM rex_feeds_item WHERE stream_id = 4 AND createdate < (NOW() - INTERVAL 2 MONTH)"); ?>

Alternativ:

<?php rex_sql::factory()->setQuery("DELETE t1 FROM rex_feeds_item t1 JOIN (SELECT id FROM rex_feeds_item WHERE stream_id = 1 ORDER BY id DESC LIMIT 50,500) t2 ON t1.id = t2.id"); ?>

Dies löscht nicht nach Datum, sondern nach Anzahl. Vorteil: Wenn viele Posts immer geladen werden, kann sich die die DB sehr schnell aufblähen und Probleme beim Backup machen.

Eigenen Provider anmelden

Feeds kann Inhalte auch anderer Quellen als die der mitglieferten Provider annehmen.

Moderne Schreibweise (empfohlen)

Hierzu erstellt man eine extended Class der FriendsOfRedaxo\Feeds\Stream\AbstractStream im lib Ordner des eigenen AddOns oder des project-AddOns an, z.B.: MyCustomStream. Man kann sich dabei an die mitgelieferten Classes im Ordner /lib/Stream halten.

<?php
use FriendsOfRedaxo\Feeds\Stream\AbstractStream;

class MyCustomStream extends AbstractStream
{
    // Ihre Implementierung hier
}

Anschließend meldet man den neuen Provider wie folgt in der boot.php an:

use FriendsOfRedaxo\Feeds\Stream;

Stream::addStream("MyCustomStream");

Legacy-Schreibweise (deprecated)

Die alte Schreibweise funktioniert weiterhin:

// Erstellen einer extended Class der `rex_feeds_stream_abstract`
class rex_feeds_stream_my_class extends rex_feeds_stream_abstract
{
    // Ihre Implementierung hier
}

// Anmelden in der boot.php
rex_feeds_stream::addStream("rex_feeds_stream_my_class");

Extension Points nutzen

Feeds kommt mit 2 Extension Points, namentlich FEEDS_STREAM_FETCHED nach Abruf eines Streams sowie FEEDS_ITEM_SAVED nach dem Speichern eines neuen Eintrags.

So lassen sich nach Abruf eines oder mehrerer Streams bestimmte Aktionen ausführen.

Weitere Infos zu Extension Points in REDAXO unter https://www.redaxo.org/doku/master/extension-points

Zum GitHub-Repository von Feeds

RSS Feed

Gebe einfach die URL zum Feed ein. ;-)

Tipp: Mastodon-Feed auslesen: https://phpc.social/@REDAXO.rss

Vimeo Pro

Zum Auslesen des Streams werden User-ID, Access Token und ein Client Secret benötigt.

Alle Infos dazu unter: https://developer.vimeo.com/api/guides/start

Feeds und YForm

Die Stream-Tabelle lässt sich im YForm-Tablemanager importieren. Dadurch ist es möglich eine eigene Oberfläche für die Redakteure bereitzustellen.

Lizenz

AddOn, siehe LICENSE

Vendoren, siehe Vendors-Ordner des AddOns

Autor

Friends Of REDAXO

Credits

Contributors