====== Email Validation ======
Email Validation (based on ''emailval.js'' v0.2 by [[person:tracker1]]) is a simple script that, when enabled,
requires a user to validate their email address by entering a validation code that the system has e-mailed to them.

Upon successful validation, the user's security level is updated, allowing for more access privileges.

===== Install =====

Set ''email_validation = true'' in the ''[logon]'' section of your ''[[dir:ctrl]]/[[config:modopts.ini]]'' file.

===== Configure ===== 

The [[https://gitlab.synchro.net/main/sbbs/-/blob/master/exec/emailval.js|e-mail validation module]] supports the following configuration options in the ''[emailval]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file:

^ Option ^ Default ^ Description ^
| valid_chars | ''ACDEFHJKLMNPQRTUVWXY23456789!@#$%&*'' | Valid characters to use in generated validation codes |
| code_length | ''16'' | Length of generated validation codes |
| level_before_validation | ''50''  | Security [[access:level]] of unvalidated users |
| level_after_validation | ''60''  | Security [[access:level]] of validated users  |
| flags1_after_validation | //no change// | [[access:Flags]] (from flags set 1) to give, add-to, or remove-from validated users |
| flags2_after_validation | //no change// | " " (from flags set 2) |
| flags3_after_validation | //no change// | " " (from flags set 3) |
| flags4_after_validation | //no change// | " " (from flags set 4) |
| exemptions_after_validation | //no change// | [[access:Exemptions]] to give, add-to, or remove-from validated users |
| restrictions_after_validation | //no change// | [[access:Restrictions]] to give, add-to, or remove-from validated users |
| expiration_after_validation | ''false'' | If ''true'', leave or extend the user account expiration date. If ''false'', set validated users to not expire |
| expiration_days_after_validation | //no change// | If ''expiration_after_validation = true'', the days to extend the user's expiration date, once validated |


**Note**:\\
The flags, exemptions, and restrictions ''.ini'' values support 'A' through 'Z' with the optional '+' (add) and '-' (remove) modifiers.\\
e.g. "+A-B" to add the A flag and remove the B flag \\
e.g. "AB" to change the flag set to just "AB" \\

Numeric values are supported for assignment (not modification). \\
e.g. 0 = no flags, 1 = A, 2 = B, 4 = C, 8 = D, etc. \\

===== See Also =====
  * [[:module:|Modules]]