RDMO needs to send E-Mails to its users. The connection to the SMPT server is configured by several settings in your
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend' EMAIL_HOST = 'localhost' EMAIL_PORT = '25' EMAIL_HOST_USER = '' EMAIL_HOST_PASSWORD = '' EMAIL_USE_TLS = False EMAIL_USE_SSL = False DEFAULT_FROM_EMAIL = ''
EMAIL_HOST is the URL or IP of the SMTP server,
EMAIL_PORT is the port it is listening on (usually 25, 465, or 587), and
EMAIL_HOST_PASSWORD are credentials, if the SMTP server needs authentication.
STARTTLS connection (usually on port 587)
EMAIL_USE_TLS needs to be set to
EMAIL_USE_SSL needs to be set to
True for an implicit TLS/SSL connection (usually on port 465).
DEFAULT_FROM_EMAIL sets the FROM field for the E-mails send to the users.
For a development/testing setup a simple E-mail backend, which only displays the E-mail on the terminal, can be used:
EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend' EMAIL_FROM = 'firstname.lastname@example.org'
This is also the default backend, if no E-mail settings are added to
Send tasks via Email¶
Tasks can be send by users via email. To enable this function add the following to your
PROJECT_SEND_ISSUE = True EMAIL_RECIPIENTS_CHOICES = [ ('email@example.com', 'Eddy Example <firstname.lastname@example.org>'), ]
PROJECT_SEND_ISSUE enable the feature,
EMAIL_RECIPIENTS_CHOICES determines a fixed list of recipients for mails from your RDMO instance. Instead of a fixed list or in combination, you can also set
EMAIL_RECIPIENTS_INPUT = True
to enable users to send tasks to arbitrary addresses. Please consider all implications of this feature. In particular, you might not want to enable this feature, if your RDMO instance is open to anyone. The emails will be send from the
DEFAULT_FROM_EMAIL and set the user sending the task in CC.
Invite users to projects¶
Users are invited to projects by email. If the user is already in the database, he or she will be stored with the invitation.
If not, an email will be send nevertheless and any user (usually a newly created account, but also an existing account of the user with a different email address is possible). If sending emails to non registered emails is not derisired, this feature can be prevented by setting:
PROJECT_SEND_INVITE = False
A timeout for this process can be set with:
PROJECT_INVITE_TIMEOUT = False