Options

The options page

The plugin adds a configuration page labelled Email Users inside the settings panel of the administration interface.

The options you can set on the option page are:

  • Mail format: "HTML" or "Plain Text". This determines the format in which are sent the notification emails.
  • BCC limit: on some outgoing mail servers or hosts, there is a limit to the number of recipients that can be included in the Bcc field of the email. For most setups, you don't need to change this value. However, if you have a lot of registered users and your emails don't get sent, you could try setting that value to 30. For example, Dreamhost is a host that uses such a limitation.
  • Default notification subject and default notification body: those two fields will indicate how a notification email will be formatted. Depending on the mail format, you should use HTML syntax or not. There are a number of tags that can be included in those fields in order to customize the email according to the sender and the post. Those tags are:
    • %BLOG_URL%: the link to the blog
    • %BLOG_NAME%: the blog's name
    • %FROM_NAME%: the wordpress user name of the person sending the mail
    • %POST_TITLE%: the title of the post you want to highlight
    • %POST_EXCERPT%: the excerpt of the post you want to highlight
    • %POST_URL%: the link to the post you want to highlight

User permissions & capabilities

Email Users uses capabilities to define what users are allowed to do. Below is a list of the capabilities used by the plugin and the default user roles allowed to make these actions. If you want to change the roles having those capabilities, you should use the excellent Role Manager plugin.

Capability Description Default roles
manage-options Access this options page. Administrators only.
email_single_user Send an email to a single user. Administrators, editors, authors and contributors.
email_multiple_users Send an email to various users at the same time. Administrators, editors and authors.
email_users_notify Notify users of new posts. Administrators and editors.
email_user_groups Send an email to user groups. Administrators and editors.