Simple:Press Documentation

Plugin: HTML Emails

Plugin Description

Plugin: HTML Emails – This Simple:Press plugin allows emails from the forum to be sent in HTML format including using templates for CSS, header, and footer.

Plugin Features

Note: Independent of this plugin, the following email related link and screen exist.

  • An “Email Settings” sub-menu entry under the Admin Forum menu “Options” entry linked to the “Options – Email Settings” admin screen.
  • An “Options – Email Settings” admin screen with a “New User Email” section, a “Email Address Settings” section, and a “Report Post” section if the Simple:Press Report Post to Admin plugin is activated. Each section has radio buttons and text input boxes for specifying options.The “Help” link should be used for assistance in setting up the options.
    • The HTML email plugin’s “HMTL Emails – New User Email” admin screen option can override settings on the “Options – Email Settings” admin screen.

Installing this Simple:Press plugin adds:

  • A new “HTML Emails” section in the Plugin Management panel under the Admin menu path Forum – Plugins – Available Plugins. From this panel the Simple:Press “HTML Emails” plugin can be activated, or deleted by the admin.

Activating this plugin provides:

  • A change to the new “HTML Emails” section in the Plugin Management panel under the Admin menu path Forum – Plugins – Available Plugins so the Simple:Press “HTML Emails” plugin can be deactivated, uninstalled, and have it Options set. The “Options” selection links to the existing “Options – Email Settings” admin screen mentioned above.
  • A new “HTML Emails” menu entry under the Admin Forum menu with sub-menu entries “HTML Global Settings”, “Admin New Posts”, “New Users”, “PW Changed”, “Mentions” (if the Mention and Tag Users plugin is activated), “Report Post” (if the Report Post to Admins plugin is activated),”New PM” (if the Private Messaging plugin is activated),”Subscriptions” (if the Subscriptions – Topic and Forum plugin is activated), and “Digests” (if the Subscriptions – Topic and Forum plugin is activated and its email digest option has been selected). These menu links provide new admin screens for specifying the characteristics of the various HTML emails.
  • A new “HTML Emails – Global Settings” admin screen with a “Global CSS” section, a “Global Header” section and a “Global Footer” section. Each section has text input boxes for specifying options.The “Help” link should be used for assistance in setting up the options.
  • A new “HTML Emails – Admin New Post Notifications” admin screen with an “Options” section, and a “Format Email” section. Each section has either radio buttons or text input boxes for specifying options. The “Help” link should be used for assistance in setting up the options.
  • A new “HTML Emails – New User Email” admin screen with an “Options” section, a “Format User Email” section, and a “Format Admin Email” section. Each section has either radio buttons or text input boxes for specifying options. The “Help” link should be used for assistance in setting up the options.
  • A new “HTML Emails – Password Changed” admin screen with an “Options” section, a “Format User Email” section, and a “Format Admin Email” section. Each section has either radio buttons or text input boxes for specifying options. The “Help” link should be used for assistance in setting up the options.
  • If the Simple:Press Mention and Tag Users plugin is activated, a new “HTML Emails – Mentions Email” admin screen with an “Options” section, and a “Format User Email” section. Each section has either radio buttons or text input boxes for specifying options. The “Help” link should be used for assistance in setting up the options.
  • If the Simple:Press Report Post to Admins plugin is activated, a new “HTML Emails – Report Post Email” admin screen with an “Options” section, and a “Format User Email” section. Each section has either radio buttons or text input boxes for specifying options. The “Help” link should be used for assistance in setting up the options.
  • If the Simple:Press Private Messaging plugin is activated, a new “HTML Emails – New PM Email” admin screen with an “Options” section, and a “Format User Email” section. Each section has either radio buttons or text input boxes for specifying options. The “Help” link should be used for assistance in setting up the options.
  • If the Simple:Press Subscriptions – Topic and Forum plugin is activated, a new “HTML Emails – Subscription Notification Email” admin screen with an “Options” section, and a “Format User Email” section. Each section has either radio buttons or text input boxes for specifying options. The “Help” link should be used for assistance in setting up the options.
  • If the Simple:Press Subscriptions – Topic and Forum plugin is activated and the digest option has been selected by the admin, a new “HTML Emails – Subscription Digest Email” admin screen with an “Options” section, and a “Format User Email” section. Each section has either radio buttons or text input boxes for specifying options. The “Help” link should be used for assistance in setting up the options.

