Please note that this documentation is for the most recent version of this extension. It may not be relevant for older versions. Related documentation can be found in the documentation directory of the extension.
Data Mapping
In this documentation, you will learn how the data from the various feed formats (RSS 2.0 and Atom) is mapped to the internal data format, which is then available to you in your Fluid templates.
Feed Mapping Table
The following table shows the comparison between RSS 2.0 and Atom elements and how they end up in your Fluid array (usually in the {items} variable).
| Fluid Key | RSS 2.0 Element | Atom Element | Description |
|---|---|---|---|
title |
<title> |
<title> |
Title of the entry |
link |
<link> |
<link href="..."> |
Link to the original post |
guid |
<guid> |
<id> |
Unique ID of the post |
description |
<description> |
<summary> or media:description |
Summary or description |
pubDate |
<pubDate> |
<published> or <updated> |
Publication date (as \DateTime object) |
creator |
<dc:creator> |
<author><name> |
Name of the creator |
category |
<category> |
Not explicitly mapped | Category of the post |
media.url |
<media:content url="..."> or <enclosure url="..."> |
<media:thumbnail url="..."> |
URL to the preview image or medium |
media.medium |
<media:content medium="..."> |
"image" (fixed for thumbnails) |
Type of medium |
Cache Information
In addition to the feed entries, useful cache information is added to the main feed array:
| Key | Description |
|---|---|
t3cache |
Status of the cache (fetched or restored) |
t3cacheCreateDate |
Cache creation time (Format: Y-m-d H:i:s) |
t3cacheExpireDate |
Cache expiration time (Format: Y-m-d H:i:s) |
t3cacheRemaining |
Remaining cache time in seconds |
Usage in Fluid
You can iterate over the array within your template. Here is a short example:
<f:for each="{items}" as="item">
<h3>{item.title}</h3>
<f:if condition="{item.media.url}">
<img src="{item.media.url}" alt="{item.title}" />
</f:if>
<p><f:format.date format="d.m.Y">{item.pubDate}</f:format.date></p>
</f:for>
