REDAXO Feed Aggregator
feed suchbegriff
Installer
abrufen und Hauptmenü
> AddOns
installieren.AddOns
> Feeds
aufrufen,+
-Symbol klicken,Hinweis: Ggf. müssen zusätzlich in den Einstellungen von Feeds Zugangsdaten (bspw. API-Schlüssel) hinterlegt werden, bspw. bei Vimeo und YouTube.
Die Feeds können manuell unter AddOns
> Feeds
abgerufen werden, oder in regelmäßigen Intervallen über einen Cronjob abgerufen werden:
AddOns
> Cronjob
aufrufen,+
-Symbol klicken,Frontend
auswählen,Feeds: Feeds abrufen
auswählen,Speichern
bestätigen.Jetzt werden Feeds-Streams regelmäßig dann abgerufen, wenn die Website aufgerufen wird. Weitere Infos zu REDAXO-Cronjobs.
Um ein Feed auszugeben, können die Inhalte in einem Modul oder Template per SQL oder mit nachfolgender Methode abgerufen werden, z.B.:
<?php
$stream_id = 1;
// Mediamanager Typ mit feeds als erster Effekt
$media_manager_type = 'feeds_thumb';
$stream = rex_feeds_stream::get($stream_id);
$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="https://github.com/FriendsOfREDAXO/feeds/blob/main/'. $item->getUrl() .'" title="'. rex_escape($stream->getTitle()) .'">';
// Bild ausgeben
print '<img src="https://github.com/FriendsOfREDAXO/feeds/raw/main/'.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>';
}
?>
Die Bilder eines Feeds werden in der Datenbank gespeichert und müssen mit dem Mediamanager-Effekt feeds
ausgelesen werden. Der Effekt muss an den Anfang der Verarbeitung.
.feeds
übergeben. Beispielcode:
$bildurl = rex_media_manager::getUrl($media_manager_type,$item->getId() .'.feeds';
Ü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)"); ?>
Feeds kann Inhalte auch anderer Quellen als die der mitglieferten Provider annehmen.
Hierzu erstellt man eine extended Class der rex_feeds_stream_abstract
im lib Ordner des eigenen AddOns oder des project-AddOns an, z.B.: rex_feeds_stream_my_class
. Man kann sich dabei an die mitgelieferten Classes im Ordner /lib/streams
halten. Alle möglichen Methoden findet man in der rex_feeds_stream_abstract
-Class unter /lib/stream_abstract.php
. Dort ruft man die Streamdaten ab und ordnet diese den Tabellenspalten zu.
Anschließend meldet man den neuen Provider wie folgt in der boot.php an:
rex_feeds_stream::addStream("rex_feeds_stream_meine_klasse");
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
Gebe einfach die URL zum Feed ein. ;-)
Tipp: Mastodon-Feed auslesen: https://phpc.social/@REDAXO.rss
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
Die Stream-Tabelle lässt sich im YForm-Tablemanager importieren. Dadurch ist es möglich eine eigene Oberfläche für die Redakteure bereitzustellen.
AddOn, siehe LICENSE
Vendoren, siehe Vendors-Ordner des AddOns