There are no new permissions added to the permission sets due to this plugin.

Plugin Requirements

Simple:Press version 5.5.7 and above is required.

The following Simple:Press plugins must be activated and their options set up for their associated HTML Email sub-menu entry and administrative screen/panel to be displayed allowing set up of HTML Email functionality for them:

  • Mention and Tag Users for “Mentions” sub-menu entry and related admin panel.
  • Report Post to Admins for “Report Post” sub-menu entry and related admin panel.
  • Private Messaging for the “New PM” sub-menu entry and related admin panel.
  • Subscriptions – Topic and Forum for “Subscriptions” sub-menu entry and related admin panel.
    • With its “digest email” option selected for “Digests” sub-menu entry and related admin panel.

The Simple:Press plugin must be installed, activated, and its options set before it is operational.

As part of the installation, a “HTML Emails” section is added to the Plugin Management panel under the admin menu Forum – Plugins – Available Plugins. From this panel the HTML Emails plugin can be activated, deactivated, uninstalled, deleted, or its options set up using its “Activate/Delete” and “Deactivate/Uninstall/Options” selections.

There are no new permissions added to the permission sets due to this plugin.

The plugin does not have template tags incorporated into current themes so developing a Custom or Child Theme to accommodate any desired template tag changes is not needed before installing this plugin. Information on Child Themes is located on our Creating a Child Theme page. Information on creating and installing themes is located on our Creating a Custom Theme page.

Plugin Installation and Activation

Please see Using Plugins on how to obtain and install the Simple:Press HTML Email plugin.

As mentioned there, the default location for Simple:Press plugin folders is …/wp-content/sp-resources/forum-plugins. If this path is changed, it is important to note that the plugin’s folder and its content need to reside in the forum plugins folder wherever it has been moved and however it has been renamed. See Storage Locations for more information.

Activation is accomplished from the Admin Dashboard panel menu by selecting “Forum” and then “Plugins” from the drop down Forum Admin menu. On the Simple:Press Administration panel select the “HTML Emails” plugin on the “Plugin Management” panel and click on “Activate”. The “Activate/Delete” label changes to “Deactivate/Uninstall/Options”. To deactivate the plugin, click on “Deactivate”. The “Deactivate/Uninstall/Options” label changes to “Activate/Delete”.

Plugin Administrative Options

