Install MT-Notifier

  • Download the MT-Notifier distribution archive.
  • Navigate to the Movable Type home directory.
  • Unpack the distribution archive.
  • Your archive should contain these files:
    • MT_HOME/mt-static/plugins/Notifier/images/Notifier.gif
    • MT_HOME/php/plugins/function.MTNotifierCatID.php
    • MT_HOME/plugins/Notifier/mt-notifier.cgi
    • MT_HOME/plugins/Notifier/mtplugin.pkg
    • MT_HOME/plugins/Notifier/Notifier.html
    • MT_HOME/plugins/Notifier/Notifier.pl
    • MT_HOME/plugins/Notifier/lib/Notifier.pm
    • MT_HOME/plugins/Notifier/lib/Notifier/Data.pm
    • MT_HOME/plugins/Notifier/lib/Notifier/History.pm
    • MT_HOME/plugins/Notifier/lib/Notifier/L10N.pm
    • MT_HOME/plugins/Notifier/lib/Notifier/Manager.pm
    • MT_HOME/plugins/Notifier/lib/Notifier/Queue.pm
    • MT_HOME/plugins/Notifier/lib/Notifier/Upgrader.pm
    • MT_HOME/plugins/Notifier/lib/Notifier/L10N/de.pm
    • MT_HOME/plugins/Notifier/lib/Notifier/L10N/en_us.pm
    • MT_HOME/plugins/Notifier/tmpl/header.tmpl
    • MT_HOME/plugins/Notifier/tmpl/notification_request.tmpl
    • MT_HOME/plugins/Notifier/tmpl/notifier_start.tmpl
    • MT_HOME/plugins/Notifier/tmpl/settings_blog.tmpl
    • MT_HOME/plugins/Notifier/tmpl/settings_system.tmpl
    • MT_HOME/plugins/Notifier/tmpl/subscription_view.tmpl
    • MT_HOME/plugins/Notifier/tmpl/email/confirmation.tmpl
    • MT_HOME/plugins/Notifier/tmpl/email/confirmation_subject.tmpl
    • MT_HOME/plugins/Notifier/tmpl/email/notification.tmpl
    • MT_HOME/plugins/Notifier/tmpl/email/notification_subject.tmpl
  • That's it - MT-Notifier is installed!
  • You don't need to do anything else unless you want to require confirmations.
  • Or unless you want your users to unsubscribe themselves Or use the queue.
  • In that case, make sure that mt-notifier.cgi is executable on your server.

MT-Notifier Settings

Unlike prior versions of MT-Notifier, version 3 does not contain a standalone interface. All configuration of the plugin is done through the new integrated settings, available at both the blog and site level.

While Movable Type 3.2 allows you to disable plugins at the site level, there is no way to do so at the blog level. MT-Notifier, however, includes an option - available at the blog level only - to disable itself. Since by default MT-Notifier is enabled upon installation, if you don't want it to be enabled, you should immediately disable it.

At the blog level, you should also verify the MT-Notifier setting to provide confirmation emails to your users. By default, this option is enabled, meaning any request that comes into the system will require confirmation. In other words, when someone subscribes, a confirmation email is sent to that address so that they can confirm both the existence of the address and the validity of the subscription request.

Also at the blog level, take a moment to indicate the email address to use when sending the confirmation messages, especially if you plan on offering either blog or category level subscriptions that require confirmation. This is because blogs and categories do not have email addresses associated with them (unlike most entries).

Most options are also available at the site level, so they can be set at the site level and then individual blogs can be set to override the options as needed. In some cases, both options must be set.

For instance, in order for a confirmation to be sent, both the site and the blog level confirmations must be enabled. If either is disabled, no confirmations will be sent - subscription requests will be automatically processed instead.

MT-Notifier Subscriptions

Now that your copy of MT-Notifier is installed and configured, you need to create some subscriptions. There are three ways to do this.

  • #1: Use the itemset action menus inside Movable Type.

Every list of items in Movable Type (for instance, entries) is called an itemset. Along with this itemset, you'll see a list of available actions in a drop-down control, from which you can select an action to perform on selected items. In this case, you can choose to Add Subscriptions, Block Subscriptions or View Subscription Count. Each of these is fairly self explanatory. Just select items from the list by clicking, then choose the item from the menu and click GO.

MT-Notifier Itemset Action Menu

When you do, you will be presented with another screen that allows you to add names (for subscribing or blocking subscriptions) or a screen that shows you a count of current subscribers (when viewing the count).

  • #2: Create a standalone subscription form.

To allow users to subscribe without you having to create subscriptions for them, you can add this HTML to your page. Just make sure you create it outside of any other forms that you have (including any comment forms):

<form method="get" action="<$MTCGIPath$>plugins/Notifier/mt-notifier.cgi">
<input type="hidden" name="blog_id" value="<$MTBlogID$>" />
Subscribe to This Blog<br/ >
<input name="email" />
<input type="submit" class="button" value="Go" />
</form>

Once you have added this form to the page, users can subscribe to be notified of new entries that are posted on your site. To allow your users to subscribe to a category instead of the entire blog, specify category_id (with a valid category ID) instead of blog_id.

Because there is no category ID tag within an entry, MT-Notifier includes a template tag for use in your templates called <$MTNotifierCatID> that you can use to fill in this field automatically, easily providing a "subscribe to this category" function if you so desire.

  • #3: Add a checkbox to your comment form for those leaving a comment.

This is the simplest change, but it requires that someone leave a comment. Just go into your template that contains your comment form and add this HTML:

<p><label for="subscribe">Subscribe to This Entry:</label>
<input type="checkbox" name="subscribe" value="1" /></p>

Once you have added this checkbox to your comment form, then anyone leaving a comment on your blog just needs to check the box and they will automatically be notified of any comments that are left.

Note that this is good for comment notifications only, where the first example of using the itemset action menu was good for entry notifications. You cannot use this method for entry notifications.

If you wish to allow users to subscribe to comments on an entry without having to leave a comment, you can do so by creating a standalone form, then replacing blog_id in the example with entry_id and inserting a valid entry ID (likely using the <$MTEntryID$> template tag).

Should you encounter any problems creating your subscriptions, you might want to visit the Troubleshooting Forms page.

Subscription Confirmations

  • Make sure that mt-notifier.cgi is executable on your server.
  • Both the system and blog confirmations must be on to send confirmations.
  • Add a default sender address using the system level plugin settings.
  • For any blogs that won't use this address, configure a blog-level address.
  • That's it. Now you can allow your users to confirm their subscriptions!

Using the MT-Notifier Queue

  • Make sure that mt-notifier.cgi is executable on your server.
  • Both the system and blog queue must be on to send notifications via queue.
  • Once notifications are in the queue, you must create a cron job to send them:
  • cd /home/username/mt/plugins/Notifier; ./mt-notifier.cgi queued 800
  • The first option (in italic) is the full filesystem path to MT-Notifier.
  • The second option (in bold) is the number of notifications to send.
  • Schedule the job as often as you would like, but don't run afoul of your host!
  • That's it. Now you can queue your notifications!