Feeds
You can add as many Feeds as you like to Feedamic.
Each of your Feeds has a number of configuration options.
Sites
You can choose what sites you want your Feed to appear.
If you have a single site, you can leave this as "All Sites".
For multi-site users, you can choose what Sites the feed configuration applies to. This means that any filtering (such as Collection) will only apply to the content within this Site.
Title and Description
The Title and Description fields are core to a RSS and Atom feed - pretty self explanatory here too.
You also need to provide a handle to your feed - just like a handle in any of your Blueprints, this must be unique. Your handle will be used as part of the key for caching too.
Routes
Feedamic is built to create RSS and Atom feeds.
If you want Feedamic to generate a specific feed type, make sure to provide a Route.
Your routes will also be generated based on the Site configuration - whether that is a separate domain or a separate path, your routes are multi-site compatible.
If you leave a Rotue blank, that feed type will not be generated.
For advanced use cases, you can also choose to change the view for each feed type - or leave blank to use Feedamic's.
Filtering
You can choose to filter your feed in a number of different ways.
Collections
Every feed must be filtered by Collection - and that can be a single Collection, or multiple Collections.
The one condition here is that they all must be of the same type: either dated or not-dated. You cannot mix-and-match Collection types.
This is because we need to collate all of your Entries and sort them correctly: dated collections get sorted by the "date" field, where as ordered collections are sorted by the "order".
Taxonomies
You can add advanced Taxonomy Term filtering to your Feed, and apply groups of filter sets.
All of the sets will be applied with "and" logic alongside your other filtering options (making your feed smaller as more filters are applied), but within each set you can choose "and" or "or" logic.
In one of your sets, you could have "Apple" and "Banana", meaning only Entries tagged with both Apple and Banana will be included.
Or, you could have a set configured as "Apple" or "Banana", meaning Entries tagged with any of Apple or Banana will be included.
Scope
You can make a Scope in your app, and apply it to your Feed configuration.
Your app directory will be scanned and any Scopes found will be available to be selected.
Limit
For some sites, you may want your feed to include everything: but note it will get bigger as you publish more content.
Or, you can limit the number of Entries returned.
Field mappings
All of those Defaults apply here: rather than configuring every field for every feed every time, your defaults are inherited.
You can choose to either:
use the Defaults, or
customise for this feed
For some field types, you can also choose to disable the field.
You're able to map:
Title
Summary
Content
Image (and if enabled, Image Dimensions)
Author (type and handles)
Copyright
You can choose to use the default Copyright message, customise it for the feed, or disable it.
Author
These are the fallback Author Name and Email strings for when no author is found for an Entry.
You can either use your defaults, or customise them for the feed.
Models
Alt URL
Some site configurations may want to set a different URL for the feed.
If you're unsure, leave this blank to use the Site's URL.