RUA Pro – Documentation

NEW OPTIONS

************* CHANGES Coming Soon  2017 ************

Added Import from CSV file. 

  1. Format your CSV file so the columns match the RUA database table. See example CSV file above. You can read more documentation on the RUA Import settings page.

2. Click the Blue button to chose the CSV file from your computer.

3. Once you have chosen the file, click the Green Import to DB button.

4. If everything is successfully, you will see a Green Success message other wise you will receive a Red Error message.

5. Check your dashboard.

 

 

Fixed subscribe / unsubscribe templates for translation.

Added CSS classes for Form Error Messages

************* 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.

************* CHANGES  9-2016 ************

Added two new features.

  1. An email is sent to site admin email address upon new subscriber.
  2. This was the MOST requested feature. Only ONE email is sent upon Published Post. No more emails sent when you Edit your post. So you can now edit your post as many times as you like and you will not bother your subscribers.

 

************* CHANGES  8-2016 ************

Added a New Tools page. Moved export by Excel to this page. Added export by CSV. The bottom of this page displays system and plugin information for better support.

ruatoolsMore Customer requested options! Added new Options to send Published Posts by a single Category. In order to get this working, you would need to turn “ON” the Turn Off all posts settings and then choose the category you want your email notifications to be sent. So for example, you would Select ON for the Turn Off All Posts setting. This would block all email notifications for All Posts. Now choose which Category you would like emails to be sent.

** Important**  If you add a Category and do not see it in the list, this is because you do not have at least ONE post attached to that category. You need to have at least ONE post with that category in order to see it in the list. Just create a test post, select your new category. Then go back to the Email Settings page and it will show up in the list. Now create a post with that Category and it will then work. This is how the WordPress get_categories function works. In order for it to show up in the list, there must be at least ONE post attached to that category. After you have multiple posts using that Category, then feel free to go back and delete your original Test post you created with your Category.

ruapostsbycat

************* CHANGES  7-2016 ************

Customers ask for new options. We deliver.

You can now send New Post Publication emails on a Custom Post Type. I have added a new setting where you can choose a Custom Post Type slug from one of your Custom Post Types in your WordPress website and your Subscribers will be sent an email notification when a new Custom Post Type was published. RED BOX: new drop-down list that lists the slug name of your Custom Post Types available.

rua-cpt

Now you can MANUALLY Add or EDIT your subscribers from the backend.

I added a new sub-page which appears below the Email Subscribers Menu titled: ADD/EDIT Subscribers. (Red Arrow). The first form on the page allows you to Add a subscriber from the back end. You need to add the name, email, subscriber status, site id and Subscribe Date. When done Click the Save Subscriber Button (Purple Arrow).

rua-manual-1

The next form is Pick Email Subscriber for Editing. Until you Pick a Subscriber there will no NO Edit Form(Orange Arrow). This form shows a drop-down menu list (Blue Arrow) of all of your subscribers. Choose the subscriber you which to edit and Click the Pick Subscriber button(Green Arrow). Once you click this button the third form (Orange Box) will appear which is for editing the Subscriber that you picked using the second form (Pick Subscriber). With the Edit Form, you can change the Subscribers name, email, subscriber status, site id, and subscriber date. You cannot change the Subscriber ID. This is there for reference only. Once you are done with your changes, Click the Save Subscriber Button below the third form. The form will process, save your changes and BE PATIENT. The page refreshes to update your Subscriber List in the Pick Subscriber Form. Need to make more changes, pick another Subscriber from the Pick Subscriber Form again and repeat.

 

rua-manual-2

************* CHANGES 6-2016 ************

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!

rua-blog

HOW TO  SETUP THE RUA BLOG SUBSCRIBER PLUGIN

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

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 Pro 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: http://yourwesbsite.com/subscribe/. 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.

rua-subscribe-page

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

rualiteunsubpage

 

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).

ruapro3

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)
  • Site Contact Form URL: This setting is for your to place the URL of your website contact page or some page where your subscribers can find help. This link appears on the Subscribe and Unsubscribe pages whenever there is a failure/error upon subscribing or unsubscribing. (Required)
  • Form Header: Green arrow below. This is the header that is displayed above the Subscribe Form on the website. (Optional)
  • Form Header Size: Blue arrow below. This is the size of the Customs Form Header, h1, h2. h3, h4, h5, h6. (Optional)
  • Form Background Color: Orange arrow below. This is the background color of the Subscribe Form. (Optional)
  • Form Text Color: Purple arrow below. This is the color of the text on the Subscribe Form. (Optional)
  • Form Button Color: Red arrow below. This is the background color of the Submit Button. (Optional)
  • Form Button Text Color:Yellow arrow below. This is the color of the text for the Form Submit button. (Optional)
  • Form Button Text: White arrow below.  This is the color of the text on the Subscribe Form. (Optional)

 

