feat(newsletter): Add subscription confirmation email functionality

- Implemented `send_subscription_confirmation` function to send a confirmation email upon subscription. - Added a default HTML template for the confirmation email in settings. - Updated the newsletter management page to handle subscription and unsubscription actions. - Created new templates for embedding contact and newsletter forms. - Added styles for the new templates and unified CSS styles across the application. - Updated tests to reflect changes in the newsletter management API endpoints.
2025-10-30 12:38:26 +01:00
parent f7695be8ef
commit 56840ac313
24 changed files with 897 additions and 449 deletions
--- a/server/services/newsletter.py
+++ b/server/services/newsletter.py
@@ -28,6 +28,61 @@ def update_email(old_email: str, new_email: str) -> bool:
    return update_subscriber(old_email, new_email)


+def send_subscription_confirmation(email: str) -> bool:
+    """Send a confirmation email to the subscriber."""
+    import logging
+    from .. import settings
+
+    if not settings.SMTP_SETTINGS["host"]:
+        logging.info("SMTP not configured; skipping confirmation email")
+        return False
+
+    # Get template from settings or default
+    template = getattr(settings, 'NEWSLETTER_CONFIRMATION_TEMPLATE', """
+    <html>
+    <body>
+        <h2>Welcome to our Newsletter!</h2>
+        <p>Thank you for subscribing to our newsletter. You're now part of our community and will receive updates on our latest news and offers.</p>
+        <p>If you wish to unsubscribe at any time, you can do so by visiting our <a href="https://your-domain.com/newsletter/manage">subscription management page</a>.</p>
+        <p>Best regards,<br>The Team</p>
+    </body>
+    </html>
+    """).strip()
+
+    try:
+        import smtplib
+        from email.mime.text import MIMEText
+        from email.mime.multipart import MIMEMultipart
+
+        sender = settings.SMTP_SETTINGS["sender"] or "noreply@example.com"
+
+        # Create message
+        msg = MIMEMultipart('alternative')
+        msg['Subject'] = "Newsletter Subscription Confirmation"
+        msg['From'] = sender
+        msg['To'] = email
+
+        # Add HTML content
+        html_part = MIMEText(template, 'html')
+        msg.attach(html_part)
+
+        # Send email
+        with smtplib.SMTP(settings.SMTP_SETTINGS["host"], settings.SMTP_SETTINGS["port"], timeout=15) as server:
+            if settings.SMTP_SETTINGS["use_tls"]:
+                server.starttls()
+            if settings.SMTP_SETTINGS["username"]:
+                server.login(
+                    settings.SMTP_SETTINGS["username"], settings.SMTP_SETTINGS["password"] or "")
+            server.send_message(msg)
+
+        logging.info("Confirmation email sent to %s", email)
+        return True
+
+    except Exception as exc:
+        logging.exception("Failed to send confirmation email to %s: %s", email, exc)
+        return False
+
+
 def send_newsletter_to_subscribers(subject: str, content: str, emails: list[str], sender_name: str | None = None) -> int:
    """Send newsletter to list of email addresses. Returns count of successful sends."""
    import logging