[Summary view] [Print] [Text view]

   1  <?php
   2  // This file is part of Moodle - http://moodle.org/
   3  //
   4  // Moodle is free software: you can redistribute it and/or modify
   5  // it under the terms of the GNU General Public License as published by
   6  // the Free Software Foundation, either version 3 of the License, or
   7  // (at your option) any later version.
   8  //
   9  // Moodle is distributed in the hope that it will be useful,
  10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  // GNU General Public License for more details.
  13  //
  14  // You should have received a copy of the GNU General Public License
  15  // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  16  
  17  /**
  18   * Airnotifier message processor to send messages to the APNS provider: airnotfier. (https://github.com/dongsheng/airnotifier)
  19   *
  20   * @package    message_airnotifier
  21   * @category   external
  22   * @copyright  2012 Jerome Mouneyrac <[email protected]>
  23   * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  24   * @since Moodle 2.7
  25   */
  26  
  27  
  28  require_once($CFG->dirroot . '/message/output/lib.php');
  29  
  30  /**
  31   * Message processor class
  32   *
  33   * @package   message_airnotifier
  34   * @copyright 2012 Jerome Mouneyrac
  35   * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  36   */
  37  class message_output_airnotifier extends message_output {
  38  
  39      /**
  40       * Processes the message and sends a notification via airnotifier
  41       *
  42       * @param stdClass $eventdata the event data submitted by the message sender plus $eventdata->savedmessageid
  43       * @return true if ok, false if error
  44       */
  45      public function send_message($eventdata) {
  46          global $CFG;
  47          require_once($CFG->libdir . '/filelib.php');
  48  
  49          if (!empty($CFG->noemailever)) {
  50              // Hidden setting for development sites, set in config.php if needed.
  51              debugging('$CFG->noemailever active, no airnotifier message sent.', DEBUG_MINIMAL);
  52              return true;
  53          }
  54  
  55          // Skip any messaging suspended and deleted users.
  56          if ($eventdata->userto->auth === 'nologin' or
  57              $eventdata->userto->suspended or
  58              $eventdata->userto->deleted) {
  59              return true;
  60          }
  61  
  62          // Site id, to map with Moodle Mobile stored sites.
  63          $siteid = md5($CFG->wwwroot . $eventdata->userto->username);
  64  
  65          // Airnotifier can handle custom requests using processors (that are Airnotifier plugins).
  66          // In the extra parameter we indicate which processor to use and also additional data to be handled by the processor.
  67          // Here we clone the eventdata object because will be deleting/adding attributes.
  68          $extra = clone $eventdata;
  69  
  70          // Delete attributes that may content private information.
  71          if (!empty($eventdata->userfrom)) {
  72              $extra->userfromid = $eventdata->userfrom->id;
  73              $extra->userfromfullname = fullname($eventdata->userfrom);
  74              unset($extra->userfrom);
  75          }
  76          $extra->usertoid = $eventdata->userto->id;
  77          unset($extra->userto);
  78  
  79          $extra->processor       = 'moodle';
  80          $extra->site            = $siteid;
  81          $extra->date            = (!empty($eventdata->timecreated)) ? $eventdata->timecreated : time();
  82          $extra->notification    = (!empty($eventdata->notification)) ? 1 : 0;
  83  
  84          // We are sending to message to all devices.
  85          $airnotifiermanager = new message_airnotifier_manager();
  86          $devicetokens = $airnotifiermanager->get_user_devices($CFG->airnotifiermobileappname, $eventdata->userto->id);
  87  
  88          foreach ($devicetokens as $devicetoken) {
  89  
  90              if (!$devicetoken->enable) {
  91                  continue;
  92              }
  93  
  94              // Sending the message to the device.
  95              $serverurl = $CFG->airnotifierurl . ':' . $CFG->airnotifierport . '/api/v2/push/';
  96              $header = array('Accept: application/json', 'X-AN-APP-NAME: ' . $CFG->airnotifierappname,
  97                  'X-AN-APP-KEY: ' . $CFG->airnotifieraccesskey);
  98              $curl = new curl;
  99              $curl->setHeader($header);
 100  
 101              $params = array(
 102                  'device'    => $devicetoken->platform,
 103                  'token'     => $devicetoken->pushid,
 104                  'extra'     => $extra
 105              );
 106  
 107              // JSON POST raw body request.
 108              $resp = $curl->post($serverurl, json_encode($params));
 109          }
 110  
 111          return true;
 112      }
 113  
 114      /**
 115       * Creates necessary fields in the messaging config form.
 116       *
 117       * @param array $preferences An array of user preferences
 118       */
 119      public function config_form($preferences) {
 120          global $CFG, $OUTPUT, $USER, $PAGE;
 121  
 122          $systemcontext = context_system::instance();
 123          if (!has_capability('message/airnotifier:managedevice', $systemcontext)) {
 124              return get_string('nopermissiontomanagedevices', 'message_airnotifier');
 125          }
 126  
 127          if (!$this->is_system_configured()) {
 128              return get_string('notconfigured', 'message_airnotifier');
 129          } else {
 130  
 131              $PAGE->requires->css('/message/output/airnotifier/style.css');
 132  
 133              $airnotifiermanager = new message_airnotifier_manager();
 134              $devicetokens = $airnotifiermanager->get_user_devices($CFG->airnotifiermobileappname, $USER->id);
 135  
 136              if (!empty($devicetokens)) {
 137                  $output = '';
 138  
 139                  foreach ($devicetokens as $devicetoken) {
 140  
 141                      if ($devicetoken->enable) {
 142                          $hideshowiconname = 't/hide';
 143                          $dimmed = '';
 144                      } else {
 145                          $hideshowiconname = 't/show';
 146                          $dimmed = 'dimmed_text';
 147                      }
 148  
 149                      $hideshowicon = $OUTPUT->pix_icon($hideshowiconname, get_string('showhide', 'message_airnotifier'));
 150                      $name = "{$devicetoken->name} {$devicetoken->model} {$devicetoken->platform} {$devicetoken->version}";
 151                      $hideurl = new moodle_url('message/output/airnotifier/action.php',
 152                                      array('hide' => !$devicetoken->enable, 'deviceid' => $devicetoken->id,
 153                                          'sesskey' => sesskey()));
 154  
 155                      $output .= html_writer::start_tag('li', array('id' => $devicetoken->id,
 156                                                                      'class' => 'airnotifierdevice ' . $dimmed)) . "\n";
 157                      $output .= html_writer::label($name, 'deviceid-' . $devicetoken->id, array('class' => 'devicelabel ')) . ' ' .
 158                          html_writer::link($hideurl, $hideshowicon, array('class' => 'hidedevice', 'alt' => 'show/hide')) . "\n";
 159                      $output .= html_writer::end_tag('li') . "\n";
 160                  }
 161  
 162                  // Include the AJAX script to automatically trigger the action.
 163                  $airnotifiermanager->include_device_ajax();
 164  
 165                  $output = html_writer::tag('ul', $output, array('id' => 'airnotifierdevices'));
 166              } else {
 167                  $output = get_string('nodevices', 'message_airnotifier');
 168              }
 169              return $output;
 170          }
 171      }
 172  
 173      /**
 174       * Parses the submitted form data and saves it into preferences array.
 175       *
 176       * @param stdClass $form preferences form class
 177       * @param array $preferences preferences array
 178       */
 179      public function process_form($form, &$preferences) {
 180          return true;
 181      }
 182  
 183      /**
 184       * Loads the config data from database to put on the form during initial form display
 185       *
 186       * @param array $preferences preferences array
 187       * @param int $userid the user id
 188       */
 189      public function load_data(&$preferences, $userid) {
 190          return true;
 191      }
 192  
 193      /**
 194       * Tests whether the airnotifier settings have been configured
 195       * @return boolean true if airnotifier is configured
 196       */
 197      public function is_system_configured() {
 198          $airnotifiermanager = new message_airnotifier_manager();
 199          return $airnotifiermanager->is_system_configured();
 200      }
 201  }
 202