{"id":21842588,"url":"https://github.com/brookinsconsulting/ezrssfeed","last_synced_at":"2026-05-19T03:51:35.933Z","repository":{"id":62497507,"uuid":"105315311","full_name":"brookinsconsulting/ezrssfeed","owner":"brookinsconsulting","description":"The 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.","archived":false,"fork":false,"pushed_at":"2017-10-02T20:59:33.000Z","size":24,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-26T11:27:52.469Z","etag":null,"topics":["extension","ezpublish","ezpublishlegacy","feed","php","rss","xml"],"latest_commit_sha":null,"homepage":"http://projects.ez.no/ezrssfeed","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brookinsconsulting.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-09-29T20:41:37.000Z","updated_at":"2024-10-10T18:34:14.000Z","dependencies_parsed_at":"2022-11-02T11:46:23.757Z","dependency_job_id":null,"html_url":"https://github.com/brookinsconsulting/ezrssfeed","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brookinsconsulting%2Fezrssfeed","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brookinsconsulting%2Fezrssfeed/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brookinsconsulting%2Fezrssfeed/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brookinsconsulting%2Fezrssfeed/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brookinsconsulting","download_url":"https://codeload.github.com/brookinsconsulting/ezrssfeed/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244825654,"owners_count":20516592,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["extension","ezpublish","ezpublishlegacy","feed","php","rss","xml"],"created_at":"2024-11-27T22:12:34.022Z","updated_at":"2026-05-19T03:51:35.892Z","avatar_url":"https://github.com/brookinsconsulting.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# eZ RSS Feed\n\nThe 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\n\nVersion\n=======\n\n* The current version of eZ RSS Feed is 0.1.2\n\n* Last Major update: October 02, 2017\n\n\nCopyright\n=========\n\n* eZ RSS Feed is copyright 1999 - 2017 Brookins Consulting\n\n* See: [COPYRIGHT.md](COPYRIGHT.md) for more information on the terms of the copyright and license\n\nLicense\n=======\n\neZ RSS Feed is licensed under the GNU General Public License.\n\nThe complete license agreement is included in the [LICENSE](LICENSE.md) file.\n\neZ RSS Feed is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 2 of the License or at your\noption a later version.\n\neZ RSS Feed is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nThe GNU GPL gives you the right to use, modify and redistribute\neZ RSS Feed under certain conditions. The GNU GPL license\nis distributed with the software, see the file [LICENSE](LICENSE.md).\n\nIt is also available at [http://www.gnu.org/licenses/gpl.txt](http://www.gnu.org/licenses/gpl.txt)\n\nYou should have received a copy of the GNU General Public License\nalong with eZ RSS Feed in in the [LICENSE](LICENSE.md) file.\n\nIf not, see [http://www.gnu.org/licenses/](http://www.gnu.org/licenses/).\n\nUsing eZ RSS Feed under the terms of the GNU GPL is free (as in freedom).\n\nFor more information or questions please contact: license@brookinsconsulting.com\n\n\nRequirements\n============\n\nThe following requirements exists for using eZ RSS Feed extension:\n\n\n### eZ Publish version\n\n* Make sure you use eZ Publish version 5.x (required) or higher.\n\n* Designed and tested with eZ Publish Community Project 2017.1\n\n\n### PHP version\n\n* Make sure you have PHP 5.x or higher.\n\n\nFeatures\n========\n\n### Toolbar\n\nAs an example of usage there is a toolbar available\n\n### Operator\n\nThis solution provides the following eztpl operator:\n\n* Operator: `ezrssfeed`\n\n### Dependencies\n\n* This solution depends on eZ Publish Legacy\n\n\nUse case\n========\n\nThis solution was created to provide a simple way to fetch and display rss feed content within your own website templates.\n\n# Installation\n\n## Extension Installation via Composer\n\nRun the following command from your project root to install the extension:\n\n    ```bash\n    $ composer require brookinsconsulting/ezrssfeed dev-master;```\n\n## Extension Installation via Manual\n\nExtract the ezrssfeed.tar.gz in your eZ Publish Legacy extension directory. \n\n## Activate the extension\n\n### Activate the extension (via Admin)\n   Either in adminitration interface:\n     Go to \"Setup\"\n     Go to \"Extensions\"\n     Check the checkbox beside \"ezrssfeed\"\n     Click \"Activate\"\n\n### Activate the extension (via ini-files):\n     Add the following to your settings/override/site.ini.append.php file:\n```\n     [ExtensionSettings]\n     ActiveExtensions[]=ezrssfeed\n```\n\n# Usage\n\nThe 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.\n\n## Toolbar\nAs 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. \n\nThe toolbar makes it easy to add rssfeeds to your page. The settings are self explaining.\n\n## Template operator\n\nFor 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.\n\nThe available parameters are:\n* url: \n  The url of the feed to download\n  This parameter is required.\n* items: \n  The number of items to return (set to 0 for all items) \n  Default value: 4\n* channeldata: \n  Return channel data?\n  Default value: False\n* imagedata: \n  Return rssfeed image data?\n  This might not be avaiable in all feeds.\n  Default value: False\n  \n### Example Usage\n```\n{let slashdot=ezrssfeed(\"http://slashdot.org/index.rss\", 4, true(), false()}\n```\n\nThis will load the feed from the given url, return the 4 first items, with channeldata,  without imagedata, and store this in the variable slashdot.\n\n## Cache blocks\n\nMaking 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. \n\nSome sites may ban you for a period of time if you request the feeds to often.\n\nA complete example using the operator:\n```\n{cache-block expiry=300}\n  {let feed=ezrssfeed(\"http://slashdot.org/index.rss\", 10, true(), true() )}\n     \u003ch2\u003e\n       \u003ca href=\"{$feed.image.link.content}\"\u003e\u003cimg src=\"{$feed.image.url.content}\" alt=\"{$feed.image.title.content}\"\u003e\u003c/a\u003e\n       \u003ca href=\"{$feed.channel.link.content}\"\u003e{$feed.channel.title.content}\u003c/a\u003e\n     \u003c/h2\u003e\n    \u003cul\u003e\n    {section var=theitem loop=$feed.items}\n      \u003cli\u003e\u003ca href=\"{$theitem.link.content}\"\u003e{$theitem.title.content}\u003c/a\u003e\u003c/li\u003e\n      \u003cp\u003e{$theitem.description.content|shorten(80)}\u003c/p\u003e\n    {/section}\n    \u003c/ul\u003e\n  {/let}\n{/cache-block} \n```\nThe cacheblock has expiry of 300 seconds, which means the feed will be regenerated every 5 minutes.\n\n\nIf you want to see the data eZRSS returns put the following in a template:\n```\n{let freshmeat_data=ezrssfeed(\"http://download.freshmeat.net/backend/fm-releases-unix.xml\", 0, true(), true() )}\n     {$freshmeat_data|attribute(show)}\n{/let}\n```\nHere 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. \n\nAnd 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.\n\n\nTesting\n=====\n\nThe solution is configured to work once properly installed and configured.\n\n\nTroubleshooting\n===============\n\n### Read the FAQ\n\nSome problems are more common than others. The most common ones are listed in the the [doc/FAQ.md](doc/FAQ.md)\n\n\n### Support\n\nIf 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](http://brookinsconsulting.com/contact)\n\n\n# Changelog\n\nv1.2 (2017-10-02)\n  - Replaced eZXML library usage with DOMDocument for eZ Publish 5 Compatability. (5.x)\n\nv1.1 ( 2006-08-21 )\n - Added generation of timestamps for each item\n - Fixed broken parsing of some timestamps from the rss\n - Fixed some typos in the readme\n\nv1.0 ( 2005-02-13 )\n - Initial release (3.x)\n \n# Credits\n\n- Updated By: Brookins Consulting\n- Released By: Kristian Hole\n- Originally written by: Ole Morten Halvorsen\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrookinsconsulting%2Fezrssfeed","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrookinsconsulting%2Fezrssfeed","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrookinsconsulting%2Fezrssfeed/lists"}