How to set up providers:

• After the successful login into the admin tool, the main window is shown. Select the provider you want to edit or add/remove one.
• It is required to configure the (undeleteable) system provider first. It contains the application's default settings. Select the "system" entry in the select box and click the "edit" button. This directs you to the edit window where you see the input fields for the different settings. Enter the settings, especially the SMTP host and port, your name and your e-mail address (or the one you wish to use as the default).
  Notes:
  1. The system provider is the only one that cannot have individual settings, i.e. an overwriting file.
  2. Theoretically, you can leave each line empty, but this isn't recommended at all, because providers that haven't defined their individual settings (i.e. created their own overriding file) or that aren't allowed to overwrite the SMTP settings won't be able to send mails then.
• If you like, you can add URLs for the site you wish to show in case the mail was sent successfully, for the one in case the sending failed and for the one in case somebody tried to hack or to spam the application. If you leave those fields blank, MailWebForm w rites some default, unformatted output to the client.
• Now you can add as many providers as you'd like to. Enter their name, e-mail address and - optionally - the overwriting path setting. As default, the directory of overwriting files is "<configdir>" which means that MailWebForm stores the provider's files (named <provider-name>.properties) in there. If you'd like to allow a provider to edit the overriding file manually, enter a directory that is accessible to the provider's owner user, since this user probably isn't allowed to access the <configdir>. Finally, decide whether the provider is allowed to overwrite the SMTP settings, i.e. is allowed to overwrite the system's default setting.
  Notes:
  1. Per default, the "test" provider is registered. This provider has an overwriting file in the <configdir> itself (named test.properties). That's why this provider's path property isn'd defined. You might now change or activate/deactivate the settings in the test.properties file to see how the application behaves.
  2. Of course no path setting is required in case the provider isn't allowed to overwrite the default settings. Note: He's still able to overwrite those settings (except the SMTP ones, if prohibited) through the URL parameters defined in the mail-sending site!
• The hierarchy of overwriting is:
  URL parameters > provider settings (stored in the <provider-name>.properties file) > global settings (stored in the <configdir>/mailwebform.properties file)