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! Logo User Guide

Manage forms 

In this screen you can see all your forms. Click on the form name to edit it, or if you want to duplicate a form, select it and click on Copy. Each form should have an unique form name. Learn more about creating multi-language forms here .

Forms Manager list columns:

  • Form Title
    The form title will be displayed in the front-end. You can remove it from the layout. Learn how here .
  • Form Name
    The form name is used to identify your forms. Also it is being used when creating multi-language forms.
  • Published
    A form is Unpublished when initially created. Make sure you publish it before hitting preview.
  • Data
    A small report on the submissions for the form. Click on it to view the submissions screen.
  • Form Link
    This is the main link of the form and can be used when adding the form to a menu item .
  • Preview
    Same as Form Link.
  • Form ID
    The Form ID is used when adding the form to the front-page menu. More about adding the form to a menu item.

Creating a new form [Read All]

When you want to create a new Form, just click on the New button in the forms manager screen. Before being able to add fields to your form, you have to set up 2 parameters: form name and form title. Type the title for the form, then the name and click on Apply.

A new button called "New Field" will appear. You can read more about the parameters you can set up in a form in the Editing a saved form section.

Editing a saved form [Read All]

You can edit the forms by clicking on the form's title in the Forms Manager screen. When editing your form, you can change all it's parameters, add / remove / publish / unpublish your fields.

You can also use the Copy button to duplicate one or more fields to the same or to other forms.

Setting up the e-mail [Read All]

Read more on customizing the e-mails here

The e-mail functionality enables you to send you and your customers a notification. The nice part of it it's that this e-mail is fully customizable, so you'll be able to make it as nice as you want, and include all the user's submitted data.

First of all you must make sure that your Joomla installation e-mail is working. To do so, just create a new user. The user should receive a notification e-mail. This operation guarantees that the joomla e-mail parameters are set up correctly.

Now for the customization part, let's take an example:

Assuming that your form has the following fields:

  • Field id: fullname, Field Type: textbox, Default Value:
  • Field id: email, Field Type: textbox, Default Value:
  • Field id: phone, Field Type: textbox, Default Value:
  • Field id: city, Field Type: selectbox, Default Value: rome|Rome,paris|Paris,london|London
  • Field id: subject, Field Type: textbox, Default Value:
  • Field id: message, Field Type: textarea, Default Value:

Let's customize the e-mail now. In order to make it work, make sure none of the fields are empty.

  1. Edit your form, and go to the Emails tab
  2. In the Email Form Data To: type {email},your@emailaddress.com
    • {email} will be replaced by the system with what the user typed in the field that has id=email
  3. In the Email Form Data From type your company e-mail address. We strongly advice you not to use the same email that you used in Email Form Data To, because on some servers, the message won't be sent to the same account (because From and To would be the same).
  4. Email From Name: type here the Mail from name. The name of your company would do just fine.
  5. Email Subject:type here the subject of your mail. You can simply add {subject} because we defined a field with the id = subject. This way, the e-mail will have whatever the user typed in the Subject field as a subject of the e-mail message
  6. Email Message: Here you could type something like:

Dear {fullname},
your submission has been registered. Here's a copy:

Fullname: {fullname}
Email: {email}
Phone: {phone}
City: {city}
Subject: {subject}
Message:

{message}

Notice that i used all the form fields defined above.

 

Read more on customizing the e-mails here

 

Customizing the Thankyou message [Read All]

Adding custom scripts to the form [Read All]

Changing the form appearance [Read All]

In this chapter we'll describe how to change the form appearance. First of all you have to understand how RSform parses the code. Edit your form and go to Form Style. You can see there the Edit the form style textarea. That acts as a container, and the {formfields} placeholder will be replaced with the fields' html code.

This example will change the form style appearance.

  1. Change the code inside the Edit the form style textarea to:
    <h2>{formtitle}</h2>
    <div class="forme">
    {formfields}
    </div>
  2. Now that we have created the container, lets focus on the fields. The fields placeholders are:
    • {fieldtitle} - the field title
    • {validationsign} - the * validation sign for mandatory fields
    • {field} - the field itself
    • {fielddesc} - the field description (if any)

    Create a new field, and in it's Field Style textarea, replace the existing code with:
    <div class="field">
        <strong>{fieldtitle} {validationsign}</strong>
        {field}
    </div>
  3. The result for a form with 3 fields will be:
<h2>{formtitle}</h2>
<div class="forme">
<div class="field">
    <strong>{fieldtitle} {validationsign}</strong>
    {field}
</div>
 <div class="field">
    <strong>{fieldtitle} {validationsign}</strong>
    {field}
</div>
<div class="field">
    <strong>{fieldtitle} {validationsign}</strong>
    {field}
</div>
</div>

RSform! Multi-language [Read All]

RSform! supports multi-language forms. In order to get your multi-language forms up and running, follow these simple steps(example for spanish language):

  1. Locate and copy the file /components/com_forme/languages/en.php to /components/com_forme/languages/es.php
  2. Create your default (lets say english) form. In the Form Editor / Form Edit tab, type en in the Form Language ISO field
  3. Select your form in the Forms list, and click Copy. An identical form will be created.
  4. Edit the new form, and change the Form Language ISO to es for example, or de for german, or whatever language you wish.
  5. If you have joomfish installed, RSform! will autodetect language change by the visitor, and switch to the proper form
  6. If you do not have joomfish, RSform! also detects the GET parameter lang=en for example.

Adding a form to the menu [Read All]

Here's a step by step guide that helps you add a form to your main menu:

In Joomla 1.0.x

  1. Go to Manage forms, and click on Preview next to the form you want to add
  2. Copy the link (where you are taken to)
  3. Go back to Administrator > Menu > mainmenu > New > Link-url
  4. Give the new menu item a title, and paste the previously copied code

In Joomla 1.5.x

Solution 1: 

  1. Go to Manage forms, and look at the last column (form id). Let's assume your form id is 1
  2. Go to Administrator > Menu > mainmenu > New > Internal > RSform!
  3. Give your menu item a name, and on the right side, in the Parameters tab, in the Form Id textbox type 1 (the form id)

Solution 2:

  1. Go to Manage forms, and click on Preview next to the form you want to add
  2. Copy the link starting from index.php(something like: index.php?option=com_forme&fid=1)
  3. Go back to Administrator > Menu >mainmenu > New > External >
  4. Paste the link and give your menu item a title.