[ADD] email_template_qweb

8 years ago · ec7939b2d9
11 changed files with 235 additions and 0 deletions
--- a/email_template_qweb/README.rst
+++ b/email_template_qweb/README.rst
@ -0,0 +1,71 @@
+.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
+    :alt: License: AGPL-3
+
+========================
+QWeb for email templates
+========================
+
+This module was written to allow you to write email templates in QWeb instead
+of jinja2. The advantage here is that with QWeb, you can make use of
+inheritance and the ``call`` statement, which allows you to reuse designs and
+snippets in multiple templates, making your development process simpler.
+
+Usage
+=====
+
+To use this module, you need to:
+
+* Select `QWeb` in the field `Body templating engine`
+* Select a QWeb view to be used to render the body field
+* Apart from QWeb's standard variables, you also have access to ``object`` and
+  ``email_template``, which are browse records of the current object and the
+  email template in use, respectively.
+
+.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
+    :alt: Try me on Runbot
+    :target: https://runbot.odoo-community.org/runbot/149/8.0
+
+Demo data contains an example on how to separate corporate identity from a
+template's content.
+
+For further information, please visit:
+
+* https://www.odoo.com/forum/help-1
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-tools/issues>`_.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us smashing it by providing a detailed and welcomed feedback
+`here <https://github.com/OCA/server-tools/issues/new?body=module:%20email_template_qweb%0Aversion:%209.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Credits
+=======
+
+Contributors
+------------
+
+* Holger Brunn <hbrunn@therp.nl>
+* Dave Lasley <dave@laslabs.com>
+
+Do not contact contributors directly about help with questions or problems concerning
+this addon, but use the `forum <https://www.odoo.com/forum/help-1>`_,
+the `community mailing list <mailto:community@mail.odoo.com>`_,
+or the `appropriate specialized mailinglist <https://odoo-community.org/groups>`_ for help,
+and the bug tracker linked in `Bug Tracker`_ above for technical issues.
+
+Maintainer
+----------
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+This module is maintained by the OCA.
+
+OCA, or the Odoo Community Association, is a nonprofit organization whose
+mission is to support the collaborative development of Odoo features and
+promote its widespread use.
+
+To contribute to this module, please visit https://odoo-community.org.
--- a/email_template_qweb/init.py
+++ b/email_template_qweb/init.py
@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+# © 2016 Therp BV <http://therp.nl>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+from . import models
--- a/email_template_qweb/openerp.py
+++ b/email_template_qweb/openerp.py
@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+# © 2016 Therp BV <http://therp.nl>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+{
+    "name": "QWeb for email templates",
+    "version": "9.0.1.0.0",
+    "author": "Therp BV,Odoo Community Association (OCA)",
+    "license": "AGPL-3",
+    "category": "Marketing",
+    "summary": "Use the QWeb templating mechanism for emails",
+    "depends": [
+        'mail',
+    ],
+    "demo": [
+        "demo/ir_ui_view.xml",
+        "demo/mail_template.xml",
+    ],
+    "data": [
+        "views/mail_template.xml",
+    ],
+}
--- a/email_template_qweb/demo/ir_ui_view.xml
+++ b/email_template_qweb/demo/ir_ui_view.xml
@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<odoo>
+    <template id="view_email_template_corporate_identity">
+        <body>
+            <html>
+                <img style="float: right" t-attf-src="data:image;base64,{{env.user.company_id.logo}}" />
+                <!-- if some template calling us sets this variable,
+                     we print a h1 tag /-->
+                <h1 t-if="email_heading"><t t-esc="email_heading" /></h1>
+                <t t-raw="0" />
+                <!-- use some standard footer if the user doesn't have
+                     a signature /-->
+                <footer t-if="not email_use_user_signature">
+                    <p>
+                        <a t-att-href="env.user.company_id.website">
+                            <t t-esc="env.user.company_id.name" />
+                        </a>
+                    </p>
+                    <p><t t-esc="env.user.company_id.phone" /></p>
+                </footer>
+                <footer t-if="email_use_user_signature">
+                    <t t-raw="env.user.signature" />
+                </footer>
+            </html>
+        </body>
+    </template>
+    <template id="view_email_template_demo1">
+        <!-- because we can simply call the ci here, we don't need to
+             repeat it /-->
+        <t t-call="email_template_qweb.view_email_template_corporate_identity">
+            <!-- the template we call uses this as title if we set it /-->
+            <t t-set="email_heading" t-value="email_template.subject" />
+            <h2>Dear <t t-esc="object.name" />,</h2>
+            <p>
+                This is an email template using qweb.
+            </p>
+        </t>
+    </template>
+</odoo>
--- a/email_template_qweb/demo/mail_template.xml
+++ b/email_template_qweb/demo/mail_template.xml
@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<odoo>
+    <record id="email_template_demo1" model="mail.template">
+        <field name="name">QWeb demo</field>
+        <field name="body_type">qweb</field>
+        <field name="body_view_id" ref="view_email_template_demo1" />
+        <field name="model_id" ref="base.model_res_users" />
+        <field name="subject">QWeb demo email</field>
+    </record>
+</odoo>
--- a/email_template_qweb/models/init.py
+++ b/email_template_qweb/models/init.py
@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+# © 2016 Therp BV <http://therp.nl>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+from . import mail_template
--- a/email_template_qweb/models/mail_template.py
+++ b/email_template_qweb/models/mail_template.py
@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+# © 2016 Therp BV <http://therp.nl>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+from openerp import api, fields, tools, models
+
+
+class MailTemplate(models.Model):
+    _inherit = 'mail.template'
+
+    body_type = fields.Selection(
+        [('jinja2', 'Jinja2'), ('qweb', 'QWeb')], 'Body templating engine',
+        default='jinja2', required=True)
+    body_view_id = fields.Many2one(
+        'ir.ui.view', 'Body view', domain=[('type', '=', 'qweb')])
+    body_view_arch = fields.Text(related=['body_view_id', 'arch'])
+
+    @api.multi
+    def generate_email(self, res_ids, fields=None):
+        result = super(MailTemplate, self).generate_email(
+            res_ids, fields=fields
+        )
+        for record_id, this in self.get_email_template(res_ids).iteritems():
+            if this.body_type == 'qweb' and\
+                    (not fields or 'body_html' in fields):
+                for record in self.env[this.model].browse(record_id):
+                    result[record_id]['body_html'] = self.render_post_process(
+                        this.body_view_id.render({
+                            'object': record,
+                            'email_template': this,
+                        })
+                    )
+                    result[record_id]['body'] = tools.html_sanitize(
+                        result[record_id]['body_html']
+                    )
+        return result
--- a/email_template_qweb/static/description/icon.png
+++ b/email_template_qweb/static/description/icon.png
--- a/email_template_qweb/tests/init.py
+++ b/email_template_qweb/tests/init.py
@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+# © 2016 Therp BV <http://therp.nl>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+from . import test_mail_template_qweb
--- a/email_template_qweb/tests/test_mail_template_qweb.py
+++ b/email_template_qweb/tests/test_mail_template_qweb.py
@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+# © 2016 Therp BV <http://therp.nl>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+from openerp.tests.common import TransactionCase
+
+
+class TestMailTemplateQweb(TransactionCase):
+    def test_email_template_qweb(self):
+        template = self.env.ref('email_template_qweb.email_template_demo1')
+        mail_values = template.generate_email([self.env.user.id])
+        self.assertTrue(
+            # this comes from the called template if everything worked
+            '<footer>' in mail_values[self.env.user.id]['body_html'],
+            'Did not rcv rendered template in response. Got: \n%s\n' % (
+                mail_values[self.env.user.id]['body_html']
+            )
+        )
--- a/email_template_qweb/views/mail_template.xml
+++ b/email_template_qweb/views/mail_template.xml
@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<odoo>
+    <record id="email_template_form" model="ir.ui.view">
+        <field name="model">mail.template</field>
+        <field name="inherit_id" ref="mail.email_template_form" />
+        <field name="arch" type="xml">
+            <field name="model_id" position="after">
+                <field name="body_type" />
+            </field>
+            <field name="body_html" position="before">
+                <group attrs="{'invisible': [('body_type', '!=', 'qweb')]}">
+                    <field name="body_view_id" attrs="{'required': [('body_type', '=', 'qweb')]}" />
+                    <field name="body_view_arch" attrs="{'required': [('body_type', '=', 'qweb')], 'invisible': [('body_view_id', '=', False)]}" />
+                </group>
+            </field>
+            <field name="body_html" position="attributes">
+                <attribute name="attrs">{'invisible': [('body_type', '!=', 'jinja2')]}</attribute>
+            </field>
+        </field>
+    </record>
+    <record id="email_template_tree" model="ir.ui.view">
+        <field name="model">mail.template</field>
+        <field name="inherit_id" ref="mail.email_template_tree" />
+        <field name="arch" type="xml">
+            <field name="report_name" position="before">
+                <field name="body_type" />
+            </field>
+        </field>
+    </record>
+</odoo>