plugins/EmailReminder/lib/userconfirmregreminderhandler.php

   1 <?php
   2 /**
   3  * StatusNet - the distributed open-source microblogging tool
   4  *
   5  * Handler for queue items of type 'uregem' - sends email registration
   6  * confirmation reminders to a particular user.
   7  *
   8  * This program is free software: you can redistribute it and/or modify
   9  * it under the terms of the GNU Affero General Public License as published by
  10  * the Free Software Foundation, either version 3 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU Affero General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Affero General Public License
  19  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  20  *
  21  * @category  Email
  22  * @package   StatusNet
  23  * @author    Zach Copley <zach@status.net>
  24  * @copyright 2011 StatusNet, Inc.
  25  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
  26  * @link      http://status.net/
  27  */
  28
  29 if (!defined('STATUSNET')) {
  30     exit(1);
  31 }
  32
  33 /**
  34  * Handler for queue items of type 'uregrem'
  35  *
  36  * @category  Email
  37  * @package   StatusNet
  38  * @author    Zach Copley <zach@status.net>
  39  * @copyright 2011 StatusNet, Inc.
  40  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
  41  * @link      http://status.net/
  42  */
  43 class UserConfirmRegReminderHandler extends UserReminderHandler {
  44
  45     const REGISTER_REMINDER = 'register';
  46
  47     /**
  48      * Return transport keyword which identifies items this queue handler
  49      * services; must be defined for all subclasses.
  50      *
  51      * Must be 8 characters or less to fit in the queue_item database.
  52      * ex "email", "jabber", "sms", "irc", ...
  53      *
  54      * @return string
  55      */
  56     function transport() {
  57         return 'uregrem';
  58     }
  59
  60     /**
  61      * Send an email registration confirmation reminder until the user
  62      * confirms her registration. We'll send a reminder after one day,
  63      * three days, and a full week.
  64      *
  65      * @todo abstract this bit further
  66      *
  67      * @param Confirm_address $confirm
  68      * @return boolean success value
  69      */
  70     function sendNextReminder($confirm)
  71     {
  72         $regDate = strtotime($confirm->modified); // Seems like my best bet
  73         $now     = strtotime('now');
  74
  75         // Days since registration
  76         $days = ($now - $regDate) / 86499; // 60*60*24 = 86499
  77
  78         // Welcome to one of the ugliest switch statement I've ever written
  79
  80         switch($days) {
  81         case ($days > 1 && $days < 2):
  82             if (Email_reminder::needsReminder(self::REGISTER_REMINDER, $confirm, 1)) {
  83                 common_log(LOG_INFO, "Sending one day registration confirmation reminder to {$confirm->address}", __FILE__);
  84                 // TRANS: Subject for reminder e-mail.
  85                 $subject = _m('Reminder - please confirm your registration!');
  86                 return EmailReminderPlugin::sendReminder(
  87                     self::REGISTER_REMINDER,
  88                     $confirm,
  89                     $subject,
  90                 1);
  91             } else {
  92                 return true;
  93             }
  94             break;
  95         case ($days > 3 && $days < 4):
  96             if (Email_reminder::needsReminder(self::REGISTER_REMINDER, $confirm, 3)) {
  97                 common_log(LOG_INFO, "Sending three day registration confirmation reminder to {$confirm->address}", __FILE__);
  98                 // TRANS: Subject for reminder e-mail.
  99                 $subject = _m('Second reminder - please confirm your registration!');
 100                     return EmailReminderPlugin::sendReminder(
 101                         self::REGISTER_REMINDER,
 102                         $confirm,
 103                         $subject,
 104                         3
 105                     );
 106                 } else {
 107                     return true;
 108                 }
 109             break;
 110         case ($days > 7 && $days < 8):
 111             if (Email_reminder::needsReminder(self::REGISTER_REMINDER, $confirm, 7)) {
 112                 common_log(LOG_INFO, "Sending one week registration confirmation reminder to {$confirm->address}", __FILE__);
 113                 // TRANS: Subject for reminder e-mail.
 114                 $subject = _m('Final reminder - please confirm your registration!');
 115                 return EmailReminderPlugin::sendReminder(
 116                     self::REGISTER_REMINDER,
 117                     $confirm,
 118                     $subject,
 119                     7
 120                 );
 121             } else {
 122                 return true;
 123             }
 124             break;
 125         }
 126         return true;
 127     }
 128 }