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)