CRM/Activity/BAO/ICalendar.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.6                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2014                                |
   7  +--------------------------------------------------------------------+
   8  | This file is a part of CiviCRM.                                    |
   9  |                                                                    |
  10  | CiviCRM is free software; you can copy, modify, and distribute it  |
  11  | under the terms of the GNU Affero General Public License           |
  12  | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
  13  |                                                                    |
  14  | CiviCRM is distributed in the hope that it will be useful, but     |
  15  | WITHOUT ANY WARRANTY; without even the implied warranty of         |
  16  | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
  17  | See the GNU Affero General Public License for more details.        |
  18  |                                                                    |
  19  | You should have received a copy of the GNU Affero General Public   |
  20  | License and the CiviCRM Licensing Exception along                  |
  21  | with this program; if not, contact CiviCRM LLC                     |
  22  | at info[AT]civicrm[DOT]org. If you have questions about the        |
  23  | GNU Affero General Public License or the licensing of CiviCRM,     |
  24  | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
  25  +--------------------------------------------------------------------+
  26  */
  27
  28 /**
  29  *
  30  * @package CRM
  31  * @copyright CiviCRM LLC (c) 2004-2014
  32  * $Id$
  33  *
  34  */
  35
  36 /**
  37  * Generate ical invites for activities
  38  *
  39  */
  40 class CRM_Activity_BAO_ICalendar {
  41
  42   /**
  43    * @var object The activity for which we're generating ical.
  44    */
  45   protected $activity;
  46
  47   /**
  48    * Constructor.
  49    *
  50    * @param object $act
  51    *   Reference to an activity object.
  52    *
  53    * @return \CRM_Activity_BAO_ICalendar
  54    */
  55   public function __construct(&$act) {
  56     $this->activity = $act;
  57   }
  58
  59   /**
  60    * Add an ics attachment to the input array.
  61    *
  62    * @param array $attachments
  63    *   Reference to array in same format returned from CRM_Core_BAO_File::getEntityFile().
  64    * @param array $contacts
  65    *   Array of contacts (attendees).
  66    *
  67    * @return string|null
  68    *   Array index of the added attachment in the $attachments array, else NULL.
  69    */
  70   public function addAttachment(&$attachments, $contacts) {
  71     // Check preferences setting
  72     if (CRM_Core_BAO_Setting::getItem(CRM_Core_BAO_Setting::SYSTEM_PREFERENCES_NAME, 'activity_assignee_notification_ics')) {
  73       $config = &CRM_Core_Config::singleton();
  74       $this->icsfile = tempnam($config->customFileUploadDir, 'ics');
  75       if ($this->icsfile !== FALSE) {
  76         rename($this->icsfile, $this->icsfile . '.ics');
  77         $this->icsfile .= '.ics';
  78         $icsFileName = basename($this->icsfile);
  79
  80         // get logged in user's primary email
  81         // TODO: Is there a better way to do this?
  82         $organizer = $this->getPrimaryEmail();
  83
  84         $template = CRM_Core_Smarty::singleton();
  85         $template->assign('activity', $this->activity);
  86         $template->assign('organizer', $organizer);
  87         $template->assign('contacts', $contacts);
  88         $template->assign('timezone', date_default_timezone_get());
  89         $calendar = $template->fetch('CRM/Activity/Calendar/ICal.tpl');
  90         if (file_put_contents($this->icsfile, $calendar) !== FALSE) {
  91           if (empty($attachments)) {
  92             $attachments = array();
  93           }
  94           $attachments['activity_ics'] = array(
  95             'mime_type' => 'text/calendar',
  96             'fileName' => $icsFileName,
  97             'cleanName' => $icsFileName,
  98             'fullPath' => $this->icsfile,
  99           );
 100           return 'activity_ics';
 101         }
 102       }
 103     }
 104     return NULL;
 105   }
 106
 107   /**
 108    * Remove temp file.
 109    */
 110   public function cleanup() {
 111     if (!empty ($this->icsfile)) {
 112       @unlink($this->icsfile);
 113     }
 114   }
 115
 116   /**
 117    * TODO: Is there a better way to do this?
 118    * @return string
 119    */
 120   private function getPrimaryEmail() {
 121     $session = &CRM_Core_Session::singleton();
 122     $uid = $session->get('userID');
 123     $primary = '';
 124     $emails = CRM_Core_BAO_Email::allEmails($uid);
 125     foreach ($emails as $eid => $e) {
 126       if ($e['is_primary']) {
 127         if ($e['email']) {
 128           $primary = $e['email'];
 129           break;
 130         }
 131       }
 132
 133       if (count($emails) == 1) {
 134         $primary = $e['email'];
 135         break;
 136       }
 137     }
 138     return $primary;
 139   }
 140
 141 }