]> scripts.mit.edu Git - autoinstalls/mediawiki.git/blobdiff - includes/SpecialEmailuser.php
MediaWiki 1.11.0
[autoinstalls/mediawiki.git] / includes / SpecialEmailuser.php
index 2e667d5e5eb4c9f8a36d0a270f614c75cac144bb..1d5a964731ae30527cf3c2a93ff4fe1b0d275431 100644 (file)
@@ -1,58 +1,70 @@
 <?php
 /**
  *
- * @package MediaWiki
- * @subpackage SpecialPage
+ * @addtogroup SpecialPage
  */
 
-/**
- *
- */
 require_once('UserMailer.php');
 
+/**
+ * @todo document
+ */
 function wfSpecialEmailuser( $par ) {
        global $wgUser, $wgOut, $wgRequest, $wgEnableEmail, $wgEnableUserEmail;
 
        if( !( $wgEnableEmail && $wgEnableUserEmail ) ) {
-               $wgOut->errorpage( "nosuchspecialpage", "nospecialpagetext" );
+               $wgOut->showErrorPage( "nosuchspecialpage", "nospecialpagetext" );
                return;
        }
-       
+
        if( !$wgUser->canSendEmail() ) {
                wfDebug( "User can't send.\n" );
-               $wgOut->errorpage( "mailnologin", "mailnologintext" );
+               $wgOut->showErrorPage( "mailnologin", "mailnologintext" );
                return;
        }
-       
+
        $action = $wgRequest->getVal( 'action' );
        $target = isset($par) ? $par : $wgRequest->getVal( 'target' );
        if ( "" == $target ) {
                wfDebug( "Target is empty.\n" );
-               $wgOut->errorpage( "notargettitle", "notargettext" );
+               $wgOut->showErrorPage( "notargettitle", "notargettext" );
                return;
        }
-       
+
        $nt = Title::newFromURL( $target );
        if ( is_null( $nt ) ) {
                wfDebug( "Target is invalid title.\n" );
-               $wgOut->errorpage( "notargettitle", "notargettext" );
+               $wgOut->showErrorPage( "notargettitle", "notargettext" );
                return;
        }
-       
+
        $nu = User::newFromName( $nt->getText() );
        if( is_null( $nu ) || !$nu->canReceiveEmail() ) {
                wfDebug( "Target is invalid user or can't receive.\n" );
-               $wgOut->errorpage( "noemailtitle", "noemailtext" );
+               $wgOut->showErrorPage( "noemailtitle", "noemailtext" );
                return;
        }
 
-       $address = $nu->getEmail();
-       $f = new EmailUserForm( $nu->getName() . " <{$address}>", $target );
+       if ( $wgUser->isBlockedFromEmailUser() ) {
+               // User has been blocked from sending e-mail. Show the std blocked form.
+               wfDebug( "User is blocked from sending e-mail.\n" );
+               $wgOut->blockedPage();
+               return;
+       }
+
+       $f = new EmailUserForm( $nu );
 
        if ( "success" == $action ) {
-               $f->showSuccess();
+               $f->showSuccess( $nu );
        } else if ( "submit" == $action && $wgRequest->wasPosted() &&
-               $wgUser->matchEditToken( $wgRequest->getVal( 'wpEditToken' ) ) ) {
+                               $wgUser->matchEditToken( $wgRequest->getVal( 'wpEditToken' ) ) ) 
+       {
+               # Check against the rate limiter
+               if( $wgUser->pingLimiter( 'emailuser' ) ) {
+                       $wgOut->rateLimited();
+                       return;
+               }
+
                $f->doSubmit();
        } else {
                $f->showForm();
@@ -60,51 +72,54 @@ function wfSpecialEmailuser( $par ) {
 }
 
 /**
- * @todo document
- * @package MediaWiki
- * @subpackage SpecialPage
+ * Implements the Special:Emailuser web interface, and invokes userMailer for sending the email message.
+ * @addtogroup SpecialPage
  */
 class EmailUserForm {
 
-       var $mAddress;
        var $target;
        var $text, $subject;
+       var $cc_me;     // Whether user requested to be sent a separate copy of their email.
 
-       function EmailUserForm( $addr, $target ) {
+       /**
+        * @param User $target
+        */
+       function EmailUserForm( $target ) {
                global $wgRequest;
-               $this->mAddress = $addr;
                $this->target = $target;
                $this->text = $wgRequest->getText( 'wpText' );
                $this->subject = $wgRequest->getText( 'wpSubject' );
+               $this->cc_me = $wgRequest->getBool( 'wpCCMe' );
        }
 
        function showForm() {
-               global $wgOut, $wgUser, $wgLang;
+               global $wgOut, $wgUser;
 
                $wgOut->setPagetitle( wfMsg( "emailpage" ) );
                $wgOut->addWikiText( wfMsg( "emailpagetext" ) );
 
-               if ( $this->subject === "" ) { 
-                       $this->subject = wfMsg( "defemailsubject" ); 
+               if ( $this->subject === "" ) {
+                       $this->subject = wfMsg( "defemailsubject" );
                }
 
                $emf = wfMsg( "emailfrom" );
                $sender = $wgUser->getName();
                $emt = wfMsg( "emailto" );
-               $rcpt = str_replace( "_", " ", $this->target );
+               $rcpt = $this->target->getName();
                $emr = wfMsg( "emailsubject" );
                $emm = wfMsg( "emailmessage" );
                $ems = wfMsg( "emailsend" );
+               $emc = wfMsg( "emailccme" );
                $encSubject = htmlspecialchars( $this->subject );
-               
-               $titleObj = Title::makeTitle( NS_SPECIAL, "Emailuser" );
+
+               $titleObj = SpecialPage::getTitleFor( "Emailuser" );
                $action = $titleObj->escapeLocalURL( "target=" .
-                       urlencode( $this->target ) . "&action=submit" );
-               $token = $wgUser->editToken();
+                       urlencode( $this->target->getName() ) . "&action=submit" );
+               $token = htmlspecialchars( $wgUser->editToken() );
 
                $wgOut->addHTML( "
 <form id=\"emailuser\" method=\"post\" action=\"{$action}\">
-<table border='0'><tr>
+<table border='0' id='mailheader'><tr>
 <td align='right'>{$emf}:</td>
 <td align='left'><strong>" . htmlspecialchars( $sender ) . "</strong></td>
 </tr><tr>
@@ -113,50 +128,68 @@ class EmailUserForm {
 </tr><tr>
 <td align='right'>{$emr}:</td>
 <td align='left'>
-<input type='text' name=\"wpSubject\" value=\"{$encSubject}\" />
+<input type='text' size='60' maxlength='200' name=\"wpSubject\" value=\"{$encSubject}\" />
 </td>
-</tr><tr>
-<td align='right'>{$emm}:</td>
-<td align='left'>
-<textarea name=\"wpText\" rows='10' cols='60' wrap='virtual'>" . htmlspecialchars( $this->text ) .
+</tr>
+</table>
+<span id='wpTextLabel'><label for=\"wpText\">{$emm}:</label><br /></span>
+<textarea name=\"wpText\" rows='20' cols='80' wrap='virtual' style=\"width: 100%;\">" . htmlspecialchars( $this->text ) .
 "</textarea>
-</td></tr><tr>
-<td>&nbsp;</td><td align='left'>
+" . wfCheckLabel( $emc, 'wpCCMe', 'wpCCMe', $wgUser->getBoolOption( 'ccmeonemails' ) ) . "<br />
 <input type='submit' name=\"wpSend\" value=\"{$ems}\" />
-</td></tr></table>
 <input type='hidden' name='wpEditToken' value=\"$token\" />
 </form>\n" );
 
        }
 
        function doSubmit() {
-               global $wgOut, $wgUser, $wgLang, $wgOutputEncoding;
-           
-               $from = wfQuotedPrintable( $wgUser->getName() ) . " <" . $wgUser->getEmail() . ">";
-               $subject = wfQuotedPrintable( $this->subject );
-               
-               if (wfRunHooks('EmailUser', array(&$this->mAddress, &$from, &$subject, &$this->text))) {
-                       
-                       $mailResult = userMailer( $this->mAddress, $from, $subject, $this->text );
-                       
+               global $wgOut, $wgUser;
+
+               $to = new MailAddress( $this->target );
+               $from = new MailAddress( $wgUser );
+               $subject = $this->subject;
+
+               if( wfRunHooks( 'EmailUser', array( &$to, &$from, &$subject, &$this->text ) ) ) {
+
+                       $mailResult = userMailer( $to, $from, $subject, $this->text );
+
                        if( WikiError::isError( $mailResult ) ) {
                                $wgOut->addHTML( wfMsg( "usermailererror" ) . $mailResult);
                        } else {
-                               $titleObj = Title::makeTitle( NS_SPECIAL, "Emailuser" );
-                               $encTarget = wfUrlencode( $this->target );
+                               
+                               // if the user requested a copy of this mail, do this now,
+                               // unless they are emailing themselves, in which case one copy of the message is sufficient.
+                               if ($this->cc_me && $to != $from) {
+                                       $cc_subject = wfMsg('emailccsubject', $this->target->getName(), $subject);
+                                       if( wfRunHooks( 'EmailUser', array( &$from, &$from, &$cc_subject, &$this->text ) ) ) {
+                                               $ccResult = userMailer( $from, $from, $cc_subject, $this->text );
+                                               if( WikiError::isError( $ccResult ) ) {
+                                                       // At this stage, the user's CC mail has failed, but their 
+                                                       // original mail has succeeded. It's unlikely, but still, what to do?
+                                                       // We can either show them an error, or we can say everything was fine,
+                                                       // or we can say we sort of failed AND sort of succeeded. Of these options, 
+                                                       // simply saying there was an error is probably best.
+                                                       $wgOut->addHTML( wfMsg( "usermailererror" ) . $ccResult);
+                                                       return;
+                                               }
+                                       }
+                               }
+                               
+                               $titleObj = SpecialPage::getTitleFor( "Emailuser" );
+                               $encTarget = wfUrlencode( $this->target->getName() );
                                $wgOut->redirect( $titleObj->getFullURL( "target={$encTarget}&action=success" ) );
-                               wfRunHooks('EmailUserComplete', array($this->mAddress, $from, $subject, $this->text));
+                               wfRunHooks( 'EmailUserComplete', array( $to, $from, $subject, $this->text ) );
                        }
                }
        }
 
-       function showSuccess() {
-               global $wgOut, $wgUser;
+       function showSuccess( &$user ) {
+               global $wgOut;
 
                $wgOut->setPagetitle( wfMsg( "emailsent" ) );
                $wgOut->addHTML( wfMsg( "emailsenttext" ) );
 
-               $wgOut->returnToMain( false );
+               $wgOut->returnToMain( false, $user->getUserPage() );
        }
 }
-?>
+