"""
store/email_utils.py
─────────────────────
Shared HTML shell for the store app's transactional emails (customer order
confirmation in signals.py, admin payment-proof notification in views.py),
styled to match the Tai AfroPress storefront palette — cream background,
green/rust/gold Kente stripe, Archivo typeface with web-safe fallbacks.
Email clients don't reliably support external CSS/webfonts or CSS
gradients (Outlook desktop in particular), so this uses inline styles and a
table-based layout — the standard "bulletproof HTML email" pattern — rather
than the CSS classes/gradients the actual site uses. Buttons declare a
solid `bgcolor` first so they degrade to a plain solid color instead of
breaking in clients that ignore the gradient.
"""
from django.utils import timezone
BRAND = {
"bg": "#fbf7ef",
"card": "#ffffff",
"border": "#ece2cf",
"text": "#21160a",
"muted": "#6d6152",
"green": "#1f5039",
"rust": "#b9461f",
"gold": "#e8932c",
"gold_light": "#f3b850",
"gold_dark": "#e07b2c",
"dark": "#160f08",
"dark_muted": "#c9b48a",
}
FONT_STACK = "Archivo,'Segoe UI',Arial,sans-serif"
BRAND_WORDMARK = {
"afropress": "TAI AfroPress",
"bookstore": "Tai BookStore",
}
BRAND_FOOTER_NAME = {
"afropress": "Tai AfroPress",
"bookstore": "Tai BookStore",
}
def render_email_shell(
*, heading: str, body_html: str, cta_label: str = "", cta_url: str = "",
brand: str = "afropress", preheader: str = "",
) -> str:
"""
Wraps `body_html` in the branded email shell: Kente-stripe top bar,
white card with heading, optional gold gradient CTA button, dark footer.
`brand` switches the header wordmark/footer line between the two Tai
identities ("afropress" | "bookstore") — same BRAND palette either way,
no separate color scheme. `preheader` is the short hidden snippet shown
next to the subject in an inbox's message list; harmless to omit.
"""
wordmark = BRAND_WORDMARK.get(brand, BRAND_WORDMARK["afropress"])
footer_name = BRAND_FOOTER_NAME.get(brand, BRAND_FOOTER_NAME["afropress"])
preheader_html = (
f'
{preheader}
'
if preheader else ""
)
cta_html = ""
if cta_label and cta_url:
cta_html = f"""