CM Curated RSS Aggregator (CMCRA) - Getting Started (With Video)
How It Works
Prefer a Complete Step-by-Step?
Check our use case guide:
CM Curated RSS Aggregator displays lists of links gathered from RSS feed/feeds. Feeds are assigned to categories that are organized into lists (each category can have a single feed assigned to it).
This guide will walk through the process of setting up the plugin.
Setting Up in Three Steps
You can set up the plugin in three quick steps.
- Create a List. It will be displayed on your website.
- Create a Category. It will include feeds and place them inside a list.
- Include the List on a page or post.
Create a List
Lists will be displayed on your website. They can contain multiple categories and, as such, many feeds.
To create a simple links list go to Admin Dashboard → CM Curated RSS Aggregator → List. Create a new list. Now you'll be able to assign categories to that list.
Learn more about lists in the specific guide.
Create a Category and Connect it to the Related Lists
Go to Categories and create a new one. Pass the feed URLs and write the feed name.
The following images highlight only essential fields. To learn more about this screen, check the specific guide on Categories.
a) Write the category title
b) Include the feed URLs, one per line.
Note: starting from version 1.1.8, the plugin supports FeedBurner links.
c) Define the match and exclusion keywords.
It's possible to filter the content by using match keywords and exclusion keywords.How it works Only content that has the match keywords and doesn't have the exclusion keywords will be shown.
For example, you can set a feed to only include items that have the word soccer in them by inputting "soccer" as a positive keyword. And, by writing "international, league" in the negative keywords field, articles with the words "international" or "league" will be left out.
The effect of positive and negative words can be combined. With this example, only content without the words "international" and "league" and with the word "soccer" will be displayed. This assures that you can display links that are dealing with that specific topic.
d) Assign this category to any number of existing lists.
Learn more about categories in the specific guide.
Include the List on a Post/Page
Paste the shortcode to your post/page.
You can display specific lists by using the "list" attribute. For instance, the following would only show the "Test List" list: .
Learn more about shortcodes in the specific guide.
Remember: you can use shortcodes in many ways. Examples of what you can do:
- Show one list only on a page (by applying a list attribute on the shortcode)
- Show multiple lists on the same page (by applying specifying multiple list attributes on the shortcode)
- Show different lists on different pages (by applying different list attributes on different versions of the shortcode)
Congratulations! You've set up your first list. You will find more in-depth resources in the Guide Index.