After activation, a) on the aforementioned “Available Plugins” page and “Plugin Management” panel , click “Options” on the “HTML Emails” plugin section or b) under the “Options” entry on the forum menu on the left side forum admin page click the “Email Settings” sub-menu item to get the “Options – Email Settings” panel.

  • Options – Email Settings Screen
    • A review of this screen is being provided for reference even though it is not a direct result of the HTML Emails plugin.
  • Selecting “New User Email” Options
    • In this section, these settings allow one to tailor emails sent to new users following registration to the site and forum. There is full control over type of email version used. If the defaulted Simple:Press version is used, there is full control over both the Email Subject Line and the content of the Email Message.
    • Email Type:
      • Use of the Simple:Press new user email version is set as the default. If one prefers the standard WordPress email version – or are using another plugin that is capable of generating the new user email, then turn the forum option off and the alternative version will be used in it’s place.
      • Click on the green colored radio button to the left of the text “Use the Simple:Press new user email version” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is gray.
      • Click on the “Update Email Options” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update Email Options” button until all desired changes have been made.
    • Note:
      • The following keywords can be used as placeholders within the email and will be replaced by their values when the email is sent. It is very important to to enter these into the message text exactly as shown and the very minimum that should be used are the User Name and Password:
        • %USERNAME%
        • %PASSWORD%
        • %BLOGNAME%
        • %SITEURL%
        • %LOGINURL%
        • %NEWLINE%
      • Note the use of %NEWLINE% to end paragraphs.
      • Also, since emails are sent plain text, HTML is not allowed in the message.
    • Email Subject Line:
      • If the Simple:Press option at the top of the section is selected, insert the desired Email subject line text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update Email Options” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update Email Options” button until all desired changes have been made.
    • Email Message (no html):
      • If the Simple:Press option at the top of the section is selected, insert the desired Email Message text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update Email Options” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update Email Options” button until all desired changes have been made.
  • Selecting “Email Address Settings” Options
    • Note: This section is not affected by the Simple:Press HMTL Email plugin.
    • The term ‘WordPress’ is used as the sender of any email from within the system unless the setting in this section are used. These settings allow one to override that and enable the use of any email address preferred. These are the email address components that will be used in forum emails.
    • Use Simple:Press settings:
      • Use of the Simple:Press email setting is set as the default. If one prefers the standard WordPress email settings, then turn the forum option off .
      • Click on the green colored radio button to the left of the text “Use the following email settings” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is gray.
      • Click on the “Update Email Options” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update Email Options” button until all desired changes have been made.
    • The senders name:
      • If the Simple:Press option at the top of the section is selected, insert the desired sender’s name text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update Email Options” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update Email Options” button until all desired changes have been made.
    • The email from name:
      • If the Simple:Press option at the top of the section is selected, insert the desired email from name text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update Email Options” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update Email Options” button until all desired changes have been made.
    • The email domain name:
      • If the Simple:Press option at the top of the section is selected, insert the desired email domain name text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update Email Options” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update Email Options” button until all desired changes have been made.
  • Selecting “Report Post” Options
    • If the Simple:Press Report Post plugin is activated and set up, one can allow users (via permissions) to report posts with questionable content.
    • Note: This section is not affected by the Simple:Press HMTL Email plugin.
    • Report post email address list:
      • One can enter a comma separated list of email addresses to receive a reported post. When someone reports a post with questionable content, this list of email addresses will receive the question post report email.
      • Click on the “Update Email Options” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update Email Options” button until all desired changes have been made.

From the Forum Admin menu on the left of admin pages, open the “HTML Emails” entry to see the sub-menu and select “HTML Global Settings”.

  • HMTL Emails- Global Settings Screen
  • Global CSS
    • In this section, one can create optional – and standard – CSS rules that can be applied to the HTML Emails.
    • Note: Do NOT include HTML Script tags around your CSS rules. These will be automatically added by the processor at email construction time.
    • On each of the HTML Email Admin Panels one can then select whether to include the global CSS, Header and Footer.
    • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
  • Global Header
    • In this section, one can create optional – and standard – header block that can be applied to the HTML Emails.
    • Note: Do NOT include HTML html, head or body tags. These will be automatically added by the processor at email construction time.
    • On each of the HTML Email Admin Panels one can then select whether to include the global CSS, Header and Footer.
    • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
  • Global Footer
    • In this section, one can create optional – and standard – footer block that can be applied to the HTML Emails.
    • Note: Do NOT include HTML closing body or html tags. These will be automatically added by the processor at email construction time.
    • On each of the HTML Email Admin Panels one can then select whether to include the global CSS, Header and Footer.
    • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.

From the Forum Admin menu on the left of admin pages, open the “HTML Emails” entry, to see the sub-menu and select “Admin New Posts”.

  • HTML Emails – Admin New Post Notifications Screen
  • Selecting “Options” Options
    • In this section, one can enable HTML formatting for the admin new post notifications. One can also select whether to make use of any global CSS, Header or Footer HTML.
    • Enable admin notification emails in HTML:
      • Use of the Simple:Press admin notification emails in HTML is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Enable admin notification emails in HTML” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Use global CSS, header and footer:
      • Use of the Simple:Press global CSS, header and footer is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Use global CSS, header and footer” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
  • Selecting “Format Email” Options
    • On this panel, one can use an HTML template for formatting the admin new post notifications.
    • Email subject line (no html allowed):
      • One can create a template for the email subject, though no HTML is allowed in the subject. For the subject, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the subject. The allowed subject placeholders are:
        • %BLOGNAME%
        • %TOPICNAME%
      • If the “Enable admin notification emails in HTML” option is selected at the top of the panel, insert the desired email subject line text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Email message (html allowed):
      • One can also create a template for the email body with HTML allowed. For the email body, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the body. The allowed body placeholders are:
        • %BLOGNAME%
        • %GROUPNAME%
        • %FORUMNAME%
        • %TOPICNAME%
        • %POSTERNAME%
        • %POSTEREMAIL%
        • %POSTERIP%
        • %POSTURL%
        • %POSTCONTENT%
      • If the “Enable admin notification emails in HTML” option is selected, insert the desired email message text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.

