-
Notifications
You must be signed in to change notification settings - Fork 15
Settings
The settings are stored in a config.json
file. This file shouldn't be edited manually, as a functional configuration panel can be displayed using :
echo $p01contact->panel();
This panel is accessible in the supported CMS, see GetSimple plugin#configuration or Pico CMS plugin#configuration.
Setting | Description |
---|---|
Default emails | One ore more email addresses, separated by commas, that will receive mails from every forms. |
Language | Define the global language used in forms. See translation. |
Messages minimum length | Minimum number of characters to write in message fields to be valid. |
Default parameters | Parameters used for default forms. See syntax. |
Separator | Character separating parameters in the syntax. Comma by default. You may want to use a less-common character if you need commas inside the parameters. |
Logs number | Maximum number of entries to keep on logs. |
The default global language is English, or may be set trough code.
When used as a CMS plugin, the global default language will match the system one.
Each form can override this setting and be defined to a specific language.
$p01contact = new P01contact();
$p01contact->default_lang = 'ru';
$form = new P01contactForm($p01contact);
$form->lang = 'fr';
In tags syntax :
(% contact fr %)
These options allows to define required or prohibited terms for specific fields types.
The first field indicates the field type, for example email
, the second input define the rule type :
-
Blacklist
: prohibited values that must not be present in the given field. -
Whitelist
: possible values required for the given field.
The last field contains the list of terms, separated by commas.
These options allow to configure the security mechanisms included by default or to setup additional measures.
Setting | Description |
---|---|
Use hidden honeypot field | Add to every forms a hidden field that should not be filled. Humans won't see it, but most spam bots will fell in the trap. |
Minimum time after page load | Minimum number of seconds between a page load and a form submission. Fellow humans need at least a few seconds to read, fill and submit a form. Robots don't. |
Minimum time between two submissions | Minimum number of seconds between two form submissions. |
Maximum submissions by hour | Maximum number of submissions every hour. |
The system will also detect and prevent the user to send again a submitted form (ex. reloading the page).
The native anti-spam and anti-error mechanisms should prevent all undesirable submissions. If you need a higher level of security you can insert a Google reCaptcha by using a captcha
field and defining the public and secret keys.
These settings may be useful for debugging.
Setting | Description |
---|---|
Disable all forms | Disable mail sending, without hiding the contact forms. |
Debug mode | Disable mail sending, display p01contact health checks, data structures, data sent by POST and the email that would have been sent. Don't active that on production website! |
The debug data can be shown with :
$p01contact->debug();
For CMS, see GetSimple plugin#debug or Pico CMS plugin#debug.