SMF Mod Site

Mod Name:
Automatic Newsletter for SMF2
Created By:
New Feature
First Created:
January 30, 2012, 01:01:26 PM
Last Modified:
January 22, 2015, 04:45:37 PM
Latest Version:
Compatible With:
2.0.2, 2.0.3, 2.0.4, 2.0.5, 2.0.9
Total Downloads:

Download this mod (17kB) [1660]
Manual Install Instructions for SMF

Below are some preview images of what the mod looks like when being used


Allows anyone (including guests) to subscribe to an automatically generated weekly. fortnightly or monthly email newsletter.  Guests need to enter their email address, registered members don't.  The subscription options shows above the board index and (optionally) during forum registration.

The Newsletter can optionally contain forum stats, the latest news item, recent topics list, upcoming events from the calendar, video links (included in posts), and recent picture from SMF Gallery (if installed) - the newsletter email always includes an unsubscribe link.


  • Newsletter can be subscribed to during initial forum registration or at any time
  • Newsletter frequency can be selected by the user when subscribing (weekly, fortnightly or monthly)
  • Frequency timer starts from when the user subscribes (to reduce server email load).
  • Subscriber can unsubscribe on the forum OR by clicking an "unsubscribe" link in the Newsletter.
  • Newsletter sub/unsubscribe options show above OR below forum list.
  • Newsletter is HTML formatted (includes plain text version) using forum name and logo image (styling can be edited).
  • Portal PHP block code included (to allow newletter subscription options to appear on any portal page (using a custom portal PHP block)

Admin Settings:
  • Allow guest to subscribe to the newsletter.
  • Use guest permissions when selecting topics, videos and pictures to include.
  • Choose position of Subscribe/Unsubscribe buttons (top or bottom of forum listing)
  • Chose whether subscribtion option is shown during forum registration
  • Number of recent topic titles/links to include in the newsletter (set to 0 to exclude topics from the newsletter)
  • Select which boards to exclude when selecting topics
  • Number of recent videos to include (set to 0 to exclude videos from the newsletter)
  • Select which boards to exclude videos from
  • Include SMF Gallery pictures
  • Gallery categories to ignore
  • Include basic forum stats
  • Include the latest news item (the SMF newsfader doesn't have to be enabled)
  • Include basic forum stats
  • Include calendar events
  • Manual subscribtion removal by email address - allows deletion of invalid or bouncing emails
  • Newletter CSS styling can be edited in the SMF Language Editor
  • Newletter can be previewed before activating.

Note that unless you have selected guest permissions or exclude some board(s) then the titles of (and links to) new topics that appear in ALL boards will be included in the newsletter even if the recipient does not have permission to read the topic post itself.  This can be used as a way to encourage forum or group membership by showing topic titles but not allowing access to the content.

To change the CSS styling of the newsletter:
Admin->Configuration->Languages->Edit Languages->(whatever your langueg is called)->edit Languages Entries -> select "Modifications"
... find and edit the CSS string "newsltr_email_style"

PHP version 5.2 or higher
SMF version 2.0 or higher

1. On some web hosts you may need to disable compression in SMF (if the newletter preview shows a blank page):
Admin->Configuration->Server Settings->General and clear enable compressed output option

2. Adding Newsletter Subscription to a Portal page
You can add the newsletter subscription options on any portal page (if it supports custom PHP code blocks - EzPortal, SimplePortal, etc.)  After installing this mod, create a new custom PHP block in your portal (see portal instaructions) and paste the code from the file portal_block.php, included in this zip package into the new block.

3. This mod is affected by a bug in the SMF 2.0.8->2.0.9 patch - see HERE for description of the issue and a fix.

added subscribe on register feature
fixed portal_block.php syntax error
added more robust check for SMF Gallery
fixed bug in video inclusion code (shows in error log)
added sample portal PHP block code
fixed SMF_Gallery detection bug in adminsettings
Cleaned up HTML format imporving email client compatibility
Newsletter can include SMF Gallery pictures and YouTube videos (from posts)
Now works properly on forums with unsupported languages (reverts to english)
moved newsletter CSS style to languages - can now be edited by an admin

   Copyright 2012/2013 John Robertson
   Released under the GNU/GPL license