From the Forum Admin menu on the left of admin pages, open the “HTML Emails” entry, to see the sub-menu and select “New Users”.

  • HTML Emails – New Users Screen
  • Selecting “Options” Options
    • In this section, one can enable HTML formatting for the new user emails.  NOTE: use of this HTML Email option will override the New User Email settings on the “Options – Email Settings panel seen at forum – options – email settings. One can also select whether to make use of any global CSS, Header or Footer HTML.
    • Enable new user emails in HTML:
      • Use of the Simple:Press new user emails in HTML is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Enable new user emails in HTML” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Use global CSS, header and footer:
      • Use of the Simple:Press global CSS, header and footer is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Use global CSS, header and footer” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
  • Selecting “Format User Email” Options
    • On this panel, one can use an HTML template for formatting the emails sent to new users.
    • Email subject line (no html allowed):
      • One can create a template for the email subject, though no HTML is allowed in the subject. For the subject, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the subject. The allowed subject placeholders are:
        • %BLOGNAME%
        • %USERNAME%
      • If the “Enable new user emails in HTML” option is selected at the top of the panel, insert the desired email subject line text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Email message (html allowed):
      • One can also create a template for the email body with HTML allowed. For the email body, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the body. The allowed body placeholders are:
        • %USERNAME%
        • %PASSWORD%
        • %BLOGNAME%
        • %SITEURL%
        • %LOGINURL%
      • If the “Enable new user emails in HTML” option is selected at the top of the panel, insert the desired email message text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
  • Selecting “Format Admin Email” Options
    • On this panel, one can use an HTML template for formatting the emails sent to the admin for new users.
    • Email subject line (no html allowed):
      • One can create a template for the email subject, though no HTML is allowed in the subject. For the subject, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the subject. The allowed subject placeholders are:
        • %BLOGNAME%
        • %USERNAME%
      • If the “Enable new user emails in HTML” option is selected at the top of the panel, insert the desired email subject line text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Email message (html allowed):
      • One can also create a template for the email body with HTML allowed. For the email body, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the body. The allowed body placeholders are:
        • %USERNAME%
        • %USEREMAIL%
        • %USERIP%
        • %BLOGNAME%
      • If the “Enable new user emails in HTML” option is selected at the top of the panel, insert the desired email message text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.

From the Forum Admin menu on the left of admin pages, open the “HTML Emails” entry, to see the sub-menu and select “PW Changed” (Password Changed).

  • HTML Emails – Password Changed Screen
  • Selecting “Options” Options
    • In this section, one can enable HTML formatting for the password changed emails. One can also select whether to make use of any global CSS, Header or Footer HTML.
    • Enable password changed emails in HTML:
      • Use of the Simple:Press password changed emails in HTML is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Enable password changed emails in HTML” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Use global CSS, header and footer:
      • Use of the Simple:Press global CSS, header and footer is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Use global CSS, header and footer” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
  • Selecting “Format User Email” Options
    • On this panel, one can use an HTML template for formatting the emails sent to users who request to change their password.
    • Email subject line (no html allowed):
      • One can create a template for the email subject, though no HTML is allowed in the subject. For the subject, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the subject. The allowed subject placeholders are:
        • %BLOGNAME%
        • %USERNAME%
      • If the “Enable password changed emails in HTML” option is selected at the top of the panel, insert the desired email subject line text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Email message (html allowed):
      • One can also create a template for the email body with HTML allowed. For the email body, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the body. The allowed body placeholders are:
        • %USERNAME%
        • %USEREMAIL%
        • %USERIP%
        • %BLOGNAME%
        • %SITEURL%
        • %RESETURL%
      • If the “Enable password changed emails in HTML” option is selected at the top of the panel, insert the desired email message text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
  • Selecting “Format Admin Email” Options
    • On this panel, one can use an HTML template for formatting the emails sent to the admin when a user requests to change their password.
    • Email subject line (no html allowed):
      • One can create a template for the email subject, though no HTML is allowed in the subject. For the subject, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the subject. The allowed subject placeholders are:
        • %BLOGNAME%
        • %USERNAME%
      • If the “Enable password changed emails in HTML” option is selected at the top of the panel, insert the desired email subject line text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Email message (html allowed):
      • One can also create a template for the email body with HTML allowed. For the email body, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the body. The allowed body placeholders are:
        • %USERNAME%
        • %USEREMAIL%
        • %USERIP%
        • %BLOGNAME%
      • If the “Enable password changed emails in HTML” option is selected at the top of the panel, insert the desired email message text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.

