# Reward Functions

## Activating myCRED Reward Points

This addon integrates with the latest version of myCRED giving you a way for complete multipoint management. Once you have installed the addon, you’d need to activate the functionality from two places. First from the myCRED hooks and next from the form itself.

### #1: Installing the main myCRED Plugin:

If you haven’t already, then this addon will prompt you to install myCRED plugin. Simply click on the link and activate the plugin once it is downloaded.

### #2: Activating myCRED Hook:

Hooks are a way for executing myCRED system under certain events. myCRED detects an event/interaction between your user and your website and awards points accordingly. Our addon would extend inbuilt myCRED hooks with form submission events.

- Go to WP Admin > myCRED > Hooks.
- Enable Points for eForm submission.

If you have multiple reward points then please repeat the step for every point types.

### #3: Activating myCRED Integration inside eForm:

Now that we have let myCRED know about our integration, it is time to set it up. As always, the setup is on per form basis and we have moved every award points settings inside Integration tab.

- Create/Edit any form.
- Go to Integration > myCRED Awards.
- Enable the settings and set the options.

And now your form is setup to award points upon every submission. Do note that there are several settings which you can modify globally and override per form.

## myCRED Hook Settings

As mentioned earlier this addon would add a new hook Points for eForm form submission to the myCRED > Hooks menu. The options are as follows:

### #1: Limits:

Controls how you limit points assignment.

- Once for each form: A particular user would be awarded only once for every form he submits. This works on a form level. If you have same form available under different URL, then also points would be awarded only for the first time. Successive submissions would not render any award.
- Once for every n days: A particular user would be awarded only once per “n” day no matter what form s/he submits. You need to set the limit below it.
- Once for each form per n days: A particular user would be awarded only once per “n” days for a particular form. If s/he submits a different form within the days limit then s/he will be awarded. This is the most recommended limitation for an ever-engaging experience.

### #2: Days Limit:

If you have set a limitation based on “n” days, then you can specify the “n” here. It can be, 1 for limitation imposed on the basis of 24 hours or anything of your liking. It accepts fractions, so if you want to impose, say a limit for `30 mins`, then you can enter `0.02083.`

### #3: Log template:

Just like any myCRED hooks, fsqm too generates log. The template can be modified here. You can put any string you want. Following custom “tags” are available:

- `%name%` will be replaced by form name.
- `%id%` will be replaced by form ID.
- `%from%` will be replaced by the URL from where the submission has occurred.

Do note that all of these settings are global. Each of them can be overridden by form settings.

## eForm Integration Settings

Award points has to be setup from individual forms. There you can specifiy how much points you would like to award. Additionally myCRED hook settings can also be overridden.

### #1: Reward Point Type:

There are three possible reward points available.

- Static Point: A simple point would be awarded. You need to mention it inside Reward Point settings.
- Score Obtained: For a quiz form, score obtained would be rewarded to the user.
- Mathematical Element: Output of any mathematical element can be awarded to the user. You would also need to specify Mathematical Field ID.

### #2: Disable Points subtraction

Points would be considered as rewards when the output is positive. For negative points (in case of score or mathematical element) it would be considered as myCRED deductions. If you want to disable deductions, then enable this option.

### #3: Calculation Multiplier:

In case of score or mathematical element dependent points you can have a multiplier. For example set it to 2 to award double the point whereas set it to 0.5 to award half.

### #4: Overriding Global Settings:

Limits and Days limits can be overridden per form.

### #5: Disable Point Types

If you want to disable rewarding points for a particular point type for this form, then check the form in this section. This works against the global myCRED hook. So even if eForm is enabled in the point type hook, if you disable a point type here, eForm will not contribute to adding points.

### Get more with eForm through our collection of Addons

#### Love eForm? Checkout our addons

Checkout our collection of eForm Addons designed to help you get more. You can take reports offline, award users with myCRED points and do more with direct export to a dedicated mySQL table. More to come soon.

iPanelThemes Web Solutions Pvt. Ltd.