RSS Post Importer - Adding RSS Feeds
There's no limit on the number of feeds that can be created. Each feed is a process that imports content on a continuous basis after being set up.
From the WordPress dashboard navigate to CM RSS Post Importer Pro → RSS Feeds. Then click on the Blue 'Add RSS Feed' button at the top of the page.
- Give the Feed a name and then begin configuring it.
- Feed URL - The source URL of the feed. (e.g. http://example.com/music/charts/topfourty.rss) Make sure the source you are trying to import is a valid RSS feed. You can check this by using the validate link. Also please visit our troubleshooting guide as some site block importing posts from their site.
- Processing Interval - How often the plugin will run and import any new RSS content added. If you set this number to run frequently this may slow your site depending on the number of posts available on the source site. Make sure you understand the impact of the frequency on your site's performance.
- Fetch Limit - The limit to the number of RSS posts that the Plugin will fetch from the source. Even if the source has more posts the plugin will only import the amount set. If you don't set any limit it will bring everything.
- Since date limit - The limit to how far back the RSS Post Importer will search back for posts to add. The since date is relevant to the date which appears in the original post metadata (when the post was written). This is an optional filter and, if not set, no timeframe limit will be set when importing posts.
The format used in this case can be a specific date - for example 2017-05-01 or a text describing how many days back from current day to fetch article in the following format.
See the PHP 'strtotime' documentation for how to structure these dates correctly.
- Until date limit - The upper date limit or until when the RSS Post Importer plugin will search for posts to add using the original date shown in the pst metadata. (both the 'Since date limit' and the 'Until date limit' will search without limits if left empty).
- Match keywords (comma separated) - Will import posts only if they contain the keywords defined in this text area.
This is an important feature which lets you filter the posts you are importing based on keywords found in the post content. You can list many keywords and if ONE of the keywords is found the post will be imported
- Exclusion keywords (comma separated) - Will import posts only if they do not contain keywords defined in this text area.
You can list many keywords in this list. In case only ONE of the exclusion keywords will be found the post will not be imported.
By clicking on 'customize' it is possible to change the way posts are imported using the RSS Importer Plugin. The Title, Description and Content have the same Configuration options.
- Word Limit - Limits the number of words from the beginning of the text body that will be imported. You can also trim the number of words by using the parameter trim_words=x in a shortcode, being x the number of words.
For example if you want display on the first 55 characters of the title you can use [rss_feed_item_title trim_words=55]. This also applies to the description or content shortcodes.
- Strip all HTML tags - Removes all HTML tags (such as <h1>, <h2> ,<strong> etc.), importing nothing but a plain text version of the original feed.
You can use a parameter inside the shortcode. For example [rss_feed_item_title strip_all_tags=1]
Clicking on 'customize' for the Image shortcode produces different configuration options.
- Height - Sets the height of the imported image in pixels.
- Width - Sets the width of the imported image in pixels.
- CSS class name - Allows for a class name to be applied to the image for further styles to be applied using CSS styling.
This parameters can also be used inside the image shortcode as per the following example [rss_feed_item_image height=55 width=100 class=funcybox]
The final three shortcodes cannot be modified and are simply there to allow for some reference information to be added to the imported post after import to credit the original content creators.
- Permalink - Includes the URL address of the original article. You can use this shortcode [rss_feed_item_permalink] in case you want to print out the URL of the article in the content or elsewhere in the imported post
- Date - Includes the Publish date of the article. You can use this shortcode [rss_feed_item_date] in case you want to print out the URL of the article in the content or elsewhere in the imported post. The format attribute of the date is taken from the PHP format and can be changed in many ways. Please check the following guide http://php.net/manual/en/function.date.php for more options
- Source - Includes the URL of the RSS feed source that has been imported. For example if the permalink is https://www.cminds.com/blog/wordpress/10-wordpress-glossary-plugins/ then the source will be https://www.cminds.com
Finally the Add New XML Tag button can be used to Create new Shortcodes. Tags can be given a Name and then the shortcode attributes added between the square braces.
This is an important feature that can support processing additional metadata tags which are found in the post rss feed. For example in case the feed includes a price tag. You can add the tag description in the section and then use it elsewhere in the post template
Post Template (Export)
Once the RSS is imported the RSS Importer Plugin works to Export the post onto your own site. The following settings determine how this output will appear and what attributes it will have.
- Post Type - Choose what kind of post it will be. A page, a custom post type or something else. The default is a WordPress post
- Category - The category that imported posts will fall under can be configured here. This applied only if the post type created on your site is a regular "Post"
- Alternatively the checkbox below can be checked to Use category from feed item. Doing this will use the original category. If this does not exist on your site it will create it.
- Categories cannot be created manually here in the Post Template section. To add new categories this must be done before in Posts → Categories.
- Status - Determines the publish status of the Post. It can be published automatically, saved as draft or held for revision. It can also be set as private.
- Author - Chooses which Site user will be set as the Author for Imported posts.
- Published on - Choose between the original Publication date and the Import date as the date to be used for the publication date to appear on your site.
rel="nofollow"to links - Adds the nofollow attribute to links in the post. This is important for search engine which are indexing your site in case you dont want them to follow the links included in the important articles.
- Set featured image - Downloads and saves the featured image to the WordPress media of your site. Once found it will also be set as the featured image for the saved post. You can also use the featured image as a shortcode using the following [rss_feed_item_image]
The Template can be altered using the shortcodes shown above or with some manually entered text. You can also apply the relevant parameters to each of the shortcodes.
After completing the configuration for the Feed remember to Save. Either as a Draft by clicking ' Save Draft' or as a Published Feed by clicking 'Publish' on the upper right of the page.