diff --git a/docs/sending/templates.rst b/docs/sending/templates.rst index f50071c..5b4baa5 100644 --- a/docs/sending/templates.rst +++ b/docs/sending/templates.rst @@ -16,12 +16,6 @@ to rewrite your email templates if you switch ESPs. better, portable and maintainable option. -.. note:: - - Normalized merge variables and template identification - are coming to Anymail soon. - - .. currentmodule:: anymail.message .. _esp-templates: @@ -29,6 +23,15 @@ better, portable and maintainable option. ESP templates ------------- +.. warning:: + + These normalized ESP-template attributes aren't implemented yet. + but are planned for a future Anymail update. If you are using + your ESP's transactional templates, + `your input `_ + would be appreciated. + + .. To use a *Mandrill* (MailChimp) template stored in your Mandrill account, .. set a :attr:`template_name` and (optionally) :attr:`template_content` .. on your :class:`~django.core.mail.EmailMessage` object:: @@ -58,11 +61,14 @@ ESP templates .. can be used with templates. -.. attribute:: AnymailMessage.template_name +.. attribute:: AnymailMessage.template_id + (not yet implemented) .. attribute:: AnymailMessage.global_merge_vars + (not yet implemented) + .. ``dict``: merge variables to use for all recipients (most useful with :ref:`mandrill-templates`). :: .. .. message.global_merge_vars = {'company': "ACME", 'offer': "10% off"} @@ -72,6 +78,8 @@ ESP templates .. attribute:: AnymailMessage.merge_vars + (not yet implemented) + .. ``dict``: per-recipient merge variables (most useful with :ref:`mandrill-templates`). The keys .. in the dict are the recipient email addresses, and the values are dicts of merge vars for .. each recipient::