# nForms

by nCrafts

## Installation

1. Extract the folder nForms somewhere.
2. Open the file users.php, and change the value of the variable(s) to restrict access.
3. and ... we're done; visit yoursite.com/nForms/

## Form Building

To access the form builder, click on a form under Existing Forms. The form builder screen can be divided into two parts. The left part is the Dashboard and the right part is our Form Preview.

### Dashboard

1. List of Forms: Takes you back to the form index.
2. Save: The form saves every 10 seconds. Nevertheless, you can click on Save to manually save it any time.
3. Form Options
4. Styling: This allows you to customize the various elements of the form.

Below these options are the various form elements you can add. To add a form element, just click on the button.

File Upload and Captcha fields cannot be added more than once in a form.

You can embed Google Maps using the Custom field. Get the HTML link from Google Maps, and paste it in the text box in the options for Custom field.

Follow the same procedure to embed videos, and other widgets.

### Form Preview

To view the options of the Form Title, Submit Button, or any added element, click on it.

You can drag and drop the elements to change their order.

The Live Form Preview tries to capture the form just as would appear on your page. However, the actual form might appear different depending on your theme, and other changes to basic CSS styles.

### Using the Forms

1. Enter the following code on the top of the page

    					<?php
    					$file_path = '../nforms/function.php';
    					 include($file_path);
    					 ?>

Please change the ../nforms/function.php with the correct path of the function.php file, which is in the main nForms directory.

2. (a) Enter the following PHP code at the place where you want the form.

    					<?php
    					nform(1);
    					?>

Replace '1' with the id of the requisite form.

2. (b) Use the code below to get a popup form

    					<?php
    					nform(6, 1, 'Click Here!', 'btn');
    					?>

Replace '6' with the id of the requisite form.

Keep the '1' in place to get the form to open up as a modal box.

Replace the 'Click Here!' with the text you want on the button which triggers the modal box.

You can use custom styling on this button, by replacing the 'btn' with the appropriate class.

## Form Submissions

When a user submits a form, the form data is delivered to the email recipients, and is saved in a JSON in files.

Email recipients can be added under Form Options inside the Form Builder screen.

All the form submissions can also be accessed from the Submissions table in the Form Index screen.

On the same screen you can see statistics on form submissions.

You can also export the form submissions data to a spreadsheet by clicking on Export Data to Excel.

## File Manager

As you might know, nForms has a fantastic File Upload field feature for your forms. All the files uploaded by users can be viewed from the File Manager table from the Form Index screen.

You can also access the uploaded files by viewing the form submissions data.

## Support

In case of general queries or clarifications, you can post a comment in the Item Discussion section.

If you encounter bugs along the way, or wish to suggest some features in the plugin, please contact me through my profile page.