Přidání tagu {% maillink %}
Vyrábí odkazy, které vedou na poslání mailu.
Psal jsem to spíš po paměti, nejsem si jistý, že to takhle je přesně
podle příslušného RFC, ale jako PoC dobrý a když to nebude fungovat, tak
se implementace opraví.
Všimněte si, že to je otestované, takže když někdo opraví testy
(=předpis chování), tak je pak snadné z diffu a všeho odvodit úpravu.
V Django dokumentaci se píše něco o tom, že by se měl použít spíš
`format_html` a `conditional_escape`, ale zatím jsem to víc nezkoumal.
Je žádoucí z tagu {% maillink %} odddělit i tag {% mailurl %}, který by
vracel samotnou URL. Obojí dává smysl umět (speciálně bastlení odkazů z
URL je stejně strašně nepřehledné, takže je lepší to zavřít do {%
maillink %} a nikdy nevidět), ale zatím to oddělené není… (Ale jsou na
to testy, takže by se mělo aspoň dát poznat, že rozdělení nerozbije
chování.)
2 years ago
|
|
|
from django import template
|
|
|
|
from django.utils.safestring import mark_safe
|
|
|
|
from urllib.request import quote as urlencode
|
|
|
|
register = template.Library()
|
|
|
|
|
|
|
|
@register.simple_tag
|
|
|
|
def mailurl(*, subject=None, body=None, to=[]):
|
Přidání tagu {% maillink %}
Vyrábí odkazy, které vedou na poslání mailu.
Psal jsem to spíš po paměti, nejsem si jistý, že to takhle je přesně
podle příslušného RFC, ale jako PoC dobrý a když to nebude fungovat, tak
se implementace opraví.
Všimněte si, že to je otestované, takže když někdo opraví testy
(=předpis chování), tak je pak snadné z diffu a všeho odvodit úpravu.
V Django dokumentaci se píše něco o tom, že by se měl použít spíš
`format_html` a `conditional_escape`, ale zatím jsem to víc nezkoumal.
Je žádoucí z tagu {% maillink %} odddělit i tag {% mailurl %}, který by
vracel samotnou URL. Obojí dává smysl umět (speciálně bastlení odkazů z
URL je stejně strašně nepřehledné, takže je lepší to zavřít do {%
maillink %} a nikdy nevidět), ale zatím to oddělené není… (Ale jsou na
to testy, takže by se mělo aspoň dát poznat, že rozdělení nerozbije
chování.)
2 years ago
|
|
|
"""TODO: Dokumentace"""
|
|
|
|
if isinstance(to, str):
|
|
|
|
to = [to]
|
|
|
|
assert isinstance(to, list)
|
|
|
|
parts = [
|
|
|
|
f'mailto:{str.join(",", to)}',
|
|
|
|
]
|
|
|
|
if len(to) < 1:
|
|
|
|
raise ValueError('Cannot mail to empty set of people')
|
|
|
|
|
|
|
|
if subject:
|
|
|
|
parts.append(f'subject={urlencode(subject)}')
|
|
|
|
if body:
|
|
|
|
parts.append(f'body={urlencode(body)}')
|
|
|
|
|
|
|
|
if len(parts) > 1:
|
|
|
|
url = parts[0] + '?' + str.join('&', parts[1:])
|
|
|
|
else:
|
|
|
|
url = parts[0]
|
|
|
|
return url
|
|
|
|
|
|
|
|
@register.simple_tag
|
|
|
|
def maillink(text, subject=None, body=None, to=[], attrs=None):
|
|
|
|
url = mailurl(subject=subject, body=body, to=to)
|
Přidání tagu {% maillink %}
Vyrábí odkazy, které vedou na poslání mailu.
Psal jsem to spíš po paměti, nejsem si jistý, že to takhle je přesně
podle příslušného RFC, ale jako PoC dobrý a když to nebude fungovat, tak
se implementace opraví.
Všimněte si, že to je otestované, takže když někdo opraví testy
(=předpis chování), tak je pak snadné z diffu a všeho odvodit úpravu.
V Django dokumentaci se píše něco o tom, že by se měl použít spíš
`format_html` a `conditional_escape`, ale zatím jsem to víc nezkoumal.
Je žádoucí z tagu {% maillink %} odddělit i tag {% mailurl %}, který by
vracel samotnou URL. Obojí dává smysl umět (speciálně bastlení odkazů z
URL je stejně strašně nepřehledné, takže je lepší to zavřít do {%
maillink %} a nikdy nevidět), ale zatím to oddělené není… (Ale jsou na
to testy, takže by se mělo aspoň dát poznat, že rozdělení nerozbije
chování.)
2 years ago
|
|
|
if not attrs: attrs = ''
|
|
|
|
mezera = ' '*bool(attrs)
|
|
|
|
full_link = f'<a href="{url}"{mezera}{attrs}>{text}</a>'
|
|
|
|
return mark_safe(full_link)
|