This page introduces my new WordPress plugin called WP-Form-Mail. You can use it to create e-mailable forms on your blog pages.

Download the plugin from here (version 0.4, ZIP, 3 KB) and simply extract the plugin archive into your WordPress plugins directory and activate the plugin. That was the installation! (Note. WordPress 2.0 or newer recommended. Might work with older WordPresses, but is not tested.)

After plugin is activated, go to Dashboard » Options » WP-Form-Mail to change plugin options. Most importantly you need to define which e-mail address the forms are submitted to. Despite being able to create many e-mailable forms, only one destination address can be specified. Note that only one form per page is supported! Although the forms can be inside posts as well, this is not recommended, because many posts can be included on one page (e.g. an archive page).

In the options you can also specify a style class for the DIV in which the submit result is printed. By default it is wp_form_mail_info, but you can change this to whatever. Make sure that there is a style class with that name specified!

In order to create a e-mailable form, you have three custom tags at your disposal.

  • [wp-form-mail-info] specifies where the result info box is placed. Recommended to be placed directly above the form so that the user knows the form is submitted properly.
  • [wp-form-mail-field] marks the position of hidden form field. Must be placed inside the form element!
  • [wp-form-mail-self] can be used in the form’s action attribute, and will be replaced with the current REQUEST_URI. However, simply omitting the action attribute will achieve the same result.

Please note that as there is no security scheme of any kind implemented, by using this plugin you are probably inviting a lot of automated form spam to your selected e-mail address. In the future a CAPTCHA shall be included with this plugin however.

Leave a Reply

Your email address will not be published. Required fields are marked *