Виправлення проблем із відображенням шаблону електронної пошти FreeMarker

Вирішення проблем із відображенням HTML у електронних листах, надісланих через FreeMarker

Конфігурація Java та 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);
    }
}

Впровадження вбудованого CSS для вмісту електронної пошти HTML

Java із Spring Email і вбудованим CSS

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);
    }
}

Поширені запитання щодо інтеграції шаблонів електронної пошти

1. Чому в моїй електронній пошті відображається HTML-код?
2. Зазвичай це відбувається, коли поштовий клієнт не розпізнає HTML як вміст через неправильні параметри типу MIME або відсутність підтримки HTML у вашій конфігурації надсилання електронної пошти.
3. Як я можу переконатися, що мої стилі застосовані в Outlook?
4. використання CSS inlining щоб переконатися, що стилі не видаляються Outlook, який може ігнорувати зовнішні стилі або стилі заголовків.
5. Що таке FreeMarker?
6. FreeMarker — це система шаблонів, яка використовується для створення текстових виводів на основі шаблонів, які часто використовуються для створення динамічних електронних листів HTML.
7. Як перевірити свої електронні листи HTML?
8. Використовуйте інструменти тестування електронної пошти, як-от Litmus або Email on Acid, щоб переглянути, як ваші електронні листи виглядають у різних клієнтах електронної пошти перед їх надсиланням.
9. Чому зображення не відображаються в моїх електронних листах?
10. Це може бути пов’язано з тим, що поштовий клієнт блокує зображення за замовчуванням або через проблеми з посиланням на зображення в HTML-коді.

Завершуємо нашу дискусію про візуалізацію шаблонів

Щоб орієнтуватися у складнощах візуалізації електронної пошти за допомогою шаблонів FreeMarker, потрібне чітке розуміння як механізму шаблонів, так і можливостей клієнта електронної пошти. Використовуючи такі стратегії, як вбудовування CSS і ретельне тестування на різних клієнтах, розробники можуть значно покращити відображення електронних листів. Крім того, розуміння та використання правильної конфігурації Spring і класів Java може допомогти в доставці електронних листів, які відповідають очікуванням щодо дизайну, що зрештою забезпечить професійну та привабливу взаємодію з користувачем.