From the Forum Admin menu on the left of admin pages, open the “HTML Emails” entry, to see the sub-menu and select “Mentions”.

  • HTML Emails – Mentions Email Screen
    • This screen is only available if the Simple:Press Mention and Tag Users plugin is activated and set up.
  • Selecting “Options” Options
    • In this section, one can enable HTML formatting for the emails sent to a user when they are mentioned in a post (if the Simple:Press Mention and Tag Users plugin is activated and set up for email). One can also select whether to make use of any global CSS, Header or Footer HTML.
    • Enable mentions emails in HTML:
      • Use of the Simple:Press mentions emails in HTML is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Enable mentions emails in HTML” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Use global CSS, header and footer:
      • Use of the Simple:Press global CSS, header and footer is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Use global CSS, header and footer” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
  • Selecting “Format User Email” Options
    • On this panel, one can use an HTML template for formatting the emails sent to to a user when mentioned in a post (if the Simple:Press Mention and Tag User plugin is activated and set up for email).
    • Email subject line (no html allowed):
      • One can create a template for the email subject, though no HTML is allowed in the subject. For the subject, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the subject. The allowed subject placeholders are:
        • %BLOGNAME%
        • %MENTIONBY%
      • If the “Enable mentions emails in HTML” option is selected at the top of the panel, insert the desired email subject line text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Email message (html allowed):
      • One can also create a template for the email body with HTML allowed. For the email body, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the body. The allowed body placeholders are:
        • %BLOGNAME%
        • %GROUPNAME%
        • %FORUMNAME%
        • %TOPICNAME%
        • %POSTURL%
        • %USERNAME%
        • %MENTIONBY%
        • %SITEURL%
      • If the “Enable mentions emails in HTML” option is selected, insert the desired email message text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.

From the Forum Admin menu on the left of admin pages, open the “HTML Emails” entry, to see the sub-menu and select “Report Post”.

  • HTML Emails – Report Post Email Screen
    • This screen is only available if the Simple:Press Report Post to Admins plugin is activated and set up.
  • Selecting “Options” Options
    • In this section, one can enable HTML formatting for the emails sent to the admin users when a post is reported as improper (if the Simple:Press Report Post to Admins plugin is activated). One can also select whether to make use of any global CSS, Header or Footer HTML.
    • Enable report post emails in HTML:
      • Use of the Simple:Press report post emails in HTML is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Enable report post emails in HTML” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Use global CSS, header and footer:
      • Use of the Simple:Press global CSS, header and footer is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Use global CSS, header and footer” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
  • Selecting “Format User Email” Options
    • On this panel, one can use an HTML template for formatting the emails sent to an admin when a post is reported as improper (if the Simple:Press Report Post to Admins plugin is activated).
    • Email subject line (no html allowed):
      • One can create a template for the email subject, though no HTML is allowed in the subject. For the subject, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the subject. The allowed subject placeholders are:
        • %BLOGNAME%
        • %REPORTER%
      • If the “Enable report post emails in HTML” option is selected at the top of the panel, insert the desired email subject line text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Email message (html allowed):
      • One can also create a template for the email body with HTML allowed. For the email body, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the body. The allowed body placeholders are:
        • %BLOGNAME%
        • %GROUPNAME%
        • %FORUMNAME%
        • %TOPICNAME%
        • %POSTURL%
        • %POSTCONTENT%
        • %POSTREPORT%
        • %REPORTER%
        • %SITEURL%
      • If the “Enable report post emails in HTML” option is selected, insert the desired email message text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.

