Installation and Setup

Here’s how to install the Related RSS Plugin.

THE ACME TAG

The ACME Tag makes our custom field tags obsolete. It will appear in your page and post editor and allows you to more easily customize your feeds.

INSTALLATION

Download the Related RSS Plugin to your desktop, or some folder you can easily find. The plugin is a zip file.

  • Log into your WordPress Blog as Admin
  • Click the Plugins menu.
  • Click Add New
  • At the top of the page, click the “Upload” link.
  • On the Upload page, you’ll see a Browse button. Click it, and in the File Upload window, navigate to the folder where you downloaded the plugin’s zip file.
  • Choose the zip file and then “Open” or “Select” in the File Upload window.
  • You’ll now be back on the Plugin Upload page. Click the Install Now button.
  • WordPress will now upload the file.
  • When the upload is complete, WordPress should report that the upload was successful, and ask you if you would like to Activate the plugin.
  • Click the Activate link.
  • Your Related RSS Plugin is now installed.

SETUP INSTRUCTIONS

Once the plugin is installed, follow these Setup instructions. First, we’re going to make the Plugin settings. Later, we’ll make the Widget’s settings.

PLUGIN SETTINGS

Scroll down to the bottom of the page and find the Related RSS menu. Click it, then click Settings.

  • FEED: Choose the feed you’d like to use on your site. You can choose between Google News and Bnig News. You can also choose “Custom” for the Feed URL and type in any valid RSS feed you want in the next field.
  • FEED URL: Once you click the feed, the proper syntax for that feed will appear in the Feed URL field. You can customize the feed’s URL if you want to add or change parameters.
  • DEFAULT TAGS: Most pages will have their own tags or custom fields that will be used for that page’s feed. But for pages without tags or custom fields to determine the keywords for the feed, the Related RSS Plugin will use the default tags as the keywords for the feed. Enter your default tag in the Default Tag field.
  • POST FIRST TAG: By default Related RSS uses the first tag of each post to generate a unique feed on your post pages. Not all tags will generate a feed, so if you wish to disable this function until you can check your tags, disable “Post First Tag”
  • SPREAD THE WORD: Help us spread the word about the Related RSS Plugin. Clicking this checkbox will put a link at the bottom of your feed to the Related RSS Plugin website. THANK YOU!
  • AFFILIATE PROGRAM: Join our affiliate program. Put your affiliate link in this field and the “Spread the Word” link will include your affiliate URL.
  • SAVE: After you are done making your settings, click the “Save Settings” button.

WIDGET SETUP

 


Click the Appearance Menu, and then Widgets.

Drag the Related RSS Widget into the sidebar where you’d like the Related RSS Feed to appear.

Click the title bar for the Related RSS Widget to open the widget.

  • TITLE: Enter a title for this Feed. Note that this title is the same for all of the pages where this widget will appear, regardless of the tags or keywords used for that feed. So, either use a generic title that could reasonably apply to the feed regardless of the topic, or use [keywords] in the title so that the actual words used for that page’s feed will show up in the title (ie “[keywords] News” will display as “Baseball News” for a page or post where “Baseball” is the keyword, and as “Football News” for pages or posts where “Football” is the topic.)
  • EXCLUDE: You can prevent the Related RSS feed from showing on any page or pages by typing a list of the page or post IDs you want to exclude.
  • NUMBER OF ITEMS: You can decide how many items you would like to have appear in the feed.
  • DISPLAY ITEM CONTENT: If you would like to display only the headlines for each news item, uncheck this box. If you’d like to display text as well, check this box.
  • CHARACTERS TO SHOW: If you are displaying item content, you can limit how much text for each story to show by entering a number into this field.
  • DISPLAY ITEM AUTHOR: Click this box if you’d like to show the item’s content, if available.
  • DISPLAY ITEM DATE: Click this box if you’d like to show the item’s date, if available.
  • OPEN LINKS IN NEW WINDOW: Click this box if you would like to open a new window when users click the item links.
  • SAVE: When you are done making your settings, click SAVE.

CUSTOM FIELDS

 


There are two custom field options which can be used in both posts and pages to generate unique sidebar feeds.   Using this option will override the first tag feature as well as default posts.

Inside your post or page editor look for the “Custom Fields” form below the editor box.  If you do not see it you need to enable it via the screen options tab at top of dashboard.

If you wish to enter in specific keywords for your feed provider instead of using the first tag you would enter RRSSFEEDKEYWORDS in the Name field, and your desired keywords in the Value field.  See graphic: (Note, if you have Version 1.5 and above, you can use our ACME Tag for your tags instead)

 

 

If you wish to enter a specific feed with your desired keywords included or perhaps just a standard feed you would enter RRSSFEEDURL in the Name field, and your desired feed in the Value field.  See graphic:

Please note in this graphic there is a plus sign between dog and training.  Certain feeds separate multiple keywords in different ways so please make sure you know the format for your feed.  Our plugin takes care of this for our default setup, but can’t override this field.

UPGRADE INSTRUCTIONS

 


In order to upgrade the Related RSS plugin to the latest version you first need to download the latest version from our customer area here.

Then you would deactivate and delete the existing plugin, (Don’t worry your settings will be saved)  And then upload and activate the zip file via Plugins > Add New.

Please watch this video if you need more assistance.

PHP INCLUDE CODE

 


In Version 1.1 we added the ability to insert php code into a theme template to display the plugin.  Some advanced users wanted this flexibility so we’ve added it.

In a nutshell, here’s the code snippet you’ll add:

<?php

$RRSSInstance = array(
'title' => 'Feed [keywords]', // Give the feed a title. Tag can be inserted [keywords]
'items' => 5, // How many items would you like to display?
'show_summary' => 1, // Display item content?
'show_summary_limit' => 50, // Content characters to show.
'show_author' => 1, // Display item author if available?
'show_date' => 1, // Display item date?
'exclude' => 0, // Exclude Comma separated Page IDs.
'target' => 0, // Open links in new window?
'nofollow' => 0, // Add No-Follow to links?
);
the_widget('Widget_Related_RSS', $RRSSInstance, array());

?>

We’ve also added some video instruction on this in the second half of the video above.

IF YOU NEED SUPPORT…
Contact Us Here