RSS Plug-In User Guide

Introduction

RSS plug-in is a small, very useful add-on for Oempro which users to fetch dynamic content from any RSS feed in their email campaigns and auto responders.

For example, you have a company website with a blog and you send monthly newsletter to your customers. You can just install this RSS plug-in to your Oempro and let it to fetch your latest 10 posts from your blog and insert into your email content automatically.

How To Get RSS Plug-In?

It's available in add-on store.

Installation

Installation is easy and takes only a few minutes to install. After purchasing and downloading the RSS plug-in, follow these steps to complete the installation:

Unzip the downloaded RSS plug-in package to your desktop
Go into the RSS plug-in directory
Upload the octrss directory under "upload" directory into your Oempro's /plugins/ directory on the server
Login to your Oempro administration area
Click "Settings" on the top right menu
Click "Plug-Ins" on the left menu
Click "Enable" button next to RSS plug-in on the list

That's all. Now, RSS plug-in is enabled and ready to use. However, there's one more step. You need to enable this plug-in for user groups you wish to authorize.

Click "User Groups" left menu link in settings page
Click on the user group you wish to authorize
Click "Permissions" tab
Go to "Plug-Ins" section and check "RSS Plug-In"
Save user group settings

Now, plug-in is ready to use for users of the authorized user group.

Upgrade

In order to upgrade RSS plug-in, simply download the latest version package from Octeth Client Area and unzip it. Then upload contents "upload" directory to your Oempro/plugins/ directory.

Then go to your Oempro administration area, click "Settings" on the top right menu and then click "Plug-Ins" on the left menu. Disable and enable your RSS plug-in and upgrade will be completed.

Quick Start Guide

Once RSS plug-in is enabled, there will be a new personalization option in campaign and auto responder email content editors.

We will explain how RSS plug-in works and how it can be implemented with an example.

Let's say you have an email campaign and you wish to include latest news from Octeth's blog in your email campaign.

This is the RSS feed URL which we are going to pull content from:

http://feeds.feedburner.com/life_at_octeth

Let's create a campaign from scratch step by step:

Login to your Oempro user area
Click "Create Campaign" link
Fill in requested information in campaign settings screen
Select "From Scratch" email content type
Enter your name and email address and click "Next"
Enter your subject: "Latest Octeth News"
Go into rich text editor and enter your email content as you wish
Now, move your mouse over percentage icon (%) on the rich text toolbar and a menu will appear. Go into "RSS" section on that menu and you will find all available RSS plug-in content tags.
Each RSS content blog should start with "RSS Fetching Start Tag" and end with "RSS Fetching End Tag". Between these two tags will be repeated with each entry fetched from the target RSS feed.
For this example, we have written the following HTML code to populate content from Google News RSS service:
Now save your email content and proceed to preview step
That's all. Just schedule your campaign and send it. Oempro will fetch RSS content for you and populate email content.

RSS Email Content Tag Reference

%RSS:[url]:[no. of items to fetch]%: This is the start tag. Everything between the start and end tag will be repeated for each RSS entry.; [url]: Enter the URL of the RSS feed; [no. of items to fetch]: Set how many feed items to be fetched and populated
%RSS:END%: This is the end tag. Every start tag must be closed with this end tag.
%RSS:TITLE:[length]%: Title of the RSS entry; [length]: Enter the number of characters to show for each title. Longer titles will be truncated.
%RSS:CONTENT:[length]%: Content of the RSS entry; [length]: Enter the number of characters to show for each entry content. Longer contents will be truncated.
%RSS:POST-LINK%: Link to the RSS feed entry
%RSS:COMMENTS-LINK%: Link to the comments of the RSS feed entry
%RSS:PUBLISH-DATE%: Date of the RSS feed entry publish
%RSS:AUTHOR%: Name of the RSS feed entry author