From the Forum Admin menu on the left of admin pages, open the “HTML Emails” entry, to see the sub-menu and select “New PM”.

  • HTML Emails – New PM Email Screen
    • This screen is only available if the Simple:Press Private Messaging plugin is activated and set up for emails.
  • Selecting “Options” Options
    • In this section, one can enable HTML formatting for the emails sent to a user when they receive a private message (if the Simple:Press Private Messaging plugin is activated). One can also select whether to make use of any global CSS, Header or Footer HTML.
    • Enable new private message emails in HTML:
      • Use of the Simple:Press private message emails in HTML is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Enable new private message emails in HTML” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Use global CSS, header and footer:
      • Use of the Simple:Press global CSS, header and footer is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Use global CSS, header and footer” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
  • Selecting “Format User Email” Options
    • On this panel, one can use an HTML template for formatting the emails sent to a user when they receive a private message (if the Simple:Press Private Messaging plugin is activated).
    • Email subject line (no html allowed):
      • One can create a template for the email subject, though no HTML is allowed in the subject. For the subject, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the subject. The allowed subject placeholders are:
        • %BLOGNAME%
        • %SENDER%
      • If the “Enable new private message emails in HTML” option is selected at the top of the panel, insert the desired email subject line text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Email message (html allowed):
      • One can also create a template for the email body with HTML allowed. For the email body, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the body. The allowed body placeholders are:
        • %BLOGNAME%
        • %PMTITLE%
        • %PMCONTENT%
        • %INBOXURL%
        • %SENDER%
        • %SITEURL%
      • If the “Enable private message emails in HTML” option is selected, insert the desired email message text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.

From the Forum Admin menu on the left of admin pages, open the “HTML Emails” entry, to see the sub-menu and select “Subscriptions”.

  • HTML Emails – Subscription Notification Email Screen
    • This screen is only available if the Simple:Press Subscriptions – Topic and Forum plugin is activated and set up.
  • Selecting “Options” Options
    • In this section, one can enable HTML formatting for the emails sent to a user when a new post is made to a subscribed forum/topic(if the Simple:Press Subscriptions plugin is activated). One can also select whether to make use of any global CSS, Header or Footer HTML.
    • Enable subscription notification emails in HTML:
      • Use of the Simple:Press subscription notification emails in HTML is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Enable subscription notification emails in HTML” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Use global CSS, header and footer:
      • Use of the Simple:Press global CSS, header and footer is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Use global CSS, header and footer” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
  • Selecting “Format User Email” Options
    • On this panel, one can use an HTML template for formatting the emails sent to a user when a new post is made to a subscribed forum/topic(if the Simple:Press Subscriptions plugin is activated).
    • Email subject line (no html allowed):
      • One can create a template for the email subject, though no HTML is allowed in the subject. For the subject, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the subject. The allowed subject placeholders are:
        • %BLOGNAME%
        • %TOPICNAME%
      • If the “Enable subscription notification emails in HTML” option is selected at the top of the panel, insert the desired email subject line text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Email message (html allowed):
      • One can also create a template for the email body with HTML allowed. For the email body, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the body. The allowed body placeholders are:
        • %BLOGNAME%
        • %GROUPNAME%
        • %FORUMNAME%
        • %TOPICNAME%
        • %POSTURL%
        • %POSTCONTENT%
        • %POSTER%
        • %SITEURL%
      • If the “Enable subscription notification emails in HTML” option is selected, insert the desired email message text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.

