SMF Mod Site

Mod Name:
Automatic Newsletter for SMF2
Created By:
New Feature
First Created:
January 30, 2012, 01:01:26 PM
Last Modified:
October 11, 2018, 12:41:16 PM
Latest Version:
Compatible With:
2.0.2, 2.0.3, 2.0.4, 2.0.5, 2.0.9, 2.0.15
Total Downloads:

Download this mod (18kB) [469]
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 or SMFhacks Multimedia Gallery (if either are installed) - the newsletter email always includes an unsubscribe link as required by law.


  • 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).
  • Example 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 admin deletion of invalid or bounced emails
  • Newletter CSS styling can be edited in the SMF Language Editor
  • Newletter can be previewed before activating.
  • If a users account is deleted any newsletter subscription they may have will also be deleted

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

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

Adding Newsletter Subscription to an SMF Portal block
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 instructions) and paste the code from the file portal_block.php, included in this zip package into the new block.

added auto newsletter unsubscribe to user delete function
fixed various mini-bugs
now supports SMFpacks Multimedia Gallery images in addition to SMF Gallery
fixed youtube video URL to detect https//
added missing picture gallery exlcude cats to database
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

    This is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This software is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    GNU General Public License for more details.