Skip to content

Commit ca7dbdc

Browse files
committed
Docs: clarify ESP templates not yet implemented
1 parent 1e4abad commit ca7dbdc

File tree

1 file changed

+15
-7
lines changed

1 file changed

+15
-7
lines changed

docs/sending/templates.rst

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,19 +16,22 @@ to rewrite your email templates if you switch ESPs.
1616
better, portable and maintainable option.
1717

1818

19-
.. note::
20-
21-
Normalized merge variables and template identification
22-
are coming to Anymail soon.
23-
24-
2519
.. currentmodule:: anymail.message
2620

2721
.. _esp-templates:
2822

2923
ESP templates
3024
-------------
3125

26+
.. warning::
27+
28+
These normalized ESP-template attributes aren't implemented yet.
29+
but are planned for a future Anymail update. If you are using
30+
your ESP's transactional templates,
31+
`your input <https://github.com/anymail/django-anymail/issues/5>`_
32+
would be appreciated.
33+
34+
3235
.. To use a *Mandrill* (MailChimp) template stored in your Mandrill account,
3336
.. set a :attr:`template_name` and (optionally) :attr:`template_content`
3437
.. on your :class:`~django.core.mail.EmailMessage` object::
@@ -58,11 +61,14 @@ ESP templates
5861
.. can be used with templates.
5962
6063
61-
.. attribute:: AnymailMessage.template_name
64+
.. attribute:: AnymailMessage.template_id
6265

66+
(not yet implemented)
6367

6468
.. attribute:: AnymailMessage.global_merge_vars
6569

70+
(not yet implemented)
71+
6672
.. ``dict``: merge variables to use for all recipients (most useful with :ref:`mandrill-templates`). ::
6773
..
6874
.. message.global_merge_vars = {'company': "ACME", 'offer': "10% off"}
@@ -72,6 +78,8 @@ ESP templates
7278
7379
.. attribute:: AnymailMessage.merge_vars
7480

81+
(not yet implemented)
82+
7583
.. ``dict``: per-recipient merge variables (most useful with :ref:`mandrill-templates`). The keys
7684
.. in the dict are the recipient email addresses, and the values are dicts of merge vars for
7785
.. each recipient::

0 commit comments

Comments
 (0)