Oprava problémů se zobrazením šablony e-mailu FreeMarker

Řešení problémů se zobrazením HTML v e-mailech odeslaných přes FreeMarker

Konfigurace Java a Spring Framework

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer;
import freemarker.template.Template;
import java.util.Map;
import java.util.HashMap;
import java.nio.charset.StandardCharsets;
import javax.mail.internet.MimeMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Service;
@Service
public class EmailService {
    @Autowired
    private JavaMailSender mailSender;
    @Autowired
    private FreeMarkerConfigurer freemarkerConfigurer;
    public void sendEmail(Map<String, Object> model) throws Exception {
        Template template = freemarkerConfigurer.getConfiguration().getTemplate("emailTemplate.ftl");
        String html = FreeMarkerTemplateUtils.processTemplateIntoString(template, model);
        MimeMessage message = mailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(message, MimeMessageHelper.MULTIPART_MODE_MIXED_RELATED, StandardCharsets.UTF_8.name());
        helper.setTo("example@example.com");
        helper.setText(html, true);
        helper.setSubject("Testing from Spring Boot");
        mailSender.send(message);
    }
}

Implementace CSS Inlining pro HTML e-mailový obsah

Java s Spring Email a CSS Inlining

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.core.io.ClassPathResource;
import org.springframework.util.StreamUtils;
import java.nio.charset.StandardCharsets;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.mail.javamail.JavaMailSender;
import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;
@Service
public class InlineCssEmailService {
    @Autowired
    private JavaMailSender mailSender;
    public void sendStyledEmail(Map<String, Object> model, String templatePath) throws Exception {
        String htmlContent = new String(StreamUtils.copyToByteArray(new ClassPathResource(templatePath).getInputStream()), StandardCharsets.UTF_8);
        Document document = Jsoup.parse(htmlContent);
        document.select("style").forEach(style -> {
            String css = style.data();
            document.select(style.attr("for")).attr("style", css);
        });
        MimeMessage message = mailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(message, true);
        helper.setTo("test@example.com");
        helper.setSubject("Styled Email Test");
        helper.setText(document.outerHtml(), true);
        mailSender.send(message);
    }
}

Časté dotazy k integraci šablon e-mailu

1. Proč se v mém e-mailu zobrazuje kód HTML?
2. K tomu obvykle dochází, když e-mailový klient nedokáže rozpoznat HTML jako obsah kvůli nesprávnému nastavení typu MIME nebo nedostatku podpory HTML v konfiguraci odesílání e-mailů.
3. Jak mohu zajistit, aby byly mé styly použity v aplikaci Outlook?
4. Použití CSS inlining zajistit, aby styly nebyly odstraněny aplikací Outlook, která může ignorovat externí styly nebo styly záhlaví.
5. Co je FreeMarker?
6. FreeMarker je šablonový engine používaný pro generování textového výstupu na základě šablon, často používaný pro vytváření dynamických HTML e-mailů.
7. Jak otestuji své HTML e-maily?
8. Pomocí nástrojů pro testování e-mailů, jako je Litmus nebo Email on Acid, si před odesláním můžete prohlédnout, jak vaše e-maily vypadají v různých e-mailových klientech.
9. Proč se v mých e-mailech nezobrazují obrázky?
10. Může to být způsobeno tím, že e-mailový klient ve výchozím nastavení blokuje obrázky, nebo problémy s tím, jak jsou obrázky odkazovány v kódu HTML.

Závěr naší diskuse o vykreslování šablon

Orientace ve složitosti vykreslování e-mailů pomocí šablon FreeMarker vyžaduje jasnou představu jak o nástroji šablon, tak o možnostech e-mailového klienta. Využitím strategií, jako je vkládání CSS a pečlivé testování napříč různými klienty, mohou vývojáři výrazně zlepšit způsob zobrazování e-mailů. Pochopení a využití správné konfigurace Spring a tříd Java navíc může pomoci při doručování e-mailů, které splňují očekávání návrhu, což v konečném důsledku zajišťuje profesionální a poutavou uživatelskou zkušenost.