diff --git a/mail_layout_force/README.rst b/mail_layout_force/README.rst new file mode 100644 index 000000000..d594dd719 --- /dev/null +++ b/mail_layout_force/README.rst @@ -0,0 +1,118 @@ +================= +Mail Layout Force +================= + +.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png + :target: https://odoo-community.org/page/development-status + :alt: Beta +.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png + :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html + :alt: License: AGPL-3 +.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fsocial-lightgray.png?logo=github + :target: https://github.com/OCA/social/tree/14.0/mail_layout_force + :alt: OCA/social +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png + :target: https://translation.odoo-community.org/projects/social-14-0/social-14-0-mail_layout_force + :alt: Translate me on Weblate +.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png + :target: https://runbot.odoo-community.org/runbot/205/14.0 + :alt: Try me on Runbot + +|badge1| |badge2| |badge3| |badge4| |badge5| + +Odoo will add a default email layout on most commercial communications. + +The email layout is a ``QWeb`` view that ends up wrapping the message body +when sending an email. It usually displays the related document reference, +the company logo, and a small footer saying "Powered by Odoo". + +There are notably two main layouts used in Odoo, and the user can't control when +they're used, as it's hardcoded into the different applications. + +* ``mail.mail_notification_light`` +* ``mail.mail_notification_paynow`` + +This module allows to force a specific layout for a given ``email.template``, +effectively overwritting the one hardcoded by Odoo. + +This allows you to fully customize the way Odoo emails are rendered and sent +to your customers. + +**Table of contents** + +.. contents:: + :local: + +Configuration +============= + +# Go to Configuration > Technical > Emails > Templates +# Open the desired ``email.template`` record. +# In Advanced Parameters tab, find the Force Layout field. + +You can leave it empty to use the default email layout (chosen by Odoo). +You can force a custom email layout of your own. +You can use the *Mail: No-Layout notification template* to prevent Odoo +from adding a layout. + +To configure a custom layout of your own, some technical knowledge is needed. +You can see how the existing layouts are defined for details or inspiration: + +* ``mail.mail_notification_light`` +* ``mail.mail_notification_paynow`` +* ``mail.mail_notification_borders`` + +Bug Tracker +=========== + +Bugs are tracked on `GitHub 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 `_. + +Do not contact contributors directly about support or help with technical issues. + +Credits +======= + +Authors +~~~~~~~ + +* Camptocamp + +Contributors +~~~~~~~~~~~~ + +* `Camptocamp `_ + + * Iván Todorovich + +Maintainers +~~~~~~~~~~~ + +This module is maintained by the OCA. + +.. image:: https://odoo-community.org/logo.png + :alt: Odoo Community Association + :target: https://odoo-community.org + +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. + +.. |maintainer-ivantodorovich| image:: https://github.com/ivantodorovich.png?size=40px + :target: https://github.com/ivantodorovich + :alt: ivantodorovich + +Current `maintainer `__: + +|maintainer-ivantodorovich| + +This module is part of the `OCA/social `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/mail_layout_force/static/description/index.html b/mail_layout_force/static/description/index.html new file mode 100644 index 000000000..fabcd530d --- /dev/null +++ b/mail_layout_force/static/description/index.html @@ -0,0 +1,458 @@ + + + + + + +Mail Layout Force + + + +
+

Mail Layout Force

+ + +

Beta License: AGPL-3 OCA/social Translate me on Weblate Try me on Runbot

+

Odoo will add a default email layout on most commercial communications.

+

The email layout is a QWeb view that ends up wrapping the message body +when sending an email. It usually displays the related document reference, +the company logo, and a small footer saying “Powered by Odoo”.

+

There are notably two main layouts used in Odoo, and the user can’t control when +they’re used, as it’s hardcoded into the different applications.

+
    +
  • mail.mail_notification_light
    • +
  • mail.mail_notification_paynow
    • +
+

This module allows to force a specific layout for a given email.template, +effectively overwritting the one hardcoded by Odoo.

+

This allows you to fully customize the way Odoo emails are rendered and sent +to your customers.

+

Table of contents

+ +
+

Configuration

+

# Go to Configuration > Technical > Emails > Templates +# Open the desired email.template record. +# In Advanced Parameters tab, find the Force Layout field.

+

You can leave it empty to use the default email layout (chosen by Odoo). +You can force a custom email layout of your own. +You can use the Mail: No-Layout notification template to prevent Odoo +from adding a layout.

+

To configure a custom layout of your own, some technical knowledge is needed. +You can see how the existing layouts are defined for details or inspiration:

+
    +
  • mail.mail_notification_light
    • +
  • mail.mail_notification_paynow
    • +
  • mail.mail_notification_borders
    • +
+
+
+

Bug Tracker

+

Bugs are tracked on GitHub 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.

+

Do not contact contributors directly about support or help with technical issues.

+
+
+

Credits

+
+

Authors

+
    +
  • Camptocamp
    • +
+
+
+

Contributors

+ +
+
+

Maintainers

+

This module is maintained by the OCA.

+Odoo Community Association +

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.

+

Current maintainer:

+

ivantodorovich

+

This module is part of the OCA/social project on GitHub.

+

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

+
+
+
+ +