.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
   :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
   :alt: License: AGPL-3

==============================================
Fixed-Width Layout Snippets for Writing Emails
==============================================

This module extends the functionality of the website mail designer with new
snippets with a fixed-width layout that works fine across any mail client,
including MS Outlook.

Installation
============

This module is prepared to be compatible with module ``website_mail_bg_color``.
If you install it, you will be able to change snippets' background colors, but
it is not required.

Usage
=====

To use this module, you need to:

#. Install any module that makes use of the website mail designer, such as
   ``mass_mailing``.
#. Edit an email with the website mail designer.
#. You have a new collection of snippets under *Fixed 560px Width* section.
   Use them as usual.

If you choose the *Horizontal Separator* snippet, you will be able to set its
height too. For that, you will have to aim carefully to click inside the green
line, and then use the option that will float above it.

.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
   :alt: Try me on Runbot
   :target: https://runbot.odoo-community.org/runbot/205/8.0

Known issues / Roadmap
======================

* Snippet code is ugly, but that's because mail client HTML engines usually
  lack many of the modern CSS and HTML features. I hope we will be able to
  improve this as mail clients keep improving.
* To set the *Horizontal Separator* height, you have to click inside it, which
  will insert a ``<br type="_moz"/>`` in Firefox, that will make it seem like
  its height is at least like a caret, even if you set a lower value. Do not
  worry, it goes away when you press *Save*.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues
<https://github.com/OCA/social/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
<https://github.com/OCA/
social/issues/new?body=module:%20
website_mail_snippet_fixed%0Aversion:%20
8.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Credits
=======

Images
------

* Odoo Community Association: `Icon <https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg>`_.

Contributors
------------

* Daniel Gómez-Zurita <danielgz@antiun.com>
* Rafael Blasco <rafabn@antiun.com>
* Jairo Llopis <yajo.sk8@gmail.com>

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.