scripts/lib/cocanwiki_emailnotify.ml

   1 (* COCANWIKI - a wiki written in Objective CAML.
   2  * Written by Richard W.M. Jones <rich@merjis.com>.
   3  * Copyright (C) 2004 Merjis Ltd.
   4  * $Id: cocanwiki_emailnotify.ml,v 1.9 2006/07/31 09:49:45 rich Exp $
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; see the file COPYING.  If not, write to
  18  * the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  19  * Boston, MA 02111-1307, USA.
  20  *)
  21
  22 open Apache
  23 open Registry
  24 open Cgi
  25 open Printf
  26
  27 open ExtList
  28
  29 open Cocanwiki
  30
  31 (* This is where we coordinate email notification from various
  32  * scripts which create or update the wiki.
  33  *)
  34 let email_notify ~subject ~body ?user dbh hostid =
  35   (* Get own userid, if we have it.  Don't want to send email
  36    * notification back to the person who changed the page.  If
  37    * we don't have a userid, set it to 0, because no real user can
  38    * have userid = 0.
  39    *
  40    * Also get the user's email address.
  41    *)
  42   let own_userid, from_addr =
  43     match user with
  44       | None
  45       | Some Anonymous -> 0l, None
  46       | Some (User (userid, _, _, {email = Some email})) ->
  47           userid, Some ("", email)
  48       | Some (User (userid, _, _, _)) ->
  49           userid, None in
  50
  51   (* Send a change email to everyone who hasn't opted out using
  52    * their preferences.  This behaviour replaces the old
  53    * 'email_notify' table.  Don't send email to invited accounts
  54    * who have not yet confirmed.
  55    *)
  56   let rows = PGSQL(dbh)
  57     "select name, email
  58        from users
  59       where hostid = $hostid and id <> $own_userid and email_notify
  60         and email is not null and invite is null" in
  61   let to_addrs = List.filter_map (
  62     function
  63     | (name, Some email) ->
  64         Some (name, email)
  65     | (name, None) -> None
  66   ) rows in
  67
  68   (* Get the canonical hostname. *)
  69   let canonical_hostname = List.hd (
  70     PGSQL(dbh)
  71       "select canonical_hostname from hosts where id = $hostid"
  72   ) in
  73
  74   if to_addrs <> [] then (
  75     (* Prepare the body of the message.  The assumption is that
  76      * this takes time and database access, so we defer the creation
  77      * of the body until we know that someone needs to be notified.
  78      *)
  79     let body = body () in
  80
  81     (* Add the opt-out signature to the body. *)
  82     let body = body ^ "\n\n-- \n" ^
  83       "To stop receiving further emails:\n" ^
  84       "(1) Go to http://" ^ canonical_hostname ^ "/_userprefs\n" ^
  85       "(2) Uncheck 'Receive email notifications'\n" ^
  86       "(3) Press 'Update Preferences'\n" in
  87
  88     let subject = canonical_hostname ^ ": " ^ subject in
  89
  90     let content_type =
  91       "text/plain", ["charset", Mimestring.mk_param "UTF-8"] in
  92
  93     (* Send the email. *)
  94     let msg =
  95       Netsendmail.compose ~to_addrs ?from_addr ~content_type ~subject body in
  96     Netsendmail.sendmail msg
  97   )