wcs/wcs/qommon/admin/emails.py

282 lines
11 KiB
Python

# w.c.s. - web application for online forms
# Copyright (C) 2005-2010 Entr'ouvert
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, see <http://www.gnu.org/licenses/>.
from quixote import redirect
from quixote.directory import Directory
from quixote.html import htmltext, TemplateIO
from .. import _
from ..form import *
from .. import misc, get_cfg
from ..backoffice.menu import html_top
from ..admin.cfg import cfg_submit
class EmailsDirectory(Directory):
emails_dict = {}
_q_exports = ['', 'options']
@classmethod
def register(cls, key, description, hint=None, enabled=False,
default_subject=None, default_body=None, category=None):
if key in cls.emails_dict:
return
cls.emails_dict[key] = {
'description': description,
'default_subject': default_subject,
'default_body': default_body,
'hint': hint,
'enabled': enabled,
'category': category,
}
@classmethod
def is_enabled(cls, key):
emails_cfg = get_cfg('emails', {})
return emails_cfg.get('email-%s_enabled' % key, True)
@classmethod
def get_subject(cls, email_key):
emails_cfg = get_cfg('emails', {})
cfg_key = 'email-%s' % email_key
default_subject = cls.emails_dict[email_key].get('default_subject')
if default_subject:
default_subject = _(default_subject)
real_subject = emails_cfg.get(cfg_key + '_subject') or default_subject
return real_subject
@classmethod
def get_body(cls, email_key):
emails_cfg = get_cfg('emails', {})
cfg_key = 'email-%s' % email_key
default_body = cls.emails_dict[email_key].get('default_body')
if default_body:
default_body = _(default_body)
real_body = emails_cfg.get(cfg_key) or default_body
return real_body
@classmethod
def set_subject(cls, email_key, value):
emails_cfg = get_cfg('emails', {})
cfg_key = 'email-%s' % email_key
default_subject = cls.emails_dict[email_key].get('default_subject')
if value == default_subject:
return
if value == _(default_subject):
return
emails_cfg[cfg_key + '_subject'] = value
get_publisher().reload_cfg()
get_publisher().cfg['emails'] = emails_cfg
get_publisher().write_cfg()
@classmethod
def set_body(cls, email_key, value):
emails_cfg = get_cfg('emails', {})
cfg_key = 'email-%s' % email_key
default_body = cls.emails_dict[email_key].get('default_body')
if value == default_body:
return
if value == _(default_body):
return
emails_cfg[cfg_key] = value
get_publisher().reload_cfg()
get_publisher().cfg['emails'] = emails_cfg
get_publisher().write_cfg()
def options(self):
form = Form(enctype='multipart/form-data')
emails = get_cfg('emails', {})
form.add(StringWidget, 'smtp_server', title = _('SMTP Server'),
required = False, value = emails.get('smtp_server', ''))
form.add(StringWidget, 'smtp_login', title = _('SMTP Login'),
required = False, value = emails.get('smtp_login', ''))
form.add(StringWidget, 'smtp_password', title = _('SMTP Password'),
required = False, value = emails.get('smtp_password', ''))
form.add(StringWidget, 'from', title = _('Email Sender'),
required = True, value = emails.get('from'))
form.add(StringWidget, 'reply_to', title = _('Reply-To Address'),
required = False, value = emails.get('reply_to'))
form.add(TextWidget, 'footer', title=_('Email Footer'), cols=70, rows=5,
required=False, value=emails.get('footer'))
form.add(CheckboxWidget, 'check_domain_with_dns',
title = _('Check DNS for domain name'),
value = emails.get('check_domain_with_dns', True),
hint = _('Use a DNS request to check domain names used in email fields'))
form.add(WidgetList, 'well_known_domains',
title=_('Domains to check for spelling errors'),
element_type=StringWidget,
element_kwargs={'render_br': False},
value=get_publisher().get_email_well_known_domains())
form.add(WidgetList, 'valid_known_domains',
title=_('Domains that should not be considered spelling errors'),
element_type=StringWidget,
element_kwargs={'render_br': False},
value=get_publisher().get_email_valid_known_domains())
form.add_submit('submit', _('Submit'))
form.add_submit('cancel', _('Cancel'))
if form.get_widget('cancel').parse():
return redirect('.')
if not form.is_submitted() or form.has_errors():
html_top('settings', title = _('Emails'))
get_response().breadcrumb.append(('options', _('General Options')))
r = TemplateIO(html=True)
r += htmltext('<h2>%s</h2>') % _('General Options')
mail_redirection = get_cfg('debug', {}).get('mail_redirection')
if mail_redirection:
r += htmltext('<div class="infonotice">')
r += htmltext('<p>')
r += _('Warning: all emails are sent to <%s>') % mail_redirection
r += htmltext(' <a href="../debug_options">%s</a>') % _('Debug Options')
r += htmltext('</p>')
r += htmltext('</div>')
r += form.render()
return r.getvalue()
else:
cfg_submit(form, 'emails', [ 'smtp_server', 'smtp_login',
'smtp_password', 'from', 'reply_to', 'footer',
'check_domain_with_dns', 'well_known_domains',
'valid_known_domains'])
return redirect('.')
def _q_index(self):
html_top('settings', title = _('Emails'))
r = TemplateIO(html=True)
r += htmltext('<h2>%s</h2>') % _('Emails')
r += htmltext('<ul>')
r += htmltext('<li><a href="options">%s</a></li>') % _('General Options')
r += htmltext('</ul>')
keys = self.emails_dict.keys()
categories = {}
for k, v in self.emails_dict.items():
if v.get('category'):
translated_category = _(v.get('category'))
else:
translated_category = _('Miscellaneous')
if translated_category not in categories:
categories[translated_category] = []
categories[translated_category].append(k)
for category_key in sorted(categories.keys()):
if len(categories) > 1:
r += htmltext('<h3>%s</h3>') % category_key
keys = categories.get(category_key)
keys.sort(key=lambda x: _(self.emails_dict[x]['description']))
r += htmltext('<ul>')
for email_key in keys:
email_values = self.emails_dict[email_key]
r += htmltext('<li><a href="%s">%s</a></li>') % (email_key,
_(email_values['description']))
r += htmltext('</ul>')
r += htmltext('<p>')
r += htmltext('<a href="..">%s</a>') % _('Back')
r += htmltext('</p>')
return r.getvalue()
def email(self, email_key, email_label, hint = None, check_template = None,
enabled = True):
emails_cfg = get_cfg('emails', {})
cfg_key = 'email-%s' % email_key
default_subject = _(self.emails_dict[email_key].get('default_subject'))
default_body = _(self.emails_dict[email_key].get('default_body'))
displayed_subject = emails_cfg.get(cfg_key + '_subject') or default_subject
displayed_body = emails_cfg.get(cfg_key) or default_body
form = Form(enctype='multipart/form-data')
form.add(CheckboxWidget, cfg_key + '_enabled', title = _('Enabled Email'),
value = emails_cfg.get(cfg_key + '_enabled', True), default = enabled)
form.add(StringWidget, cfg_key + '_subject', title = _('Subject'),
value = displayed_subject, size = 40)
form.add(TextWidget, cfg_key, title = email_label, value = displayed_body,
cols = 80, rows = 10, hint = hint)
form.add_submit('submit', _('Submit'))
if displayed_subject != default_subject or displayed_body != default_body:
form.add_submit('restore-default', _('Restore default email'))
form.add_submit('cancel', _('Cancel'))
if form.get_submit() == 'cancel':
return redirect('.')
if form.get_submit() == 'restore-default':
self.email_submit(None, email_key)
return redirect('')
if form.is_submitted() and not form.has_errors():
if self.email_submit(form, email_key, check_template):
return redirect('.')
form.set_error(cfg_key, _('Invalid template'))
get_response().breadcrumb.append((email_key, email_label))
html_top('settings', title = _('Emails'))
r = TemplateIO(html=True)
r += htmltext('<h2>%s - %s</h2>') % (_('Email'), email_label)
r += form.render()
r += get_publisher().substitutions.get_substitution_html_table(
intro=_('The email subject and body can reference variables from the table below:'))
return r.getvalue()
def email_submit(self, form, email_key, check_template = None):
get_publisher().reload_cfg()
cfg_key = 'email-%s' % email_key
emails_cfg = get_cfg('emails', {})
if form:
template = form.get_widget(cfg_key).parse()
if check_template and not check_template(template):
return False
default_subject = _(self.emails_dict[email_key].get('default_subject'))
default_body = _(self.emails_dict[email_key].get('default_body'))
if template == default_body:
template = None
subject = form.get_widget(cfg_key + '_subject').parse()
if subject == default_subject:
subject = None
emails_cfg[str(cfg_key)] = template
emails_cfg[str(cfg_key + '_enabled')] = form.get_widget(
cfg_key + '_enabled').parse()
emails_cfg[str(cfg_key + '_subject')] = subject
else:
emails_cfg[str(cfg_key)] = None
get_publisher().cfg['emails'] = emails_cfg
get_publisher().write_cfg()
return True
def _q_lookup(self, component):
if component not in self.emails_dict:
return None
return self.email(component,
_(self.emails_dict[component]['description']),
_(self.emails_dict[component]['hint']),
self.emails_dict[component]['enabled'])
def _q_traverse(self, path):
get_response().breadcrumb.append(('emails/', _('Emails')))
return Directory._q_traverse(self, path)