Admin
Purple RSS
17min
purple hub introduction purple feed allows publishers to generate rss feeds following rss 2 0 specification from contents in the purple hub you can define various feeds based on a variety of filters you can then access these feeds either through the purple manager url (default setting) or through a custom domain prerequisites have an administrator role in purple hub the following setting must be activated to use purple feeds the "purple ds hub purple rss" plugin must be activated configuration create a new feed use "purple rss" > "add feed" from menu add a feed title click "configure feed" you will then see the "edit feed" page edit a feed base information (required) feed title string name your feed (e g sports) feed slug string to edit the automatically created slug, use the \[ edit slug ] button beside the label the slug is unique and will automatically be set to a unique slug if one like this already exists feed base target uri string tell the rss service on which url the feed is running (how to display the article links in the feed) you can configure the custom domain e g , if the article must be accessible at https //www yourdomain com/ subdir /\[ article slug ], "subdir" must be defined here feed image select you can select a thumbnail from your media library to enrich the rss feed with a teaser image content filter the content filter defines what articles will be delivered within the feed, so you can set categories to be included into the feed the feed will always only deliver published articles by dragging the elements from the lower list to the upper list (or empty area, if no filter was defined), the filter will be created automatically all arguments are connected with an and relation if you choose one category, the content belonging to this category is displayed in the feed if you select two, only content, that belongs to both categories get displayed e g if you select the categories 'sports' and 'regional', only the articles that belong to both categories, 'sports' and 'regional', get displayed articles, only belonging to one of both, wouldn’t get listed in the rss feed additional information include post contents on delivery checkbox allows to pass the whole article text to external services if checked, an item will contain the element \<content\ encoded> with full article content this is interesting for external text to speech services (like bot talk) or newsletter use cases example create a 'newsletter' category in purple hub, write a newsletter article, add the article to the category 'newsletter' and create an rss feed, containing articles with the category 'newsletter' to ingest this article to your newsletter rss function include featured image on delivery checkbox enrich the rss feed with a teaser image if checked, an item will contain the element \<enclosure> with attributes url that has the url of the featured image length with bytes of the image type with mime type information limit number of items int the maximum number of items that will be returned from the purple content cloud feed description string a descriptive text about your feed feed category string a definition of the category/categories your feed belongs to combine multiple categories with a slash "/" has no correlation with the filter category copyright string contains the copyright information of your feed ttl int the ttl argument will be used by automatic feed readers as time between automated feed calls in min the default setting is 60 minutes language select language setting is only available if the hub is set up with polylang as a multi language hub if you set this information, the language information will be added to the feed the feed items still depend on your selected filter options feed type mediarss as a default, the feed type for rss feeds is "rss 2 0" however, it is possible to change this to "mediarss" by changing the feed type dropdown for this feed type, it is possible to configure an acf field that will be displayed for the media\ credit tag for the featured image the description field of the image will be shown as media\ description tag include acfs when you have custom properties configured for articles (see create custom fields in purple hub docid\ sfolj8v8qcn3m3jibzbuk ), you can configure the rss feed to also include this information for each field, you can configure which tag name will be used for each article, custom tags will then be added to the rss items, as seen below custom tag names need to be prefixed with purple to adhere to the rss standard resulting rss feed item \<item> \<title>example article with extra info and isins\</title> \<link>https //test de/example article with extra info and isins\</link> \<purple\ isin xmlns\ purple="https //schema purplepublish com/feeds">isin value 1\</purple\ isin> \<purple\ isin xmlns\ purple="https //schema purplepublish com/feeds">isin value 2\</purple\ isin> \<purple\ extrainfo xmlns\ purple="https //schema purplepublish com/feeds">this is the acf extra info of the article\</purple\ extrainfo> \<description /> \<category>uncategorized\</category> \<pubdate>wed, 08 may 2024 08 41 43 gmt\</pubdate> \<author>erik brendel\@sprylab com\</author> \<guid>daab79cd e503 4711 ba44 c9a72b9c17f4\</guid> \</item> publish feed if all required information is set and saved, this will publish your feed with the saved configuration save feed properties this will save feed properties in our database make sure to save your changes before leaving the configuration screen updating a feed configuration if you want to modify your feed configuration and publish your updates, please follow these steps modify your feed configuration as needed (for example "change tts from 60 > 90" ) click on the "save feed properties" button in the lower left this will persist the latest configuration in our database click on "publish feed" in the upper right of the configuration screen this will update your feed with the latest configuration note always save your properties before updating/publishing a feed otherwise your changes will not be published view feed depending on your hub environment, the final feed uris differ prod https //feeds purplemanager com/\[ team id ]/\[ feed slug ] staging https //feeds staging purplemanager com/\[ team id ]/\[ feed slug ] dev https //feeds dev purplemanager com/\[ team id ]/\[ feed slug ]