Newsletters / Notifications / E-mail

These FAQs briefly summarise key points on how to configure e-mail for Composr and also how to create and send newsletters. These also touch on notifications and digest e-mails.

For more information, check out these tutorials:
Question How does Composr send emails?
Answer Composr constructs emails using language strings and templates written in Comcode. It sends emails in both HTML and plain text formats to ensure compatibility with different email clients. To minimize the chance of emails being marked as spam, Composr embeds CSS and images directly into the email instead of linking to them externally.

View

Question How do I configure SMTP settings in Composr?
Answer Composr can use either its own SMTP connection code or PHP's built-in SMTP functionality. Using PHP's SMTP settings is generally recommended and can be managed at the server level. However, if your SMTP server requires authentication (which PHP doesn't support natively) or if your server lacks an SMTP server, you'll need to use Composr's SMTP connection code, configurable in the Configuration module.

View

Question Why are my emails being blocked by spam filters?
Answer Several factors can cause emails to be blocked:
  • Server issues: Your server might be on a spam blacklist, or there may be problems with your server's reverse DNS or HELO settings.
  • Content issues: Your email content might trigger spam filters due to factors like an unreasonable image-to-text ratio, broken reply-to addresses, or inconsistent text and HTML versions.
  • SPF records: Your "Website email address" might be hosted on a different server with an SPF record that doesn't authorize your web server to send emails from that address.

View

Question How can I prevent my emails from being marked as spam?
Answer Here are some tips to reduce the likelihood of your emails being flagged as spam:
  • Set up SPF records: SPF (Sender Policy Framework) helps verify that your server is authorized to send emails from your domain.
  • Ask users to whitelist your email address: Encourage recipients to add your email address to their contacts list or "Safe Senders" list.
  • Configure DKIM: DKIM (DomainKeys Identified Mail) adds a digital signature to your emails, increasing their legitimacy.
  • Use a reputable email service provider: Consider using a third-party email service if you're struggling with email deliverability.

View

Question What are the different ways to target recipients for my newsletters?
Answer Composr offers several targeting options:
  • Subscriptions: Users can specifically subscribe to newsletters, separate from site membership.
  • Usergroups (Conversr only): You can send newsletters to members of specific usergroups, regardless of their newsletter subscriptions.
  • CSV imports/exports: You can import subscribers from a CSV file or export your subscriber list for custom targeting.

View

Question How can I ensure my newsletters comply with data privacy regulations?
Answer Composr provides built-in mechanisms for compliance:
  • Unsubscribe links: Newsletters include an unsubscribe link, allowing recipients to opt out of the newsletters.
  • Global unsubscribe: All Composr emails include a link to a global unsubscribe page (data/unsubscribe.php), letting users unsubscribe from all site emails.

View

Question How can I customize the appearance of my newsletters?
Answer You can customize the look of your newsletters by editing the following templates:
  • NEWSLETTER_DEFAULT_FCOMCODE.txt: This template defines the default content and layout for newsletters.
  • MAIL.tpl: This template controls the overall appearance of emails sent from Composr.
  • Custom mail templates: You can create custom HTML templates for specific newsletters.

View

Question How can I handle bounced emails?
Answer Composr includes a bounce filter tool that helps you remove bounced email addresses from your subscriber list. To use this tool, you'll need:
  • The PHP IMAP extension enabled on your server.
  • A dedicated folder on your email server to collect bounced emails.

The bounce filter tool scans the specified folder for bounce messages and lets you remove the corresponding addresses from your newsletter list. Composr will also halt attempts sending e-mails to those addresses to help prevent you from getting listed on spam blocklists.

View

Question What notification options are available to members?
Answer Members can choose from a wide range of notifications, including:
  • Content Updates: Notifications for new or updated content, such as news articles, forum posts, and gallery images.
  • Private Messages: Alerts for new private messages received.
  • Friend Requests: Notifications for new friend requests.
  • Administrative Actions: Alerts for actions taken by site administrators, such as account approvals or content moderation decisions.

Members can choose to receive notifications via:
  • Email: Notifications sent directly to their email address.
  • Digest Email: Combined summaries of activity sent in batched emails. This requires the system scheduler and the digest e-mails configuration option to be enabled.
  • Private Topics: Notifications delivered as private forum topics.
  • SMS: Notifications sent as text messages (requires configuration and incurs costs).
  • Web Notifications: Real-time alerts displayed within the Composr interface.

View

Question Can I control which notifications members receive?
Answer Yes, you can control notification settings through two mechanisms:
  • Notification Defaults: You can set default notification preferences for all members. You can enable or disable specific notifications and choose the delivery method (Admin Zone > Setup > Notification defaults).
  • Notification Lock-down: You can force members to receive or prevent them from receiving certain notifications (Admin Zone > Setup > Notification lock-down). This allows you to enforce specific notification policies and manage email volume.

View

Question How can I troubleshoot notification problems?
Answer If you're having issues with notifications, here are some troubleshooting steps:
  • Check Email Logs: View the email log (Admin Zone > Audit > E-mail queue/log) to see what notifications have been sent.
  • Use the SU Feature: Impersonate a member using the SU feature (described in the "Testing access and privileges" tutorial) to view their notification settings and confirm they are set up correctly.
  • Enable Carbon-copy Email: Configure a "Carbon-copy e-mail address" in the configuration settings to receive copies of all outgoing emails, including notifications. This helps you monitor email delivery.
  • Verify System Scheduler: Ensure the system scheduler is configured correctly if members are not receiving digest emails.
  • Check Digest Settings: Confirm that "Enable digest notifications" is enabled in the Messages configuration settings.
  • Review "Safety listing limit": If a notification has too many categories, members might not see the full selection tree. Adjust the "Safety listing limit" in the configuration settings if necessary.

View