1: <?php
  2: /**
  3:  * This class provides Horde-specific functions for the Horde_Prefs_Identity
  4:  * class.
  5:  *
  6:  * Copyright 2010-2012 Horde LLC (http://www.horde.org/)
  7:  *
  8:  * See the enclosed file COPYING for license information (LGPL). If you
  9:  * did not receive this file, see http://www.horde.org/licenses/lgpl21.
 10:  *
 11:  * @author   Jan Schneider <jan@horde.org>
 12:  * @author   Michael Slusarz <slusarz@horde.org>
 13:  * @category Horde
 14:  * @license  http://www.horde.org/licenses/lgpl21 LGPL 2.1
 15:  * @package  Core
 16:  */
 17: class Horde_Core_Prefs_Identity extends Horde_Prefs_Identity
 18: {
 19:     /**
 20:      * Sends a message to an email address supposed to be added to the
 21:      * identity.
 22:      * A message is send to this address containing a link to confirm that the
 23:      * address really belongs to that user.
 24:      *
 25:      * @param integer $id       The identity's ID.
 26:      * @param string $old_addr  The old From: address.
 27:      *
 28:      * @throws Horde_Mime_Exception
 29:      */
 30:     public function verifyIdentity($id, $old_addr)
 31:     {
 32:         global $conf;
 33: 
 34:         $hash = strval(new Horde_Support_Randomid());
 35: 
 36:         if (!($pref = @unserialize($this->_prefs->getValue('confirm_email')))) {
 37:             $pref = array();
 38:         }
 39:         $pref[$hash] = $this->get($id);
 40:         $this->_prefs->setValue('confirm_email', serialize($pref));
 41: 
 42:         $new_addr = $this->getValue($this->_prefnames['from_addr'], $id);
 43:         $confirm = Horde::url(Horde::getServiceLink('emailconfirm'), true)->add('h', $hash)->setRaw(true);
 44:         $message = sprintf(Horde_Core_Translation::t("You have requested to add the email address \"%s\" to the list of your personal email addresses.\n\nGo to the following link to confirm that this is really your address:\n%s\n\nIf you don't know what this message means, you can delete it."),
 45:                            $new_addr,
 46:                            $confirm);
 47: 
 48:         $msg_headers = new Horde_Mime_Headers();
 49:         $msg_headers->addMessageIdHeader();
 50:         $msg_headers->addUserAgentHeader();
 51:         $msg_headers->addHeader('Date', date('r'));
 52:         $msg_headers->addHeader('To', $new_addr);
 53:         $msg_headers->addHeader('From', $old_addr);
 54:         $msg_headers->addHeader('Subject', Horde_Core_Translation::t("Confirm new email address"));
 55: 
 56:         $body = new Horde_Mime_Part();
 57:         $body->setType('text/plain');
 58:         $body->setContents(Horde_String::wrap($message, 76));
 59:         $body->setCharset('UTF-8');
 60: 
 61:         $body->send($new_addr, $msg_headers, $GLOBALS['injector']->getInstance('Horde_Mail'));
 62: 
 63:         $GLOBALS['notification']->push(sprintf(Horde_Core_Translation::t("A message has been sent to \"%s\" to verify that this is really your address. The new email address is activated as soon as you confirm this message."), $new_addr), 'horde.message');
 64:     }
 65: 
 66:     /**
 67:      * Checks whether an identity confirmation is valid, and adds the
 68:      * validated identity.
 69:      *
 70:      * @param string $hash  The saved hash of the identity being validated.
 71:      */
 72:     public function confirmIdentity($hash)
 73:     {
 74:         global $notification;
 75: 
 76:         $confirm = $this->_prefs->getValue('confirm_email');
 77:         if (empty($confirm)) {
 78:             $notification->push(Horde_Core_Translation::t("There are no email addresses to confirm."), 'horde.message');
 79:             return;
 80:         }
 81: 
 82:         $confirm = @unserialize($confirm);
 83:         if (empty($confirm)) {
 84:             $notification->push(Horde_Core_Translation::t("There are no email addresses to confirm."), 'horde.message');
 85:             return;
 86:         } elseif (!isset($confirm[$hash])) {
 87:             $notification->push(Horde_Core_Translation::t("Email addresses to confirm not found."), 'horde.message');
 88:             return;
 89:         }
 90: 
 91:         $identity = $confirm[$hash];
 92:         $id = array_search($identity['id'], $this->getAll($this->_prefnames['id']));
 93:         if ($id === false) {
 94:             /* Adding a new identity. */
 95:             $verified = array();
 96:             foreach ($identity as $key => $value) {
 97:                 if (!$this->_prefs->isLocked($key)) {
 98:                     $verified[$key] = $value;
 99:                 }
100:             }
101:             $this->add($verified);
102:         } else {
103:             /* Updating an existing identity. */
104:             foreach ($identity as $key => $value) {
105:                 $this->setValue($key, $value, $id);
106:             }
107:         }
108:         $this->save();
109:         unset($confirm[$hash]);
110:         $this->_prefs->setValue('confirm_email', serialize($confirm));
111: 
112:         $notification->push(sprintf(Horde_Core_Translation::t("The email address %s has been added to your identities. You can close this window now."), $verified[$this->_prefnames['from_addr']]), 'horde.success');
113:     }
114: 
115:     /**
116:      * Returns the from address based on the chosen identity. If no
117:      * address can be found it is built from the current user name and
118:      * the specified maildomain.
119:      *
120:      * @param integer $ident  The identity to retrieve the address from.
121:      *
122:      * @return string  A valid from address.
123:      */
124:     public function getFromAddress($ident = null)
125:     {
126:         return $GLOBALS['prefs']->getValue('from_addr');
127:     }
128: 
129:     /**
130:      * Returns the identity's id that matches the passed addresses.
131:      *
132:      * @param mixed $addresses     Either an array or a single string or a
133:      *                             comma-separated list of email addresses.
134:      * @param boolean $search_own  Search for a matching identity in own
135:      *                             addresses also?
136:      *
137:      * @return integer  The id of the first identity that from or alias
138:      *                  addresses match (one of) the passed addresses or
139:      *                  null if none matches.
140:      */
141:     public function getMatchingIdentity($addresses, $search_own = true)
142:     {
143:         return null;
144:     }
145: 
146: }
147: