RUA Lite – Documentation

************* CHANGES  12-2016 ************

Fixed conflicts with new WordPress 4.7 core version.  Created new page templater system to work with new WordPress 4.7 and older versions.

After installing and activating the plugin, you need to setup some things first before RUA Blog Subscriber Lite can work properly.

************* IMPORTANT CHANGE ************

I have added a new settings field to the settings page entitled: “Your Blog Page URL”. PLEASE make sure you enter the URL of your Blog Page. Very important!


1. You need to create two pages with the exact name and URL in order for your users to subscribe and unsubscribe correctly. If you have a Subscription blog, you have to allow users the ability to unsubscribe from your blog in the emails. RUA Blog Subscriber Lite sends over this unsubscribe link using a specific URL. Also, in order for your users to successfully subscribe to your blog, a Subscribe link is sent to the users in an email using a specific URL. So making these two new pages are a MUST in order for RUA Blog Subscriber CORRECTLY!

2. Create an NEW page titled ‘Subscribe’. Make sure that the URL has this exact pattern: In the Template manager drop-down list, choose Subscribe (which is a special template) and then click Publish.

IMPORTANT – Do not place the subscription form or anything else on the “Subscribe” page or “Unsubscribe” page. These pages are specially reserved for the RUA plugin to work correctly. Putting anything in the Editor will cause errors in your subscribers being able to Subscribe to your blog.


3. Create an NEW page titled ‘Unsubscribe’. Make sure that the URL has this exact pattern: In the Template manager drop-down list, choose Unsubscribe (which is a special template) and then click Publish.



4. Now you need to go create your settings at the Email Subscribers Settings page which is located under the Settings menu in the Left Admin Bar. (Green Arrow on screenshot below).


5. How you need to place your settings in the appropriate input boxes and click ‘Save Settings’ button. Below is the list of settings and their descriptions:

  • Name: the name of your blog, website, company name or your personal name. (Required)
  • Site URL: the URL of your website (Required)
  • Address: the address of your company, business, etc.. (Optional)
  • City: the city of your company, business, etc. (Optional)
  • State: the state of your company, business, etc. (Optional)
  • Zip: the zip code of your company, business, etc. (Optional)
  • Phone Number: The phone number of your company, business, etc. (Optional)
  • From Email Subject: This is the subject of the email that will be sent to your subscribers. (Required)
  • From Email Address: This is the From email address of the email that is sent to your subscribers. (Required)
  • Custom Form Header: Green arrow below. This is the header that is displayed above the Subscribe Form on the website. (Optional)


  • Custom Button Text: Orange arrow above. This is the text that appears on the Submit Button of the Subscribe Form. (Optional)
  • Email Logo URL: This is the URL of the Image that will appear at the top of the emails that will be sent to your subscribers. (Highly Suggested)
  • How to get your Email Logo URL. Go to the Media Section in your WordPress website. Upload a new image or choose an image already in your Media library. Click on the image and on the right side of the screen there is the URL of the image. Select this URL, Copy and Paste it into the Email Logo URL input box.


  • Custom Success Message: This is the message that will appear at the top of the Subscribe Form upon a successfully User Subscription. (Required)


  • Your Email Logo: This is not a setting. This is just for you to see what your Email Logo looks like after saving the Email Logo URL setting. So once you place your Email Logo URL and click ‘Save Settings’ button, the image will be displayed in that area.


  • Lastly, the following settings are REQUIRED in order for the email to be sent. Without a subject or from email address will cause the email system to not work correctly.

6. Most of the settings above have to deal with the emails that are sent to your subscribers. Let’s take a look at the FIRST email that is sent to a subscriber after successfully completing the Blog Subscription Form on your website:

  • Pink arrow: This is the Email Logo Image that you saved in your settings
  • Blue arrow: This is a personalized opening using your subscriber’s name they entered in the Subscription Form.
  • Green arrow: This is the Confirmation Link. This allows a user to confirm their subscription. This button links directly to the Subscribe page that you created at the beginning along with special information that will be processed on the Subscribe page. AGAIN, this is why it is REQUIRED to name the Subscribe page correctly in order for the plugin to work correctly.
  • Orange arrow: This is where your other information shows up. So if you do not want to place your personal address information in the settings then it will NOT appear in the emails. Remember, the address settings are Optional.
  • Blue Links: The name and URL of your blog or website is required so it appears in the email with the correct link. So a user can just click on the link in the email to go directly to your website.


7. Ok, Now let’s get the Subscription Form on the page. Using this simple shortcode ruasubscriber  place this on a page or post as below:


8. To place the Subscription Form in a widget you will need to use the Shortcode Widget Plugin so you can place the ruasubscriber shortcode in a widget. Widgets alone cannot handle shortcodes, so you MUST use the Shortcode Widget Plugin in order to place the shortcode for the form in a widget. The Shortcode widget is a FREE plugin found in the WordPress Plugins Directory. The link is here: . Once you get this plugin installed and activated, in the widgets section, drag n drop the Shortcode Widget into your specific widget section. Now you can  place the ruasubscriber shortcode in the textbox. See below:


9. Dashboard Time: Now we have our plugin working let’s take a look at our dashboard to see our subscribers. To get to the dashboard, look for the ‘Email Subscribers’ menu in the left side Admin menu. Green arrow.


10. Dashboard Details:

  • Green arrow: Total Members: This is the total number of SUBSCRIBED Members. Not the total of users in the dashboard.
  • Orange arrow: This is a filter that allows for the number of subscribers to be displayed in the dashboard.
  • Blue arrow: This is a filter that allows you to filter between All, Subscribed, Unsubscribed and Unverified Users.
  • All means every user no matter what their Status is.
  • Subscribed Status: Subscribers that successfully filled out the Subscription Form, received the Verification email, clicked on the Confirm Link, successfully became Verified by reaching the Subscription page with a ‘You have been successfully subscribed message”. Getting this message is based on Verification keys and code within the Subscribe template that you used to create the Subscribe Page.
  • Unverified Status: Subscribers that successfully filled out the Subscription Form, but did not become Verified. This could happen for a number of possibilities: 1) User decided not to Confirm their subscription. 2) Email got blocked by Subscribers email provider. 3) Email got sent to spam by Subscribers email provider. 4) Email Delivery time might be very slow. 5) Your server cannot send emails. 6) Your server is having issues sending the emails. 7) Subscriber did not successfully get directed to the Subscribe page. 8) Subscribe page was not created correctly with the proper name and proper URL pattern. These are the most common issues of the Unverified status.
  • Unsubscribed Status: Subscribers that have clicked on the Unsubscribed Link in the New Blog Post Emails that are sent out upon new blog post creation.
  • Purple arrow: Search box. You can use this box to search for particular Subscribers.
  • Black arrow: Delete button. You can delete Subscribers.
  • Pink arrow: Unsubscribe Date. This shows the date: (Year, Month, Day) a person Unsubscribe from your blog.
  • White arrow: Status: You can view the status of each subscriber.
  • Yellow arrow: Shows the number of subscribers on the dashboard and how many total entries there are.
  • Red arrow: Pagination: Allows you to cycle through your subscribers.


11. So what does a New Blog Post created email looks like. Let’s take a look:

  • Orange arrow: View Post Button. This is a link to your blog post page.
  • Purple arrow: Unsubscribe Link. This is required in Blog subscription emails that are sent out. You must allow a person the ability to successfully unsubscribe form your blog. This link is a special link that uses the subscribers email address that will direct a  user to the Unsubscribe page. Yes, I know, again with the page creation requirements. It is imperative, that the Unsubscribe page is created correctly. There is special code on the Unsubscribe template that uses the subscribers email address in order to successfully Unsubscribe a person from your blog. Once a user unsubscribes from your blog their status will change to Unsubscribe.


12. What does a Successful Subscribe page look like:


13. What does a Successful Unsubscribe page look like:



14. If you experience any issues, please give us a chance yo fix your issue. We pride ourselves on Customer Service and promise to fix any issues with the plugin. There might be certain issues that we cannot control like Server permissions, special server modules in order send emails, etc.  There is a really SIMPLE plugin that allows you to check and see if your WordPress website can send emails. Here is the link: Also certain email providers can cause problems with emails being sent, like blocking or filtering your emails to spam. Again this is out of our control. We have tested and re-tested RUA Blog Subscriber many times and have not run into any issues so far. So if you experience any issues, please fill out a support ticket so we can help you. Thank you for trusting us to make your WordPress Blogging experience a Happy One! Check out some of our other products at our Shop page.