Wallogit.com
2017 © Pedro Peláez
eZ Publish Legacy extension which provides a a configurable rssfeed toolbar for displaying rssfeeds on your site. It also contains a rssfeed template operator for fetching rssfeeds into a template with eZ Publish Legacy. Great for reports!
The eZRSSFeed extension contains a configurable rssfeed toolbar for displaying rssfeeds on your site. It also contains a rssfeed template operator for fetching rssfeeds into a template, (*1)
The current version of eZ RSS Feed is 0.1.2, (*2)
Last Major update: October 02, 2017, (*3)
eZ RSS Feed is copyright 1999 - 2017 Brookins Consulting, (*4)
See: COPYRIGHT.md for more information on the terms of the copyright and license, (*5)
eZ RSS Feed is licensed under the GNU General Public License., (*6)
The complete license agreement is included in the LICENSE file., (*7)
eZ RSS Feed is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License or at your option a later version., (*8)
eZ RSS Feed is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details., (*9)
The GNU GPL gives you the right to use, modify and redistribute eZ RSS Feed under certain conditions. The GNU GPL license is distributed with the software, see the file LICENSE., (*10)
It is also available at http://www.gnu.org/licenses/gpl.txt, (*11)
You should have received a copy of the GNU General Public License along with eZ RSS Feed in in the LICENSE file., (*12)
If not, see http://www.gnu.org/licenses/., (*13)
Using eZ RSS Feed under the terms of the GNU GPL is free (as in freedom)., (*14)
For more information or questions please contact: license@brookinsconsulting.com, (*15)
The following requirements exists for using eZ RSS Feed extension:, (*16)
Make sure you use eZ Publish version 5.x (required) or higher., (*17)
Designed and tested with eZ Publish Community Project 2017.1, (*18)
As an example of usage there is a toolbar available, (*19)
This solution provides the following eztpl operator:, (*20)
ezrssfeed
This solution was created to provide a simple way to fetch and display rss feed content within your own website templates., (*21)
Run the following command from your project root to install the extension:, (*22)
```bash $ composer require brookinsconsulting/ezrssfeed dev-master;```
Extract the ezrssfeed.tar.gz in your eZ Publish Legacy extension directory., (*23)
Either in adminitration interface: Go to "Setup" Go to "Extensions" Check the checkbox beside "ezrssfeed" Click "Activate", (*24)
Add the following to your settings/override/site.ini.append.php file:
[ExtensionSettings]
ActiveExtensions[]=ezrssfeed
The extension can be used in two ways. Either as a toolbar or as an template operator. It can also be used as an example of how to create a toolbar., (*25)
As an example of usage there is a toolbar available. Once the extension has been installed and activated there will be a "rssfeed" toolbar available in the administration interface., (*26)
The toolbar makes it easy to add rssfeeds to your page. The settings are self explaining., (*27)
For more flexibility the operator can be used in your templates. The ezrss operator takes at a minimum one argument, the url of the RSS-feed., (*28)
The available parameters are: * url: The url of the feed to download This parameter is required. * items: The number of items to return (set to 0 for all items) Default value: 4 * channeldata: Return channel data? Default value: False * imagedata: Return rssfeed image data? This might not be avaiable in all feeds. Default value: False, (*29)
{let slashdot=ezrssfeed("http://slashdot.org/index.rss", 4, true(), false()}
This will load the feed from the given url, return the 4 first items, with channeldata, without imagedata, and store this in the variable slashdot., (*30)
Making sure the ezrssfeed is inside a {cache-block} is a very good idea, this will increase the performance of the site, and you won't download the feed everytime someone loads you page., (*31)
Some sites may ban you for a period of time if you request the feeds to often., (*32)
A complete example using the operator:, (*33)
{cache-block expiry=300}
{let feed=ezrssfeed("http://slashdot.org/index.rss", 10, true(), true() )}
<h2>
<a href="{$feed.image.link.content}"><img src="{$feed.image.url.content}" alt="{$feed.image.title.content}"></a>
<a href="{$feed.channel.link.content}">{$feed.channel.title.content}</a>
</h2>
<ul>
{section var=theitem loop=$feed.items}
<li><a href="{$theitem.link.content}">{$theitem.title.content}</a></li>
<p>{$theitem.description.content|shorten(80)}</p>
{/section}
</ul>
{/let}
{/cache-block}
The cacheblock has expiry of 300 seconds, which means the feed will be regenerated every 5 minutes., (*34)
If you want to see the data eZRSS returns put the following in a template:, (*35)
{let freshmeat_data=ezrssfeed("http://download.freshmeat.net/backend/fm-releases-unix.xml", 0, true(), true() )}
{$freshmeat_data|attribute(show)}
{/let}
Here we call ezrssfeed with a rssfeed url as a argument. The number of items is set to 0 which means every item in the feed., (*36)
And we download both the channeldata and it will then open the url, parse it and return the data. The attribute(show) displays all available data., (*37)
The solution is configured to work once properly installed and configured., (*38)
Some problems are more common than others. The most common ones are listed in the the doc/FAQ.md, (*39)
If you have find any problems not handled by this document or the FAQ you can contact Brookins Consulting through the support system: http://brookinsconsulting.com/contact, (*40)
v1.2 (2017-10-02) - Replaced eZXML library usage with DOMDocument for eZ Publish 5 Compatability. (5.x), (*41)
v1.1 ( 2006-08-21 ) - Added generation of timestamps for each item - Fixed broken parsing of some timestamps from the rss - Fixed some typos in the readme, (*42)
v1.0 ( 2005-02-13 ) - Initial release (3.x), (*43)
eZ Publish Legacy extension which provides a a configurable rssfeed toolbar for displaying rssfeeds on your site. It also contains a rssfeed template operator for fetching rssfeeds into a template with eZ Publish Legacy. Great for reports!
GPL-2.0+
template atom feed rss export ez publish operator