Download the PHP package dodecastudio/craft-feedreader without Composer
On this page you can find all versions of the php package dodecastudio/craft-feedreader. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download dodecastudio/craft-feedreader
More information about dodecastudio/craft-feedreader
Files in dodecastudio/craft-feedreader
Package craft-feedreader
Short Description A simple plugin to load and display RSS and Atom feeds in Craft CMS templates.
License proprietary
Informations about the package craft-feedreader
FeedReader plugin for Craft CMS
Requirements
- Craft CMS 3.X, 4.X or 5.X
- PHP 7.4+
Installation
Install the plugin as follows:
-
Open your terminal and go to your Craft project:
cd /path/to/project -
Then tell Composer to load the plugin:
composer require dodecastudio/craft-feedreader - In the Control Panel, go to Settings → Plugins and click the “Install” button for FeedReader.
Overview
The FeedReader plugin makes use of Craft's built-in Feeds API to load and display RSS or Atom feeds directly in templates. As the Feeds API was deprecated in Craft 4, this plugin borrows the original code from Craft 3 in order to ensure function across both these versions of Craft.
Using FeedReader
Fetching a feed
The getFeed variable will fetch a feed and return feed information and feed items as an array.
You can then output information about the feed and the items it contains, like so:
Supported parameters
The parameters available for the getFeed variable are:
| Parameter | Type | Default | Description |
|---|---|---|---|
url |
String |
The URL of the feed being loaded. | |
cacheDuraction |
Int |
86400 | The duration in seconds for which to cache the feed result. The default of 86400 can be overridden using a custom settings config file. |
normalize |
Boolean |
true | Whether or not to "normalize" the data returned for each item or entry. This is helpful when non-standard data is being returned. |
Fetching feed items
If you don't need feed information and would like a little bit more control over the feed items, then the getFeedItems variable will fetch feed items and return them as an array.
You can then output the items, like so:
Supported parameters
The parameters available for the getFeedItems variable are:
| Parameter | Type | Default | Description |
|---|---|---|---|
url |
String |
The URL of the feed being loaded. | |
limit |
Int |
20 | The number of feed items to return. |
offset |
Int |
0 | The starting index of the item from which to start the returned feed items. |
cacheDuraction |
Int |
86400 | The duration in seconds for which to cache the feed result. The default of 86400 can be overridden using a custom settings config file. |
normalize |
Boolean |
true | Whether or not to "normalize" the data returned for each item or entry. This is helpful when non-standard data is being returned. |
Plugin Settings
Default settings can be overridden. Please see the feedreader-config.php file for details.
All versions of craft-feedreader with dependencies
craftcms/cms Version ^3.0|^4.0|^5.0
laminas/laminas-feed Version >=2.17.0
guzzlehttp/guzzle Version ^7.2.0