From iThemes Codex
Revision as of 22:14, 16 June 2011 by Skylermoore (talk | contribs)
Jump to: navigation, search


EmailBuddy is an email newsletter solution for WordPress. This plugin allows you to place subscription forms around your site where visitors can subscribe to receive email updates. All of the information that is submitted to the subscription forms around the site is stored in organized lists that are groups or events.


Groups are used to store subscribers information. Then if you can use EmailBuddy to easily a mass email to everyone in that group. Since you can create multiple groups of email subscribers you can create more specific emails that you only send to certain groups.


Events are similar to groups since they are another way to store email subscribers. But events have the ability to schedule a date and time for when an event is going to happen. Since it is an event EmailBuddy has a feature that allows you to schedule email reminders that occur a set amount of time before the time that the event is scheduled for. The reminder emails can be scheduled for anywhere from an hour before the event to years before the event. Events allow for scheduling up to three reminders per event.


EmailBuddy has a built in system that allows you to easily create text-based emails. This system has a feature that allows you to access a list of predefined variables that you can easily add to your emails. Here is a list of those variables:

  • User's email address. {email_address}
  • Date and time when message is sent. {datetime}
  • URL to this site. {siteurl}
  • Unsubscribe link. {unsubscribe}
  • Name of blog. {blogname}
  • Subject of email. {title}
  • Custom field* Name. {custom_name}

The text wrapped in {} above are what will be added to the email then later will be changed to the variable that it is supposed to reference.

Subscription Forms

The subscription forms allow users to easily subscribe to your email newsletter. EmailBuddy adds the ability to add email subscription forms to posts, pages, and widgets.

Adding a subscription form to post or page

When the EmailBuddy plugin is activated on your site it adds a shortcode button to the posts and page editors.


If you want to add a email subscription form to a post or page all you have to do is click that button and a popup form will ask for all of the information needed to customize that form.


Here is a list of the different form fields and the details for what each field is asking for.
List to subscribe to - This is a drop-down option that has a list of groups and events to choose which list the subscription form will add the subscribers to.
Submit button text - Set what the text on the submit button says.
Confirmation text or redirect URL - This option allows you to set what the confirmation message is when a visitor submits a subscription form.
Input form text (optional) - This text will be the default text in the input box that asks for the visitors email.
Custom form inputs(Your Name) - If this box is checked then the submission form will add a field asking for the subscribers name.

Adding a subscription form to a widget area

Navigate to the Widgets area under Appearance in the WordPress Admin area. Drag the EmailBuddy widget into the widget area that you would like for it to display in and fill out the form with the information for the subscription form that you would like to add. A description of information that should be added to the form fields is provided in the adding a subscription form to a post or page section above.


  • Two types of lists: Events & Groups. Subscribers to each list may be auto-subscribed to another type of list.
  • Events:
    • Events allows you to schedule reminder emails for one-time or recurring events. Up to three email reminders may be sent per scheduled event.
    • Events may repeat on a regular basis (ie. daily, weekly, monthly, yearly)
  • Groups:
    • Groups function as containers of subscribers. This is useful for collecting groups of users for later sending broadcasts to. Groups can be used for newsletter or simply organization. For example, you may wish all users that subscribe to a certain event also be entered into a group to later send newsletters to.
  • Send mass mails & newsletters.
  • Manage user subscriptions.
  • Create & manage email messages to be sent.
    • Messages support detailed variables for customization such as (but not limited to):
      • User's email address.
      • Date/time
      • URL to site
      • Unsubscribe link
      • Name of blog
      • Title of this list
  • Import/export email addresses
  • Easily post subscription forms on your site using one of the available methods:
    • Widgets
    • Shortcodes to use anywhere in your posts
    • Easily insert via a button on the Add Posts page to add anywhere in your posts
  • Simple Style Manager for styling widgets, confirmation response, and subscription form.
  • Send user to any page of your site upon subscribing (or back to the same page)
  • Slide-down subscription confirmation for non-obtrusive stylish confirmation of their action.
  • Classes available for all components for advanced styling above the Simple Style Manager

Postponed Features

Custom welcome email upon subscription or validation after double opt-in.


Classes emailbuddy_pretext emailbuddy_posttext


Shortcode Format Example: [emailbuddy type="event" list="0" button="Subscribe" confirmation="Thank you for subscribing!" ]

Additional Resources

  1. Plugin Store
  2. PluginBuddy Tutorials
  4. Support Forums