RSjoomla! - Quality Joomla! Components

My Account






Lost Password?
No account yet? Register

Newsletter Subscribe

If you would like to be one of the first people to hear about the release of our new components then make sure you have subscribed to our announcements list! We won't bug you with unnecessary stuff.




RSform!Pro Logo User Guide

Emails 

With RSForm 2.0, you can send custom emails to the users that submitted the form. Naturally, you can customize RSForm 2.0 to send another email to you, as administrator. These two types of email are configured separately, in the two corresponding tabs of the back-end form management. In both cases, you can use simple placeholders to display information.
Because both forms are identical, we will cover them both

Let's see what fields can be configured.

  • Email Form data to: the address where the email should be sent.
  • Email Form data FROM: whenever the user receives the email, this will be be the senders' address (i.e. from who the mail came from).
  • Email From Name: whenever the user receives the email, this will be be the senders' name (i.e. the person's name the mail came from).
  • Email Subject: the subject of the email.
  • Email Mode: you can send your email as plain text, or, if you wish to add more `color' to your message, you can send a HTML email.
  • Email Text: the actual text of the email. If you set the last parameter (Email mode) to HTML, then you'll be able to put here HTML code, for a nicer email look.

    Important note! If you write here HTML tags BUT haven't set the Email mode option to HTML, the HTML tags will not be interpreted and the user, instead of seeing a nice bold message, may see something like Hello dear user in his email. Please take caution.

In all of these fields you can use placeholders to write important data. We defined for your ease of use general and form specific placeholders. Form specific placeholders are used just like layout placeholders are. Supported options for component placeholders are:

  • value: this returns the value typed by the user in the corresponding component.
  • name: the name of the component, as defined in the back-end.
  • caption: the caption of the component, as defined in the back-end.

Let's see a short example. Suppose that among others, your form has a text field that required the user to input his/her name. This component is called user_name. If you want to use that value in your user message, write this in your email text field: language=HTML commentstyle= basicstyle= tabsize=2



If an user typed `Albert Einstein', the email that he would receive after he submitted the form will be: language=HTML commentstyle= basicstyle= tabsize=2



Let's see now the second category, general placeholders. General placeholders are used like this:

{global:placeholder_name}
Consult the following table for all the placeholders supported.

Placeholder name Description Logged in user required?
username If the user is registered to your Joomla website, his username will appear when using this placeholder Yes
userid If the user is registered to your Joomla website, his user id will appear when using this placeholder Yes
useremail If the user is registered to your Joomla website, his email will appear when using this placeholder Yes
fullname If the user is registered to your Joomla website, his fullname will appear when using this placeholder Yes
userip The IP of the user that submitted the form No
date_added The date the user submitted the form No
sitename The name of your site, as defined in your Joomla configuration No
siteurl The URL of your site No



So, let's say that in the admin e-mail you want to track the IP address of your submissions. Just add {global:userip} in your admin email message and every time you receive an email, the IP of the user that submitted the form will appear.

How to send a email on specific address depending on the selected checkbox [Read All]

In this article we will describe how to send a mail to a specific recipient selected through a checkbox.

We will first need to create the checkbox components. Note that we will be using different components for every checkbox that we wish to create.

Example:

1. Name: email1
    Items: email1@email.com|Send to email1

2. Name: email2
    Items: email2@email.com|Send to email2

In "Admin Emails" tab just fill in the "To:" field with {email1:value},{email2:value}