ruapro9

  • 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.

emaillogourl

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

rualitesuccess

  • 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.

ruapro6

  • 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.

rualite6

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

rualite99

8. To place the Subscription Form in a widget you will need to use the Shortcode Widget Plugin so you can place the rua[subscriber 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: https://wordpress.org/plugins/shortcode-widget/ . 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:

rualite88

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.

ruapro11

10. Dashboard Details:

  • Blue arrow: Total Members: This is the total number of SUBSCRIBED Members. Not the total of users in the dashboard.
  • Green arrow: This is a filter that allows for the number of subscribers to be displayed in the dashboard.
  • Orange arrow: This is a filter that allows you to filter between All, Subscribed, Unsubscribed and Unverified Users.
  • All means every users 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.
  • Red arrow: Search box. You can use this box to search for particular Subscribers.
  • Pink arrow: Delete button. You can delete Subscribers.
  • White arrow: Unsubscribe Date. This shows the date: (Year, Month, Day) a person Unsubscribe from your blog.
  • Yellow arrow: Status: You can view the status of each subscriber.
  • Black arrow: Shows the number of subscribers on the dashboard and how many total entries there are.
  • Aqua arrow: Pagination: Allows you to cycle through your subscribers.
  • Purple arrow: Export button, Allows you to export your subscribers to an Excel spreadsheet by Status.

ruapro91

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.

rualite8

12. What does a Successful Subscribe page look like:

rua-pro-sub

13. What does a Successful Unsubscribe page look like:

rua-pro-unsub

14. Custom Emails: With the RUA Blog Subscriber version you can elect to send custom emails for both new subscriber email and new blog post published emails. Let’s take a look: The custom emails sent in a panel. You can click back and forth between the two different email version by clicking on the panel headings. Purple arrow: Custom Email for Blog Subscribers. Red arrow Custom Email for Published Post. This screenshot is for New Blog subscribers. Enable Custom Emails: Green arrow below:  allows you to enable/disable the ability to send a custom email. Enable Default Email Footer: Orange arrow below: allows you to enable/disable the ability to display the default footer. The default footer is the email footer that contains the Blog Website link, the address, etc. Yellow arrow shows the email editor. Here you can create the BODY of your custom emails. Each email already comes personalized with ‘Hi, Username,’. Then will be the Custom Email Body, and then the default footer if enabled.

ruapro4

 

15. Custom Email for Published Post: This screenshot for Published Post. Green arrow below:  allows you to enable/disable the ability to send a custom email. Enable Default Email Footer: Red arrow below: allows you to enable/disable the ability to display the default footer. The default footer is the email footer that contains the Blog Website link, the address, etc. Yellow arrow shows the email editor. Here you can create the BODY of your custom emails. Each email already comes personalized with ‘Hi, Username,’. Then will be the Custom Email Body, and then the default footer if enabled. Enable View Post Button: Orange arrow below: allows you to enable/disable the View Post button.

ruapro10

16. Email Editor. Here you can create the BODY of your custom emails. Each email already comes personalized with ‘Hi, Username,’ see Orange arrow below. Then will be the Custom Email Body that you can create, and then the default footer if enabled. Green arrow below, shows the default footer being disabled. When writing custom emails in the editor, you have access to some template tags:

  • {site_name} – Your site name
  • {site_url} – Your site URL
  • {site_email_logo} – Your site Email Logo
  • {site_address} – Address of your Company/Website/Business
  • {from_email_address} – The FROM email address

So within the email body your would type {site_name} and the name of your site will appear in the email. In order to create paragraphs and line breaks, just use normal HTML formatting such as paragraph tag and line break tag.

17. OK. Are you ready to see what a Custom Email would look like? Here is a custom email using some of the template tags and using HTML formatting for headers, paragraphs and line breaks.

ruaproemail1

18. Here is a custom email without any formatting and the default footer enabled.

ruaproemail2

 

19. 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: https://wordpress.org/plugins/check-email/ 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.