From the Forum Admin menu on the left of admin pages, open the “HTML Emails” entry, to see the sub-menu and select “Digests”.

  • HTML Emails – Subscription Digest Email Screen
    • This screen is only available if the Simple:Press Subscriptions – Topic and Forum plugin is activated and set up with its subscription digest email option selected.
  • Selecting “Options” Options
    • In this section, one can enable HTML formatting for the emails sent to a user for their subscription digests (if the Simple:Press Subscriptions plugin is activated and the digest email option has been selected). One can also select whether to make use of any global CSS, Header or Footer HTML.
    • Enable subscription digest emails in HTML:
      • Use of the Simple:Press subscription digest emails in HTML is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Enable subscription digest emails in HTML” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Use global CSS, header and footer:
      • Use of the Simple:Press global CSS, header and footer is set as the default. If one prefers to not use them, then turn the forum option off.
      • Click on the green colored radio button to the left of the text “Use global CSS, header and footer” to deselect the Simple:Press option. The radio button is deselected when its color is gray. Select the Simple:Press option by clicking the gray radio button. The radio button is selected when its color is green.
      • Click on the “Update ” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
  • Selecting “Format User Email” Options
    • On this panel, one can use an HTML template for formatting the emails sent to a user for their subscription digests (if the Simple:Press Subscriptions plugin is activated and the digest email option has been selected).
    • Email subject line (no html allowed):
      • One can create a template for the email subject, though no HTML is allowed in the subject. For the subject, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the subject. The allowed subject placeholders are:
        • %BLOGNAME%
        • %TYPE%
      • If the “Enable subscription digest emails in HTML” option is selected at the top of the panel, insert the desired email subject line text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Email header (once at top – html allowed):
      • One can also create a template for the email body header with HTML allowed. This body header is output once at the beginning of the digest email. For the email header, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the body. The allowed body placeholders are:
        • %BLOGNAME%
        • %TYPE%
        • %PROFILEURL%
        • %SITEURL%
      • If the “Enable subscription digest emails in HTML” option is selected at the top of the panel, insert the desired email header text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Email message (once per topic – html allowed):
      • One can also create a template for the email body with HTML allowed. The email body is output once per subscription entry in the digest. For the email body, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the body. The allowed body placeholders are:
        • %BLOGNAME%
        • %GROUPNAME%
        • %FORUMNAME%
        • %TOPICNAME%
        • %POSTURL%
        • %POSTCONTENT%
        • %COUNT%
        • %SITEURL%
      • If the “Enable subscription digest emails in HTML” option is selected, insert the desired email message text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.
    • Email footer (once at bottom – html allowed):
      • One can also create a template for the email body footer with HTML allowed. The email body footer is output once at the end of the digest email. For the email footer, several placeholders are allowed for inserting email specific values. To use a placeholder, insert the appropriate placeholder where it is to appear within the body. The allowed body placeholders are:
        • %BLOGNAME%
        • %TYPE%
        • %PROFILEURL%
        • %SITEURL%
      • If the “Enable subscription digest emails in HTML” option is selected at the top of the panel, insert the desired email footer text into the input box. If the default text is acceptable, no input is required.
      • Click on the “Update” button to save the setting if no other changes are to be made in this or other sections of the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.

Plugin Language Translation

A plugin’s message strings can be translated from English to other languages and then the translation displayed if language translation files are available. Some plugins may not have such files.

Information regarding downloading language files, “mo’ language file placement, and translation (language localization) is found at Localization.

More information is available regarding translation files at Simple:Press Translations. On the base page, select the “Getting Started Guide” link for basics about it’s use. On that page, select the “register a username here” link to obtain a password to the site. Use the “Contact Form” link to request the desired language if it is not currently available. The “Contact Form” link may also be used to volunteer to be a validator for a translation project.

The HTML Emails plugin’s available language translation files with translation statistics, and message translations can be viewed at HTML Emails Translations. Select the Version link to see the languages available. Select the link for the desired language to see forum messages and their available translations. If available, export the file for the selected language to its proper forum language sub-folder as a “mo” file using the export link at the bottom of the page displaying the actual message translations for the language selected.

The default location for plugin language files is …/wp-content/sp-resources/forum-language/sp-plugins. If this path is changed, it is important to note that the plugin’s language file needs to reside in the language sub-folder for sp plugins wherever it has been moved and however it has been renamed. See Storage Locations for more information.

Plugin Usage

Forum admins use this plugin to set up the administrative options. Forum admins and forum users observe the results in emails they received.

Plugin Special Notes

Some of the admin screens provided by this plugin will only be displayed if the Simple:Press plugin associated with that screen is activated and its options set up.

Template Tags Used in the Plugin

There are no Template Tags available for this plugin that allows the admin to further customize it’s usage or otherwise customize the website.

Actions and Hooks Used in the Plugin

There are no Actions and Hooks available in Template Tags for this plugin.

There are no other Actions and Hooks available for this plugin.

Plugin and Template Tag Changelog

Since Simple:Press version 5.5.0.

Codex page sync’d to code version 5.5.3.

More Topics In SimplePress: Plugins


Copyright © 2006-2019 Simple:Press. All Rights Reserved.