Messages for unconfirmed addresses will be queued until the address is confirmedor a timeout period defaulting to 3 days elapses.

This app is configured with the same settings as Django's email backend plusEMAIL_CONFIRMATION_WAIT which is an integer specifying the number of days to keepqueued messages for an unconfirmed address before deleting them. This settingdefaults to 3. You also need a valid domain name for Django's Sites frameworkso the confirmation link is at the correct host.

If you're unfamiliar with the Sites framework, look for 'Sites' in the Django admin,it should be self-explanatory.

ConfirmedEmailMessage.send() and send_email_confirmed() differ from the originals intheir return values. Instead of a return value of 0/1 to indicate failure/success therecan be a different status for each destination address. These return instead a dictionary witheach destination address as a key and a state indicatingsuccess/failure/queued pending confirmation; see the documentation forsender.ConfirmedEmailMessage.sent() for details.This allows you to display a message indicating that confirmation is necessary if appropriate.

settings variables:

EMAIL_CONFIRMATION_WAIT: Number of days to wait between sending confirmation emails. Defaults to 3 days.

EMAIL_CONFIRMATION_TEMPLATE: Template to use as the body of confirmation emails. It's important for this template to contain a link for the user to click on passed to the template via variable {{confirmation_link}}. See default template 'confirmation_email.txt' for an example.

ADDRESS_CONFIRMED_TEMPLATE: Template displayed to a user when they click on a confirmation link. Defaults to 'address_confirmed.html' and has template variable {{email_address}} passed to it.