Evaluate forms were made by Webform module 8.x - Users Manual

Evaluate Webform (EvalWF) 8.x - Users Guide

What is this module for?

- If you would like to create a test for a group of people to help them what is their knowledge level,
- If you need to know how your colleges know your products/services,
- If you would like to create a quiz and give special offers to the bests,
- If you have courses, you would like pretest to determine which class is the best for applicant,

You may need this module.

EvalWF can make automatic evaluation of forms were created by Webform module. You just need to set values/points for each available answers and it can calculate the final result of the submitted form.

When user filled your test it can make an automatic evaluation and can show a result page with summarized points and if conditions were set it gives a continue depending on the result.

If emailing were set it sends the results to the given email address that collects all the results. (As the sender will send a lot of emails with the similar subject and body, the email client can filter it as a SPAM.)

Minimum requirements:
---------------------
Drupal 8.5
Webform 8.x-5.x
PHP 7.0

How does it work?

As the other Drupal module, it must be installed (admin/modules) before you can use it, and you can reach management side under admin/structure.

If you have created a form with Webform module you can add an evaluation for it. Not all of Webform elements can be evaluated now, but most of them usable. 

If you have created an evaluation for a form you can set email sending with results if automatic evaluation were set. For this you have to modify form’s confirmation url to the result page. See below…

You can choose hide results, in this case the submitter will see only the ‘Thanks for filling’ section, you can manage under evaluation settings.

If you would like different continues for different results you have to set conditions where you can specify continuation url.

- Creating a form with Webform:

First, create a webform with supported elements. You can group them in a filedset/container/deails element if you would like summarize these groups partly.

​

Supported webform elements:

• checkbox, checkboxes, checkboxes other
• radios, radios other
• select, select other
• table select, likert
• number, range
• table sort and table select sort

Textfield, textarea, email elements will be displayed on result page as simple text.

- Creating/Managing evaluations

Then, you have to create an evaluation setting in EvalWF admin menu (admin/structure/evalwf).

Here you can add/edit/delete settings for each form.

​

- General settings

Then, You must give a name for evaluation (if it already used for other evalwf settings you must give machine name too), and you can set general settings.

If you would like here you can change:

• the result page settings: Title, ‘Thanks for filling text’, Direct Jump, Show evaluation, Show all available answers and its points, Formatting settings (theme)
• the email settings: Send, Send to, Formatting setting (theme)

​

- Elements settings

Then, You need to give value/points for each elements/each answers. These points were given if that answer were chosen.

If number/range elements in your form, you have to specify the good answers too.

If you used sort element You have to set the answers to good order and give values for the ‘first %n element in good order’

​

- Conditions

Then, You can specify conditions. The evaluation will run from top to bottom and if one is true it stops and returns the link given in condition. If none of them true the else condition will give link if it is enable. If neither of them true no link will be given.
It creates an extra link to bottom of the result page as continue which depends on result as described above.

​

- Manage Evaluations

Here You can manage evaluations and you can get the result of submissions. You may need to change configuration settings e.g. if you would like to send result in email.

- EvalWF Configuration

Main configuration of this module, here you can modify admin evaluation and main emailing settings.

How to evaluate?

The evaluation can automatic, - if you would like it will send the result in email, - or you can do it manually.

To get the results manually you have to go to submissions and choose evaluate operation. This will show the evaluation page.

Administrators can evaluate through evaluations management

To use automatic evaluation you have to set the forms confirmation url to evalwf/[webform:id]/[webform_submission:sid]. (do not modify, just copy and paste to url field at form settings)

For receiving result in email, you have to go evalwf admin page and modify the evaluation settings. You have to select the send option and specify the email address which will collect these emails. (Some email client mark them as SPAM)

Related modules

• EvalWF - Evaluate Forms were made by Webform module

• Webform