You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

90 lines
3.0 KiB

  1. .. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
  2. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  3. :alt: License: AGPL-3
  4. ==============================================
  5. Fixed-Width Layout Snippets for Writing Emails
  6. ==============================================
  7. This module extends the functionality of the website mail designer with new
  8. snippets with a fixed-width layout that works fine across any mail client,
  9. including MS Outlook.
  10. Installation
  11. ============
  12. This module is prepared to be compatible with module ``website_mail_bg_color``.
  13. If you install it, you will be able to change snippets' background colors, but
  14. it is not required.
  15. Usage
  16. =====
  17. To use this module, you need to:
  18. #. Install any module that makes use of the website mail designer, such as
  19. ``mass_mailing``.
  20. #. Edit an email with the website mail designer.
  21. #. You have a new collection of snippets under *Fixed 560px Width* section.
  22. Use them as usual.
  23. If you choose the *Horizontal Separator* snippet, you will be able to set its
  24. height too. For that, you will have to aim carefully to click inside the green
  25. line, and then use the option that will float above it.
  26. .. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
  27. :alt: Try me on Runbot
  28. :target: https://runbot.odoo-community.org/runbot/205/8.0
  29. Known issues / Roadmap
  30. ======================
  31. * Snippet code is ugly, but that's because mail client HTML engines usually
  32. lack many of the modern CSS and HTML features. I hope we will be able to
  33. improve this as mail clients keep improving.
  34. * To set the *Horizontal Separator* height, you have to click inside it, which
  35. will insert a ``<br type="_moz"/>`` in Firefox, that will make it seem like
  36. its height is at least like a caret, even if you set a lower value. Do not
  37. worry, it goes away when you press *Save*.
  38. Bug Tracker
  39. ===========
  40. Bugs are tracked on `GitHub Issues
  41. <https://github.com/OCA/social/issues>`_. In case of trouble, please
  42. check there if your issue has already been reported. If you spotted it first,
  43. help us smashing it by providing a detailed and welcomed `feedback
  44. <https://github.com/OCA/
  45. social/issues/new?body=module:%20
  46. website_mail_snippet_fixed%0Aversion:%20
  47. 8.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  48. Credits
  49. =======
  50. Images
  51. ------
  52. * Odoo Community Association: `Icon <https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg>`_.
  53. Contributors
  54. ------------
  55. * Daniel Gómez-Zurita <danielgz@antiun.com>
  56. * Rafael Blasco <rafabn@antiun.com>
  57. * Jairo Llopis <yajo.sk8@gmail.com>
  58. Maintainer
  59. ----------
  60. .. image:: https://odoo-community.org/logo.png
  61. :alt: Odoo Community Association
  62. :target: https://odoo-community.org
  63. This module is maintained by the OCA.
  64. OCA, or the Odoo Community Association, is a nonprofit organization whose
  65. mission is to support the collaborative development of Odoo features and
  66. promote its widespread use.
  67. To contribute to this module, please visit https://odoo-community.org.