General Settings

Once you install the free core WP RSS Aggregator plugin, you will be presented with a long list of general settings.

These general settings can be set from the Settings section under the RSS Aggregator menu item.

NOTE: When using the  Feed to Post add-on, many of the general settings are hidden and no longer applicable, since Feed to Post uses a different way of displaying the imported posts (without using the shortcode).  Click here to learn more.

Below is an explanation of each setting available in the WP RSS Aggregator general settings. Each setting is also explained in the video above if you prefer a more visual overview. 

To see a screenshot of the general settings see below:

Limit feed items stored by age

This is the maximum amount of time that feed items are allowed to stay stored on your site. Once this limit has been exceeded, the feed item will be permanently deleted from your site. Feed items already imported before setting this option will be deleted if they eventually exceed this age limit. Also, items in the RSS feed that are already older than this age will not be imported at all.

EXAMPLE: If you import a feed item today at 2pm, and set this option to delete any feed items that have been stored for more than one day, the imported feed item will be deleted tomorrow at 2pm.

Leave this box empty if you don’t want to set a limit.

Limit feed items stored per feed

This is the maximum number of imported items to keep stored for each individual feed source. Any feed source that has its own limit set will see that limit override this one.

When new items are imported and the limit for a feed source is exceeded, the oldest feed items for that feed source will be permanently deleted to make room for the new ones. If you already have feed items imported from a feed source, setting this option later may delete some of your already imported feed items in order to comply with the new limit.

EXAMPLE: You have just set this setting to limit the feed items stored per feed to 10. Your feed source has imported 10 feed items today and stored them on your site. Tomorrow, it finds 2 new feed items to import. In order to import the new feed items, the oldest 2 from the 10 imported today will be permanently deleted. The 2 newly imported feed items are now the newest ones in the list for this feed source.

Leave this box empty if you don’t want to set a limit.

Limit feed items per import

This option refers to the maximum amount of feed items to import per fetch, for each individual feed source.

EXAMPLE: If a feed source is set to fetch new feed items every 12 hours, and the next fetch finds that there are 8 new feed items to import, the plugin will only import 5 of them. Which ones are imported depends on the Import order option explained below.

The frequency of updates (how often the plugin fetches new feed items) is still determined by the  feed processing interval.

Import order

This is the order in which the feed items for every feed source will be imported.

  • Select “Any” if the order is not significant, say if you want all new feed items to be imported either way.
  • Select “Latest First” to import the most recent feed items first.
  • Select “Oldest first” to import the oldest feed items first.
EXAMPLE: If you set the plugin to import "Oldest first", and you have the same scenario as in the example for the Limit feed items per import option above, the from those 8 new feed items, the plugin will import the oldest 5.

So, if out of those 8 feed items, 2 have a published date of Monday 1st April, 3 have a published date of Tuesday 2nd April, and 3 have a published date of Wednesday 3rd April, the plugin will only import the oldest 5, which are the 2 from Monday 1st April and the 3 from Tuesday 2nd April.  

This setting is very useful when used with the Limit feed items per import option above.

Feed processing interval

This option determines how frequently the feed sources (that do not have  their own up date interval) should check for updates and fetch new feed items accordingly.

It is recommended to not have more than 20 feed sources that use this global update interval. Having too many feed sources updating precisely at the same time can cause the  WP Cron System to crash. You can learn how to stagger the imports for different feed sources here.

Unique titles only

This option allows you to choose whether to allow multiple feed items to have the same title. When enabled, if a feed item has the same name as a previously imported feed item, it will not be imported.

This can be useful in cases where permalinks change, or where multiple permalinks refer to the same title (from one or more feed sources). When ticking this box from within the general plugin settings, it will apply to ALL feed sources.

NOTE: An item is considered to be unique if no item with it’s permalink exists anywhere in the system. The items’ permalink in the feed is defined by the <link> tag, or the <guid> tag if its isPermaLink attribute is set to true. Once imported, the permalink is stored in the wprss_item_permalink custom field of the resulting posts.

Custom feed URL

This will be the URL of the custom feed located at http://yoursite.com/custom_feed_url

WP RSS Aggregator allows you to create a custom RSS feed that contains ALL of the feed items imported through the plugin. This setting allows you to change the URL of the custom feed to anything of your choice. This feed can then be used on any other site to import the same feed items imported into the first site.

NOTE: You may be required to refresh your permalinks after you change this setting, before it can take effect. You can do this by going to Settings > Permalinks from your Dashboard sidebar menu and clicking Save.

Custom feed title

The title of the custom feed mentioned above. This title will be included in the RSS source of the custom feed, in a <title> tag.

Custom feed limit

The maximum number of feed items to include in the custom feed mentioned above. The feed will always include the most recent feed items and leave out any of the older ones that do not fit within the limit.

Log level threshold

This is a debugging feature that is only to be used when trying to debug a problem with WP RSS Aggregator.

It offers a drop-down menu where each option determines how verbose the error log output will be. The error log can be located at RSS Aggregator > Debugging. Here’s a quick overview of your options:

  • Default : with this option, you (the admin) will only see new entries in the error log when something breaks. By default, this is the same as the Error level.
  • Error : this is currently the highest threshold.
  • Warning : this is used when things don’t go as planned, however the import can still continue.
  • Notice : this means that there is something that potentially needs attention.
  • Info : this refers to general events, such as the start and end of an import, or certain stages of an import, or summaries.
  • System : this provides more verbose information about system processes (the average user would rarely need to know about or use these)
  • None : no error log generated.
  • Error and below : this will include ALL entries in the log output. Many times, this is the level requested to be used by our support team when trying to debug an issue.
  • Warning and below : this will include anything from the Warning threshold down until System.
  • Notice and below : this will include anything from the Notice threshold down until System.
  • Info and below : this will include anything from the Info threshold down until System.

Certificate Path

This path to the file containing one or more certificates. These will be used to certify certificates over secure connection, such as when fetching a remote resource over HTTPS. The default is the path to the certificate file bundled with WordPress.

NOTE: This setting does not ever need to be changed by you or any other user. It should only be modified if requested to do so by a WP RSS Aggregator support engineer. In all the months that this option has been available, it has never needed to be changed.

Feed Request User Agent

The string to be used as the useragent for feed requests. If not empty, this exact string will be sent with every request made by WP RSS Aggregator for a feed source XML document. Some servers react in unexpected ways to the default value. In such cases, try changing this to something else.

The default value is determined by the SimplePie library, and reflects its name, version and build numbers, and some other information.

If you see an error similar to “ Failed to fetch feed “http://www.lindenwoodlions.com/rss.aspx”. The resource could not be retrieved because of a client error with code 404. Server returned 0 characters:” in the error log, but are able to access the feed source in the browser, then it is possible that the server is responding in an unexpected way to the useragent that is sent with each feed request. 

To fix this, try setting the Feed Request Useragent setting to something more standard, such as the useragent sent by a popular browser. The useragent sent by your browser could be a good start.

CLICK HERE to find your current Browser User Agent String.

Still need help? Contact Us Contact Us