Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 3.9.x will end* 10 May 2021 (12 months).
  • Bug fixes for security issues in 3.9.x will end* 8 May 2023 (36 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.
<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

/**
< * Airnotifier message processor to send messages to the APNS provider: airnotfier. (https://github.com/dongsheng/airnotifier)
> * Airnotifier message processor to send messages to the APNS provider: airnotfier. (https://github.com/dcai/airnotifier)
* * @package message_airnotifier * @category external * @copyright 2012 Jerome Mouneyrac <jerome@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @since Moodle 2.7 */ require_once($CFG->dirroot . '/message/output/lib.php'); /** * Message processor class * * @package message_airnotifier * @copyright 2012 Jerome Mouneyrac * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class message_output_airnotifier extends message_output { /** * Processes the message and sends a notification via airnotifier * * @param stdClass $eventdata the event data submitted by the message sender plus $eventdata->savedmessageid * @return true if ok, false if error */ public function send_message($eventdata) { global $CFG, $DB; require_once($CFG->libdir . '/filelib.php'); if (!empty($CFG->noemailever)) { // Hidden setting for development sites, set in config.php if needed. debugging('$CFG->noemailever active, no airnotifier message sent.', DEBUG_MINIMAL); return true; } // Skip any messaging suspended and deleted users. if ($eventdata->userto->auth === 'nologin' or $eventdata->userto->suspended or $eventdata->userto->deleted) { return true; } // If username is empty we try to retrieve it, since it's required to generate the siteid. if (empty($eventdata->userto->username)) { $eventdata->userto->username = $DB->get_field('user', 'username', array('id' => $eventdata->userto->id)); } // Site id, to map with Moodle Mobile stored sites. $siteid = md5($CFG->wwwroot . $eventdata->userto->username); // Airnotifier can handle custom requests using processors (that are Airnotifier plugins). // In the extra parameter we indicate which processor to use and also additional data to be handled by the processor. // Here we clone the eventdata object because will be deleting/adding attributes. $extra = clone $eventdata; // Delete attributes that may content private information. if (!empty($eventdata->userfrom)) { $extra->userfromid = $eventdata->userfrom->id; $extra->userfromfullname = fullname($eventdata->userfrom); unset($extra->userfrom); } $extra->usertoid = $eventdata->userto->id; unset($extra->userto); $extra->processor = 'moodle'; $extra->site = $siteid; $extra->date = (!empty($eventdata->timecreated)) ? $eventdata->timecreated : time(); $extra->notification = (!empty($eventdata->notification)) ? 1 : 0;
> $encryptnotifications = get_config('message_airnotifier', 'encryptnotifications') == 1; > $encryptprocessing = get_config('message_airnotifier', 'encryptprocessing');
// Site name. $site = get_site(); $extra->sitefullname = clean_param(format_string($site->fullname), PARAM_NOTAGS); $extra->siteshortname = clean_param(format_string($site->shortname), PARAM_NOTAGS);
< // Clean HTML, push notifications must arrive clean. < if (!empty($extra->smallmessage)) { < $extra->smallmessage = clean_param($extra->smallmessage, PARAM_NOTAGS); < } < if (!empty($extra->fullmessage)) { < $extra->fullmessage = clean_param($extra->fullmessage, PARAM_NOTAGS); < } < if (!empty($extra->fullmessagehtml)) { < $extra->fullmessagehtml = clean_param($extra->fullmessagehtml, PARAM_NOTAGS);
> // Clean HTML and ony allow data not to be ignored by Airnotifier to reduce the payload size. > if (empty($extra->smallmessage)) { > $extra->smallmessage = $extra->fullmessage;
}
> $extra->smallmessage = clean_param($extra->smallmessage, PARAM_NOTAGS); > unset($extra->fullmessage); // Send wwwroot to airnotifier. > unset($extra->fullmessagehtml); $extra->wwwroot = $CFG->wwwroot; > unset($extra->fullmessageformat); > unset($extra->fullmessagetrust);
// We are sending to message to all devices. $airnotifiermanager = new message_airnotifier_manager(); $devicetokens = $airnotifiermanager->get_user_devices($CFG->airnotifiermobileappname, $eventdata->userto->id); foreach ($devicetokens as $devicetoken) {
<
if (!$devicetoken->enable) { continue; }
> // Check if we should skip sending the notification. // Sending the message to the device. > if ($encryptnotifications && empty($devicetoken->publickey) && $serverurl = $CFG->airnotifierurl . ':' . $CFG->airnotifierport . '/api/v2/push/'; > $encryptprocessing == message_airnotifier_manager::ENCRYPT_UNSUPPORTED_NOT_SEND) { $header = array('Accept: application/json', 'X-AN-APP-NAME: ' . $CFG->airnotifierappname, > 'X-AN-APP-KEY: ' . $CFG->airnotifieraccesskey); > continue; // Avoid sending notifications to devices not supporting encryption. $curl = new curl; > } // Push notifications are supposed to be instant, do not wait to long blocking the execution. >
$curl->setopt(array('CURLOPT_TIMEOUT' => 2, 'CURLOPT_CONNECTTIMEOUT' => 2)); $curl->setHeader($header);
> // Clone the data to avoid modifying the original. $params = array( > $deviceextra = clone $extra; 'device' => $devicetoken->platform, > 'token' => $devicetoken->pushid, > $deviceextra->encrypted = $encryptnotifications; 'extra' => $extra > $deviceextra = $this->encrypt_payload($deviceextra, $devicetoken); ); > > // We use Firebase to deliver all Push Notifications, and for all device types. // JSON POST raw body request. > // Firebase has a 4KB payload limit. $resp = $curl->post($serverurl, json_encode($params)); > // https://firebase.google.com/docs/cloud-messaging/concept-options#notifications_and_data_messages } > // If the message is over that limit we remove unneeded fields and replace the title with a simple message. > if (\core_text::strlen(json_encode($deviceextra), '8bit') > 4000) { return true; > $deviceextra->smallmessage = get_string('view_notification', 'message_airnotifier'); } > } >
< 'extra' => $extra
> 'extra' => $deviceextra
* Creates necessary fields in the messaging config form.
> if ($deviceextra->encrypted) { * > // Setting alert to null makes air notifier send the notification as a data payload, * @param array $preferences An array of user preferences > // this forces Android phones to call the app onMessageReceived function to decrypt the notification. */ > // Otherwise notifications are created by the Android system and will not be decrypted. public function config_form($preferences) { > $params['alert'] = null; global $CFG, $OUTPUT, $USER, $PAGE; > }
> * Encrypt the notification payload. $systemcontext = context_system::instance(); > * if (!has_capability('message/airnotifier:managedevice', $systemcontext)) { > * @param stdClass $payload The notification payload. return get_string('nopermissiontomanagedevices', 'message_airnotifier'); > * @param stdClass $devicetoken The device token record } > * @return stdClass > */ if (!$this->is_system_configured()) { > protected function encrypt_payload(stdClass $payload, stdClass $devicetoken): stdClass { return get_string('notconfigured', 'message_airnotifier'); > if (empty($payload->encrypted)) { } else { > return $payload; > } $airnotifiermanager = new message_airnotifier_manager(); > $devicetokens = $airnotifiermanager->get_user_devices($CFG->airnotifiermobileappname, $USER->id); > if (empty($devicetoken->publickey)) { > $payload->encrypted = false; if (!empty($devicetokens)) { > return $payload; $output = ''; > } > foreach ($devicetokens as $devicetoken) { > $publickey = sodium_base642bin($devicetoken->publickey, SODIUM_BASE64_VARIANT_ORIGINAL); > $fields = [ if ($devicetoken->enable) { > 'userfromfullname', $hideshowiconname = 't/hide'; > 'userfromid', $dimmed = ''; > 'sitefullname', } else { > 'smallmessage', $hideshowiconname = 't/show'; > 'subject', $dimmed = 'dimmed_text'; > 'contexturl', } > ]; > foreach ($fields as $field) { $hideshowicon = $OUTPUT->pix_icon($hideshowiconname, get_string('showhide', 'message_airnotifier')); > if (!isset($payload->$field)) { $name = "{$devicetoken->name} {$devicetoken->model} {$devicetoken->platform} {$devicetoken->version}"; > continue; > } $output .= html_writer::start_tag('li', array('id' => $devicetoken->id, > $payload->$field = sodium_bin2base64(sodium_crypto_box_seal( 'class' => 'airnotifierdevice ' . $dimmed)) . "\n"; > $payload->$field, $output .= html_writer::label($name, 'deviceid-' . $devicetoken->id, array('class' => 'devicelabel ')) . ' ' . > $publickey html_writer::link('#', $hideshowicon, array('class' => 'hidedevice', 'alt' => 'show/hide')) . "\n"; > ), SODIUM_BASE64_VARIANT_ORIGINAL); $output .= html_writer::end_tag('li') . "\n"; > } } > > // Remove extra fields which may contain personal data. // Include the AJAX script to automatically trigger the action. > // They cannot be encrypted otherwise we would go over the 4KB payload size limit. $airnotifiermanager->include_device_ajax(); > unset($payload->usertoid); > unset($payload->replyto); $output = html_writer::tag('ul', $output, array('class' => 'list-unstyled unstyled', > unset($payload->replytoname); 'id' => 'airnotifierdevices')); > unset($payload->siteshortname); } else { > unset($payload->customdata); $output = get_string('nodevices', 'message_airnotifier'); > unset($payload->contexturlname); } > unset($payload->replytoname); return $output; > unset($payload->attachment); } > unset($payload->attachname); } > > return $payload; /** > } * Parses the submitted form data and saves it into preferences array. > * > /**
* @param stdClass $form preferences form class * @param array $preferences preferences array */ public function process_form($form, &$preferences) { return true; } /** * Loads the config data from database to put on the form during initial form display * * @param array $preferences preferences array * @param int $userid the user id */ public function load_data(&$preferences, $userid) { return true; } /** * Tests whether the airnotifier settings have been configured * @return boolean true if airnotifier is configured */ public function is_system_configured() { $airnotifiermanager = new message_airnotifier_manager(); return $airnotifiermanager->is_system_configured(); } }
<