Файловый менеджер - Редактировать - /home/harasnat/www/mf/communication.zip
Назад
PK q�/[�a*�u u upgrade.txtnu &1i� This file describes API changes in /communication/* Information provided here is intended especially for developers. PK q�/[Q���[ [ configure.phpnu &1i� <?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/>. /** * Configure communication for a given instance. * * @package core_communication * @copyright 2023 David Woloszyn <david.woloszyn@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ require_once('../config.php'); require_once('lib.php'); require_login(); $contextid = required_param('contextid', PARAM_INT); $instanceid = required_param('instanceid', PARAM_INT); $instancetype = required_param('instancetype', PARAM_TEXT); $component = required_param('component', PARAM_COMPONENT); $selectedcommunication = optional_param('selectedcommunication', null, PARAM_PLUGIN); $context = \core\context::instance_by_id($contextid); $instanceinfo = [ 'contextid' => $context->id, 'instanceid' => $instanceid, 'instancetype' => $instancetype, 'component' => $component, ]; // Requires communication to be enabled. if (!core_communication\api::is_available()) { throw new \moodle_exception('communicationdisabled', 'communication'); } // Attempt to load the communication instance with the provided params. $communication = \core_communication\api::load_by_instance( context: $context, component: $component, instancetype: $instancetype, instanceid: $instanceid, provider: $selectedcommunication, ); // No communication, no way this form can be used. if (!$communication) { throw new \moodle_exception('nocommunicationinstance', 'communication'); } // Set variables according to the component callback and use them on the page. [$instance, $context, $heading, $returnurl] = component_callback( $component, 'get_communication_instance_data', [$instanceid] ); // Set up the page. $PAGE->set_context($context); $PAGE->set_url('/communication/configure.php', $instanceinfo); $PAGE->set_title(get_string('communication', 'communication')); $PAGE->set_heading($heading); $PAGE->add_body_class('limitedwidth'); // Append the instance data before passing to form object. $instanceinfo['instancedata'] = $instance; // Get our form definitions. $form = new \core_communication\form\configure_form( context: $context, instanceid: $instanceinfo['instanceid'], instancetype: $instanceinfo['instancetype'], component: $instanceinfo['component'], selectedcommunication: $selectedcommunication, instancedata: $instanceinfo['instancedata'], ); if ($form->is_cancelled()) { redirect($returnurl); } else if ($data = $form->get_data()) { component_callback($component, 'update_communication_instance_data', [$data]); redirect($returnurl); } // Display the page contents. echo $OUTPUT->header(); echo $OUTPUT->heading(get_string('communication', 'communication'), 2); $form->display(); echo $OUTPUT->footer(); PK q�/[�b��� � 8 provider/customlink/lang/en/communication_customlink.phpnu &1i� <?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/>. /** * Strings for component communication_customlink, language 'en'. * * @package communication_customlink * @copyright 2023 Michael Hawkins <michaelh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ $string['cachedef_customlink'] = 'Custom link data'; $string['customlinkurl'] = 'Custom link URL'; $string['customlinkurl_help'] = 'Provide a link to an existing room from any communication service you would like to make available to participants - such as Microsoft Teams, Slack or Matrix.'; $string['customlinkurlinfo'] = 'The URL of an existing room already set up for this course.'; $string['pluginname'] = 'Custom link'; $string['privacy:metadata'] = 'Custom link communication plugin does not store any personal data.'; PK q�/[L�7$F F 0 provider/customlink/classes/privacy/provider.phpnu &1i� <?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/>. namespace communication_customlink\privacy; use core_privacy\local\metadata\null_provider; /** * Privacy Subsystem for communication_customlink implementing null_provider. * * @package communication_customlink * @copyright 2023 Michael Hawkins <michaelh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class provider implements null_provider { /** * Get the language string identifier with the component's language * file to explain why this plugin stores no data. * * @return string */ public static function get_reason(): string { return 'privacy:metadata'; } } PK q�/[� �w� � 5 provider/customlink/classes/communication_feature.phpnu &1i� <?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/>. namespace communication_customlink; use core_communication\processor; /** * class communication_feature to handle custom link specific actions. * * @package communication_customlink * @copyright 2023 Michael Hawkins <michaelh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class communication_feature implements \core_communication\communication_provider, \core_communication\form_provider, \core_communication\room_chat_provider { /** @var string The database table storing custom link specific data */ protected const CUSTOMLINK_TABLE = 'communication_customlink'; /** @var \cache_application $cache The application cache for this provider. */ protected \cache_application $cache; /** * Load the communication provider for the communication API. * * @param processor $communication The communication processor object. * @return communication_feature The communication provider object. */ public static function load_for_instance(processor $communication): self { return new self($communication); } /** * Constructor for communication provider. * * @param processor $communication The communication processor object. */ private function __construct( private \core_communication\processor $communication, ) { $this->cache = \cache::make('communication_customlink', 'customlink'); } /** * Create room - room existence managed externally, always return true. * * @return boolean */ public function create_chat_room(): bool { return true; } /** * Update room - room existence managed externally, always return true. * * @return boolean */ public function update_chat_room(): bool { return true; } /** * Delete room - room existence managed externally, always return true. * * @return boolean */ public function delete_chat_room(): bool { return true; } /** * Fetch the URL for this custom link provider. * * @return string|null The custom URL, or null if not found. */ public function get_chat_room_url(): ?string { global $DB; $commid = $this->communication->get_id(); $cachekey = "link_url_{$commid}"; // Attempt to fetch the room URL from the cache. if ($url = $this->cache->get($cachekey)) { return $url; } // If not found in the cache, fetch the URL from the database. $url = $DB->get_field( self::CUSTOMLINK_TABLE, 'url', ['commid' => $commid], ); // Cache the URL. $this->cache->set($cachekey, $url); return $url; } public function save_form_data(\stdClass $instance): void { global $DB; $commid = $this->communication->get_id(); $cachekey = "link_url_{$commid}"; $newrecord = new \stdClass(); $newrecord->url = $instance->customlinkurl ?? null; $existingrecord = $DB->get_record( self::CUSTOMLINK_TABLE, ['commid' => $commid], 'id, url' ); if (!$existingrecord) { // Create the record if it does not exist. $newrecord->commid = $commid; $DB->insert_record(self::CUSTOMLINK_TABLE, $newrecord); } else if ($newrecord->url !== $existingrecord->url) { // Update record if the URL has changed. $newrecord->id = $existingrecord->id; $DB->update_record(self::CUSTOMLINK_TABLE, $newrecord); } else { // No change made. return; } // Cache the new URL. $this->cache->set($cachekey, $newrecord->url); } public function set_form_data(\stdClass $instance): void { if (!empty($instance->id) && !empty($this->communication->get_id())) { $instance->customlinkurl = $this->get_chat_room_url(); } } public static function set_form_definition(\MoodleQuickForm $mform): void { // Custom link description for the communication provider. $mform->insertElementBefore($mform->createElement( 'text', 'customlinkurl', get_string('customlinkurl', 'communication_customlink'), 'maxlength="255" size="40"' ), 'addcommunicationoptionshere'); $mform->addHelpButton('customlinkurl', 'customlinkurl', 'communication_customlink'); $mform->setType('customlinkurl', PARAM_URL); $mform->addRule('customlinkurl', get_string('required'), 'required', null, 'client'); $mform->addRule('customlinkurl', get_string('maximumchars', '', 255), 'maxlength', 255); $mform->insertElementBefore($mform->createElement( 'static', 'customlinkurlinfo', '', get_string('customlinkurlinfo', 'communication_customlink'), 'addcommunicationoptionshere' ), 'addcommunicationoptionshere'); } public static function is_configured(): bool { return true; } } PK q�/[�Ӵv v ! provider/customlink/db/caches.phpnu &1i� <?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/>. /** * Defined caches used internally by the provider. * * @package communication_customlink * @copyright 2023 Michael Hawkins <michaelh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ declare(strict_types=1); defined('MOODLE_INTERNAL') || die(); $definitions = [ 'customlink' => [ 'mode' => cache_store::MODE_APPLICATION, 'simplekeys' => true, 'simpledata' => true, ], ]; PK q�/[�\ӑG G " provider/customlink/db/install.xmlnu &1i� <?xml version="1.0" encoding="UTF-8" ?> <XMLDB PATH="communication/provider/customlink/db" VERSION="20230826" COMMENT="Stores the link associated with a custom link communication instance." xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../../lib/xmldb/xmldb.xsd" > <TABLES> <TABLE NAME="communication_customlink" COMMENT="Stores the link associated with a custom link communication instance."> <FIELDS> <FIELD NAME="id" TYPE="int" LENGTH="10" NOTNULL="true" SEQUENCE="true"/> <FIELD NAME="commid" TYPE="int" LENGTH="10" NOTNULL="true" SEQUENCE="false" COMMENT="ID of the communication record"/> <FIELD NAME="url" TYPE="char" LENGTH="255" NOTNULL="false" SEQUENCE="false" COMMENT="URL being linked to by the provider"/> </FIELDS> <KEYS> <KEY NAME="primary" TYPE="primary" FIELDS="id"/> <KEY NAME="fk_commid" TYPE="foreign" FIELDS="commid" REFTABLE="communication" REFFIELDS="id" COMMENT="Foreign key for communication reference"/> </KEYS> </TABLE> </TABLES> </XMLDB> PK q�/[8ʮ�t t B provider/customlink/tests/behat/fixtures/custom_link_test_page.phpnu &1i� <?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/>. /** * A page which can be used to represent a messaging service while testing the custom link communication provider. * * The current Moodle user's username is listed in the heading to make it easier to confirm the page has been * opened by the expected user. * * @package communication_customlink * @copyright 2023 Michael Hawkins <michaelh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ require_once(__DIR__ . '/../../../../../../config.php'); defined('BEHAT_SITE_RUNNING') || die(); global $OUTPUT, $PAGE, $USER; $PAGE->set_url('/communication/provider/customlink/tests/behat/fixtures/custom_link_test_page.php'); require_login(); $PAGE->set_context(core\context\system::instance()); echo $OUTPUT->header(); echo "<h2>Example messaging service - {$USER->username}</h2>"; echo "<p>Imagine this is a wonderful messaging service being accessed directly from a link in Moodle!</p>"; echo $OUTPUT->footer(); PK q�/[ 1�8 8 3 provider/customlink/tests/behat/custom_link.featurenu &1i� @communication @communication_customlink @javascript Feature: Communication custom link In order to facilitate easy access to an existing communication platform As a teacher I need to be able to make a custom communication link available in my course Background: Given the following "users" exist: | username | firstname | lastname | email | | teacher1 | Teacher | 1 | teacher1@example.com | | student1 | Student | 1 | student1@example.com | And the following "courses" exist: | fullname | shortname | | Course 1 | C1 | And the following "course enrolments" exist: | user | course | role | | teacher1 | C1 | editingteacher | | student1 | C1 | student | And the following config values are set as admin: | enablecommunicationsubsystem | 1 | Scenario: As a teacher I can configure a custom communication provider for my course Given I am on the "Course 1" "Course" page logged in as "teacher1" And "Chat to course participants" "button" should not be visible When I navigate to "Communication" in current page administration And the "Provider" select box should contain "Custom link" And I should not see "Custom link URL" And I select "Custom link" from the "Provider" singleselect And I should see "Custom link URL" And I set the following fields to these values: | communicationroomname | Test URL | | customlinkurl | #wwwroot#/communication/provider/customlink/tests/behat/fixtures/custom_link_test_page.php | And I press "Save changes" Then "Chat to course participants" "button" should be visible And I click on "Chat to course participants" "button" # Check the link hits the expected destination. And I switch to a second window And I should see "Example messaging service - teacher1" in the "region-main" "region" And I close all opened windows # Ensure any communication subsystem tasks have no impact on availability. And I run all adhoc tasks And I am on the "Course 1" course page And "Chat to course participants" "button" should be visible And I click on "Chat to course participants" "button" And I switch to a second window And I should see "Example messaging service - teacher1" in the "region-main" "region" And I close all opened windows And I log out # Confirm student also has access to the custom link. And I am on the "Course 1" "Course" page logged in as "student1" And "Chat to course participants" "button" should be visible And I click on "Chat to course participants" "button" And I switch to a second window And I should see "Example messaging service - student1" in the "region-main" "region" Scenario: As a teacher I can disable and re-enable a custom communication provider for my course Given I am on the "Course 1" "Course" page logged in as "teacher1" And "Chat to course participants" "button" should not be visible When I navigate to "Communication" in current page administration And I select "Custom link" from the "Provider" singleselect And I set the following fields to these values: | communicationroomname | Test URL | | customlinkurl | #wwwroot#/communication/provider/customlink/tests/behat/fixtures/custom_link_test_page.php | And I press "Save changes" And "Chat to course participants" "button" should be visible And I run all adhoc tasks And I navigate to "Communication" in current page administration And I select "None" from the "Provider" singleselect And I press "Save changes" And "Chat to course participants" "button" should not be visible And I run all adhoc tasks And I am on the "Course 1" course page And "Chat to course participants" "button" should not be visible And I navigate to "Communication" in current page administration And I select "Custom link" from the "Provider" singleselect And I set the following fields to these values: | communicationroomname | Test URL | | customlinkurl | #wwwroot#/communication/provider/customlink/tests/behat/fixtures/custom_link_test_page.php | And I press "Save changes" And "Chat to course participants" "button" should be visible And I run all adhoc tasks And I am on the "Course 1" course page And "Chat to course participants" "button" should be visible And I click on "Chat to course participants" "button" And I switch to a second window And I should see "Example messaging service - teacher1" in the "region-main" "region" PK q�/[P���� � 8 provider/customlink/tests/communication_feature_test.phpnu &1i� <?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/>. namespace communication_customlink; use core_communication\processor; use core_communication\communication_test_helper_trait; defined('MOODLE_INTERNAL') || die(); require_once(__DIR__ . '/../../../tests/communication_test_helper_trait.php'); /** * Class communication_feature_test to test the custom link features implemented using the core interfaces. * * @package communication_customlink * @category test * @copyright 2023 Michael Hawkins <michaelh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @coversDefaultClass \communication_customlink\communication_feature */ class communication_feature_test extends \advanced_testcase { use communication_test_helper_trait; public function setUp(): void { parent::setUp(); $this->resetAfterTest(); $this->setup_communication_configs(); } /** * Test create, update and delete chat room. * * @covers ::load_for_instance */ public function test_load_for_instance(): void { $communicationprocessor = $this->get_test_communication_processor(); $instance = communication_feature::load_for_instance($communicationprocessor); $this->assertInstanceOf('communication_customlink\communication_feature', $instance); } /** * Test create, update and delete chat room. * * @covers ::create_chat_room * @covers ::update_chat_room * @covers ::delete_chat_room */ public function test_create_update_delete_chat_room(): void { $communicationprocessor = $this->get_test_communication_processor(); // Create, update and delete room should always return true because this provider contains // a link to a room, but does not manage the existence of the room. $createroomresult = $communicationprocessor->get_room_provider()->create_chat_room(); $updateroomresult = $communicationprocessor->get_room_provider()->update_chat_room(); $deleteroomresult = $communicationprocessor->get_room_provider()->delete_chat_room(); $this->assertTrue($createroomresult); $this->assertTrue($updateroomresult); $this->assertTrue($deleteroomresult); } /** * Test save form data with provider's custom field and fetching with get_chat_room_url(). * * @covers ::save_form_data * @covers ::get_chat_room_url */ public function test_save_form_data(): void { $communicationprocessor = $this->get_test_communication_processor(); $customlinkurl = 'https://moodle.org/message/index.php'; $formdatainstance = (object) ['customlinkurl' => $customlinkurl]; // Test the custom link URL is saved and can be retrieved as expected. $communicationprocessor->get_form_provider()->save_form_data($formdatainstance); $fetchedurl = $communicationprocessor->get_room_provider()->get_chat_room_url(); $this->assertEquals($customlinkurl, $fetchedurl); } /** * Create a test custom link communication processor object. * * @return processor */ protected function get_test_communication_processor(): processor { $course = $this->getDataGenerator()->create_course(); $instanceid = $course->id; $context = \core\context\system::instance(); $component = 'core_course'; $instancetype = 'coursecommunication'; $selectedcommunication = 'communication_customlink'; $communicationroomname = 'communicationroom'; $communicationprocessor = processor::create_instance( $context, $selectedcommunication, $instanceid, $component, $instancetype, $communicationroomname, ); return $communicationprocessor; } /** * Test if the selected provider is configured. * * @covers ::is_configured */ public function test_is_configured(): void { $communicationprocessor = $this->get_test_communication_processor(); $this->assertTrue($communicationprocessor->get_form_provider()->is_configured()); } } PK q�/[����W W provider/customlink/version.phpnu &1i� <?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/>. /** * Version information for communication_customlink. * * @package communication_customlink * @copyright 2023 Michael Hawkins <michaelh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); $plugin->component = 'communication_customlink'; $plugin->version = 2023100900; $plugin->requires = 2023100400; $plugin->maturity = MATURITY_ALPHA; PK q�/[�w��� � ' provider/matrix/classes/matrix_room.phpnu &1i� <?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/>. namespace communication_matrix; use stdClass; /** * Class to manage the updates to the room information in db. * * @package communication_matrix * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class matrix_room { private const TABLE = 'matrix_room'; /** @var \stdClass|null $record The matrix room record from db */ /** * Load the matrix room record for the supplied processor. * @param int $processorid * @return null|self */ public static function load_by_processor_id( int $processorid, ): ?self { global $DB; $record = $DB->get_record(self::TABLE, ['commid' => $processorid]); if (!$record) { return null; } return new self($record); } /** * Matrix rooms constructor to load the matrix room information from matrix_room table. * * @param stdClass $record */ private function __construct( private stdClass $record, ) { } /** * Create matrix room data. * * @param int $processorid The id of the communication record * @param string|null $topic The topic of the room for matrix * @param string|null $roomid The id of the room from matrix * @return self */ public static function create_room_record( int $processorid, ?string $topic, ?string $roomid = null, ): self { global $DB; $roomrecord = (object) [ 'commid' => $processorid, 'roomid' => $roomid, 'topic' => $topic, ]; $roomrecord->id = $DB->insert_record(self::TABLE, $roomrecord); return self::load_by_processor_id($processorid); } /** * Update matrix room data. * * @param string|null $roomid The id of the room from matrix * @param string|null $topic The topic of the room for matrix */ public function update_room_record( ?string $roomid = null, ?string $topic = null, ): void { global $DB; if ($roomid !== null) { $this->record->roomid = $roomid; } if ($topic !== null) { $this->record->topic = $topic; } $DB->update_record(self::TABLE, $this->record); } /** * Delete matrix room data. */ public function delete_room_record(): void { global $DB; $DB->delete_records(self::TABLE, ['commid' => $this->record->commid]); unset($this->record); } /** * Get the processor id. * * @return int */ public function get_processor_id(): int { return $this->record->commid; } /** * Get the matrix room id. * * @return string|null */ public function get_room_id(): ?string { return $this->record->roomid; } /** * Get the matrix room topic. * * @return string */ public function get_topic(): string { return $this->record->topic ?? ''; } } PK q�/[?�63R R , provider/matrix/classes/privacy/provider.phpnu &1i� <?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/>. namespace communication_matrix\privacy; use core_privacy\local\metadata\null_provider; /** * Privacy Subsystem for communication_matrix implementing null_provider. * * @package communication_matrix * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore */ class provider implements null_provider { /** * Get the language string identifier with the component's language * file to explain why this plugin stores no data. * * @return string */ public static function get_reason(): string { return 'privacy:metadata'; } } PK q�/[�*83� � , provider/matrix/classes/matrix_constants.phpnu &1i� <?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/>. namespace communication_matrix; /** * class matrix_constants to have one location to store all constants related to matrix. * * @package communication_matrix * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class matrix_constants { /** * User default power level for matrix. */ public const POWER_LEVEL_DEFAULT = 0; /** * User moderator power level for matrix. */ public const POWER_LEVEL_MODERATOR = 50; /** * User moderator power level for matrix. */ public const POWER_LEVEL_MOODLE_MODERATOR = 51; /** * User power level for matrix associated to moodle site admins. It is a custom power level for site admins. */ public const POWER_LEVEL_MOODLE_SITE_ADMIN = 90; /** * User maximum power level for matrix. This is only associated to the token user to allow god mode actions. */ public const POWER_LEVEL_MAXIMUM = 100; } PK q�/[Z�N�,h ,h 1 provider/matrix/classes/communication_feature.phpnu &1i� <?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/>. namespace communication_matrix; use communication_matrix\local\spec\features\matrix\{ create_room_v3 as create_room_feature, get_room_members_v3 as get_room_members_feature, remove_member_from_room_v3 as remove_member_from_room_feature, update_room_avatar_v3 as update_room_avatar_feature, update_room_name_v3 as update_room_name_feature, update_room_topic_v3 as update_room_topic_feature, upload_content_v3 as upload_content_feature, media_create_v1 as media_create_feature, }; use communication_matrix\local\spec\features\synapse\{ create_user_v2 as create_user_feature, get_room_info_v1 as get_room_info_feature, get_user_info_v2 as get_user_info_feature, invite_member_to_room_v1 as invite_member_to_room_feature, }; use core_communication\processor; use stdClass; use GuzzleHttp\Psr7\Response; /** * class communication_feature to handle matrix specific actions. * * @package communication_matrix * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class communication_feature implements \core_communication\communication_provider, \core_communication\form_provider, \core_communication\room_chat_provider, \core_communication\room_user_provider, \core_communication\user_provider { /** @var ?matrix_room $room The matrix room object to update room information */ private ?matrix_room $room = null; /** @var string|null The URI of the home server */ protected ?string $homeserverurl = null; /** @var string The URI of the Matrix web client */ protected string $webclienturl; /** @var \communication_matrix\local\spec\v1p1|null The Matrix API processor */ protected ?matrix_client $matrixapi; /** * Load the communication provider for the communication api. * * @param processor $communication The communication processor object * @return communication_feature The communication provider object */ public static function load_for_instance(processor $communication): self { return new self($communication); } /** * Reload the room information. * This may be necessary after a room has been created or updated via the adhoc task. * This is primarily intended for use in unit testing, but may have real world cases too. */ public function reload(): void { $this->room = null; $this->processor = processor::load_by_id($this->processor->get_id()); } /** * Constructor for communication provider to initialize necessary objects for api cals etc.. * * @param processor $processor The communication processor object */ private function __construct( private \core_communication\processor $processor, ) { $this->homeserverurl = get_config('communication_matrix', 'matrixhomeserverurl'); $this->webclienturl = get_config('communication_matrix', 'matrixelementurl'); if ($processor::is_provider_available('communication_matrix')) { // Generate the API instance. $this->matrixapi = matrix_client::instance( serverurl: $this->homeserverurl, accesstoken: get_config('communication_matrix', 'matrixaccesstoken'), ); } } /** * Check whether the room configuration has been created yet. * * @return bool */ protected function room_exists(): bool { return (bool) $this->get_room_configuration(); } /** * Whether the room exists on the remote server. * This does not involve a remote call, but checks whether Moodle is aware of the room id. * @return bool */ protected function remote_room_exists(): bool { $room = $this->get_room_configuration(); return $room && ($room->get_room_id() !== null); } /** * Get the stored room configuration. * @return null|matrix_room */ public function get_room_configuration(): ?matrix_room { $this->room = matrix_room::load_by_processor_id($this->processor->get_id()); return $this->room; } /** * Return the current room id. * * @return string|null */ public function get_room_id(): ?string { return $this->get_room_configuration()?->get_room_id(); } /** * Create members. * * @param array $userids The Moodle user ids to create */ public function create_members(array $userids): void { $addedmembers = []; // This API requiures the create_user feature. $this->matrixapi->require_feature(create_user_feature::class); foreach ($userids as $userid) { $user = \core_user::get_user($userid); $userfullname = fullname($user); // Proceed if we have a user's full name and email to work with. if (!empty($user->email) && !empty($userfullname)) { $qualifiedmuid = matrix_user_manager::get_formatted_matrix_userid($user->username); // First create user in matrix. $response = $this->matrixapi->create_user( userid: $qualifiedmuid, displayname: $userfullname, threepids: [(object) [ 'medium' => 'email', 'address' => $user->email, ], ], externalids: [], ); $body = json_decode($response->getBody()); if (!empty($matrixuserid = $body->name)) { // Then create matrix user id in moodle. matrix_user_manager::set_matrix_userid_in_moodle($userid, $qualifiedmuid); if ($this->add_registered_matrix_user_to_room($matrixuserid)) { $addedmembers[] = $userid; } } } } // Set the power level of the users. if (!empty($addedmembers) && $this->is_power_levels_update_required($addedmembers)) { $this->set_matrix_power_levels(); } // Mark then users as synced for the added members. $this->processor->mark_users_as_synced($addedmembers); } public function update_room_membership(array $userids): void { $this->set_matrix_power_levels(); } /** * Add members to a room. * * @param array $userids The user ids to add */ public function add_members_to_room(array $userids): void { $unregisteredmembers = []; $addedmembers = []; foreach ($userids as $userid) { $matrixuserid = matrix_user_manager::get_matrixid_from_moodle($userid); if ($matrixuserid && $this->check_user_exists($matrixuserid)) { if ($this->add_registered_matrix_user_to_room($matrixuserid)) { $addedmembers[] = $userid; } } else { $unregisteredmembers[] = $userid; } } // Set the power level of the users. if (!empty($addedmembers) && $this->is_power_levels_update_required($addedmembers)) { $this->set_matrix_power_levels(); } // Mark then users as synced for the added members. $this->processor->mark_users_as_synced($addedmembers); // Create Matrix users. if (count($unregisteredmembers) > 0) { $this->create_members($unregisteredmembers); } } /** * Adds the registered matrix user id to room. * * @param string $matrixuserid Registered matrix user id */ private function add_registered_matrix_user_to_room(string $matrixuserid): bool { // Require the invite_member_to_room API feature. $this->matrixapi->require_feature(invite_member_to_room_feature::class); if (!$this->check_room_membership($matrixuserid)) { $response = $this->matrixapi->invite_member_to_room( roomid: $this->get_room_id(), userid: $matrixuserid, ); $body = self::get_body($response); if (empty($body->room_id)) { return false; } if ($body->room_id !== $this->get_room_id()) { return false; } return true; } return false; } /** * Remove members from a room. * * @param array $userids The Moodle user ids to remove */ public function remove_members_from_room(array $userids): void { // This API requiures the remove_members_from_room feature. $this->matrixapi->require_feature(remove_member_from_room_feature::class); if ($this->get_room_id() === null) { return; } // Remove the power level for the user first. $this->set_matrix_power_levels($userids); $membersremoved = []; $currentpowerlevels = $this->get_current_powerlevel_data(); $currentuserpowerlevels = (array) $currentpowerlevels->users ?? []; foreach ($userids as $userid) { // Check user is member of room first. $matrixuserid = matrix_user_manager::get_matrixid_from_moodle($userid); if (!$matrixuserid) { // Unable to find a matrix userid for this user. continue; } if (array_key_exists($matrixuserid, $currentuserpowerlevels)) { if ($currentuserpowerlevels[$matrixuserid] >= matrix_constants::POWER_LEVEL_MAXIMUM) { // Skip removing the user if they are an admin. continue; } } if ( $this->check_user_exists($matrixuserid) && $this->check_room_membership($matrixuserid) ) { $this->matrixapi->remove_member_from_room( roomid: $this->get_room_id(), userid: $matrixuserid, ); $membersremoved[] = $userid; } } $this->processor->delete_instance_user_mapping($membersremoved); } /** * Check if a user exists in Matrix. * Use if user existence is needed before doing something else. * * @param string $matrixuserid The Matrix user id to check * @return bool */ public function check_user_exists(string $matrixuserid): bool { // This API requires the get_user_info feature. $this->matrixapi->require_feature(get_user_info_feature::class); $response = $this->matrixapi->get_user_info( userid: $matrixuserid, ); $body = self::get_body($response); return isset($body->name); } /** * Check if a user is a member of a room. * Use if membership confirmation is needed before doing something else. * * @param string $matrixuserid The Matrix user id to check * @return bool */ public function check_room_membership(string $matrixuserid): bool { // This API requires the get_room_members feature. $this->matrixapi->require_feature(get_room_members_feature::class); $response = $this->matrixapi->get_room_members( roomid: $this->get_room_id(), ); $body = self::get_body($response); // Check user id is in the returned room member ids. return isset($body->joined) && array_key_exists($matrixuserid, (array) $body->joined); } /** * Create a room based on the data in the communication instance. * * @return bool */ public function create_chat_room(): bool { if ($this->remote_room_exists()) { // A room already exists. Update it instead. return $this->update_chat_room(); } // This method requires the create_room API feature. $this->matrixapi->require_feature(create_room_feature::class); $room = $this->get_room_configuration(); $response = $this->matrixapi->create_room( name: $this->processor->get_room_name(), visibility: 'private', preset: 'private_chat', initialstate: [], options: [ 'topic' => $room->get_topic(), ], ); $response = self::get_body($response); if (empty($response->room_id)) { throw new \moodle_exception( 'Unable to determine ID of matrix room', ); } // Update our record of the matrix room_id. $room->update_room_record( roomid: $response->room_id, ); // Update the room avatar. $this->update_room_avatar(); return true; } public function update_chat_room(): bool { if (!$this->remote_room_exists()) { // No room exists. Create it instead. return $this->create_chat_room(); } $this->matrixapi->require_features([ get_room_info_feature::class, update_room_name_feature::class, update_room_topic_feature::class, ]); // Get room data. $response = $this->matrixapi->get_room_info( roomid: $this->get_room_id(), ); $remoteroomdata = self::get_body($response); // Update the room name when it's updated from the form. if ($remoteroomdata->name !== $this->processor->get_room_name()) { $this->matrixapi->update_room_name( roomid: $this->get_room_id(), name: $this->processor->get_room_name(), ); } // Update the room topic if set. $localroomdata = $this->get_room_configuration(); if ($remoteroomdata->topic !== $localroomdata->get_topic()) { $this->matrixapi->update_room_topic( roomid: $localroomdata->get_room_id(), topic: $localroomdata->get_topic(), ); } // Update room avatar. $this->update_room_avatar(); return true; } public function delete_chat_room(): bool { $this->get_room_configuration()->delete_room_record(); $this->room = null; return true; } /** * Update the room avatar when an instance image is added or updated. */ public function update_room_avatar(): void { // Both of the following features of the remote API are required. $this->matrixapi->require_features([ upload_content_feature::class, update_room_avatar_feature::class, ]); // Check if we have an avatar that needs to be synced. if ($this->processor->is_avatar_synced()) { return; } $instanceimage = $this->processor->get_avatar(); $contenturi = null; if ($this->matrixapi->implements_feature(media_create_feature::class)) { // From version 1.7 we can fetch a mxc URI and use it before uploading the content. if ($instanceimage) { $response = $this->matrixapi->media_create(); $contenturi = self::get_body($response)->content_uri; // Now update the room avatar. $response = $this->matrixapi->update_room_avatar( roomid: $this->get_room_id(), avatarurl: $contenturi, ); // And finally upload the content. $this->matrixapi->upload_content($instanceimage); } else { $response = $this->matrixapi->update_room_avatar( roomid: $this->get_room_id(), avatarurl: null, ); } } else { // Prior to v1.7 the only way to upload content was to upload the content, which returns a mxc URI to use. if ($instanceimage) { // First upload the content. $response = $this->matrixapi->upload_content($instanceimage); $body = self::get_body($response); $contenturi = $body->content_uri; } // Now update the room avatar. $response = $this->matrixapi->update_room_avatar( roomid: $this->get_room_id(), avatarurl: $contenturi, ); } // Indicate the avatar has been synced if it was successfully set with Matrix. if ($response->getReasonPhrase() === 'OK') { $this->processor->set_avatar_synced_flag(true); } } public function get_chat_room_url(): ?string { if (!$this->get_room_id()) { // We don't have a room id for this record. return null; } return sprintf( "%s#/room/%s", $this->webclienturl, $this->get_room_id(), ); } public function save_form_data(\stdClass $instance): void { $matrixroomtopic = $instance->matrixroomtopic ?? null; $room = $this->get_room_configuration(); if ($room) { $room->update_room_record( topic: $matrixroomtopic, ); } else { $this->room = matrix_room::create_room_record( processorid: $this->processor->get_id(), topic: $matrixroomtopic, ); } } public function set_form_data(\stdClass $instance): void { if (!empty($instance->id) && !empty($this->processor->get_id())) { if ($this->room_exists()) { $instance->matrixroomtopic = $this->get_room_configuration()->get_topic(); } } } public static function set_form_definition(\MoodleQuickForm $mform): void { // Room description for the communication provider. $mform->insertElementBefore($mform->createElement( 'text', 'matrixroomtopic', get_string('matrixroomtopic', 'communication_matrix'), 'maxlength="255" size="20"' ), 'addcommunicationoptionshere'); $mform->addHelpButton('matrixroomtopic', 'matrixroomtopic', 'communication_matrix'); $mform->setType('matrixroomtopic', PARAM_TEXT); } /** * Get the body of a response as a stdClass. * * @param Response $response * @return stdClass */ public static function get_body(Response $response): stdClass { $body = $response->getBody(); return json_decode($body, false, 512, JSON_THROW_ON_ERROR); } /** * Set the matrix power level with the room. * * Users with a non-moodle power level are not typically removed unless specified in the $forceremoval param. * Matrix Admin users are never removed. * * @param array $forceremoval The users to force removal from the room, even if they have a custom power level */ private function set_matrix_power_levels( array $forceremoval = [], ): void { // Get the current power levels. $currentpowerlevels = $this->get_current_powerlevel_data(); $currentuserpowerlevels = (array) $currentpowerlevels->users ?? []; // Get all the current users who need to be in the room. $userlist = $this->processor->get_all_userids_for_instance(); // Translate the user ids to matrix user ids. $userlist = array_combine( array_map( fn ($userid) => matrix_user_manager::get_matrixid_from_moodle($userid), $userlist, ), $userlist, ); // Determine the power levels, and filter out anyone with the default level. $newuserpowerlevels = array_filter( array_map( fn($userid) => $this->get_user_allowed_power_level($userid), $userlist, ), fn($level) => $level !== matrix_constants::POWER_LEVEL_DEFAULT, ); // Keep current room admins, and users which don't use our MODERATOR power level without changing them. $staticusers = $this->get_users_with_custom_power_level($currentuserpowerlevels); foreach ($staticusers as $userid => $level) { $newuserpowerlevels[$userid] = $level; } if (!empty($forceremoval)) { // Remove the users from the power levels if they are not admins. foreach ($forceremoval as $userid) { if ($newuserpowerlevels < matrix_constants::POWER_LEVEL_MAXIMUM) { unset($newuserpowerlevels[$userid]); } } } if (!$this->power_levels_changed($currentuserpowerlevels, $newuserpowerlevels)) { // No changes to make. return; } // Update the power levels for the room. $this->matrixapi->update_room_power_levels( roomid: $this->get_room_id(), users: $newuserpowerlevels, ); } /** * Filter the list of users provided to remove those with a moodle-related power level. * * @param array $users * @return array */ private function get_users_with_custom_power_level(array $users): array { return array_filter( $users, function ($level): bool { switch ($level) { case matrix_constants::POWER_LEVEL_DEFAULT: case matrix_constants::POWER_LEVEL_MOODLE_SITE_ADMIN: case matrix_constants::POWER_LEVEL_MOODLE_MODERATOR: return false; default: return true; } }, ); } /** * Check whether power levels have changed compared with the proposed power levels. * * @param array $currentuserpowerlevels The current power levels * @param array $newuserpowerlevels The new power levels proposed * @return bool Whether there is any change to be made */ private function power_levels_changed( array $currentuserpowerlevels, array $newuserpowerlevels, ): bool { if (count($newuserpowerlevels) !== count($currentuserpowerlevels)) { // Different number of keys - there must be a difference then. return true; } // Sort the power levels. ksort($newuserpowerlevels, SORT_NUMERIC); // Get the current power levels. ksort($currentuserpowerlevels); $diff = array_merge( array_diff_assoc( $newuserpowerlevels, $currentuserpowerlevels, ), array_diff_assoc( $currentuserpowerlevels, $newuserpowerlevels, ), ); return count($diff) > 0; } /** * Get the current power level for the room. * * @return stdClass */ private function get_current_powerlevel_data(): \stdClass { $roomid = $this->get_room_id(); $response = $this->matrixapi->get_room_power_levels( roomid: $roomid, ); if ($response->getStatusCode() !== 200) { throw new \moodle_exception( 'Unable to get power levels for room', ); } $powerdata = $this->get_body($response); $powerdata = array_filter( $powerdata->rooms->join->{$roomid}->state->events, fn($value) => $value->type === 'm.room.power_levels' ); $powerdata = reset($powerdata); return $powerdata->content; } /** * Determine if a power level update is required. * Matrix will always set a user to the default power level of 0 when a power level update is made. * That is, unless we specify another level. As long as one person's level is greater than the default, * we will need to set the power levels of all users greater than the default. * * @param array $userids The users to evaluate * @return boolean Returns true if an update is required */ private function is_power_levels_update_required(array $userids): bool { // Is the user's power level greater than the default? foreach ($userids as $userid) { if ($this->get_user_allowed_power_level($userid) > matrix_constants::POWER_LEVEL_DEFAULT) { return true; } } return false; } /** * Get the allowed power level for the user id according to perms/site admin or default. * * @param int $userid * @return int */ public function get_user_allowed_power_level(int $userid): int { $powerlevel = matrix_constants::POWER_LEVEL_DEFAULT; if (has_capability('communication/matrix:moderator', $this->processor->get_context(), $userid)) { $powerlevel = matrix_constants::POWER_LEVEL_MOODLE_MODERATOR; } // If site admin, override all caps. if (is_siteadmin($userid)) { $powerlevel = matrix_constants::POWER_LEVEL_MOODLE_SITE_ADMIN; } return $powerlevel; } /* * Check if matrix settings are configured * * @return boolean */ public static function is_configured(): bool { // Matrix communication settings. $matrixhomeserverurl = get_config('communication_matrix', 'matrixhomeserverurl'); $matrixaccesstoken = get_config('communication_matrix', 'matrixaccesstoken'); $matrixelementurl = get_config('communication_matrix', 'matrixelementurl'); if ( !empty($matrixhomeserverurl) && !empty($matrixaccesstoken) && (PHPUNIT_TEST || defined('BEHAT_SITE_RUNNING') || !empty($matrixelementurl)) ) { return true; } return false; } } PK q�/[�í"X X + provider/matrix/classes/local/spec/v1p2.phpnu &1i� <?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/>. namespace communication_matrix\local\spec; /** * Matrix API to support version v1.2 of the Matrix specification. * * https://spec.matrix.org/v1.2/client-server-api/ * https://spec.matrix.org/v1.2/changelog/#api-changes * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class v1p2 extends v1p1 { } PK q�/[4qX X + provider/matrix/classes/local/spec/v1p5.phpnu &1i� <?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/>. namespace communication_matrix\local\spec; /** * Matrix API to support version v1.5 of the Matrix specification. * * https://spec.matrix.org/v1.5/client-server-api/ * https://spec.matrix.org/v1.5/changelog/#api-changes * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class v1p5 extends v1p4 { } PK q�/[ �A�X X + provider/matrix/classes/local/spec/v1p4.phpnu &1i� <?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/>. namespace communication_matrix\local\spec; /** * Matrix API to support version v1.4 of the Matrix specification. * * https://spec.matrix.org/v1.4/client-server-api/ * https://spec.matrix.org/v1.4/changelog/#api-changes * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class v1p4 extends v1p3 { } PK q�/[�eg>X X + provider/matrix/classes/local/spec/v1p3.phpnu &1i� <?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/>. namespace communication_matrix\local\spec; /** * Matrix API to support version v1.3 of the Matrix specification. * * https://spec.matrix.org/v1.3/client-server-api/ * https://spec.matrix.org/v1.3/changelog/#api-changes * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class v1p3 extends v1p2 { } PK q�/[*� k + provider/matrix/classes/local/spec/v1p7.phpnu &1i� <?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/>. namespace communication_matrix\local\spec; /** * Matrix API to support version v1.7 of the Matrix specification. * * https://spec.matrix.org/v1.7/client-server-api/ * https://spec.matrix.org/v1.7/changelog/#api-changes * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class v1p7 extends v1p6 { // Note: A new Content Upload API was introduced. // See details in the spec: // https://github.com/matrix-org/matrix-spec-proposals/pull/2246. use features\matrix\media_create_v1; } PK q�/[��'�o o P provider/matrix/classes/local/spec/features/synapse/invite_member_to_room_v1.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\synapse; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; /** * Synapse API feature to invite a user into a room. * * https://matrix-org.github.io/synapse/latest/admin_api/room_membership.html#edit-room-membership-api * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait invite_member_to_room_v1 { /** * Join a user to a room. * * Note: This joins the user, and does not invite them. * * @param string $roomid * @param string $userid * @return Response */ public function invite_member_to_room(string $roomid, string $userid): Response { $params = [ ':roomid' => $roomid, 'user_id' => $userid, ]; return $this->execute(new command( $this, method: 'POST', endpoint: '_synapse/admin/v1/join/:roomid', params: $params, )); } } PK q�/[0�5� � F provider/matrix/classes/local/spec/features/synapse/create_user_v2.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\synapse; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; /** * Synapse API feature for creating a user. * * https://matrix-org.github.io/synapse/latest/admin_api/user_admin_api.html#create-or-modify-account * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait create_user_v2 { /** * Create a new user. * * @param string $userid The Matrix user id. * @param string $displayname The visible name of the user * @param array $threepids The third-party identifiers of the user. * @param null|array $externalids */ public function create_user( string $userid, string $displayname, array $threepids, ?array $externalids = null, ): Response { $params = [ ':userid' => $userid, 'displayname' => $displayname, 'threepids' => $threepids, ]; if ($externalids !== null) { $params['externalids'] = $externalids; } return $this->execute(new command( $this, method: 'PUT', endpoint: '_synapse/admin/v2/users/:userid', params: $params, )); } } PK q�/[±��� � H provider/matrix/classes/local/spec/features/synapse/get_user_info_v2.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\synapse; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; /** * Synapse API feature for fetching info about a user. * * https://matrix-org.github.io/synapse/latest/admin_api/user_admin_api.html#query-user-account * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait get_user_info_v2 { /** * Get user info. * * @param string $userid * @return Response */ public function get_user_info(string $userid): Response { return $this->execute(new command( $this, method: 'GET', endpoint: '_synapse/admin/v2/users/:userid', ignorehttperrors: true, params: [ ':userid' => $userid, ], )); } } PK q�/[~�1� � H provider/matrix/classes/local/spec/features/synapse/get_room_info_v1.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\synapse; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; /** * Synapse API feature for fetching room info. * * https://matrix-org.github.io/synapse/latest/admin_api/rooms.html#room-details-api * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait get_room_info_v1 { /** * Get room info. * * @param string $roomid * @return Response */ public function get_room_info(string $roomid): Response { return $this->execute(new command( $this, method: 'GET', endpoint: '_synapse/admin/v1/rooms/:roomid', params: [ ':roomid' => $roomid, ], )); } } PK q�/[��Tà � H provider/matrix/classes/local/spec/features/matrix/upload_content_v3.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\matrix; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; use GuzzleHttp\Psr7\Utils; /** * Matrix API feature to upload content. * * https://spec.matrix.org/v1.1/client-server-api/#post_matrixmediav3upload * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait upload_content_v3 { /** * Upload the content in the matrix/synapse server. * * @param null|\stored_file $content The content to be uploaded * @param null|string $mediaid The mediaid to associate a file with. Supported for v1.7 API an above only. * @return Response */ public function upload_content( ?\stored_file $content, ?string $mediaid = null, ): Response { $query = []; if ($content) { $query['filename'] = $content->get_filename(); } if ($mediaid !== null) { // Specification of the mediaid requires version 1.7 or above of the upload API. // See https://spec.matrix.org/v1.7/client-server-api/#put_matrixmediav3uploadservernamemediaid. $this->requires_version('1.7'); $command = new command( $this, method: 'PUT', endpoint: '_matrix/media/v3/upload/:mediaid', sendasjson: false, query: $query, params: [ ':mediaid' => $mediaid, ], ); } else { $command = new command( $this, method: 'POST', endpoint: '_matrix/media/v3/upload', sendasjson: false, query: $query, ); } if ($content) { // Add the content-type, and header. $command = $command->withHeader('Content-Type', $content->get_mimetype()); $command = $command->withBody(Utils::streamFor($content->get_content())); } return $this->execute($command); } } PK q�/[q`g� � L provider/matrix/classes/local/spec/features/matrix/update_room_avatar_v3.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\matrix; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; /** * Matrix API feature to update a room avatar. * * https://spec.matrix.org/v1.1/client-server-api/#put_matrixclientv3roomsroomidstateeventtypestatekey * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait update_room_avatar_v3 { /** * Set the avatar for a room to the specified URL. * * @param string $roomid The roomid to set for * @param null|string $avatarurl The mxc URL to use * @return Response */ public function update_room_avatar( string $roomid, ?string $avatarurl, ): Response { $params = [ ':roomid' => $roomid, 'url' => $avatarurl, ]; return $this->execute(new command( $this, method: 'PUT', endpoint: '_matrix/client/v3/rooms/:roomid/state/m.room.avatar', ignorehttperrors: true, params: $params, )); } } PK q�/[�lv�q q Q provider/matrix/classes/local/spec/features/matrix/remove_member_from_room_v3.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\matrix; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; /** * Matrix API feature to remove a member from a room. * * https://spec.matrix.org/v1.1/client-server-api/#post_matrixclientv3roomsroomidkick * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait remove_member_from_room_v3 { /** * Remove a member from a room. * * @param string $roomid The roomid to remove from * @param string $userid The member to remove * @return Response */ public function remove_member_from_room( string $roomid, string $userid, ): Response { $params = [ ':roomid' => $roomid, 'user_id' => $userid, ]; return $this->execute(new command( $this, method: 'POST', endpoint: '_matrix/client/v3/rooms/:roomid/kick', params: $params, )); } } PK q�/[H��$ $ J provider/matrix/classes/local/spec/features/matrix/update_room_name_v3.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\matrix; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; /** * Matrix API feature to update a room name. * * https://spec.matrix.org/v1.1/client-server-api/#put_matrixclientv3roomsroomidstateeventtypestatekey * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait update_room_name_v3 { /** * Set the name for a room. * * @param string $roomid * @param string $name * @return Response */ public function update_room_name(string $roomid, string $name): Response { $params = [ ':roomid' => $roomid, 'name' => $name, ]; return $this->execute(new command( $this, method: 'PUT', endpoint: '_matrix/client/v3/rooms/:roomid/state/m.room.name', params: $params, )); } } PK q�/[��- - K provider/matrix/classes/local/spec/features/matrix/update_room_topic_v3.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\matrix; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; /** * Matrix API feature to update a room topic. * * https://spec.matrix.org/v1.1/client-server-api/#put_matrixclientv3roomsroomidstateeventtypestatekey * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait update_room_topic_v3 { /** * Set the topic for a room. * * @param string $roomid * @param string $topic * @return Response */ public function update_room_topic(string $roomid, string $topic): Response { $params = [ ':roomid' => $roomid, 'topic' => $topic, ]; return $this->execute(new command( $this, method: 'PUT', endpoint: '_matrix/client/v3/rooms/:roomid/state/m.room.topic', params: $params, )); } } PK q�/[���`v v R provider/matrix/classes/local/spec/features/matrix/update_room_power_levels_v3.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\matrix; use communication_matrix\local\command; use communication_matrix\matrix_constants; use GuzzleHttp\Psr7\Response; /** * Matrix API feature to update a room power levels. * * Matrix rooms have a concept of power levels, which are used to determine what actions a user can perform in a room. * * https://spec.matrix.org/v1.1/client-server-api/#mroompower_levels * * @package communication_matrix * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait update_room_power_levels_v3 { /** * Set the avatar for a room to the specified URL. * * @param string $roomid The roomid to set for * @param array $users The users to set power levels for * @param int $ban The level required to ban a user * @param int $invite The level required to invite a user * @param int $kick The level required to kick a user * @param array $notifications The level required to send notifications * @param int $redact The level required to redact events * @return Response */ public function update_room_power_levels( string $roomid, array $users, int $ban = matrix_constants::POWER_LEVEL_MAXIMUM, int $invite = matrix_constants::POWER_LEVEL_MODERATOR, int $kick = matrix_constants::POWER_LEVEL_MODERATOR, array $notifications = [ 'room' => matrix_constants::POWER_LEVEL_MODERATOR, ], int $redact = matrix_constants::POWER_LEVEL_MODERATOR, ): Response { $params = [ ':roomid' => $roomid, 'ban' => $ban, 'invite' => $invite, 'kick' => $kick, 'notifications' => $notifications, 'redact' => $redact, 'users' => $users, ]; return $this->execute(new command( $this, method: 'PUT', endpoint: '_matrix/client/v3/rooms/:roomid/state/m.room.power_levels', params: $params, )); } } PK q�/[>9� F provider/matrix/classes/local/spec/features/matrix/media_create_v1.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\matrix; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; /** * Matrix API feature to create an mxc Media URI. * * https://spec.matrix.org/v1.1/client-server-api/#post_matrixmediav3upload * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait media_create_v1 { /** * Create a media URI. * * @return Response */ public function media_create(): Response { return $this->execute(new command( $this, method: 'POST', endpoint: '_matrix/media/v1/create', )); } } PK q�/[��c� � E provider/matrix/classes/local/spec/features/matrix/create_room_v3.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\matrix; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; /** * Matrix API feature for room creation. * * https://spec.matrix.org/v1.1/client-server-api/#post_matrixclientv3createroom * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait create_room_v3 { /** * Create a new room. * * @param string $name The room name * @param null|string $visibility The room visibility * @param null|string $preset The preset to use * @param null|array $initialstate Initial state variables * @param array $options Any additional options * @return Response */ public function create_room( string $name, ?string $visibility = null, ?string $preset = null, ?array $initialstate = null, array $options = [], ): Response { $params = [ 'name' => $name, ]; if ($visibility !== null) { $params['visibility'] = $visibility; } if ($preset !== null) { $params['preset'] = $preset; } if ($initialstate !== null) { $params['initial_state'] = $initialstate; } if (array_key_exists('topic', $options)) { $params['topic'] = $options['topic'] ?? ''; } return $this->execute(new command( $this, method: 'POST', endpoint: '_matrix/client/v3/createRoom', params: $params, )); } } PK q�/['қՍ � X provider/matrix/classes/local/spec/features/matrix/get_room_powerlevels_from_sync_v3.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\matrix; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; /** * Matrix API feature to fetch room power levels using the sync API. * * https://spec.matrix.org/v1.1/client-server-api/#get_matrixclientv3sync * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait get_room_powerlevels_from_sync_v3 { /** * Get a list of room members. * * @param string $roomid The room ID * @return Response */ public function get_room_power_levels(string $roomid): Response { // Filter the event data according to the API: // https://spec.matrix.org/v1.1/client-server-api/#filtering // We have to filter out all of the object data that we do not want, // and set a filter to only fetch the one room that we do want. $filter = (object) [ "account_data" => (object) [ // We don't want any account info for this call. "not_types" => ['*'], ], "event_fields" => [ // We only care about type, and content. Not sender. "type", "content", ], "event_format" => "client", "presence" => (object) [ // We don't need any presence data. "not_types" => ['*'], ], "room" => (object) [ // We only want state information for power levels, not timeline and ephemeral data. "rooms" => [ $roomid, ], "state" => (object) [ "types" => [ "m.room.power_levels", ], ], "ephemeral" => (object) [ "not_types" => ['*'], ], "timeline" => (object) [ "not_types" => ['*'], ], ], ]; $query = [ 'filter' => json_encode($filter), ]; return $this->execute(new command( $this, method: 'GET', endpoint: '_matrix/client/v3/sync', query: $query, sendasjson: false, )); } } PK q�/[�x�� � J provider/matrix/classes/local/spec/features/matrix/get_room_members_v3.phpnu &1i� <?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/>. namespace communication_matrix\local\spec\features\matrix; use communication_matrix\local\command; use GuzzleHttp\Psr7\Response; /** * Matrix API feature to fetch a list of room members. * * https://spec.matrix.org/v1.1/client-server-api/#get_matrixclientv3roomsroomidjoined_members * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @codeCoverageIgnore * This code does not warrant being tested. Testing offers no discernible benefit given its usage is tested. */ trait get_room_members_v3 { /** * Get a list of room members. * * @param string $roomid The room ID * @return Response */ public function get_room_members(string $roomid): Response { $params = [ ':roomid' => $roomid, ]; return $this->execute(new command( $this, method: 'GET', endpoint: '_matrix/client/v3/rooms/:roomid/joined_members', params: $params, )); } } PK q�/[_�ԽX X + provider/matrix/classes/local/spec/v1p6.phpnu &1i� <?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/>. namespace communication_matrix\local\spec; /** * Matrix API to support version v1.6 of the Matrix specification. * * https://spec.matrix.org/v1.6/client-server-api/ * https://spec.matrix.org/v1.6/changelog/#api-changes * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class v1p6 extends v1p5 { } PK q�/[�PT� � + provider/matrix/classes/local/spec/v1p1.phpnu &1i� <?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/>. namespace communication_matrix\local\spec; /** * Matrix API to support version v1.1 of the Matrix specification. * * https://spec.matrix.org/v1.1/client-server-api/ * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class v1p1 extends \communication_matrix\matrix_client { // Use the standard matrix API for these features. use features\matrix\create_room_v3; use features\matrix\get_room_members_v3; use features\matrix\remove_member_from_room_v3; use features\matrix\update_room_avatar_v3; use features\matrix\update_room_name_v3; use features\matrix\update_room_topic_v3; use features\matrix\upload_content_v3; use features\matrix\update_room_power_levels_v3; use features\matrix\get_room_powerlevels_from_sync_v3; // We use the Synapse API here because it can invite users to a room without requiring them to accept the invite. use features\synapse\invite_member_to_room_v1; // User information and creation is a server-specific feature. use features\synapse\get_user_info_v2; use features\synapse\create_user_v2; use features\synapse\get_room_info_v1; } PK q�/[L�4 4 ) provider/matrix/classes/local/command.phpnu &1i� <?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/>. namespace communication_matrix\local; use communication_matrix\matrix_client; use GuzzleHttp\Psr7\Request; use OutOfRangeException; /** * A command to be sent to the Matrix server. * * This class is a wrapper around the PSR-7 Request Interface implementation provided by Guzzle. * * It takes a set of common parameters and configurations and turns them into a Request that can be called against a live server. * * @package communication_matrix * @copyright Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class command extends Request { /** @var array $command The raw command data */ /** @var array|null $params The parameters passed into the command */ /** @var bool $sendasjson Whether to send params as JSON */ /** @var bool $requireauthorization Whether authorization is required for this request */ /** @var bool $ignorehttperrors Whether to ignore HTTP Errors */ /** @var array $query Any query parameters to set on the URL */ /** @var array|null Any parameters not used in the URI which are to be passed to the server via body or query params */ protected array $remainingparams = []; /** * Create a new Command. * * @param matrix_client $client The URL for this method * @param string $method (GET|POST|PUT|DELETE) * @param string $endpoint The URL * @param array $params Any parameters to pass * @param array $query Any query parameters to set on the URL * @param bool $ignorehttperrors Whether to ignore HTTP Errors * @param bool $requireauthorization Whether authorization is required for this request * @param bool $sendasjson Whether to send params as JSON */ public function __construct( protected matrix_client $client, string $method, string $endpoint, protected array $params = [], protected array $query = [], protected bool $ignorehttperrors = false, protected bool $requireauthorization = true, protected bool $sendasjson = true, ) { foreach ($params as $name => $value) { if ($name[0] === ':') { if (preg_match("/{$name}\\b/", $endpoint) !== 1) { throw new OutOfRangeException("Parameter not found in URL '{$name}'"); } $endpoint = preg_replace("/{$name}\\b/", urlencode($value), $endpoint); unset($params[$name]); } } // Store the modified params. $this->remainingparams = $params; if (str_contains($endpoint, '/:')) { throw new OutOfRangeException("URL contains untranslated parameters '{$endpoint}'"); } // Process the required headers. $headers = [ 'Content-Type' => 'application/json', ]; if ($this->require_authorization()) { $headers['Authorization'] = 'Bearer ' . $this->client->get_token(); } // Construct the final request. parent::__construct( $method, $this->get_url($endpoint), $headers, ); } /** * Get the URL of the endpoint on the server. * * @param string $endpoint * @return string */ protected function get_url(string $endpoint): string { return sprintf( "%s/%s", $this->client->get_server_url(), $endpoint, ); } /** * Get all parameters, including those set in the URL. * * @return array */ public function get_all_params(): array { return $this->params; } /** * Get the parameters provided to the command which are not used in the URL. * * These are typically passed to the server as query or body parameters instead. * * @return array */ public function get_remaining_params(): array { return $this->remainingparams; } /** * Get the Guzzle options to pass into the request. * * @return array */ public function get_options(): array { $options = []; if (count($this->query)) { $options['query'] = $this->query; } if ($this->should_send_params_as_json()) { $options['json'] = $this->get_remaining_params(); } if ($this->should_ignore_http_errors()) { $options['http_errors'] = false; } return $options; } /** * Whether authorization is required. * * Based on the 'authorization' attribute set in a raw command. * * @return bool */ public function require_authorization(): bool { return $this->requireauthorization; } /** * Whether to ignore http errors on the response. * * Based on the 'ignore_http_errors' attribute set in a raw command. * * @return bool */ public function should_ignore_http_errors(): bool { return $this->ignorehttperrors; } /** * Whether to send remaining parameters as JSON. * * @return bool */ public function should_send_params_as_json(): bool { return $this->sendasjson; } } PK q�/[�c�� / provider/matrix/classes/matrix_user_manager.phpnu &1i� <?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/>. namespace communication_matrix; /** * class matrix_user_manager to handle specific actions. * * @package communication_matrix * @copyright 2023 Stevani Andolo <stevani.andolo@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class matrix_user_manager { /** * Gets matrix user id from moodle. * * @param int $userid Moodle user id * @return string|null */ public static function get_matrixid_from_moodle( int $userid, ): ?string { self::load_requirements(); $field = profile_user_record($userid); $matrixprofilefield = get_config('communication_matrix', 'matrixuserid_field'); if ($matrixprofilefield === false) { return null; } return $field->{$matrixprofilefield} ?? null; } /** * Get a qualified matrix user id based on a Moodle username. * * @param string $username The moodle username to turn into a Matrix username * @return string */ public static function get_formatted_matrix_userid( string $username, ): string { $username = preg_replace('/[@#$%^&*()+{}|<>?!,]/i', '.', $username); $username = ltrim(rtrim($username, '.'), '.'); $homeserver = self::get_formatted_matrix_home_server(); return "@{$username}:{$homeserver}"; } /** * Add user's Matrix user id. * * @param int $userid Moodle user id * @param string $matrixuserid Matrix user id */ public static function set_matrix_userid_in_moodle( int $userid, string $matrixuserid, ): void { $matrixprofilefield = self::get_profile_field_name(); $field = profile_get_custom_field_data_by_shortname($matrixprofilefield); if ($field === null) { return; } $userinfodata = (object) [ 'id' => $userid, 'data' => $matrixuserid, 'fieldid' => $field->id, "profile_field_{$matrixprofilefield}" => $matrixuserid, ]; profile_save_data($userinfodata); } /** * Sets home server for user matrix id * * @return string */ public static function get_formatted_matrix_home_server(): string { $homeserver = get_config('communication_matrix', 'matrixhomeserverurl'); if ($homeserver === false) { throw new \moodle_exception('Unknown matrix homeserver url'); } $homeserver = parse_url($homeserver)['host']; if (str_starts_with($homeserver, 'www.')) { $homeserver = str_replace('www.', '', $homeserver); } return $homeserver; } /** * Insert "Communication" category and "matrixuserid" field. * * @return string */ public static function create_matrix_user_profile_fields(): string { global $CFG, $DB; require_once($CFG->dirroot . '/user/profile/definelib.php'); require_once($CFG->dirroot . '/user/profile/field/text/define.class.php'); // Check if communication category exists. $categoryname = get_string('communication', 'core_communication'); $category = $DB->count_records('user_info_category', ['name' => $categoryname]); if ($category < 1) { $data = new \stdClass(); $data->sortorder = $DB->count_records('user_info_category') + 1; $data->name = $categoryname; $data->id = $DB->insert_record('user_info_category', $data); $createdcategory = $DB->get_record('user_info_category', ['id' => $data->id]); $categoryid = $createdcategory->id; \core\event\user_info_category_created::create_from_category($createdcategory)->trigger(); } else { $category = $DB->get_record('user_info_category', ['name' => $categoryname]); $categoryid = $category->id; } set_config('communication_category_field', $categoryname, 'core_communication'); // Check if matrixuserid exists in user_info_field table. $matrixuserid = $DB->count_records('user_info_field', [ 'shortname' => 'matrixuserid', 'categoryid' => $categoryid, ]); if ($matrixuserid < 1) { $profileclass = new \profile_define_text(); $data = (object) [ 'shortname' => 'matrixuserid', 'name' => get_string('matrixuserid', 'communication_matrix'), 'datatype' => 'text', 'categoryid' => $categoryid, 'forceunique' => 1, 'visible' => 0, 'locked' => 1, 'param1' => 30, 'param2' => 2048, ]; $profileclass->define_save($data); set_config('matrixuserid_field', 'matrixuserid', 'communication_matrix'); return 'matrixuserid'; } } /** * Get the profile field name, creating the profiel field if it does not exist. * * @return string */ protected static function get_profile_field_name(): string { self::load_requirements(); $matrixprofilefield = get_config('communication_matrix', 'matrixuserid_field'); if ($matrixprofilefield === false) { $matrixprofilefield = self::create_matrix_user_profile_fields(); } return $matrixprofilefield; } /** * Load requirements for profile field management. * * This is just a helper to keep loading legacy files isolated. */ protected static function load_requirements(): void { global $CFG; require_once("{$CFG->dirroot}/user/profile/lib.php"); } } PK q�/[�+�b�* �* ) provider/matrix/classes/matrix_client.phpnu &1i� <?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/>. namespace communication_matrix; use communication_matrix\local\command; use core\http_client; use DirectoryIterator; use Exception; use GuzzleHttp\Psr7\Response; /** * The abstract class for a versioned API client for Matrix. * * Matrix uses a versioned API, and a handshake occurs between the Client (Moodle) and server, to determine the APIs available. * * This client represents a version-less API client. * Versions are implemented by combining the various features into a versionedclass. * See v1p1 for example. * * @package communication_matrix * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ abstract class matrix_client { /** @var string $serverurl The URL of the home server */ /** @var string $accesstoken The access token of the matrix server */ /** @var http_client|null The client to use */ protected static http_client|null $client = null; /** * Matrix events constructor to get the room id and refresh token usage if required. * * @param string $serverurl The URL of the API server * @param string $accesstoken The admin access token */ protected function __construct( protected string $serverurl, protected string $accesstoken, ) { } /** * Return the versioned instance of the API. * * @param string $serverurl The URL of the API server * @param string $accesstoken The admin access token to use * @return matrix_client */ public static function instance( string $serverurl, string $accesstoken, ): matrix_client { // Fetch the list of supported API versions. $clientversions = self::get_supported_versions(); // Fetch the supported versions from the server. $serversupports = self::query_server_supports($serverurl); $serverversions = $serversupports->versions; // Calculate the intersections and sort to determine the highest combined version. $versions = array_intersect($clientversions, $serverversions); if (count($versions) === 0) { // No versions in common. throw new \moodle_exception('No supported Matrix API versions found.'); } asort($versions); $version = array_key_last($versions); $classname = \communication_matrix\local\spec::class . '\\' . $version; return new $classname( $serverurl, $accesstoken, ); } /** * Determine if the API supports a feature. * * If an Array is provided, this will return true if any of the specified features is implemented. * * @param string[]|string $feature The feature to check. This is in the form of a namespaced class. * @return bool */ public function implements_feature(array|string $feature): bool { if (is_array($feature)) { foreach ($feature as $thisfeature) { if ($this->implements_feature($thisfeature)) { return true; } } // None of the features are implemented in this API version. return false; } return in_array($feature, $this->get_supported_features()); } /** * Get a list of the features supported by this client. * * @return string[] */ public function get_supported_features(): array { $features = []; $class = static::class; do { $features = array_merge($features, class_uses($class)); $class = get_parent_class($class); } while ($class); return $features; } /** * Require that the API supports a feature. * * If an Array is provided, this is treated as a require any of the features. * * @param string[]|string $feature The feature to test * @throws \moodle_exception */ public function require_feature(array|string $feature): void { if (!$this->implements_feature($feature)) { if (is_array($feature)) { $features = implode(', ', $feature); throw new \moodle_exception( "None of the possible feature are implemented in this Matrix Client: '{$features}'" ); } throw new \moodle_exception("The requested feature is not implemented in this Matrix Client: '{$feature}'"); } } /** * Require that the API supports a list of features. * * All features specified will be required. * * If an array is provided as one of the features, any of the items in the nested array will be required. * * @param string[]|array[] $features The list of features required * * Here is an example usage: * <code> * $matrixapi->require_features([ * * \communication_matrix\local\spec\features\create_room::class, * [ * \communication_matrix\local\spec\features\get_room_info_v1::class, * \communication_matrix\local\spec\features\get_room_info_v2::class, * ] * ]) * </code> */ public function require_features(array $features): void { array_walk($features, [$this, 'require_feature']); } /** * Get the URL of the server. * * @return string */ public function get_server_url(): string { return $this->serverurl; } /** * Query the supported versions, and any unstable features, from the server. * * Servers must implement the client versions API described here: * - https://spec.matrix.org/latest/client-server-api/#get_matrixclientversions * * @param string $serverurl The server base * @return \stdClass The list of supported versions and a list of enabled unstable features */ protected static function query_server_supports(string $serverurl): \stdClass { // Attempt to return from the cache first. $cache = \cache::make('communication_matrix', 'serverversions'); $serverkey = sha1($serverurl); if ($cache->get($serverkey)) { return $cache->get($serverkey); } // Not in the cache - fetch and store in the cache. $client = static::get_http_client(); $response = $client->get("{$serverurl}/_matrix/client/versions"); $supportsdata = json_decode( json: $response->getBody(), associative: false, flags: JSON_THROW_ON_ERROR, ); $cache->set($serverkey, $supportsdata); return $supportsdata; } /** * Get the list of supported versions based on the available classes. * * @return array */ public static function get_supported_versions(): array { $versions = []; $iterator = new DirectoryIterator(__DIR__ . '/local/spec'); foreach ($iterator as $fileinfo) { if ($fileinfo->isDir()) { continue; } // Get the classname from the filename. $classname = substr($fileinfo->getFilename(), 0, -4); if (!preg_match('/^v\d+p\d+$/', $classname)) { // @codeCoverageIgnoreStart // This file does not fit the format v[MAJOR]p[MINOR]]. continue; // @codeCoverageIgnoreEnd } $versions[$classname] = "v" . self::get_version_from_classname($classname); } return $versions; } /** * Get the current token in use. * * @return string */ public function get_token(): string { return $this->accesstoken; } /** * Helper to fetch the HTTP Client for the instance. * * @return \core\http_client */ protected function get_client(): \core\http_client { return static::get_http_client(); } /** * Helper to fetch the HTTP Client. * * @return \core\http_client */ protected static function get_http_client(): \core\http_client { if (static::$client !== null) { return static::$client; } // @codeCoverageIgnoreStart return new http_client(); // @codeCoverageIgnoreEnd } /** * Execute the specified command. * * @param command $command * @return Response */ protected function execute( command $command, ): Response { $client = $this->get_client(); return $client->send( $command, $command->get_options(), ); } /** * Get the API version of the current instance. * * @return string */ public function get_version(): string { $reflect = new \ReflectionClass(static::class); $classname = $reflect->getShortName(); return self::get_version_from_classname($classname); } /** * Normalise an API version from a classname. * * @param string $classname The short classname, omitting any namespace or file extension * @return string The normalised version */ protected static function get_version_from_classname(string $classname): string { $classname = str_replace('v', '', $classname); $classname = str_replace('p', '.', $classname); return $classname; } /** * Check if the API version is at least the specified version. * * @param string $minversion The minimum API version required * @return bool */ public function meets_version(string $minversion): bool { $thisversion = $this->get_version(); return version_compare($thisversion, $minversion) >= 0; } /** * Assert that the API version is at least the specified version. * * @param string $minversion The minimum API version required * @throws Exception */ public function requires_version(string $minversion): void { if ($this->meets_version($minversion)) { return; } throw new \moodle_exception("Matrix API version {$minversion} or higher is required for this command."); } } PK q�/[� �n provider/matrix/db/upgrade.phpnu &1i� <?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/>. /** * Install steps for communication_matrix. * * @package communication_matrix * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ /** * Upgrade procedures for the matrix plugin. * * @return bool */ function xmldb_communication_matrix_upgrade($oldversion) { global $DB; $dbman = $DB->get_manager(); if ($oldversion < 2023060101) { $table = new xmldb_table('matrix_rooms'); $field = new xmldb_field('topic', XMLDB_TYPE_CHAR, '255', null, false, false, null, 'roomid'); if (!$dbman->field_exists($table, $field)) { $dbman->add_field($table, $field); } // Plugin savepoint reached. upgrade_plugin_savepoint(true, 2023060101, 'communication', 'matrix'); } if ($oldversion < 2023071900) { $table = new xmldb_table('matrix_rooms'); $dbman->rename_table($table, 'matrix_room'); // Plugin savepoint reached. upgrade_plugin_savepoint(true, 2023071900, 'communication', 'matrix'); } return true; } PK q�/[�q�b� � provider/matrix/db/caches.phpnu &1i� <?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/>. /** * Cache definition for the Matrix Communication plugin. * * @package communication_matrix * @category cache * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); $definitions = [ // Used to store processed lang files. // The keys used are the revision, lang and component of the string file. // The static acceleration size has been based upon student access of the site. 'serverversions' => [ 'mode' => cache_store::MODE_APPLICATION, 'simplekeys' => true, 'simpledata' => true, 'staticacceleration' => true, 'staticaccelerationsize' => 1, 'canuselocalstore' => true, // Cache for one day. 'ttl' => 60 * 60 * 24, ], ]; PK q�/[A��� � provider/matrix/db/install.xmlnu &1i� <?xml version="1.0" encoding="UTF-8" ?> <XMLDB PATH="communication/provider/matrix/db" VERSION="20230719" COMMENT="Stores the matrix room information associated with the communication instance." xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../../lib/xmldb/xmldb.xsd" > <TABLES> <TABLE NAME="matrix_room" COMMENT="Stores the matrix room information associated with the communication instance."> <FIELDS> <FIELD NAME="id" TYPE="int" LENGTH="10" NOTNULL="true" SEQUENCE="true"/> <FIELD NAME="commid" TYPE="int" LENGTH="10" NOTNULL="true" SEQUENCE="false" COMMENT="ID of the communication record"/> <FIELD NAME="roomid" TYPE="char" LENGTH="255" NOTNULL="false" SEQUENCE="false" COMMENT="ID of the matrix room instance"/> <FIELD NAME="topic" TYPE="char" LENGTH="255" NOTNULL="false" SEQUENCE="false" COMMENT="Topic of the matrix room instance."/> </FIELDS> <KEYS> <KEY NAME="primary" TYPE="primary" FIELDS="id"/> <KEY NAME="fk_commid" TYPE="foreign" FIELDS="commid" REFTABLE="communication" REFFIELDS="id" COMMENT="Foreign key for communication reference"/> </KEYS> </TABLE> </TABLES> </XMLDB> PK q�/[��n�G G provider/matrix/db/access.phpnu &1i� <?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/>. /** * Capability definitions for matrix communication. * * @package communication_matrix * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); $capabilities = [ // Matrix moderator capability which aligns with the matrix moderator role or power level 50. 'communication/matrix:moderator' => [ 'captype' => 'read', 'contextlevel' => CONTEXT_COURSE, 'archetypes' => [ 'editingteacher' => CAP_ALLOW, 'manager' => CAP_ALLOW, 'teacher' => CAP_ALLOW, ], ], ]; PK q�/[���� � provider/matrix/settings.phpnu &1i� <?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/>. /** * Matrix communication plugin settings. * * @package communication_matrix * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die; if ($hassiteconfig) { // Home server URL. $name = new lang_string('matrixhomeserverurl', 'communication_matrix'); $desc = new lang_string('matrixhomeserverurl_desc', 'communication_matrix'); $settings->add(new admin_setting_configtext('communication_matrix/matrixhomeserverurl', $name, $desc, '')); // Access token. $name = new lang_string('matrixaccesstoken', 'communication_matrix'); $desc = new lang_string('matrixaccesstoken_desc', 'communication_matrix'); $settings->add(new admin_setting_configpasswordunmask('communication_matrix/matrixaccesstoken', $name, $desc, '')); // Element web URL. $name = new lang_string('matrixelementurl', 'communication_matrix'); $settings->add(new admin_setting_configtext('communication_matrix/matrixelementurl', $name, '', '')); } PK q�/[#�rc� � * provider/matrix/tests/matrix_room_test.phpnu &1i� <?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/>. namespace communication_matrix; /** * Tests for the matrix_room class. * * @package communication_matrix * @category test * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @coversDefaultClass \communication_matrix\matrix_room */ class matrix_room_test extends \advanced_testcase { /** * Test for load_by_processor_id with no record. * * @covers ::load_by_processor_id */ public function test_load_by_processor_id_none(): void { $this->assertNull(matrix_room::load_by_processor_id(999999999)); } /** * Test for load_by_processor_id with valid records. * * @covers ::create_room_record * @covers ::__construct * @covers ::load_by_processor_id * @covers ::get_processor_id * @covers ::get_room_id * @covers ::get_topic */ public function test_create_room_record(): void { $this->resetAfterTest(); $room = matrix_room::create_room_record( processorid: 10000, topic: null, ); $this->assertInstanceOf(matrix_room::class, $room); $this->assertEquals(10000, $room->get_processor_id()); $this->assertNotNull('', $room->get_topic()); $this->assertEquals('', $room->get_topic()); $this->assertNull($room->get_room_id()); $room = matrix_room::create_room_record( processorid: 12345, topic: 'The topic of this room is thusly', ); $this->assertInstanceOf(matrix_room::class, $room); $this->assertEquals(12345, $room->get_processor_id()); $this->assertEquals('The topic of this room is thusly', $room->get_topic()); $this->assertNull($room->get_room_id()); $room = matrix_room::create_room_record( processorid: 54321, topic: 'The topic of this room is thusly', roomid: 'This is a roomid', ); $this->assertInstanceOf(matrix_room::class, $room); $this->assertEquals(54321, $room->get_processor_id()); $this->assertEquals('The topic of this room is thusly', $room->get_topic()); $this->assertEquals('This is a roomid', $room->get_room_id()); $reloadedroom = matrix_room::load_by_processor_id(54321); $this->assertEquals(54321, $reloadedroom->get_processor_id()); $this->assertEquals('The topic of this room is thusly', $reloadedroom->get_topic()); $this->assertEquals('This is a roomid', $reloadedroom->get_room_id()); } /** * Test for update_room_record. * * @covers ::update_room_record */ public function test_update_room_record(): void { $this->resetAfterTest(); $room = matrix_room::create_room_record( processorid: 12345, topic: 'The topic of this room is that', ); // Add a roomid. $room->update_room_record( roomid: 'This is a roomid', ); $this->assertEquals('This is a roomid', $room->get_room_id()); $this->assertEquals('The topic of this room is that', $room->get_topic()); $this->assertEquals(12345, $room->get_processor_id()); // Alter the roomid and topic. $room->update_room_record( roomid: 'updatedRoomId', topic: 'updatedTopic is here', ); $this->assertEquals('updatedRoomId', $room->get_room_id()); $this->assertEquals('updatedTopic is here', $room->get_topic()); $this->assertEquals(12345, $room->get_processor_id()); } /** * Tests for delete_room_record. * * @covers ::delete_room_record */ public function test_delete_room_record(): void { global $DB; $this->resetAfterTest(); $room = matrix_room::create_room_record( processorid: 12345, topic: 'The topic of this room is that', ); $this->assertCount(1, $DB->get_records('matrix_room')); $room->delete_room_record(); $this->assertCount(0, $DB->get_records('matrix_room')); } } PK q�/[�a�� 7 provider/matrix/tests/fixtures/mocked_matrix_client.phpnu &1i� <?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/>. namespace communication_matrix\tests\fixtures; use core\http_client; /** * Tests for the api_base class. * * @package communication_matrix * @category test * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class mocked_matrix_client extends \communication_matrix\matrix_client { /** * Public variant of the constructor. */ public function __construct() { parent::__construct(...func_get_args()); } /** * Reset the test client. */ public static function reset_client(): void { self::$client = null; } /** * Set the http_client to the client specified. * * @param http_client $client */ public static function set_client(http_client $client): void { self::$client = $client; } } PK q�/[z갺;J ;J 4 provider/matrix/tests/communication_feature_test.phpnu &1i� <?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/>. namespace communication_matrix; use core\context; use core_communication\api; use core_communication\communication_test_helper_trait; use core_communication\processor; use stored_file; defined('MOODLE_INTERNAL') || die(); require_once(__DIR__ . '/matrix_test_helper_trait.php'); require_once(__DIR__ . '/../../../tests/communication_test_helper_trait.php'); /** * Class communication_feature_test to test the matrix features implemented using the core interfaces. * * @package communication_matrix * @category test * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @covers \communication_matrix\communication_feature * @coversDefaultClass \communication_matrix\communication_feature */ class communication_feature_test extends \advanced_testcase { use matrix_test_helper_trait; use communication_test_helper_trait; public function setUp(): void { parent::setUp(); $this->resetAfterTest(); $this->setup_communication_configs(); $this->initialise_mock_server(); } /** * Test create or update chat room. * * @covers ::create_chat_room */ public function test_create_chat_room(): void { // Set up the test data first. $communication = \core_communication\api::load_by_instance( context: \core\context\system::instance(), component: 'communication_matrix', instancetype: 'example', instanceid: 1, provider: 'communication_matrix', ); $communication->create_and_configure_room( communicationroomname: 'Room name', instance: (object) [ 'matrixroomtopic' => 'A fun topic', ], ); // phpcs:ignore moodle.Commenting.InlineComment.DocBlock /** @var communication_feature */ $provider = $communication->get_room_provider(); $this->assertInstanceOf( communication_feature::class, $provider, ); // Run the create_chat_room task. $result = $provider->create_chat_room(); $this->assertTrue($result); // Ensure that a room_id was set. $this->assertNotEmpty($provider->get_room_id()); // Fetch the back office room data. $remoteroom = $this->backoffice_get_room(); // The roomid set in the database must match the one set on the remote server. $this->assertEquals( $remoteroom->room_id, $provider->get_room_id(), ); // The name is a feature of the communication API itself. $this->assertEquals( 'Room name', $communication->get_room_name(), ); $this->assertEquals( $communication->get_room_name(), $remoteroom->name, ); // The topic is a Matrix feature. $roomconfig = $provider->get_room_configuration(); $this->assertEquals( 'A fun topic', $roomconfig->get_topic(), ); $this->assertEquals( $remoteroom->topic, $roomconfig->get_topic(), ); // The avatar features are checked in a separate test. } /** * Test update of a chat room. * * @covers ::update_chat_room */ public function test_update_chat_room(): void { $communication = $this->create_room( roomname: 'Our room name', roomtopic: 'Our room topic', ); // phpcs:ignore moodle.Commenting.InlineComment.DocBlock /** @var communication_feature */ $provider = $communication->get_room_provider(); $this->assertInstanceOf( communication_feature::class, $provider, ); // Update the room name. // Note: We have to update the record via the API, and then call the provider update method. // That's because the update is performed asynchronously. $communication->update_room( communicationroomname: 'Our updated room name', ); $provider->reload(); // Now call the provider's update method. $provider->update_chat_room(); // And assert that it was updated remotely. $remoteroom = $this->backoffice_get_room(); $this->assertEquals( 'Our updated room name', $communication->get_room_name(), ); $this->assertEquals( $communication->get_room_name(), $remoteroom->name, ); // The remote topic should not have changed. $this->assertEquals( 'Our room topic', $remoteroom->topic, ); // Now update just the topic. // First in the local API. $communication->update_room( instance: (object) [ 'matrixroomtopic' => 'Our updated room topic', ], ); $provider->reload(); // Then call the provider's update method to actually perform the change. $provider->update_chat_room(); // And assert that it was updated remotely. $remoteroom = $this->backoffice_get_room(); $this->assertEquals( 'Our updated room topic', $provider->get_room_configuration()->get_topic(), ); // The remote topic should have been updated. $this->assertEquals( 'Our updated room topic', $remoteroom->topic, ); // The name should not have changed. $this->assertEquals( 'Our updated room name', $communication->get_room_name(), ); } /** * Test delete chat room. * * @covers ::delete_chat_room */ public function test_delete_chat_room(): void { $communication = $this->create_room(); $processor = $communication->get_processor(); $provider = $communication->get_room_provider(); $room = matrix_room::load_by_processor_id($processor->get_id()); // Run the delete method. $this->assertTrue($provider->delete_chat_room()); // The record of the room should have been removed. $this->assertNull(matrix_room::load_by_processor_id($processor->get_id())); // But the room itself shoudl exist. $matrixroomdata = $this->get_matrix_room_data($room->get_room_id()); $this->assertNotEmpty($matrixroomdata); $this->assertEquals($processor->get_room_name(), $matrixroomdata->name); $this->assertEquals($room->get_topic(), $matrixroomdata->topic); } /** * Test update room avatar. * * @covers ::update_room_avatar * @dataProvider avatar_provider */ public function test_update_room_avatar( ?string $before, ?string $after, ): void { $this->setAdminUser(); // Create a new draft file. $logo = $this->create_communication_file('moodle_logo.jpg', 'logo.jpg'); $circle = $this->create_communication_file('circle.png', 'circle.png'); if ($before === 'logo') { $before = $logo; } else if ($before === 'circle') { $before = $circle; } if ($after === 'logo') { $after = $logo; } else if ($after === 'circle') { $after = $circle; } $communication = $this->create_matrix_room( component: 'communication_matrix', itemtype: 'example_room', itemid: 1, roomname: 'Example room name', roomavatar: $before, ); // Confirm that the avatar was set remotely. $remoteroom = $this->backoffice_get_room(); if ($before) { $this->assertStringEndsWith($before->get_filename(), $remoteroom->avatar); $avatarcontent = download_file_content($remoteroom->avatar); $this->assertEquals($before->get_content(), $avatarcontent); } else { $this->assertEmpty($remoteroom->avatar); } // Reload the API instance as the information stored has changed. $communication->reload(); // Update the avatar with the 'after' avatar. $communication->update_room( avatar: $after, ); $this->run_all_adhoc_tasks(); // Confirm that the avatar was updated remotely. $remoteroom = $this->backoffice_get_room(); if ($after) { $this->assertStringEndsWith($after->get_filename(), $remoteroom->avatar); $avatarcontent = download_file_content($remoteroom->avatar); $this->assertEquals($after->get_content(), $avatarcontent); } else { $this->assertEmpty($remoteroom->avatar); } } /** * Tests for setting and updating the room avatar. * * @return array */ public static function avatar_provider(): array { return [ 'Empty to avatar' => [ null, 'circle', ], 'Avatar to empty' => [ 'circle', null, ], 'Avatar to new avatar' => [ 'circle', 'logo', ], ]; } /** * Test get chat room url. * * @covers ::get_chat_room_url */ public function test_get_chat_room_url(): void { $communication = $this->create_room(); $provider = $communication->get_room_provider(); $url = $provider->get_chat_room_url(); $this->assertNotNull($url); // Fetch the room information from the server. $remoteroom = $this->backoffice_get_room(); $this->assertStringEndsWith( $remoteroom->room_id, $url, ); } /** * Test create members. * * @covers ::create_members * @covers ::add_registered_matrix_user_to_room */ public function test_create_members(): void { $user = $this->getDataGenerator()->create_user(); $communication = $this->create_room( members: [ $user->id, ], ); $remoteroom = $this->backoffice_get_room(); $this->assertCount(1, $remoteroom->members); $member = reset($remoteroom->members); $this->assertStringStartsWith("@{$user->username}", $member->userid); } /** * Test add/remove members from room. * * @covers ::remove_members_from_room * @covers ::add_members_to_room * @covers ::add_registered_matrix_user_to_room * @covers ::check_room_membership * @covers ::set_matrix_power_levels */ public function test_add_and_remove_members_from_room(): void { $this->markTestSkipped('Skipping while we update the Mock Server with the new route'); $user = $this->getDataGenerator()->create_user(); $user2 = $this->getDataGenerator()->create_user(); $communication = $this->create_room(); $provider = $communication->get_room_user_provider(); $remoteroom = $this->backoffice_get_room(); $this->assertCount(0, $remoteroom->members); // Add the members to the room. $provider->add_members_to_room([$user->id, $user2->id]); // Ensure that they have been created. $remoteroom = $this->backoffice_get_room(); $this->assertCount(2, $remoteroom->members); $userids = array_map(fn($member) => $member->userid, $remoteroom->members); $userids = array_map(fn($userid) => substr($userid, 0, strpos($userid, ':')), $userids); $this->assertContains("@{$user->username}", $userids); $this->assertContains("@{$user2->username}", $userids); // Remove member from matrix room. $provider->remove_members_from_room([$user->id]); // Ensure that they have been removed. $remoteroom = $this->backoffice_get_room(); $members = (array) $remoteroom->members; $this->assertCount(1, $members); $userids = array_map(fn ($member) => $member->userid, $members); $userids = array_map(fn ($userid) => substr($userid, 0, strpos($userid, ':')), $userids); $this->assertNotContains("@{$user->username}", $userids); $this->assertContains("@{$user2->username}", $userids); } /** * Test update of room membership. * * @covers ::update_room_membership * @covers ::set_matrix_power_levels * @covers ::is_power_levels_update_required * @covers ::get_user_allowed_power_level */ public function test_update_room_membership(): void { $this->markTestSkipped('Skipping while we update the Mock Server with the new route'); $this->resetAfterTest(); global $DB; // Create a new room. $course = $this->get_course('Sampleroom', 'none'); $user = $this->get_user(); $communication = $this->create_room( component: 'core_course', itemtype: 'coursecommunication', itemid: $course->id ); $provider = $communication->get_room_user_provider(); // Add the members to the room. $provider->add_members_to_room([$user->id]); // Assign teacher role to the user. $coursecontext = \context_course::instance($course->id); $teacherrole = $DB->get_record('role', ['shortname' => 'teacher']); $this->getDataGenerator()->enrol_user($user->id, $course->id); role_assign($teacherrole->id, $user->id, $coursecontext->id); // Test the tasks added as the role is a teacher. $provider->update_room_membership([$user->id]); $processor = \core_communication\processor::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $synceduser = $processor->get_instance_userids( synced: true, ); $synceduser = reset($synceduser); // Test if the communication user record is synced. $this->assertEquals($user->id, $synceduser); } /** * Test the user power level allocation according to context. * * @covers ::get_user_allowed_power_level */ public function test_get_user_allowed_power_level(): void { $this->resetAfterTest(); global $DB; // Create users. $user1 = $this->getDataGenerator()->create_user(); $user2 = $this->getDataGenerator()->create_user(); $course = $this->get_course(); $coursecontext = \context_course::instance($course->id); $teacherrole = $DB->get_record('role', ['shortname' => 'editingteacher']); $studentrole = $DB->get_record('role', ['shortname' => 'student']); $this->getDataGenerator()->enrol_user($user1->id, $course->id); $this->getDataGenerator()->enrol_user($user2->id, $course->id); // Assign roles. role_assign($teacherrole->id, $user1->id, $coursecontext->id); role_assign($studentrole->id, $user2->id, $coursecontext->id); $communicationprocessor = processor::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id ); // Test if the power level is set according to the context. $this->assertEquals( matrix_constants::POWER_LEVEL_MOODLE_MODERATOR, $communicationprocessor->get_room_provider()->get_user_allowed_power_level($user1->id) ); $this->assertEquals( matrix_constants::POWER_LEVEL_DEFAULT, $communicationprocessor->get_room_provider()->get_user_allowed_power_level($user2->id) ); } /** * Helper to create a room. * * @param null|string $component * @param null|string $itemtype * @param null|int $itemid * @param null|string $roomname * @param null|string $roomtopic * @param null|stored_file $roomavatar * @param array $members * @return api */ protected function create_room( ?string $component = 'communication_matrix', ?string $itemtype = 'example', ?int $itemid = 1, ?string $roomname = null, ?string $roomtopic = null, ?\stored_file $roomavatar = null, array $members = [], ?context $context = null, ): \core_communication\api { // Create a new room. $communication = \core_communication\api::load_by_instance( context: $context ?? \core\context\system::instance(), component: $component, instancetype: $itemtype, instanceid: $itemid, provider: 'communication_matrix', ); $communication->create_and_configure_room( communicationroomname: $roomname ?? 'Room name', avatar: $roomavatar, instance: (object) [ 'matrixroomtopic' => $roomtopic ?? 'A fun topic', ], ); $communication->add_members_to_room($members); // Run the adhoc task. $this->run_all_adhoc_tasks(); $communication->reload(); return $communication; } /** * Test if the selected provider is configured. * * @covers ::is_configured */ public function test_is_configured(): void { $course = $this->get_course(); $communicationprocessor = processor::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id ); $this->assertTrue($communicationprocessor->get_room_provider()->is_configured()); // Unset communication_matrix settings. unset_config('matrixhomeserverurl', 'communication_matrix'); unset_config('matrixaccesstoken', 'communication_matrix'); $this->assertFalse($communicationprocessor->get_room_provider()->is_configured()); } } PK q�/[���L.$ .$ 2 provider/matrix/tests/matrix_test_helper_trait.phpnu &1i� <?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/>. namespace communication_matrix; use core\context; use GuzzleHttp\Psr7\Response; /** * Trait matrix_helper_trait to generate initial setup for matrix mock and associated helpers. * * @package communication_matrix * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ trait matrix_test_helper_trait { /** * @var string $accesstoken The token for matrix connection */ protected string $accesstoken; /** * @var string $matrixhomeserverurl The server url of matrix synapse server */ protected string $matrixhomeserverurl; /** * Initialize the mock configs in settings. * * @return void */ protected function initialise_mock_configs(): void { $this->matrixhomeserverurl = TEST_COMMUNICATION_MATRIX_MOCK_SERVER; set_config('matrixhomeserverurl', $this->matrixhomeserverurl, 'communication_matrix'); $request = $this->request(); $response = $request->post($this->matrixhomeserverurl . '/backoffice/create-admin'); $admindata = json_decode($response->getBody()); $json = [ 'identifier' => [ 'type' => 'm.id.user', 'user' => $admindata->user_id, ], 'type' => 'm.login.password', 'password' => $admindata->password, ]; $request = $this->request($json); $response = $request->post($this->matrixhomeserverurl . '/_matrix/client/r0/login'); $response = json_decode($response->getBody()); if (empty($response->access_token)) { $this->markTestSkipped( 'The matrix mock server is not responsive, can not continue the tests' ); } $this->accesstoken = $response->access_token; set_config('matrixaccesstoken', $this->accesstoken, 'communication_matrix'); } /** * Get the mock server url. * * @return string */ public function get_matrix_server_url(): string { if (empty($this->matrixhomeserverurl)) { throw new \coding_exception('Can not get this information without initializing the mock server.'); } return $this->matrixhomeserverurl; } /** * Get the matrix access token. * * @return string */ public function get_matrix_access_token(): string { if (empty($this->accesstoken)) { throw new \coding_exception('Can not get this information without initializing the mock server.'); } return $this->accesstoken; } /** * This test requires mock server to be present. * * @return void */ protected function initialise_mock_server(): void { if (!defined('TEST_COMMUNICATION_MATRIX_MOCK_SERVER')) { $this->markTestSkipped( 'The TEST_COMMUNICATION_MATRIX_MOCK_SERVER constant must be defined to run communication_matrix tests' ); } $this->reset_mock(); $this->initialise_mock_configs(); } /** * Get matrix room data from matrix server. * * @param string $roomid The id of the room * @return \stdClass */ public function get_matrix_room_data(string $roomid): \stdClass { $rooms = $this->backoffice_get_all_rooms(); foreach ($rooms as $room) { if ($room->room_id === $roomid) { return $room; } } } /** * Get matrix user data from matrix server. * * @param string $roomid The id of the room * @param string $matrixuserid The id of the user * @return \stdClass */ public function get_matrix_user_data(string $roomid, string $matrixuserid): \stdClass { $users = $this->backoffice_get_all_users(); foreach ($users as $user) { if ($user->userid === $matrixuserid) { return $user; } } } /** * A backoffice call to get all registered users from our mock server. * * @return array */ public function backoffice_get_all_users(): array { $client = new \core\http_client(); return json_decode($client->get($this->get_backoffice_uri('users'))->getBody())->users; } /** * A backoffice method to create users and rooms on our mock server. * * @param array $users * @param array $rooms */ public function backoffice_create_users_and_rooms( array $users = [], array $rooms = [], ): Response { $client = new \core\http_client(); return $client->put( $this->get_backoffice_uri('create'), [ 'json' => [ 'users' => $users, 'rooms' => $rooms, ], ], ); } /** * The http request for the api call. * * @param array $jsonarray The array of json * @param array $headers The array of headers * @return \core\http_client */ public function request(array $jsonarray = [], array $headers = []): \core\http_client { $response = new \core\http_client([ 'headers' => $headers, 'json' => $jsonarray, ]); return $response; } /** * Get the URI of a backoffice endpoint on the mock server. * * @param string $endpoint * @return string */ protected function get_backoffice_uri(string $endpoint): string { return $this->get_matrix_server_url() . '/backoffice/' . $endpoint; } /** * Fetch all rooms from the back office. * * @return array */ public function backoffice_get_all_rooms(): array { $client = new \core\http_client(); return json_decode($client->get($this->get_backoffice_uri('rooms'))->getBody())->rooms; } /** * Return the first room from the server. * * In most cases there is only one room. * @return \stdClass */ public function backoffice_get_room(): \stdClass { // Fetch the room information from the server. $rooms = $this->backoffice_get_all_rooms(); $this->assertCount(1, $rooms); $room = reset($rooms); return $room; } /** * Reset the mock server * * @return void */ public function reset_mock(): void { if (defined('TEST_COMMUNICATION_MATRIX_MOCK_SERVER')) { $request = $this->request(); $response = $request->post(TEST_COMMUNICATION_MATRIX_MOCK_SERVER . '/backoffice/reset'); $response = json_decode($response->getBody()); if (empty($response->reset)) { $this->markTestSkipped( 'The matrix mock server is not responsive, can not continue the tests' ); } } } /** * Helper to create a room. * * @param null|string $component * @param null|string $itemtype * @param null|int $itemid * @param null|string $roomname * @param null|string $roomtopic * @param null|stored_file $roomavatar * @param array $members * @return api */ protected function create_matrix_room( ?string $component = 'core_course', ?string $itemtype = 'example', ?int $itemid = 1, ?string $roomname = null, ?string $roomtopic = null, ?\stored_file $roomavatar = null, array $members = [], ?context $context = null, ): \core_communication\api { $context = $context ?? \core\context\system::instance(); // Create a new room. $communication = \core_communication\api::load_by_instance( context: $context, component: $component, instancetype: $itemtype, instanceid: $itemid, provider: 'communication_matrix', ); $communication->create_and_configure_room( communicationroomname: $roomname ?? 'Room name', avatar: $roomavatar, instance: (object) [ 'matrixroomtopic' => $roomtopic ?? 'A fun topic', ], ); $communication->add_members_to_room($members); // Run the adhoc task. $this->run_all_adhoc_tasks(); return \core_communication\api::load_by_instance( context: $context, component: $component, instancetype: $itemtype, instanceid: $itemid, ); } } PK q�/[ �}7J9 J9 , provider/matrix/tests/matrix_client_test.phpnu &1i� <?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/>. namespace communication_matrix; use communication_matrix\local\command; use communication_matrix\local\spec\v1p7; use communication_matrix\local\spec\features; use communication_matrix\tests\fixtures\mocked_matrix_client; use core\http_client; use GuzzleHttp\Handler\MockHandler; use GuzzleHttp\HandlerStack; use GuzzleHttp\Middleware; use GuzzleHttp\Psr7\Response; use moodle_exception; defined('MOODLE_INTERNAL') || die(); require_once(__DIR__ . '/matrix_client_test_trait.php'); /** * Tests for the matrix_client class. * * @package communication_matrix * @category test * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @covers \communication_matrix\matrix_client * @coversDefaultClass \communication_matrix\matrix_client */ class matrix_client_test extends \advanced_testcase { use matrix_client_test_trait; /** * Data provider for valid calls to ::instance. * @return array */ public static function instance_provider(): array { $testcases = [ 'Standard versions' => [ null, v1p7::class, ], ]; // Remove a couple of versions. $versions = self::get_current_versions(); array_pop($versions); array_pop($versions); $testcases['Older server'] = [ $versions, array_key_last($versions), ]; // Limited version compatibility, including newer than we support now. $testcases['Newer versions with crossover'] = [ [ 'v1.6', 'v1.7', 'v7.9', ], \communication_matrix\local\spec\v1p7::class, ]; return $testcases; } /** * Test that the instance method returns a valid instance for the given versions. * * @dataProvider instance_provider * @param array|null $versions * @param string $expectedversion */ public function test_instance( ?array $versions, string $expectedversion, ): void { // Create a mock and queue two responses. $mock = new MockHandler([ $this->get_mocked_version_response($versions), ]); $handlerstack = HandlerStack::create($mock); $container = []; $history = Middleware::history($container); $handlerstack->push($history); $client = new http_client(['handler' => $handlerstack]); mocked_matrix_client::set_client($client); $instance = mocked_matrix_client::instance( 'https://example.com', 'testtoken', ); $this->assertInstanceOf(matrix_client::class, $instance); // Only the version API has been called. $this->assertCount(1, $container); $request = reset($container); $this->assertEquals('/_matrix/client/versions', $request['request']->getUri()->getPath()); // The client should be a v1p7 client as that is the highest compatible version. $this->assertInstanceOf($expectedversion, $instance); } /** * Test that the instance method returns a valid instance for the given versions. */ public function test_instance_cached(): void { $mock = new MockHandler([ $this->get_mocked_version_response(), $this->get_mocked_version_response(), ]); $handlerstack = HandlerStack::create($mock); $container = []; $history = Middleware::history($container); $handlerstack->push($history); $client = new http_client(['handler' => $handlerstack]); mocked_matrix_client::set_client($client); $instance = mocked_matrix_client::instance('https://example.com', 'testtoken'); $this->assertInstanceOf(matrix_client::class, $instance); // Only the version API has been called. $this->assertCount(1, $container); // Call the API again. It should not lead to additional fetches. $instance = mocked_matrix_client::instance('https://example.com', 'testtoken'); $instance = mocked_matrix_client::instance('https://example.com', 'testtoken'); $this->assertCount(1, $container); // But a different endpoint will. $instance = mocked_matrix_client::instance('https://example.org', 'testtoken'); $this->assertCount(2, $container); } /** * Test that the instance method throws an appropriate exception if no support is found. */ public function test_instance_no_support(): void { // Create a mock and queue two responses. $mock = new MockHandler([ $this->get_mocked_version_response(['v99.9']), ]); $handlerstack = HandlerStack::create($mock); $container = []; $history = Middleware::history($container); $handlerstack->push($history); $client = new http_client(['handler' => $handlerstack]); mocked_matrix_client::set_client($client); $this->expectException(moodle_exception::class); $this->expectExceptionMessage('No supported Matrix API versions found.'); mocked_matrix_client::instance( 'https://example.com', 'testtoken', ); } /** * Test the feature implementation check methods. * * @covers ::implements_feature * @covers ::get_supported_versions * @dataProvider implements_feature_provider * @param string $version * @param array|string $features * @param bool $expected */ public function test_implements_feature( string $version, array|string $features, bool $expected, ): void { $instance = $this->get_mocked_instance_for_version($version); $this->assertEquals($expected, $instance->implements_feature($features)); } /** * Test the feature implementation requirement methods. * * @covers ::implements_feature * @covers ::get_supported_versions * @covers ::require_feature * @dataProvider implements_feature_provider * @param string $version * @param array|string $features * @param bool $expected */ public function test_require_feature( string $version, array|string $features, bool $expected, ): void { $instance = $this->get_mocked_instance_for_version($version); if ($expected) { $this->assertEmpty($instance->require_feature($features)); } else { $this->expectException('moodle_exception'); $instance->require_feature($features); } } /** * Test the feature implementation requirement methods for a require all. * * @covers ::implements_feature * @covers ::get_supported_versions * @covers ::require_feature * @covers ::require_features * @dataProvider require_features_provider * @param string $version * @param array|string $features * @param bool $expected */ public function test_require_features( string $version, array|string $features, bool $expected, ): void { $instance = $this->get_mocked_instance_for_version($version); if ($expected) { $this->assertEmpty($instance->require_features($features)); } else { $this->expectException('moodle_exception'); $instance->require_features($features); } } /** * Data provider for feature implementation check tests. * * @return array */ public static function implements_feature_provider(): array { return [ 'Basic supported feature' => [ 'v1.7', features\matrix\media_create_v1::class, true, ], 'Basic unsupported feature' => [ 'v1.6', features\matrix\media_create_v1::class, false, ], '[supported] as array' => [ 'v1.6', [features\matrix\create_room_v3::class], true, ], '[supported, supported] as array' => [ 'v1.6', [ features\matrix\create_room_v3::class, features\matrix\update_room_avatar_v3::class, ], true, ], '[unsupported] as array' => [ 'v1.6', [ features\matrix\media_create_v1::class, ], false, ], '[unsupported, supported] as array' => [ 'v1.6', [ features\matrix\media_create_v1::class, features\matrix\update_room_avatar_v3::class, ], true, ], ]; } /** * Data provider for feature implementation check tests. * * @return array */ public static function require_features_provider(): array { // We'll just add to the standard testcases. $testcases = array_map(static function (array $testcase): array { $testcase[1] = [$testcase[1]]; return $testcase; }, self::implements_feature_provider()); $testcases['Require many supported features'] = [ 'v1.6', [ features\matrix\create_room_v3::class, features\matrix\update_room_avatar_v3::class, ], true, ]; $testcases['Require many including an unsupported feature'] = [ 'v1.6', [ features\matrix\create_room_v3::class, features\matrix\media_create_v1::class, ], false, ]; $testcases['Require many including an unsupported feature which has an alternate'] = [ 'v1.6', [ features\matrix\create_room_v3::class, [ features\matrix\media_create_v1::class, features\matrix\update_room_avatar_v3::class, ], ], true, ]; return $testcases; } /** * Test the get_version method. * * @param string $version * @param string $expectedversion * @dataProvider get_version_provider * @covers ::get_version * @covers ::get_version_from_classname */ public function test_get_version( string $version, string $expectedversion, ): void { $instance = $this->get_mocked_instance_for_version($version); $this->assertEquals($expectedversion, $instance->get_version()); } /** * Data provider for get_version tests. * * @return array */ public static function get_version_provider(): array { return [ ['v1.1', '1.1'], ['v1.7', '1.7'], ]; } /** * Tests the meets_version method. * * @param string $version The version of the API to test against * @param string $testversion The version to test * @param bool $expected Whether the version meets the requirement * @dataProvider meets_version_provider * @covers ::meets_version */ public function test_meets_version( string $version, string $testversion, bool $expected, ): void { $instance = $this->get_mocked_instance_for_version($version); $this->assertEquals($expected, $instance->meets_version($testversion)); } /** * Tests the requires_version method. * * @param string $version The version of the API to test against * @param string $testversion The version to test * @param bool $expected Whether the version meets the requirement * @dataProvider meets_version_provider * @covers ::requires_version */ public function test_requires_version( string $version, string $testversion, bool $expected, ): void { $instance = $this->get_mocked_instance_for_version($version); if ($expected) { $this->assertEmpty($instance->requires_version($testversion)); } else { $this->expectException('moodle_exception'); $instance->requires_version($testversion); } } /** * Data provider for meets_version tests. * * @return array */ public static function meets_version_provider(): array { return [ 'Same version' => ['v1.1', '1.1', true], 'Same version latest' => ['v1.7', '1.7', true], 'Newer version rejected' => ['v1.1', '1.7', false], 'Older version accepted' => ['v1.7', '1.1', true], ]; } /** * Test the execute method with a command. * * @covers ::execute */ public function test_command_is_executed(): void { $historycontainer = []; $mock = new MockHandler(); $instance = $this->get_mocked_instance_for_version('v1.6', $historycontainer, $mock); $command = new command( $instance, method: 'GET', endpoint: 'test/endpoint', params: [ 'test' => 'test', ], ); $mock->append(new Response(200)); $rc = new \ReflectionClass($instance); $rcm = $rc->getMethod('execute'); $rcm->setAccessible(true); $result = $rcm->invoke($instance, $command); $this->assertEquals(200, $result->getStatusCode()); $this->assertCount(1, $historycontainer); $request = array_shift($historycontainer); $this->assertEquals('GET', $request['request']->getMethod()); $this->assertEquals('/test/endpoint', $request['request']->getUri()->getPath()); } } PK q�/[ �+�Q Q 2 provider/matrix/tests/matrix_user_manager_test.phpnu &1i� <?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/>. namespace communication_matrix; use moodle_exception; /** * Class matrix_user_manager_test to test the matrix user manager. * * @package communication_matrix * @category test * @copyright 2023 Stevani Andolo <stevani.andolo@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @covers \communication_matrix\matrix_user_manager */ class matrix_user_manager_test extends \advanced_testcase { /** * Test fetcihing a users matrix userid from Moodle. */ public function test_get_matrixid_from_moodle_without_field(): void { $user = get_admin(); $this->assertNull(matrix_user_manager::get_matrixid_from_moodle($user->id)); } /** * Test fetching a user's matrix userid from Moodle. */ public function test_get_matrixid_from_moodle(): void { $this->resetAfterTest(); $user1 = $this->getDataGenerator()->create_user(); $user2 = $this->getDataGenerator()->create_user(); // Add user ids to both users. matrix_user_manager::set_matrix_userid_in_moodle( $user1->id, '@someexampleuser:matrix.moodle.org', ); matrix_user_manager::set_matrix_userid_in_moodle( $user2->id, '@someotherexampleuser:matrix.moodle.org', ); // And confirm that they're fetched back. $this->assertEquals( '@someexampleuser:matrix.moodle.org', matrix_user_manager::get_matrixid_from_moodle($user1->id), ); $this->assertEquals( '@someotherexampleuser:matrix.moodle.org', matrix_user_manager::get_matrixid_from_moodle($user2->id), ); } /** * Test fetching a formatted matrix userid from Moodle when no server is set. */ public function test_get_formatted_matrix_userid_unset(): void { $this->expectException(moodle_exception::class); matrix_user_manager::get_formatted_matrix_userid('No value'); } /** * Test fetch of a formatted matrix userid. * * @dataProvider get_formatted_matrix_userid_provider * @param string $server * @param string $username The moodle username to turn into a Matrix username * @param string $expecteduserid The expected matrix user id */ public function test_get_formatted_matrix_userid( string $server, string $username, string $expecteduserid, ): void { $this->resetAfterTest(); set_config('matrixhomeserverurl', $server, 'communication_matrix'); $this->assertEquals( $expecteduserid, matrix_user_manager::get_formatted_matrix_userid($username), ); } /** * Data provider for get_formatted_matrix_userid. * * @return array */ public static function get_formatted_matrix_userid_provider(): array { return [ 'alphanumeric' => [ 'https://matrix.example.org', 'alphabet1', '@alphabet1:matrix.example.org', ], 'chara' => [ 'https://matrix.example.org', 'asdf#$%^&*()+{}|<>?!,asdf', '@asdf.................asdf:matrix.example.org', ], 'local server' => [ 'https://synapse', 'colin.creavey', '@colin.creavey:synapse', ], 'server with port' => [ 'https://matrix.example.org:8448', 'colin.creavey', '@colin.creavey:matrix.example.org', ], ]; } /** * Data provider for set_matrix_userid_in_moodle. * * @return array */ public static function set_matrix_userid_in_moodle_provider(): array { return array_combine( array_keys(self::get_formatted_matrix_userid_provider()), array_map( fn($value) => [$value[2]], self::get_formatted_matrix_userid_provider(), ), ); } /** * Test setting of a user's matrix userid in Moodle. * * @dataProvider set_matrix_userid_in_moodle_provider * @param string $expectedusername */ public function test_set_matrix_userid_in_moodle( string $expectedusername, ): void { $this->resetAfterTest(); $user = $this->getDataGenerator()->create_user(); matrix_user_manager::set_matrix_userid_in_moodle($user->id, $expectedusername); // Get created matrixuserid from moodle. $this->assertEquals( $expectedusername, matrix_user_manager::get_matrixid_from_moodle($user->id), ); } /** * Test for getting a formatted matrix home server id. * * @dataProvider get_formatted_matrix_home_server_provider * @param string $input * @param string $expectedoutput */ public function test_get_formatted_matrix_home_server( string $input, string $expectedoutput ): void { $this->resetAfterTest(); set_config( 'matrixhomeserverurl', $input, 'communication_matrix', ); $this->assertEquals( $expectedoutput, matrix_user_manager::get_formatted_matrix_home_server(), ); } /** * Data provider for get_formatted_matrix_home_server. * * @return array */ public static function get_formatted_matrix_home_server_provider(): array { return [ 'www is removed' => [ 'https://www.example.org', 'example.org', ], 'www is not removed if it is not at the beginning' => [ 'https://matrix.www.example.org', 'matrix.www.example.org', ], 'others are not removed' => [ 'https://matrix.example.org', 'matrix.example.org', ], ]; } /** * Test creation of matrix user profile fields. */ public function test_create_matrix_user_profile_fields(): void { global $CFG; require_once("{$CFG->dirroot}/user/profile/lib.php"); $this->resetAfterTest(); $matrixprofilefield = get_config('communication_matrix', 'matrixuserid_field'); $this->assertFalse($matrixprofilefield); $this->assertIsString(matrix_user_manager::create_matrix_user_profile_fields()); $matrixprofilefield = get_config('communication_matrix', 'matrixuserid_field'); $this->assertNotFalse($matrixprofilefield); $user = $this->getDataGenerator()->create_user(); $this->assertObjectHasAttribute($matrixprofilefield, profile_user_record($user->id)); } } PK q�/[̬]"?1 ?1 , provider/matrix/tests/local/command_test.phpnu &1i� <?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/>. namespace communication_matrix\local; use GuzzleHttp\Handler\MockHandler; use GuzzleHttp\Psr7\Request; use GuzzleHttp\Psr7\Response; use ReflectionMethod; defined('MOODLE_INTERNAL') || die(); require_once(dirname(__DIR__) . '/matrix_client_test_trait.php'); /** * Tests for the Matrix command class. * * @package communication_matrix * @category test * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @covers \communication_matrix\local\command * @coversDefaultClass \communication_matrix\local\command */ class command_test extends \advanced_testcase { use \communication_matrix\matrix_client_test_trait; /** * Test instantiation of a command when no method is provided. */ public function test_standard_instantiation(): void { $instance = $this->get_mocked_instance_for_version('v1.7'); $command = new command( $instance, method: 'PUT', endpoint: 'example/endpoint', ); // Check the standard functionality. $this->assertEquals('/example/endpoint', $command->getUri()->getPath()); $this->assertEquals('PUT', $command->getMethod()); $this->assertArrayHasKey('Authorization', $command->getHeaders()); } /** * Test instantiation of a command when no method is provided. */ public function test_instantiation_without_auth(): void { $instance = $this->get_mocked_instance_for_version('v1.7'); $command = new command( $instance, method: 'PUT', endpoint: 'example/endpoint', requireauthorization: false, ); // Check the standard functionality. $this->assertEquals('/example/endpoint', $command->getUri()->getPath()); $this->assertEquals('PUT', $command->getMethod()); $this->assertArrayNotHasKey('Authorization', $command->getHeaders()); } /** * Test processing of command URL properties. * * @dataProvider url_parsing_provider * @param string $url * @param array $params * @param string $expected */ public function test_url_parsing( string $url, array $params, string $expected, ): void { $instance = $this->get_mocked_instance_for_version('v1.7'); $command = new command( $instance, method: 'PUT', endpoint: $url, params: $params, ); $this->assertEquals($expected, $command->getUri()->getPath()); } /** * Data provider for url parsing tests. * * @return array */ public static function url_parsing_provider(): array { return [ [ 'example/:id/endpoint', [':id' => '39492'], '/example/39492/endpoint', ], [ 'example/:id/endpoint/:id', [':id' => '39492'], '/example/39492/endpoint/39492', ], [ 'example/:id/endpoint/:id/:name', [ ':id' => '39492', ':name' => 'matrix', ], '/example/39492/endpoint/39492/matrix', ], ]; } /** * Test processing of command URL properties with an array which contains untranslated parameters. */ public function test_url_parsing_extra_properties(): void { $instance = $this->get_mocked_instance_for_version('v1.7'); $this->expectException(\OutOfRangeException::class); $this->expectExceptionMessage("URL contains untranslated parameters 'example/:id/endpoint'"); new command( $instance, method: 'PUT', endpoint: 'example/:id/endpoint', ); } /** * Test processing of command URL properties with an array which contains untranslated parameters. */ public function test_url_parsing_unused_properites(): void { $instance = $this->get_mocked_instance_for_version('v1.7'); $this->expectException(\OutOfRangeException::class); $this->expectExceptionMessage("Parameter not found in URL ':id'"); new command( $instance, method: 'PUT', endpoint: 'example/:ids/endpoint', params: [ ':id' => 12345, ], ); } /** * Test the parameter fetching, processing, and parsing. * * @dataProvider parameter_and_option_provider * @param string $endpoint * @param array $params * @param array $remainingparams * @param array $allparams * @param array $options */ public function test_parameters( string $endpoint, array $params, array $remainingparams, array $allparams, array $options, ): void { $instance = $this->get_mocked_instance_for_version('v1.7'); $command = new command( $instance, method: 'PUT', endpoint: $endpoint, params: $params, ); $this->assertSame($remainingparams, $command->get_remaining_params()); $this->assertSame($allparams, $command->get_all_params()); $this->assertSame($options, $command->get_options()); } /** * Data provider for parameter tests. * * @return array */ public static function parameter_and_option_provider(): array { $command = [ 'method' => 'PUT', 'endpoint' => 'example/:id/endpoint', ]; return [ 'no parameters' => [ 'endpoint' => 'example/endpoint', 'params' => [], 'remainingparams' => [], 'allparams' => [], 'options' => [ 'json' => [], ], ], 'named params' => [ 'endpoint' => 'example/:id/endpoint', 'params' => [ ':id' => 12345, ], 'remainingparams' => [], 'allparams' => [ ':id' => 12345, ], 'options' => [ 'json' => [], ], ], 'mixture of params' => [ 'endpoint' => 'example/:id/endpoint', 'params' => [ ':id' => 12345, 'name' => 'matrix', ], 'remainingparams' => [ 'name' => 'matrix', ], 'allparams' => [ ':id' => 12345, 'name' => 'matrix', ], 'options' => [ 'json' => [ 'name' => 'matrix', ], ], ], ]; } /** * Test the query parameter handling. * * @dataProvider query_provider * @param array $query * @param string $expected */ public function test_query_parameters( array $query, string $expected, ): void { // The query parameter is only added at the time we call send. // That's because it can only be provided to Guzzle as an Option, not as part of the URL. // Options can only be applied at time of transfer. // Unfortuantely that leads to slightly less ideal testing that we'd like here. $mock = new MockHandler(); $instance = $this->get_mocked_instance_for_version( 'v1.7', mock: $mock, ); $mock->append(function (Request $request) use ($expected): Response { $this->assertSame( $expected, $request->getUri()->getQuery(), ); return new Response(); }); $command = new command( $instance, method: 'PUT', endpoint: 'example/endpoint', query: $query, ); $execute = new ReflectionMethod($instance, 'execute'); $execute->setAccessible(true); $execute->invoke($instance, $command); } /** * Data provider for query parameter tests. * @return array */ public static function query_provider(): array { return [ 'no query' => [ 'query' => [], 'expected' => '', ], 'single query' => [ 'query' => [ 'name' => 'matrix', ], 'expected' => 'name=matrix', ], 'multiple queries' => [ 'query' => [ 'name' => 'matrix', 'type' => 'room', ], 'expected' => 'name=matrix&type=room', ], ]; } /** * Test the sendasjson constructor parameter. * * @dataProvider sendasjson_provider * @param bool $sendasjson * @param string $endpoint * @param array $params * @param array $remainingparams * @param array $allparams * @param array $expectedoptions */ public function test_send_as_json( bool $sendasjson, string $endpoint, array $params, array $remainingparams, array $allparams, array $expectedoptions, ): void { $instance = $this->get_mocked_instance_for_version('v1.7'); $command = new command( $instance, method: 'PUT', endpoint: $endpoint, params: $params, sendasjson: $sendasjson, ); $this->assertSame($remainingparams, $command->get_remaining_params()); $this->assertSame($allparams, $command->get_all_params()); $this->assertSame($expectedoptions, $command->get_options()); } /** * Test the sendasjosn option to the command constructor. * * @return array */ public static function sendasjson_provider(): array { return [ 'As JSON' => [ 'sendasjon' => true, 'endpoint' => 'example/:id/endpoint', 'params' => [ ':id' => 12345, 'name' => 'matrix', ], 'remainingparams' => [ 'name' => 'matrix', ], 'allparams' => [ ':id' => 12345, 'name' => 'matrix', ], 'expectedoptions' => [ 'json' => [ 'name' => 'matrix', ], ], ], 'Not as JSON' => [ 'sendasjson' => false, 'endpoint' => 'example/:id/endpoint', 'params' => [ ':id' => 12345, 'name' => 'matrix', ], 'remainingparams' => [ 'name' => 'matrix', ], 'allparams' => [ ':id' => 12345, 'name' => 'matrix', ], 'expectedoptions' => [ ], ], ]; } /** * Test the sendasjosn option to the command constructor. */ public function test_ignorehttperrors(): void { $instance = $this->get_mocked_instance_for_version('v1.7'); $command = new command( $instance, method: 'PUT', endpoint: 'example/endpoint', ignorehttperrors: true, ); $options = $command->get_options(); $this->assertArrayHasKey('http_errors', $options); $this->assertFalse($options['http_errors']); } } PK q�/[��� � 6 provider/matrix/tests/behat/matrix_room_banner.featurenu &1i� @communication @communication_matrix Feature: Display communication room status banner Show a banner depending on the room status As a teacher or admin Background: Given a Matrix mock server is configured And the following "users" exist: | username | firstname | lastname | email | | teacher1 | Teacher | 1 | teacher1@example.com | | student1 | Student | 1 | student1@example.com | And the following "courses" exist: | fullname | shortname | category | selectedcommunication | communicationroomname | | Test course | Test course | 0 | communication_matrix | matrixroom | And the following "course enrolments" exist: | user | course | role | | teacher1 | Test course | editingteacher | | student1 | Test course | student | Scenario: I can see the room has been created and in a pending status When I am on the "Test course" "Course" page logged in as "teacher1" Then I should see "Your Matrix room will be ready soon." in the "page-content" "region" When I am on the "Test course" "Course" page logged in as "student1" # Not for students to see. Then I should not see "Your Matrix room will be ready soon." in the "page-content" "region" # Skipping while we update the Mock Server with the new route. # Scenario: I can see the room has been created and ready to access # When I run all adhoc tasks # And I am on the "Test course" "Course" page logged in as "teacher1" # Then I should see "Your Matrix room is ready!" in the "page-content" "region" # # This is a one time message per user. # When I reload the page # Then I should not see "Your Matrix room is ready." in the "page-content" "region" # # Not for students to see. # When I am on the "Test course" "Course" page logged in as "student1" # Then I should not see "Your Matrix room is ready." in the "page-content" "region" Scenario: Enabling or disabling the matrix plugin hides the banner accordingly Given I am on the "Test course" "Course" page logged in as "teacher1" Then I should see "Your Matrix room will be ready soon." in the "page-content" "region" When I log in as "admin" And I navigate to "Plugins > Communication > Manage communication providers" in site administration And I should see "Matrix" And I click on "Disable" "link" in the "Matrix" "table_row" And I am on the "Test course" "Course" page logged in as "teacher1" And I should not see "Your Matrix room will be ready soon." in the "page-content" "region" And I log in as "admin" And I navigate to "Plugins > Communication > Manage communication providers" in site administration And I should see "Matrix" And I click on "Enable" "link" in the "Matrix" "table_row" And I am on the "Test course" "Course" page logged in as "teacher1" Then I should see "Your Matrix room will be ready soon." in the "page-content" "region" PK q�/[���! ! 6 provider/matrix/tests/behat/matrix_form_fields.featurenu &1i� @communication @communication_matrix @javascript Feature: Communication matrix form field In order to create a new communication room in matrix As a teacher I can update the room the information from course Background: Make sure the mock server is initialized and a course is created for teacher Given the following "users" exist: | username | firstname | lastname | email | | teacher1 | Teacher | 1 | teacher1@example.com | And the following "courses" exist: | fullname | shortname | category | | Test course | Test course | 0 | And the following "course enrolments" exist: | user | course | role | | teacher1 | Test course | editingteacher | Scenario: I can add room name for matrix room Given a Matrix mock server is configured And I log in as "teacher1" And I am on "Test course" course homepage When I navigate to "Communication" in current page administration And I set the field "id_selectedcommunication" to "Matrix" And I wait to be redirected And I should see "Room name" And I set the field "id_communicationroomname" to "Sampleroomname" And I press "Save changes" And I navigate to "Communication" in current page administration Then the field "id_communicationroomname" matches value "Sampleroomname" # Skipping while we update the Mock Server with the new route. # Scenario: I can add room topic for matrix room # Given a Matrix mock server is configured # And I log in as "teacher1" # And I am on "Test course" course homepage # When I navigate to "Communication" in current page administration # And I set the field "id_selectedcommunication" to "Matrix" # And I wait to be redirected # And I should see "Room name" # And I should see "Room topic" # And I set the field "id_communicationroomname" to "Sampleroomname" # And I set the field "id_matrixroomtopic" to "Sampleroomtopic" # And I press "Save changes" # And I navigate to "Communication" in current page administration # Then the field "id_communicationroomname" matches value "Sampleroomname" # And I press "Cancel" # And I run all adhoc tasks # And I navigate to "Communication" in current page administration # And the field "id_matrixroomtopic" matches value "Sampleroomtopic" PK q�/[��b�� � : provider/matrix/tests/behat/behat_communication_matrix.phpnu &1i� <?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/>. // phpcs:disable PSR1.Classes.ClassDeclaration.MissingNamespace use Behat\Behat\Hook\Scope\BeforeScenarioScope; use communication_matrix\matrix_test_helper_trait; use Moodle\BehatExtension\Exception\SkippedException; require_once(__DIR__ . '/../matrix_test_helper_trait.php'); require_once(__DIR__ . '/../../../../../lib/behat/behat_base.php'); require_once(__DIR__ . '/../../../../tests/communication_test_helper_trait.php'); /** * Class behat_communication_matrix for behat custom steps and configuration for matrix. * * @package communication_matrix * @category test * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class behat_communication_matrix extends \behat_base { use \core_communication\communication_test_helper_trait; use matrix_test_helper_trait; /** * BeforeScenario hook to reset the mock server. * * @BeforeScenario @communication_matrix * * @param BeforeScenarioScope $scope */ public function before_scenario(BeforeScenarioScope $scope) { if (defined('TEST_COMMUNICATION_MATRIX_MOCK_SERVER')) { $this->reset_mock(); } } /** * Setup and configure and mock server for matrix. * * @Given /^a Matrix mock server is configured$/ */ public function initialize_mock_server(): void { if (!defined('TEST_COMMUNICATION_MATRIX_MOCK_SERVER')) { throw new SkippedException( 'The TEST_COMMUNICATION_MATRIX_MOCK_SERVER constant must be defined to run communication_matrix tests' ); } $this->setup_communication_configs(); $this->initialise_mock_configs(); } } PK q�/[)/G 1 1 2 provider/matrix/tests/matrix_client_test_trait.phpnu &1i� <?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/>. namespace communication_matrix; use communication_matrix\local\spec\{v1p1, v1p2, v1p3, v1p4, v1p5, v1p6, v1p7}; use communication_matrix\tests\fixtures\mocked_matrix_client; use core\http_client; use GuzzleHttp\Handler\MockHandler; use GuzzleHttp\HandlerStack; use GuzzleHttp\Middleware; use GuzzleHttp\Psr7\Response; /** * A trait with shared tooling for handling matrix_client tests. * * @package communication_matrix * @category test * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ trait matrix_client_test_trait { public static function setUpBeforeClass(): void { parent::setUpBeforeClass(); // Ensure that the mocked client is available. require_once(__DIR__ . '/fixtures/mocked_matrix_client.php'); } public function setUp(): void { parent::setUp(); // Reset the test client. mocked_matrix_client::reset_client(); } public function tearDown(): void { parent::tearDown(); // Reset the test client. mocked_matrix_client::reset_client(); } /** * Get a mocked instance for a specific Matrix API version, * * @param string $version * @param array $historycontainer An array which will be filled with history for the mocked client. * @param MockHandler|null $mock A MockHandler object that can be appended to * @return matrix_client */ protected function get_mocked_instance_for_version( string $version, array &$historycontainer = [], ?MockHandler $mock = null, ): matrix_client { if ($mock === null) { $mock = new MockHandler(); } // Add the version response. $mock->append($this->get_mocked_version_response([$version])); $handlerstack = HandlerStack::create($mock); $history = Middleware::history($historycontainer); $handlerstack->push($history); $client = new http_client(['handler' => $handlerstack]); mocked_matrix_client::set_client($client); $client = mocked_matrix_client::instance( 'https://example.com', 'testtoken', ); // Remove the request that is required to fetch the version from the history. array_shift($historycontainer); return $client; } /** * Get a mocked response for the /versions well-known URI. * * @param array|null $versions * @param array|null $unstablefeatures * @return Response */ protected function get_mocked_version_response( array $versions = null, array $unstablefeatures = null, ): Response { $data = (object) [ "versions" => array_values(self::get_current_versions()), "unstable_features" => self::get_current_unstable_features(), ]; if ($versions) { $data->versions = array_values($versions); } if ($unstablefeatures) { $data->unstable_features = $unstablefeatures; } return new Response(200, [], json_encode($data)); } /** * A helper to get the current versions returned by synapse. * * @return array */ protected static function get_current_versions(): array { return [ v1p1::class => "v1.1", v1p2::class => "v1.2", v1p3::class => "v1.3", v1p4::class => "v1.4", v1p5::class => "v1.5", v1p6::class => "v1.6", v1p7::class => "v1.7", ]; } /** * A helper to get the current unstable features returned by synapse. * @return array */ protected static function get_current_unstable_features(): array { return [ "org.matrix.label_based_filtering" => true, "org.matrix.e2e_cross_signing" => true, "org.matrix.msc2432" => true, "uk.half-shot.msc2666.query_mutual_rooms" => true, "io.element.e2ee_forced.public" => false, "io.element.e2ee_forced.private" => false, "io.element.e2ee_forced.trusted_private" => false, "org.matrix.msc3026.busy_presence" => false, "org.matrix.msc2285.stable" => true, "org.matrix.msc3827.stable" => true, "org.matrix.msc2716" => false, "org.matrix.msc3440.stable" => true, "org.matrix.msc3771" => true, "org.matrix.msc3773" => false, "fi.mau.msc2815" => false, "fi.mau.msc2659.stable" => true, "org.matrix.msc3882" => false, "org.matrix.msc3881" => false, "org.matrix.msc3874" => false, "org.matrix.msc3886" => false, "org.matrix.msc3912" => false, "org.matrix.msc3952_intentional_mentions" => false, "org.matrix.msc3981" => false, "org.matrix.msc3391" => false, ]; } } PK q�/[���o o 0 provider/matrix/lang/en/communication_matrix.phpnu &1i� <?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/>. /** * Strings for component communication_matrix, language 'en'. * * @package communication_matrix * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ $string['cachedef_serverversions'] = 'Matrix server version information for running servers'; $string['matrixuserid'] = 'Matrix user ID'; $string['matrixhomeserverurl'] = 'Homeserver URL'; $string['matrixhomeserverurl_desc'] = 'The URL of the Synapse homeserver to connect to, for user and room creation.'; $string['matrixaccesstoken'] = 'Access token'; $string['matrixaccesstoken_desc'] = 'Access token for the account which will perform actions on the homeserver.'; $string['matrixrefreshtoken'] = 'Refresh token'; $string['matrixrefreshtoken_desc'] = 'Admin refresh token to associated with the access token.'; $string['matrixelementurl'] = 'Element web URL'; $string['matrixroomtopic'] = 'Room topic'; $string['matrixroomtopic_help'] = 'A short description of what this room is for.'; $string['matrix:moderator'] = 'Matrix moderator'; $string['pluginname'] = 'Matrix'; $string['privacy:metadata'] = 'The Matrix communication plugin does not store any personal data.'; PK q�/[�k�:L L provider/matrix/version.phpnu &1i� <?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/>. /** * Version information for communication_matrix. * * @package communication_matrix * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); $plugin->component = 'communication_matrix'; $plugin->version = 2023100900; $plugin->requires = 2023100400; $plugin->maturity = MATURITY_ALPHA; PK q�/[ � �~ ~ provider/upgrade.txtnu &1i� This file describes API changes in /communication/provider/* Information provided here is intended especially for developers. PK q�/[_��^[ [ classes/room_chat_provider.phpnu &1i� <?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/>. namespace core_communication; /** * Class communication_room_base to manage the room operations of communication providers. * * Every plugin that supports room operation must implement/extend this class in the plugin. * * @package core_communication * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ interface room_chat_provider { /** * Create a provider room when a instance is created. */ public function create_chat_room(): bool; /** * Update a provider room when a instance is updated. */ public function update_chat_room(): bool; /** * Delete a provider room when a instance is deleted. */ public function delete_chat_room(): bool; /** * Generate a room url if there is a room. * * @return string|null */ public function get_chat_room_url(): ?string; } PK q�/[��*G" " classes/room_user_provider.phpnu &1i� <?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/>. namespace core_communication; /** * Class communication_user_base to manage communication provider users. * * @package core_communication * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ interface room_user_provider { /** * Add members to communication room. * * @param array $userids The user ids to be added */ public function add_members_to_room(array $userids): void; /** * Update room membership for the communication room. * * @param array $userids The user ids to be updated */ public function update_room_membership(array $userids): void; /** * Remove members from room. * * @param array $userids The user ids to be removed */ public function remove_members_from_room(array $userids): void; } PK q�/[^ �� � classes/form_provider.phpnu &1i� <?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/>. namespace core_communication; /** * Interface form_provider to manage communication provider form options from provider plugins. * * Every provider plugin should implement this class to return the implemented form elements for custom data. * * @package core_communication * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ interface form_provider { /** * Set the form data to the instance if any data is available. * * @param \stdClass $instance The actual instance to set the data */ public function save_form_data(\stdClass $instance): void; /** * Set the form data to the instance if any data is available. * * @param \stdClass $instance The actual instance to set the data */ public function set_form_data(\stdClass $instance): void; /** * Set the form definitions. * * @param \MoodleQuickForm $mform The form object */ public static function set_form_definition(\MoodleQuickForm $mform): void; } PK q�/[�2A� � classes/user_provider.phpnu &1i� <?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/>. namespace core_communication; /** * Class communication_user_base to manage communication provider users. * * @package core_communication * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ interface user_provider { /** * Create members. * * @param array $userid The users ids to be created */ public function create_members(array $userid): void; } PK q�/[q�;z z ! classes/task/update_room_task.phpnu &1i� <?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/>. namespace core_communication\task; use core\task\adhoc_task; use core_communication\processor; /** * Class update_room_task to add a task to update a room and execute the task to action the update. * * this task will be queued by the communication api and will use the communication handler api to action the updates. * * @package core_communication * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class update_room_task extends adhoc_task { public function execute() { $data = $this->get_custom_data(); // Call the communication api to action the operation. $communication = processor::load_by_id($data->id); if ($communication === null) { mtrace("Skipping room creation because the instance does not exist"); return; } $communication->get_room_provider()->update_chat_room(); } /** * Queue the task for the next run. * * @param processor $communication The communication processor to perform the action on */ public static function queue( processor $communication, ): void { // Add ad-hoc task to update the provider room. $task = new self(); $task->set_custom_data([ 'id' => $communication->get_id(), ]); // Queue the task for the next run. \core\task\manager::queue_adhoc_task($task); } } PK q�/[����� � , classes/task/update_room_membership_task.phpnu &1i� <?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/>. namespace core_communication\task; use core\task\adhoc_task; use core_communication\processor; /** * Class update_room_membership_task to add the task to update members for the room and execute the task to action the addition. * * @package core_communication * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class update_room_membership_task extends adhoc_task { public function execute() { // Initialize the custom data operation to be used for the action. $data = $this->get_custom_data(); // Call the communication api to action the operation. $communication = processor::load_by_id($data->id); if ($communication === null) { mtrace("Skipping room creation because the instance does not exist"); return; } $communication->get_room_user_provider()->update_room_membership($communication->get_instance_userids()); } /** * Queue the task for the next run. * * @param processor $communication The communication processor to perform the action on */ public static function queue( processor $communication ): void { // Add ad-hoc task to update the provider room. $task = new self(); $task->set_custom_data([ 'id' => $communication->get_id(), ]); // Queue the task for the next run. \core\task\manager::queue_adhoc_task($task); } } PK q�/[�e@i; ; / classes/task/create_and_configure_room_task.phpnu &1i� <?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/>. namespace core_communication\task; use core\task\adhoc_task; use core_communication\processor; /** * Class create_and_configure_room_task to add a task to create a room and execute the task to action the creation. * * this task will be queued by the communication api and will use the communication handler api to action the creation. * * @package core_communication * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class create_and_configure_room_task extends adhoc_task { public function execute() { $data = $this->get_custom_data(); // Call the communication api to action the operation. $communication = processor::load_by_id($data->id); if ($communication === null) { mtrace("Skipping room creation because the instance does not exist"); return; } if (!$communication->is_instance_active()) { mtrace("Skipping room creation because the instance is not active"); return; } // If the room is created successfully, add members to the room if supported by the provider. if ($communication->get_room_provider()->create_chat_room() && $communication->supports_user_features()) { add_members_to_room_task::queue( $communication ); } } /** * Queue the task for the next run. * * @param processor $communication The communication processor to perform the action on */ public static function queue( processor $communication, ): void { // Add ad-hoc task to update the provider room. $task = new self(); $task->set_custom_data([ 'id' => $communication->get_id(), ]); // Queue the task for the next run. \core\task\manager::queue_adhoc_task($task); } } PK q�/[�W�� � ) classes/task/add_members_to_room_task.phpnu &1i� <?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/>. namespace core_communication\task; use core\task\adhoc_task; use core_communication\processor; /** * Class add_members_to_room_task to add the task to add members to the room and execute the task to action the addition. * * @package core_communication * @copyright 2023 David Woloszyn <david.woloszyn@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class add_members_to_room_task extends adhoc_task { public function execute() { // Initialize the custom data operation to be used for the action. $data = $this->get_custom_data(); // Call the communication api to action the operation. $communication = processor::load_by_id($data->id); if ($communication === null) { mtrace("Skipping room creation because the instance does not exist"); return; } $communication->get_room_user_provider()->add_members_to_room($communication->get_instance_userids()); } /** * Queue the task for the next run. * * @param processor $communication The communication processor to perform the action on */ public static function queue( processor $communication ): void { // Add ad-hoc task to update the provider room. $task = new self(); $task->set_custom_data([ 'id' => $communication->get_id(), ]); // Queue the task for the next run. \core\task\manager::queue_adhoc_task($task); } } PK q�/[m`�] ! classes/task/delete_room_task.phpnu &1i� <?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/>. namespace core_communication\task; use core\task\adhoc_task; use core_communication\processor; /** * Class delete_room_task to add a task to delete a room and execute the task to action the deletion. * * this task will be queued by the communication api and will use the communication handler api to action the deletion. * * @package core_communication * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class delete_room_task extends adhoc_task { public function execute() { $data = $this->get_custom_data(); $communication = processor::load_by_id($data->id); if ($communication === null) { mtrace("Skipping room creation because the instance does not exist"); return; } // First remove the members from the room. $communication->get_room_user_provider()->remove_members_from_room($communication->get_instance_userids(true, true)); // Now remove any mapping for users who are not in the room. $communication->delete_instance_non_synced_user_mapping($communication->get_instance_userids(false, true)); // Now delete the room. if ($communication->get_room_provider()->delete_chat_room()) { $communication->delete_instance(); } } /** * Queue the task for the next run. * * @param processor $communication The communication processor to perform the action on */ public static function queue( processor $communication, ): void { // Add ad-hoc task to update the provider room. $task = new self(); $task->set_custom_data([ 'id' => $communication->get_id(), ]); // Queue the task for the next run. \core\task\manager::queue_adhoc_task($task); } } PK q�/[3/mHe e ) classes/task/remove_members_from_room.phpnu &1i� <?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/>. namespace core_communication\task; use core\task\adhoc_task; use core_communication\processor; /** * Class remove_members_from_room to add the task to remove members to the room and execute the task to action the removal. * * @package core_communication * @copyright 2023 David Woloszyn <david.woloszyn@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class remove_members_from_room extends adhoc_task { public function execute() { // Initialize the custom data operation to be used for the action. $data = $this->get_custom_data(); // Call the communication api to action the operation. $communication = processor::load_by_id($data->id); if ($communication === null) { mtrace("Skipping room creation because the instance does not exist"); return; } $communication->get_room_user_provider()->remove_members_from_room($communication->get_all_delete_flagged_userids()); // Now remove any mapping for users who are not in the room. $communication->delete_instance_non_synced_user_mapping($communication->get_instance_userids(false, true)); } /** * Queue the task for the next run. * * @param processor $communication The communication processor to perform the action on */ public static function queue( processor $communication ): void { // Add ad-hoc task to update the provider room. $task = new self(); $task->set_custom_data([ 'id' => $communication->get_id(), ]); // Queue the task for the next run. \core\task\manager::queue_adhoc_task($task); } } PK q�/[#��i> > 5 classes/admin/manage_communication_providers_page.phpnu &1i� <?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/>. namespace core_communication\admin; use admin_setting; use core_plugin_manager; use core_text; use html_table; use html_table_row; use html_writer; use moodle_url; /** * Communication providers manager. Allow enable/disable communication providers and jump to settings. * * @package core_communication * @copyright 2023 Huong Nguyen <huongnv13@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class manage_communication_providers_page extends admin_setting { public function __construct() { $this->nosave = true; parent::__construct( 'managecommunications', new \lang_string('managecommunicationproviders', 'core_communication'), '', '' ); } public function get_setting(): bool { return true; } public function write_setting($data): string { // Do not write any setting. return ''; } public function output_html($data, $query = ''): string { global $OUTPUT; $pluginmanager = core_plugin_manager::instance(); $plugins = $pluginmanager->get_plugins_of_type('communication'); if (empty($plugins)) { return get_string('nocommunicationprovider', 'core_communication'); } $table = new html_table(); $table->head = [ get_string('name'), get_string('enable'), get_string('settings'), get_string('uninstallplugin', 'core_admin'), ]; $table->align = ['left', 'center', 'center', 'center']; $table->attributes['class'] = 'managecommunicationtable generaltable admintable'; $table->data = []; foreach ($plugins as $plugin) { $class = ''; $actionurl = new moodle_url('/admin/communication.php', ['sesskey' => sesskey(), 'name' => $plugin->name]); if ( $pluginmanager->get_plugin_info('communication_' . $plugin->name)->get_status() === core_plugin_manager::PLUGIN_STATUS_MISSING ) { $strtypename = $plugin->displayname . ' (' . get_string('missingfromdisk') . ')'; } else { $strtypename = $plugin->displayname; } if ($plugin->is_enabled()) { $hideshow = html_writer::link( $actionurl->out(false, ['action' => 'disable']), $OUTPUT->pix_icon('t/hide', get_string('disable'), 'moodle', ['class' => 'iconsmall']) ); } else { $class = 'dimmed_text'; $hideshow = html_writer::link( $actionurl->out(false, ['action' => 'enable']), $OUTPUT->pix_icon('t/show', get_string('enable'), 'moodle', ['class' => 'iconsmall']) ); } $settings = ''; if ($plugin->get_settings_url()) { $settings = html_writer::link($plugin->get_settings_url(), get_string('settings')); } $uninstall = ''; if ( $uninstallurl = core_plugin_manager::instance()->get_uninstall_url( 'communication_' . $plugin->name, 'manage' ) ) { $uninstall = html_writer::link($uninstallurl, get_string('uninstallplugin', 'core_admin')); } $row = new html_table_row([$strtypename, $hideshow, $settings, $uninstall]); if ($class) { $row->attributes['class'] = $class; } $table->data[] = $row; } return highlight($query, html_writer::table($table)); } public function is_related($query): bool { if (parent::is_related($query)) { return true; } $types = core_plugin_manager::instance()->get_plugins_of_type('communication'); foreach ($types as $type) { if ( strpos($type->component, $query) !== false || strpos(core_text::strtolower($type->displayname), $query) !== false ) { return true; } } return false; } } PK q�/[�Y�u u classes/privacy/provider.phpnu &1i� <?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/>. namespace core_communication\privacy; use core_privacy\local\metadata\collection; use core_privacy\local\request\approved_contextlist; use core_privacy\local\request\approved_userlist; use core_privacy\local\request\contextlist; use core_privacy\local\request\userlist; /** * Privacy Subsystem for core_communication implementing null_provider. * * @package core_communication * @copyright 2023 Huong Nguyen <huongnv13@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class provider implements \core_privacy\local\request\core_userlist_provider, \core_privacy\local\metadata\provider, \core_privacy\local\request\subsystem\provider { public static function get_metadata(collection $collection): collection { $collection->add_database_table('communication_user', [ 'commid' => 'privacy:metadata:communication_user:commid', 'userid' => 'privacy:metadata:communication_user:userid', 'synced' => 'privacy:metadata:communication_user:synced', ], 'privacy:metadata:communication_user'); return $collection; } public static function get_contexts_for_userid(int $userid): contextlist { return new contextlist(); } public static function export_user_data(approved_contextlist $contextlist) { // None of the core communication tables should be exported. } public static function delete_data_for_all_users_in_context(\context $context) { // None of the data from these tables should be deleted. } public static function delete_data_for_user(approved_contextlist $contextlist) { // None of the data from these tables should be deleted. } public static function get_users_in_context(userlist $userlist) { // Don't add any users. } public static function delete_data_for_users(approved_userlist $userlist) { // None of the data from these tables should be deleted. } } PK q�/[huR�' ' classes/form/configure_form.phpnu &1i� <?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/>. /** * Configure communication for a given instance - the form definition. * * @package core_communication * @copyright 2023 David Woloszyn <david.woloszyn@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_communication\form; use core\context; use stdClass; defined('MOODLE_INTERNAL') || die(); require_once($CFG->libdir . '/formslib.php'); /** * Defines the configure communication form. */ class configure_form extends \moodleform { /** * @var \core_communication\api $communication The communication api object. */ protected $communication; /** * Class constructor * * @param context $context Context object * @param int|null $instanceid Instance ID * @param string|null $instancetype Instance type * @param string|null $component Component name * @param string|null $selectedcommunication Selected communication service (provider) * @param stdClass|null $instancedata Instance data */ public function __construct( context $context, ?int $instanceid = null, ?string $instancetype = null, ?string $component = null, ?string $selectedcommunication = null, ?stdClass $instancedata = null, ) { parent::__construct( null, [ 'context' => $context, 'instanceid' => $instanceid, 'instancetype' => $instancetype, 'component' => $component, 'selectedcommunication' => $selectedcommunication, 'instancedata' => $instancedata, ], ); } /** * Defines the form fields. */ public function definition() { $mform = $this->_form; $context = $this->_customdata['context']; $instanceid = $this->_customdata['instanceid']; $instancetype = $this->_customdata['instancetype']; $component = $this->_customdata['component']; $instancedata = $this->_customdata['instancedata']; // Add communication plugins to the form. $this->communication = \core_communication\api::load_by_instance( context: $context, component: $component, instancetype: $instancetype, instanceid: $instanceid, provider: $this->_customdata['selectedcommunication'], ); $this->communication->form_definition($mform); $this->communication->set_data($instancedata); $this->set_form_definition_for_provider(); // Form buttons. $buttonarray = []; $buttonarray[] = $mform->createElement('submit', 'saveandreturn', get_string('savechanges')); $buttonarray[] = $mform->createElement('cancel'); $mform->addGroup($buttonarray, 'buttonar', '', [' '], false); $mform->closeHeaderBefore('buttonar'); // Hidden elements. $mform->addElement('hidden', 'contextid', $context->id); $mform->setType('contextid', PARAM_INT); $mform->addElement('hidden', 'instanceid', $instanceid); $mform->setType('instanceid', PARAM_INT); $mform->addElement('hidden', 'instancetype', $instancetype); $mform->setType('instancetype', PARAM_TEXT); $mform->addElement('hidden', 'component', $component); $mform->setType('component', PARAM_TEXT); // Finally set the current form data. $this->set_data($instancedata); } /** * Defines the requested/current provider * * Get the selected communication service (provider), * and then use it to show the provider form fields. */ private function set_form_definition_for_provider(): void { $instancedata = $this->_customdata['instancedata']; if ($selectedcommunication = $this->_customdata['selectedcommunication']) { // First is to check whether the selected communication was selected from the form. $provider = $selectedcommunication; } else if (isset($instancedata->selectedcommunication)) { // If the form is not yet submitted, get the value from the DB. $provider = $instancedata->selectedcommunication; } else { // Otherwise, set to PROVIDER_NONE. $provider = \core_communication\processor::PROVIDER_NONE; } $this->communication->form_definition_for_provider($this->_form, $provider); } } PK q�/[e�BK� � " classes/communication_provider.phpnu &1i� <?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/>. namespace core_communication; /** * A base communication provider. * * This interface should be used to declare support for the instantiation method for communication providers. * * Every communication provider must, as a minimum, implement this provider. * * @package core_communication * @copyright 2023 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ interface communication_provider { /** * A base communication provider. * * @param processor $communication The communication object */ public static function load_for_instance(processor $communication): self; /** * Check if the provider is configured or not. * * This method is intended to check if the plugin have got any settings and if all the settings are set properly. * This checking helps to reduce errors in future when a communication instance is added for the provider and not configured. */ public static function is_configured(): bool; } PK q�/[��r�N �N classes/processor.phpnu &1i� <?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/>. namespace core_communication; use core\context; use stdClass; use stored_file; /** * Class processor to manage the base operations of the providers. * * This class is responsible for creating, updating, deleting and loading the communication instance, associated actions. * * @package core_communication * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class processor { /** @var string The magic 'none' provider */ public const PROVIDER_NONE = 'none'; /** @var int The provider active flag */ public const PROVIDER_ACTIVE = 1; /** @var int The provider inactive flag */ public const PROVIDER_INACTIVE = 0; /** @var null|communication_provider|user_provider|room_chat_provider|room_user_provider The provider class */ private communication_provider|user_provider|room_chat_provider|room_user_provider|null $provider = null; /** * Communication processor constructor. * * @param stdClass $instancedata The instance data object */ protected function __construct( private stdClass $instancedata, ) { $providercomponent = $this->instancedata->provider; $providerclass = $this->get_classname_for_provider($providercomponent); if (!class_exists($providerclass)) { throw new \moodle_exception('communicationproviderclassnotfound', 'core_communication', '', $providerclass); } if (!is_a($providerclass, communication_provider::class, true)) { // At the moment we only have one communication provider interface. // In the future, we may have others, at which point we will support the newest first and // emit a debugging notice for older ones. throw new \moodle_exception('communicationproviderclassinvalid', 'core_communication', '', $providerclass); } $this->provider = $providerclass::load_for_instance($this); } /** * Create communication instance. * * @param context $context The context of the item for the instance * @param string $provider The communication provider * @param int $instanceid The instance id * @param string $component The component name * @param string $instancetype The instance type * @param string $roomname The room name * @return processor|null */ public static function create_instance( context $context, string $provider, int $instanceid, string $component, string $instancetype, string $roomname, ): ?self { global $DB; if ($provider === self::PROVIDER_NONE) { return null; } $record = (object) [ 'contextid' => $context->id, 'provider' => $provider, 'instanceid' => $instanceid, 'component' => $component, 'instancetype' => $instancetype, 'roomname' => $roomname, 'avatarfilename' => null, 'active' => self::PROVIDER_ACTIVE, 'avatarsynced' => 0, ]; $record->id = $DB->insert_record('communication', $record); return new self($record); } /** * Update the communication instance with any changes. * * @param null|int $active Active state of the instance (processor::PROVIDER_ACTIVE or processor::PROVIDER_INACTIVE) * @param null|string $roomname The room name */ public function update_instance( ?string $active = null, ?string $roomname = null, ): void { global $DB; if ($active !== null && in_array($active, [self::PROVIDER_ACTIVE, self::PROVIDER_INACTIVE])) { $this->instancedata->active = $active; } if ($roomname !== null) { $this->instancedata->roomname = $roomname; } $DB->update_record('communication', $this->instancedata); } /** * Delete communication data. */ public function delete_instance(): void { global $DB; $DB->delete_records('communication', ['id' => $this->instancedata->id]); } /** * Get non synced instance user ids for the instance. * * @param bool $synced The synced status * @param bool $deleted The deleted status * @return array */ public function get_instance_userids(bool $synced = false, bool $deleted = false): array { global $DB; return $DB->get_fieldset_select( 'communication_user', 'userid', 'commid = ? AND synced = ? AND deleted = ?', [$this->instancedata->id, (int) $synced, (int) $deleted] ); } /** * Get existing instance user ids. * * @return array */ public function get_all_userids_for_instance(): array { global $DB; return $DB->get_fieldset_select( 'communication_user', 'userid', 'commid = ?', [$this->instancedata->id] ); } /** * Get all the user ids flagged as deleted. * * @return array */ public function get_all_delete_flagged_userids(): array { global $DB; return $DB->get_fieldset_select( 'communication_user', 'userid', 'commid = ? AND deleted = ?', [$this->instancedata->id, 1] ); } /** * Create communication user record for mapping and sync. * * @param array $userids The user ids */ public function create_instance_user_mapping(array $userids): void { global $DB; // Check if user ids exits in existing user ids. $useridstoadd = array_diff($userids, $this->get_all_userids_for_instance()); foreach ($useridstoadd as $userid) { $record = (object) [ 'commid' => $this->instancedata->id, 'userid' => $userid, ]; $DB->insert_record('communication_user', $record); } $this->mark_users_as_not_deleted($userids); } /** * Mark users as not deleted for the instance. * * @param array $userids The user ids */ public function mark_users_as_not_deleted(array $userids): void { global $DB; if (empty($userids)) { return; } $DB->set_field_select( 'communication_user', 'deleted', 0, 'commid = ? AND userid IN (' . implode(',', $userids) . ')', [$this->instancedata->id] ); } /** * Mark users as synced for the instance. * * @param array $userids The user ids */ public function mark_users_as_synced(array $userids): void { global $DB; if (empty($userids)) { return; } $DB->set_field_select( 'communication_user', 'synced', 1, 'commid = ? AND userid IN (' . implode(',', $userids) . ')', [$this->instancedata->id] ); } /** * Reset users sync flag for the instance. * * @param array $userids The user ids */ public function reset_users_sync_flag(array $userids): void { global $DB; if (empty($userids)) { return; } $DB->set_field_select( 'communication_user', 'synced', 0, 'commid = ? AND userid IN (' . implode(',', $userids) . ')', [$this->instancedata->id] ); } /** * Delete users flag for the instance users. * * @param array $userids The user ids */ public function add_delete_user_flag(array $userids): void { global $DB; if (empty($userids)) { return; } $DB->set_field_select( 'communication_user', 'deleted', 1, 'commid = ? AND userid IN (' . implode(',', $userids) . ')', [$this->instancedata->id] ); } /** * Delete communication user record for userid. * * @param array $userids The user ids */ public function delete_instance_user_mapping(array $userids): void { global $DB; if (empty($userids)) { return; } $DB->delete_records_select( 'communication_user', 'commid = ? AND userid IN (' . implode(',', $userids) . ')', [$this->instancedata->id] ); } /** * Delete communication user record for userid who are not synced. * * @param array $userids The user ids */ public function delete_instance_non_synced_user_mapping(array $userids): void { global $DB; if (empty($userids)) { return; } $DB->delete_records_select( 'communication_user', 'commid = ? AND userid IN (' . implode(',', $userids) . ') AND synced = ?', [$this->instancedata->id, 0] ); } /** * Delete communication user record for instance. */ public function delete_user_mappings_for_instance(): void { global $DB; $DB->delete_records('communication_user', [ 'commid' => $this->instancedata->id, ]); } /** * Load communication instance by id. * * @param int $id The communication instance id * @return processor|null */ public static function load_by_id(int $id): ?self { global $DB; $record = $DB->get_record('communication', ['id' => $id]); if ($record && self::is_provider_available($record->provider)) { return new self($record); } return null; } /** * Load communication instance by instance id. * * @param context $context The context of the item for the instance * @param string $component The component name * @param string $instancetype The instance type * @param int $instanceid The instance id * @param string|null $provider The provider type - if null will load for this context's active provider. * @return processor|null */ public static function load_by_instance( context $context, string $component, string $instancetype, int $instanceid, ?string $provider = null, ): ?self { global $DB; $params = [ 'contextid' => $context->id, 'instanceid' => $instanceid, 'component' => $component, 'instancetype' => $instancetype, ]; if ($provider === null) { // Fetch the active provider in this context. $params['active'] = 1; } else { // Fetch a specific provider in this context (which may be inactive). $params['provider'] = $provider; } $record = $DB->get_record('communication', $params); if ($record && self::is_provider_available($record->provider)) { return new self($record); } return null; } /** * Check if communication instance is active. * * @return bool */ public function is_instance_active(): bool { return $this->instancedata->active; } /** * Get communication provider class name. * * @param string $component The component name. * @return string */ private function get_classname_for_provider(string $component): string { return "{$component}\\communication_feature"; } /** * Get communication instance id after creating the instance in communication table. * * @return int */ public function get_id(): int { return $this->instancedata->id; } /** * Get the context of the communication instance. * * @return context */ public function get_context(): context { return context::instance_by_id($this->get_context_id()); } /** * Get the context id of the communication instance. * * @return int */ public function get_context_id(): int { return $this->instancedata->contextid; } /** * Get communication instance type. * * @return string */ public function get_instance_type(): string { return $this->instancedata->instancetype; } /** * Get communication instance id. * * @return int */ public function get_instance_id(): int { return $this->instancedata->instanceid; } /** * Get communication instance component. * * @return string */ public function get_component(): string { return $this->instancedata->component; } /** * Get communication provider type. * * @return string|null */ public function get_provider(): ?string { return $this->instancedata->provider; } /** * Get room name. * * @return string|null */ public function get_room_name(): ?string { return $this->instancedata->roomname; } /** * Get communication instance id. * * @return room_chat_provider */ public function get_room_provider(): room_chat_provider { $this->require_api_enabled(); $this->require_room_features(); return $this->provider; } /** * Get communication instance id. * * @return user_provider */ public function get_user_provider(): user_provider { $this->require_api_enabled(); $this->require_user_features(); return $this->provider; } /** * Get communication instance id. * * @return room_user_provider */ public function get_room_user_provider(): room_user_provider { $this->require_api_enabled(); $this->require_room_features(); $this->require_room_user_features(); return $this->provider; } /** * Set provider specific form definition. * * @param string $provider The provider name * @param \MoodleQuickForm $mform The moodle form */ public static function set_provider_specific_form_definition(string $provider, \MoodleQuickForm $mform): void { $providerclass = "{$provider}\\communication_feature"; $providerclass::set_form_definition($mform); } /** * Get communication instance for form feature. * * @return form_provider */ public function get_form_provider(): form_provider { $this->requires_form_features(); return $this->provider; } /** * Get communication instance id. * * @return bool */ public function supports_user_features(): bool { return ($this->provider instanceof user_provider); } /** * Get communication instance id. * * @return bool */ public function supports_room_user_features(): bool { if (!$this->supports_user_features()) { return false; } if (!$this->supports_room_features()) { return false; } return ($this->provider instanceof room_user_provider); } /** * Check form feature available. * * @return bool */ public function requires_form_features(): void { if (!$this->supports_form_features()) { throw new \coding_exception('Form features are not supported by the provider'); } } /** * Check support for form feature. * * @return bool */ public function supports_form_features(): bool { return ($this->provider instanceof form_provider); } /** * Get communication instance id. */ public function require_user_features(): void { if (!$this->supports_user_features()) { throw new \coding_exception('User features are not supported by the provider'); } } /** * Get communication instance id. * * @return bool */ public function supports_room_features(): bool { return ($this->provider instanceof room_chat_provider); } /** * Check if communication api is enabled. */ public function require_api_enabled(): void { if (!api::is_available()) { throw new \coding_exception('Communication API is not enabled, please enable it from experimental features'); } } /** * Get communication instance id. */ public function require_room_features(): void { if (!$this->supports_room_features()) { throw new \coding_exception('room features are not supported by the provider'); } } /** * Get communication instance id. */ public function require_room_user_features(): void { if (!$this->supports_room_user_features()) { throw new \coding_exception('room features are not supported by the provider'); } } /** * Get communication instance id. * * @return bool|\stored_file */ public function get_avatar(): ?stored_file { $fs = get_file_storage(); $file = $fs->get_file( (\context_system::instance())->id, 'core_communication', 'avatar', $this->instancedata->id, '/', $this->instancedata->avatarfilename, ); return $file ?: null; } /** * Set the avatar file name. * * @param string|null $filename */ public function set_avatar_filename(?string $filename): void { global $DB; $this->instancedata->avatarfilename = $filename; $DB->set_field('communication', 'avatarfilename', $filename, ['id' => $this->instancedata->id]); } /** * Get the avatar file name. * * @return string|null */ public function get_avatar_filename(): ?string { return $this->instancedata->avatarfilename; } /** * Check if the avatar has been synced with the provider. * * @return bool */ public function is_avatar_synced(): bool { return (bool) $this->instancedata->avatarsynced; } /** * Indicate if the avatar has been synced with the provider. * * @param boolean $synced True if avatar has been synced. */ public function set_avatar_synced_flag(bool $synced): void { global $DB; $this->instancedata->avatarsynced = (int) $synced; $DB->set_field('communication', 'avatarsynced', (int) $synced, ['id' => $this->instancedata->id]); } /** * Get a room url. * * @return string|null */ public function get_room_url(): ?string { if ($this->provider && $this->is_instance_active()) { return $this->get_room_provider()->get_chat_room_url(); } return null; } /** * Is the communication provider enabled and configured, or disabled. * * @param string $provider provider component name * @return bool */ public static function is_provider_available(string $provider): bool { if (\core\plugininfo\communication::is_plugin_enabled($provider)) { $providerclass = "{$provider}\\communication_feature"; return $providerclass::is_configured(); } return false; } } PK q�/[� m�UX UX classes/api.phpnu &1i� <?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/>. namespace core_communication; use core\context; use core_communication\task\add_members_to_room_task; use core_communication\task\create_and_configure_room_task; use core_communication\task\delete_room_task; use core_communication\task\remove_members_from_room; use core_communication\task\update_room_task; use core_communication\task\update_room_membership_task; use stdClass; /** * Class api is the public endpoint of the communication api. This class is the point of contact for api usage. * * Communication api allows to add ad-hoc tasks to the queue to perform actions on the communication providers. This api will * not allow any immediate actions to be performed on the communication providers. It will only add the tasks to the queue. The * exception has been made for deletion of members in case of deleting the user. This is because the user will not be available. * The member management api part allows run actions immediately if required. * * Communication api does allow to have form elements related to communication api in the required forms. This is done by using * the form_definition method. This method will add the form elements to the form. * * @package core_communication * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class api { /** * @var null|processor $communication The communication settings object */ private ?processor $communication; /** * Communication handler constructor to manage and handle all communication related actions. * * This class is the entrypoint for all kinda usages. * It will be used by the other api to manage the communication providers. * * @param context $context The context of the item for the instance * @param string $component The component of the item for the instance * @param string $instancetype The type of the item for the instance * @param int $instanceid The id of the instance * @param string|null $provider The provider type - if null will load for this context's active provider. * */ private function __construct( private context $context, private string $component, private string $instancetype, private int $instanceid, private ?string $provider = null, ) { $this->communication = processor::load_by_instance( context: $context, component: $component, instancetype: $instancetype, instanceid: $instanceid, provider: $provider, ); } /** * Get the communication processor object. * * @param context $context The context of the item for the instance * @param string $component The component of the item for the instance * @param string $instancetype The type of the item for the instance * @param int $instanceid The id of the instance * @param string|null $provider The provider type - if null will load for this context's active provider. * @return api */ public static function load_by_instance( context $context, string $component, string $instancetype, int $instanceid, ?string $provider = null, ): self { return new self( context: $context, component: $component, instancetype: $instancetype, instanceid: $instanceid, provider: $provider, ); } /** * Reload in the internal instance data. */ public function reload(): void { $this->communication = processor::load_by_instance( context: $this->context, component: $this->component, instancetype: $this->instancetype, instanceid: $this->instanceid, provider: $this->provider, ); } /** * Return the underlying communication processor object. * * @return processor */ public function get_processor(): processor { return $this->communication; } /** * Return the room provider. * * @return \core_communication\room_chat_provider */ public function get_room_provider(): \core_communication\room_chat_provider { return $this->communication->get_room_provider(); } /** * Return the user provider. * * @return \core_communication\user_provider */ public function get_user_provider(): \core_communication\user_provider { return $this->communication->get_user_provider(); } /** * Return the room user provider. * * @return \core_communication\room_user_provider */ public function get_room_user_provider(): \core_communication\room_user_provider { return $this->communication->get_room_user_provider(); } /** * Return the form provider. * * @return \core_communication\form_provider */ public function get_form_provider(): \core_communication\form_provider { return $this->communication->get_form_provider(); } /** * Check if the communication api is enabled. */ public static function is_available(): bool { return (bool) get_config('core', 'enablecommunicationsubsystem'); } /** * Get the communication room url. * * @return string|null */ public function get_communication_room_url(): ?string { return $this->communication?->get_room_url(); } /** * Get the list of plugins for form selection. * * @return array */ public static function get_communication_plugin_list_for_form(): array { // Add the option to have communication disabled. $selection[processor::PROVIDER_NONE] = get_string('nocommunicationselected', 'communication'); $communicationplugins = \core\plugininfo\communication::get_enabled_plugins(); foreach ($communicationplugins as $pluginname => $notusing) { $provider = 'communication_' . $pluginname; if (processor::is_provider_available($provider)) { $selection[$provider] = get_string('pluginname', 'communication_' . $pluginname); } } return $selection; } /** * Get the enabled communication providers and default provider according to the selected provider. * * @param string|null $selecteddefaulprovider * @return array */ public static function get_enabled_providers_and_default(string $selecteddefaulprovider = null): array { $communicationproviders = self::get_communication_plugin_list_for_form(); $defaulprovider = processor::PROVIDER_NONE; if (!empty($selecteddefaulprovider) && array_key_exists($selecteddefaulprovider, $communicationproviders)) { $defaulprovider = $selecteddefaulprovider; } return [$communicationproviders, $defaulprovider]; } /** * Define the form elements for the communication api. * This method will be called from the form definition method of the instance. * * @param \MoodleQuickForm $mform The form element * @param string $selectdefaultcommunication The default selected communication provider in the form field */ public function form_definition( \MoodleQuickForm $mform, string $selectdefaultcommunication = processor::PROVIDER_NONE ): void { global $PAGE; [$communicationproviders, $defaulprovider] = self::get_enabled_providers_and_default($selectdefaultcommunication); $PAGE->requires->js_call_amd('core_communication/providerchooser', 'init'); // List the communication providers. $mform->addElement( 'select', 'selectedcommunication', get_string('selectcommunicationprovider', 'communication'), $communicationproviders, ['data-communicationchooser-field' => 'selector'], ); $mform->addHelpButton('selectedcommunication', 'selectcommunicationprovider', 'communication'); $mform->setDefault('selectedcommunication', $defaulprovider); $mform->registerNoSubmitButton('updatecommunicationprovider'); $mform->addElement( 'submit', 'updatecommunicationprovider', 'update communication', ['data-communicationchooser-field' => 'updateButton', 'class' => 'd-none'] ); // Just a placeholder for the communication options. $mform->addElement('hidden', 'addcommunicationoptionshere'); $mform->setType('addcommunicationoptionshere', PARAM_BOOL); } /** * Set the form definitions for the plugins. * * @param \MoodleQuickForm $mform The moodle form * @param string $provider The provider name */ public function form_definition_for_provider(\MoodleQuickForm $mform, string $provider = processor::PROVIDER_NONE): void { if ($provider === processor::PROVIDER_NONE) { return; } // Room name for the communication provider. $mform->insertElementBefore( $mform->createElement( 'text', 'communicationroomname', get_string('communicationroomname', 'communication'), 'maxlength="100" size="20"' ), 'addcommunicationoptionshere' ); $mform->setType('communicationroomname', PARAM_TEXT); $mform->insertElementBefore( $mform->createElement( 'static', 'communicationroomnameinfo', '', get_string('communicationroomnameinfo', 'communication'), ), 'addcommunicationoptionshere', ); processor::set_provider_specific_form_definition($provider, $mform); } /** * Get the avatar file. * * @return null|\stored_file */ public function get_avatar(): ?\stored_file { $filename = $this->communication->get_avatar_filename(); if ($filename === null) { return null; } $fs = get_file_storage(); $args = (array) $this->get_avatar_filerecord($filename); return $fs->get_file(...$args) ?: null; } /** * Get the avatar file record for the avatar for filesystem. * * @param string $filename The filename of the avatar * @return stdClass */ protected function get_avatar_filerecord(string $filename): stdClass { return (object) [ 'contextid' => \core\context\system::instance()->id, 'component' => 'core_communication', 'filearea' => 'avatar', 'itemid' => $this->communication->get_id(), 'filepath' => '/', 'filename' => $filename, ]; } /** * Get the avatar file. * * If null is set, then delete the old area file and set the avatarfilename to null. * This will make sure the plugin api deletes the avatar from the room. * * @param null|\stored_file $avatar The stored file for the avatar * @return bool */ public function set_avatar(?\stored_file $avatar): bool { $currentfilename = $this->communication->get_avatar_filename(); if ($avatar === null && empty($currentfilename)) { return false; } $currentfilerecord = $this->get_avatar(); if ($avatar && $currentfilerecord) { $currentfilehash = $currentfilerecord->get_contenthash(); $updatedfilehash = $avatar->get_contenthash(); // No update required. if ($currentfilehash === $updatedfilehash) { return false; } } $context = \core\context\system::instance(); $fs = get_file_storage(); $fs->delete_area_files( $context->id, 'core_communication', 'avatar', $this->communication->get_id() ); if ($avatar) { $fs->create_file_from_storedfile( $this->get_avatar_filerecord($avatar->get_filename()), $avatar, ); $this->communication->set_avatar_filename($avatar->get_filename()); } else { $this->communication->set_avatar_filename(null); } // Indicate that we need to sync the avatar when the update task is run. $this->communication->set_avatar_synced_flag(false); return true; } /** * A helper to fetch the room name * * @return string */ public function get_room_name(): string { return $this->communication->get_room_name(); } /** * Set the form data if the data is already available. * * @param \stdClass $instance The instance object */ public function set_data(\stdClass $instance): void { if (!empty($instance->id) && $this->communication) { $instance->selectedcommunication = $this->communication->get_provider(); $instance->communicationroomname = $this->communication->get_room_name(); $this->communication->get_form_provider()->set_form_data($instance); } } /** * Get the communication provider. * * @return string */ public function get_provider(): string { if (!$this->communication) { return ''; } return $this->communication->get_provider(); } /** * Create a communication ad-hoc task for create operation. * This method will add a task to the queue to create the room. * * @param string $communicationroomname The communication room name * @param null|\stored_file $avatar The stored file for the avatar * @param \stdClass|null $instance The actual instance object */ public function create_and_configure_room( string $communicationroomname, ?\stored_file $avatar = null, ?\stdClass $instance = null, ): void { if ($this->provider === processor::PROVIDER_NONE || $this->provider === '') { return; } // Create communication record. $this->communication = processor::create_instance( context: $this->context, provider: $this->provider, instanceid: $this->instanceid, component: $this->component, instancetype: $this->instancetype, roomname: $communicationroomname, ); // Update provider record from form data. if ($instance !== null) { $this->communication->get_form_provider()->save_form_data($instance); } // Set the avatar. if (!empty($avatar)) { $this->set_avatar($avatar); } // Add ad-hoc task to create the provider room. create_and_configure_room_task::queue( $this->communication, ); } /** * Create a communication ad-hoc task for update operation. * This method will add a task to the queue to update the room. * * @param null|int $active The selected active state of the provider * @param null|string $communicationroomname The communication room name * @param null|\stored_file $avatar The stored file for the avatar * @param \stdClass|null $instance The actual instance object */ public function update_room( ?int $active = null, ?string $communicationroomname = null, ?\stored_file $avatar = null, ?\stdClass $instance = null, ): void { // If the provider is none, we don't need to do anything from room point of view. if ($this->communication->get_provider() === processor::PROVIDER_NONE) { return; } $roomnamechange = null; $activestatuschange = null; // Check if the room name is being changed. if ( $communicationroomname !== null && $communicationroomname !== $this->communication->get_room_name() ) { $roomnamechange = $communicationroomname; } // Check if the active status of the provider is being changed. if ( $active !== null && $active !== $this->communication->is_instance_active() ) { $activestatuschange = $active; } if ($roomnamechange !== null || $activestatuschange !== null) { $this->communication->update_instance( active: $active, roomname: $communicationroomname, ); } // Update provider record from form data. if ($instance !== null) { $this->communication->get_form_provider()->save_form_data($instance); } // Update the avatar. // If the value is `null`, then unset the avatar. $this->set_avatar($avatar); // Always queue a room update, even if none of the above standard fields have changed. // It is possible for providers to have custom fields that have been updated. update_room_task::queue( $this->communication, ); } /** * Create a communication ad-hoc task for delete operation. * This method will add a task to the queue to delete the room. */ public function delete_room(): void { if ($this->communication !== null) { // Add the ad-hoc task to remove the room data from the communication table and associated provider actions. delete_room_task::queue( $this->communication, ); } } /** * Create a communication ad-hoc task for add members operation and add the user mapping. * * This method will add a task to the queue to add the room users. * * @param array $userids The user ids to add to the room * @param bool $queue Whether to queue the task or not */ public function add_members_to_room(array $userids, bool $queue = true): void { // No communication object? something not done right. if (!$this->communication) { return; } // No user IDs or this provider does not manage users? No action required. if (empty($userids) || !$this->communication->supports_user_features()) { return; } $this->communication->create_instance_user_mapping($userids); if ($queue) { add_members_to_room_task::queue( $this->communication ); } } /** * Create a communication ad-hoc task for updating members operation and update the user mapping. * * This method will add a task to the queue to update the room users. * * @param array $userids The user ids to add to the room * @param bool $queue Whether to queue the task or not */ public function update_room_membership(array $userids, bool $queue = true): void { // No communication object? something not done right. if (!$this->communication) { return; } // No userids? don't bother doing anything. if (empty($userids)) { return; } $this->communication->reset_users_sync_flag($userids); if ($queue) { update_room_membership_task::queue( $this->communication ); } } /** * Create a communication ad-hoc task for remove members operation or action immediately. * * This method will add a task to the queue to remove the room users. * * @param array $userids The user ids to remove from the room * @param bool $queue Whether to queue the task or not */ public function remove_members_from_room(array $userids, bool $queue = true): void { // No communication object? something not done right. if (!$this->communication) { return; } $provider = $this->communication->get_provider(); if ($provider === processor::PROVIDER_NONE) { return; } // No user IDs or this provider does not manage users? No action required. if (empty($userids) || !$this->communication->supports_user_features()) { return; } $this->communication->add_delete_user_flag($userids); if ($queue) { remove_members_from_room::queue( $this->communication ); } } /** * Display the communication room status notification. */ public function show_communication_room_status_notification(): void { // No communication, no room. if (!$this->communication) { return; } if ($this->communication->get_provider() === processor::PROVIDER_NONE) { return; } $roomstatus = $this->get_communication_room_url() ? 'ready' : 'pending'; $pluginname = get_string('pluginname', $this->get_provider()); $message = get_string('communicationroom' . $roomstatus, 'communication', $pluginname); switch ($roomstatus) { case 'pending': \core\notification::add($message, \core\notification::INFO); break; case 'ready': // We only show the ready notification once per user. // We check this with a custom user preference. $roomreadypreference = "{$this->component}_{$this->instancetype}_{$this->instanceid}_room_ready"; if (empty(get_user_preferences($roomreadypreference))) { \core\notification::add($message, \core\notification::SUCCESS); set_user_preference($roomreadypreference, true); } break; } } } PK q�/[�Kn�` ` lib.phpnu &1i� <?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/>. /** * Callback and library methods for core communication. * * @package core_communication * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ /** * Serve the files from the core_communication file areas. * * @param stdClass $course the course object * @param stdClass $cm the course module object * @param context $context the context * @param string $filearea the name of the file area * @param array $args extra arguments (itemid, path) * @param bool $forcedownload whether force download * @param array $options additional options affecting the file serving */ function core_communication_pluginfile( $course, $cm, $context, $filearea, $args, $forcedownload, array $options = [] ): void { if ($filearea !== 'avatar') { return; } $itemid = array_shift($args); $filename = array_pop($args); // Retrieve the file from the Files API. $fs = get_file_storage(); $file = $fs->get_file($context->id, 'core_communication', $filearea, $itemid, '/', $filename); if (!$file) { return; } send_file($file, $filename); } PK q�/[m��Gq q amd/build/providerchooser.min.jsnu &1i� define("core_communication/providerchooser",["exports"],(function(_exports){Object.defineProperty(_exports,"__esModule",{value:!0}),_exports.init=void 0; /** * Communication provider selection handler. * * @module core_communication/communicationchooser * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ const Selectors_fields={selector:'[data-communicationchooser-field="selector"]',updateButton:'[data-communicationchooser-field="updateButton"]'};_exports.init=()=>{document.querySelector(Selectors_fields.selector).addEventListener("change",(e=>{const form=e.target.closest("form"),updateButton=form.querySelector(Selectors_fields.updateButton),url=new URL(form.action);form.action=url.toString(),updateButton.click()}))}})); //# sourceMappingURL=providerchooser.min.js.mapPK q�/[�\� $ amd/build/providerchooser.min.js.mapnu &1i� {"version":3,"file":"providerchooser.min.js","sources":["../src/providerchooser.js"],"sourcesContent":["\n// This file is part of Moodle - http://moodle.org/ //\n// Moodle is free software: you can redistribute it and/or modify\n// it under the terms of the GNU General Public License as published by\n// the Free Software Foundation, either version 3 of the License, or\n// (at your option) any later version.\n//\n// Moodle is distributed in the hope that it will be useful,\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n// GNU General Public License for more details.\n//\n// You should have received a copy of the GNU General Public License\n// along with Moodle. If not, see <http://www.gnu.org/licenses/>.\n\n/**\n * Communication provider selection handler.\n *\n * @module core_communication/communicationchooser\n * @copyright 2023 Safat Shahin <safat.shahin@moodle.com>\n * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later\n */\n\nconst Selectors = {\n fields: {\n selector: '[data-communicationchooser-field=\"selector\"]',\n updateButton: '[data-communicationchooser-field=\"updateButton\"]',\n },\n};\n\n/**\n * Initialise the format chooser.\n */\nexport const init = () => {\n document.querySelector(Selectors.fields.selector).addEventListener('change', e => {\n const form = e.target.closest('form');\n const updateButton = form.querySelector(Selectors.fields.updateButton);\n const url = new URL(form.action);\n\n form.action = url.toString();\n updateButton.click();\n });\n};\n"],"names":["Selectors","selector","updateButton","document","querySelector","addEventListener","e","form","target","closest","url","URL","action","toString","click"],"mappings":";;;;;;;;MAuBMA,iBACM,CACJC,SAAU,+CACVC,aAAc,kEAOF,KAChBC,SAASC,cAAcJ,iBAAiBC,UAAUI,iBAAiB,UAAUC,UACnEC,KAAOD,EAAEE,OAAOC,QAAQ,QACxBP,aAAeK,KAAKH,cAAcJ,iBAAiBE,cACnDQ,IAAM,IAAIC,IAAIJ,KAAKK,QAEzBL,KAAKK,OAASF,IAAIG,WAClBX,aAAaY"}PK q�/[O��� � amd/src/providerchooser.jsnu &1i� // 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/>. /** * Communication provider selection handler. * * @module core_communication/communicationchooser * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ const Selectors = { fields: { selector: '[data-communicationchooser-field="selector"]', updateButton: '[data-communicationchooser-field="updateButton"]', }, }; /** * Initialise the format chooser. */ export const init = () => { document.querySelector(Selectors.fields.selector).addEventListener('change', e => { const form = e.target.closest('form'); const updateButton = form.querySelector(Selectors.fields.updateButton); const url = new URL(form.action); form.action = url.toString(); updateButton.click(); }); }; PK q�/[ �}��1 �1 tests/api_test.phpnu &1i� <?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/>. namespace core_communication; use communication_matrix\matrix_test_helper_trait; defined('MOODLE_INTERNAL') || die(); require_once(__DIR__ . '/../provider/matrix/tests/matrix_test_helper_trait.php'); require_once(__DIR__ . '/communication_test_helper_trait.php'); /** * Class api_test to test the communication public api and its associated methods. * * @package core_communication * @category test * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @covers \core_communication\api */ class api_test extends \advanced_testcase { use matrix_test_helper_trait; use communication_test_helper_trait; public function setUp(): void { parent::setUp(); $this->resetAfterTest(); $this->setup_communication_configs(); $this->initialise_mock_server(); } /** * Test set data to the instance. */ public function test_set_data(): void { $course = $this->get_course(); $communication = \core_communication\api::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); // Sample data. $roomname = 'Sampleroom'; $provider = 'communication_matrix'; // Set the data. $communication->set_data($course); // Test the set data. $this->assertEquals($roomname, $course->communicationroomname); $this->assertEquals($provider, $course->selectedcommunication); } /** * Test get_current_communication_provider method. */ public function test_get_provider(): void { $course = $this->get_course(); $communication = \core_communication\api::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertEquals('communication_matrix', $communication->get_provider()); } /** * Test set_avatar method. */ public function test_set_avatar(): void { global $CFG; $this->setAdminUser(); $course = $this->get_course('Sampleroom', 'none'); // Sample data. $communicationroomname = 'Sampleroom'; $selectedcommunication = 'communication_matrix'; $avatar = $this->create_communication_file( 'moodle_logo.jpg', 'moodle_logo.jpg', ); // Create the room, settingthe avatar. $communication = \core_communication\api::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, provider: $selectedcommunication, ); $communication->create_and_configure_room($communicationroomname, $avatar); // Reload the communication processor. $communicationprocessor = processor::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); // Compare result. $this->assertEquals( $avatar->get_contenthash(), $communicationprocessor->get_avatar()->get_contenthash(), ); } /** * Test the create_and_configure_room method to add/create tasks. */ public function test_create_and_configure_room(): void { // Get the course by disabling communication so that we can create it manually calling the api. $course = $this->get_course('Sampleroom', 'none'); // Sample data. $communicationroomname = 'Sampleroom'; $selectedcommunication = 'communication_matrix'; $communication = \core_communication\api::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, provider: $selectedcommunication, ); $communication->create_and_configure_room($communicationroomname); // Test the tasks added. $adhoctask = \core\task\manager::get_adhoc_tasks('\\core_communication\\task\\create_and_configure_room_task'); $this->assertCount(1, $adhoctask); $adhoctask = reset($adhoctask); $this->assertInstanceOf('\\core_communication\\task\\create_and_configure_room_task', $adhoctask); // Test the communication record exists. $communicationprocessor = processor::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertEquals($communicationroomname, $communicationprocessor->get_room_name()); $this->assertEquals($selectedcommunication, $communicationprocessor->get_provider()); } /** * Test the create_and_configure_room method to add/create tasks when no communication provider selected. */ public function test_create_and_configure_room_without_communication_provider_selected(): void { // Get the course by disabling communication so that we can create it manually calling the api. $course = $this->get_course('Sampleroom', 'none'); // Test the tasks added. $adhoctask = \core\task\manager::get_adhoc_tasks('\\core_communication\\task\\create_and_configure_room_task'); $this->assertCount(0, $adhoctask); // Test the communication record exists. $communicationprocessor = processor::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertNull($communicationprocessor); } /** * Test update operation. */ public function test_update_room(): void { $course = $this->get_course(); // Sample data. $communicationroomname = 'Sampleroomupdated'; $selectedcommunication = 'communication_matrix'; $communication = \core_communication\api::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $communication->update_room(processor::PROVIDER_ACTIVE, $communicationroomname); // Test the communication record exists. $communicationprocessor = processor::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertEquals($communicationroomname, $communicationprocessor->get_room_name()); $this->assertEquals($selectedcommunication, $communicationprocessor->get_provider()); $this->assertTrue($communicationprocessor->is_instance_active()); $communication->update_room(processor::PROVIDER_INACTIVE, $communicationroomname); // Test updating active state. $communicationprocessor = processor::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, provider: $selectedcommunication, ); $this->assertEquals($communicationroomname, $communicationprocessor->get_room_name()); $this->assertEquals($selectedcommunication, $communicationprocessor->get_provider()); $this->assertFalse($communicationprocessor->is_instance_active()); } /** * Test delete operation. */ public function test_delete_room(): void { $course = $this->get_course(); // Sample data. $communicationroomname = 'Sampleroom'; $selectedcommunication = 'communication_matrix'; // Test the communication record exists. $communicationprocessor = processor::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertEquals($communicationroomname, $communicationprocessor->get_room_name()); $this->assertEquals($selectedcommunication, $communicationprocessor->get_provider()); $communication = \core_communication\api::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $communication->delete_room(); // Test the tasks added. $adhoctask = \core\task\manager::get_adhoc_tasks('\\core_communication\\task\\delete_room_task'); // Should be 2 as one for create, another for update. $this->assertCount(1, $adhoctask); $adhoctask = reset($adhoctask); $this->assertInstanceOf('\\core_communication\\task\\delete_room_task', $adhoctask); } /** * Test the adding and removing of members from room. * * @covers ::add_members_to_room * @covers ::remove_members_from_room */ public function test_adding_and_removing_of_room_membership(): void { $course = $this->get_course(); $userid = $this->get_user()->id; // First test the adding members to a room. $communication = \core_communication\api::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $communication->add_members_to_room([$userid]); // Test the tasks added. $adhoctask = \core\task\manager::get_adhoc_tasks('\\core_communication\\task\\add_members_to_room_task'); $this->assertCount(1, $adhoctask); // Now test the removing members from a room. $communication->remove_members_from_room([$userid]); // Test the tasks added. $adhoctask = \core\task\manager::get_adhoc_tasks('\\core_communication\\task\\remove_members_from_room'); $this->assertCount(1, $adhoctask); } /** * Test the update of room membership with the change user role. * * @covers ::update_room_membership */ public function test_update_room_membership_on_user_role_change(): void { global $DB; // Generate the data. $user = $this->getDataGenerator()->create_user(); $course = $this->get_course(); $coursecontext = \context_course::instance($course->id); $teacherrole = $DB->get_record('role', ['shortname' => 'teacher']); $this->getDataGenerator()->enrol_user($user->id, $course->id); $adhoctask = \core\task\manager::get_adhoc_tasks('\\core_communication\\task\\add_members_to_room_task'); $this->assertCount(1, $adhoctask); $adhoctask = reset($adhoctask); $this->assertInstanceOf('\\core_communication\\task\\add_members_to_room_task', $adhoctask); // Test the tasks added as the role is a teacher. $adhoctask = \core\task\manager::get_adhoc_tasks('\\core_communication\\task\\update_room_membership_task'); $this->assertCount(1, $adhoctask); $adhoctask = reset($adhoctask); $this->assertInstanceOf('\\core_communication\\task\\update_room_membership_task', $adhoctask); } } PK q�/[ j���M �M tests/processor_test.phpnu &1i� <?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/>. namespace core_communication; use communication_matrix\matrix_test_helper_trait; defined('MOODLE_INTERNAL') || die(); require_once(__DIR__ . '/../provider/matrix/tests/matrix_test_helper_trait.php'); require_once(__DIR__ . '/communication_test_helper_trait.php'); /** * Class processor_test to test the communication internal api and its associated methods. * * @package core_communication * @category test * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @coversDefaultClass \core_communication\processor */ class processor_test extends \advanced_testcase { use matrix_test_helper_trait; use communication_test_helper_trait; public function setUp(): void { parent::setUp(); $this->resetAfterTest(); $this->setup_communication_configs(); $this->initialise_mock_server(); } /** * Test create instance. * * @covers ::create_instance * @covers ::get_id * @covers ::get_instance * @covers ::get_room_name */ public function test_create_instance(): void { global $DB; $this->resetAfterTest(); // Sample test data. $instanceid = 10; $context = \core\context\system::instance(); $component = 'core'; $instancetype = 'mycommunication'; $selectedcommunication = 'communication_matrix'; $communicationroomname = 'communicationroom'; $communicationprocessor = processor::create_instance( $context, $selectedcommunication, $instanceid, $component, $instancetype, $communicationroomname, ); // Now test the record against the database. $communicationrecord = $DB->get_record( 'communication', ['instanceid' => $instanceid, 'component' => $component, 'instancetype' => $instancetype] ); // Test against the set data. $this->assertNotEmpty($communicationrecord); $this->assertEquals($context->id, $communicationrecord->contextid); $this->assertEquals($instanceid, $communicationrecord->instanceid); $this->assertEquals($component, $communicationrecord->component); $this->assertEquals($selectedcommunication, $communicationrecord->provider); $this->assertEquals($communicationroomname, $communicationrecord->roomname); $this->assertEquals($instancetype, $communicationrecord->instancetype); // Test against the object. $this->assertEquals($context->id, $communicationprocessor->get_context_id()); $this->assertEquals($context, $communicationprocessor->get_context()); $this->assertEquals($communicationprocessor->get_id(), $communicationrecord->id); $this->assertEquals($communicationprocessor->get_provider(), $communicationrecord->provider); $this->assertEquals($communicationprocessor->get_room_name(), $communicationrecord->roomname); } /** * Test update instance. * * @covers ::update_instance * @covers ::is_instance_active * @covers ::get_id * @covers ::get_room_name */ public function test_update_instance(): void { global $DB; $this->resetAfterTest(); // Sameple test data. $instanceid = 10; $context = \core\context\system::instance(); $component = 'core'; $instancetype = 'mycommunication'; $selectedcommunication = 'communication_matrix'; $communicationroomname = 'communicationroom'; $communicationprocessor = processor::create_instance( $context, $selectedcommunication, $instanceid, $component, $instancetype, $communicationroomname, ); $selectedcommunication = 'none'; $communicationroomname = 'communicationroomedited'; $communicationprocessor->update_instance(processor::PROVIDER_INACTIVE, $communicationroomname); // Now test the record against the database. $communicationrecord = $DB->get_record('communication', [ 'instanceid' => $instanceid, 'component' => $component, 'instancetype' => $instancetype, ]); // Test against the set data. $this->assertNotEmpty($communicationrecord); $this->assertEquals($context->id, $communicationrecord->contextid); $this->assertEquals($instanceid, $communicationrecord->instanceid); $this->assertEquals($component, $communicationrecord->component); $this->assertEquals(processor::PROVIDER_INACTIVE, $communicationrecord->active); $this->assertEquals($communicationroomname, $communicationrecord->roomname); $this->assertEquals($instancetype, $communicationrecord->instancetype); // Test against the object. $this->assertEquals($context->id, $communicationprocessor->get_context_id()); $this->assertEquals($context, $communicationprocessor->get_context()); $this->assertEquals($communicationprocessor->get_id(), $communicationrecord->id); $this->assertEquals($communicationprocessor->is_instance_active(), $communicationrecord->active); $this->assertEquals($communicationprocessor->get_room_name(), $communicationrecord->roomname); } /** * Test delete instance. * * @covers ::delete_instance * @covers ::create_instance * @covers ::load_by_instance */ public function test_delete_instance(): void { global $DB; $this->resetAfterTest(); // Sameple test data. $instanceid = 10; $context = \core\context\system::instance(); $component = 'core'; $instancetype = 'mycommunication'; $selectedcommunication = 'communication_matrix'; $communicationroomname = 'communicationroom'; $communicationprocessor = processor::create_instance( $context, $selectedcommunication, $instanceid, $component, $instancetype, $communicationroomname, ); $communicationprocessor->delete_instance(); // Now test the record against the database. $communicationrecord = $DB->get_record('communication', [ 'instanceid' => $instanceid, 'component' => $component, 'instancetype' => $instancetype, ]); // Test against the set data. $this->assertEmpty($communicationrecord); // Test against the object. $communicationprocessor = processor::load_by_instance( context: $context, component: $component, instancetype: $instancetype, instanceid: $instanceid, ); $this->assertNull($communicationprocessor); } /** * Test load by id. * * @covers ::load_by_instance * @covers ::get_room_provider */ public function test_load_by_instance(): void { $this->resetAfterTest(); $course = $this->get_course(); $context = \core\context\course::instance($course->id); // Test the communication record exists. $communicationprocessor = processor::load_by_instance( context: $context, component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertNotNull($communicationprocessor); $this->assertInstanceOf(communication_provider::class, $communicationprocessor->get_room_provider()); $this->assertInstanceOf(room_chat_provider::class, $communicationprocessor->get_room_provider()); $this->assertInstanceOf(room_user_provider::class, $communicationprocessor->get_room_provider()); $this->assertInstanceOf(user_provider::class, $communicationprocessor->get_room_provider()); } /** * Test load by id. * * @covers ::load_by_id * @covers ::get_room_provider * @covers ::load_by_instance */ public function test_load_by_id(): void { $this->resetAfterTest(); $course = $this->get_course(); $context = \core\context\course::instance($course->id); // Test the communication record exists. $communicationprocessor = processor::load_by_instance( context: $context, component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $communicationprocessorbyid = processor::load_by_id($communicationprocessor->get_id()); $this->assertNotNull($communicationprocessorbyid); $this->assertInstanceOf(communication_provider::class, $communicationprocessorbyid->get_room_provider()); $this->assertInstanceOf(room_chat_provider::class, $communicationprocessorbyid->get_room_provider()); $this->assertInstanceOf(room_user_provider::class, $communicationprocessorbyid->get_room_provider()); $this->assertInstanceOf(user_provider::class, $communicationprocessorbyid->get_room_provider()); } /** * Test get component. * * @covers ::get_component * @covers ::load_by_instance */ public function test_get_component(): void { $this->resetAfterTest(); $course = $this->get_course(); $context = \core\context\course::instance($course->id); // Test the communication record exists. $communicationprocessor = processor::load_by_instance( context: $context, component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertEquals('core_course', $communicationprocessor->get_component()); } /** * Test get provider. * * @covers ::get_provider * @covers ::load_by_instance */ public function test_get_provider(): void { $this->resetAfterTest(); $course = $this->get_course(); $context = \core\context\course::instance($course->id); // Test the communication record exists when fetching the active provider. $communicationprocessor = processor::load_by_instance( context: $context, component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertEquals('communication_matrix', $communicationprocessor->get_provider()); // Test the communication record exists when specifying the provider. $communicationprocessor = processor::load_by_instance( context: $context, component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, provider: 'communication_matrix', ); $this->assertEquals('communication_matrix', $communicationprocessor->get_provider()); // Test the communication record exists when the provider is not active. $communicationprocessor->update_instance(processor::PROVIDER_INACTIVE); $communicationprocessor = processor::load_by_instance( context: $context, component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, provider: 'communication_matrix', ); $this->assertEquals('communication_matrix', $communicationprocessor->get_provider()); } /** * Test get room name. * * @covers ::get_room_name * @covers ::load_by_instance */ public function test_get_room_name(): void { $this->resetAfterTest(); $course = $this->get_course(); $context = \core\context\course::instance($course->id); // Test the communication record exists. $communicationprocessor = processor::load_by_instance( context: $context, component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertEquals('Sampleroom', $communicationprocessor->get_room_name()); } /** * Test get room provider. * * @covers ::get_room_provider * @covers ::require_room_features * @covers ::supports_room_features * @covers ::load_by_instance */ public function test_get_room_provider(): void { $this->resetAfterTest(); $course = $this->get_course(); $context = \core\context\course::instance($course->id); // Test the communication record exists. $communicationprocessor = processor::load_by_instance( context: $context, component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertInstanceOf(room_chat_provider::class, $communicationprocessor->get_room_provider()); } /** * Test get user provider. * * @covers ::get_user_provider * @covers ::require_user_features * @covers ::supports_user_features * @covers ::load_by_instance */ public function test_get_user_provider(): void { $this->resetAfterTest(); $course = $this->get_course(); $context = \core\context\course::instance($course->id); // Test the communication record exists. $communicationprocessor = processor::load_by_instance( context: $context, component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertInstanceOf(user_provider::class, $communicationprocessor->get_room_provider()); } /** * Test get room user provider. * * @covers ::get_room_user_provider * @covers ::require_room_features * @covers ::require_room_user_features * @covers ::supports_room_user_features * @covers ::supports_room_features * @covers ::load_by_instance */ public function test_get_room_user_provider(): void { $this->resetAfterTest(); $course = $this->get_course(); $context = \core\context\course::instance($course->id); // Test the communication record exists. $communicationprocessor = processor::load_by_instance( context: $context, component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertInstanceOf(room_user_provider::class, $communicationprocessor->get_room_user_provider()); } /** * Test get avatar. * * @covers ::get_avatar * @covers ::load_by_instance * @covers ::get_avatar_filename * @covers ::set_avatar_filename * @covers ::set_avatar_synced_flag */ public function test_get_avatar(): void { $this->resetAfterTest(); $this->setAdminUser(); global $CFG; $course = $this->get_course('Sampleroom', 'none'); // Sample data. $communicationroomname = 'Sampleroom'; $selectedcommunication = 'communication_matrix'; $avatar = $this->create_communication_file( 'moodle_logo.jpg', 'moodle_logo.jpg', ); $communication = \core_communication\api::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, provider: $selectedcommunication, ); $communication->create_and_configure_room($communicationroomname, $avatar); $communicationprocessor = processor::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $avatar = $communicationprocessor->get_avatar(); $this->assertNotNull($avatar); $this->assertEquals($avatar->get_component(), 'core_communication'); $this->assertEquals($avatar->get_filearea(), 'avatar'); $this->assertEquals($avatar->get_itemid(), $communicationprocessor->get_id()); $this->assertEquals($avatar->get_filepath(), '/'); $this->assertEquals($avatar->get_filearea(), 'avatar'); $this->assertEquals($avatar->get_filename(), $communicationprocessor->get_avatar_filename()); // Change the avatar file name to something else and check it was set. $communicationprocessor->set_avatar_filename('newname.svg'); $communicationprocessor = processor::load_by_instance( context: \core\context\course::instance($course->id), component: 'core_course', instancetype: 'coursecommunication', instanceid: $course->id, ); $this->assertEquals($communicationprocessor->get_avatar_filename(), 'newname.svg'); } /** * Test if the provider is enabled and configured, or disabled. * * @covers ::is_provider_available */ public function test_is_provider_available(): void { $this->resetAfterTest(); $communicationprovider = 'communication_matrix'; $this->assertTrue(processor::is_provider_available($communicationprovider)); // Now test is disabling the plugin returns false. set_config('disabled', 1, $communicationprovider); $this->assertFalse(processor::is_provider_available($communicationprovider)); } /** * Test delete flagged user id's return correct users. * * @covers ::get_all_delete_flagged_userids */ public function test_get_all_delete_flagged_userids(): void { $this->resetAfterTest(); $course = $this->get_course('Sampleroom', 'none'); $user1 = $this->getDataGenerator()->create_user()->id; $user2 = $this->getDataGenerator()->create_user()->id; // Sample data. $communicationroomname = 'Sampleroom'; $selectedcommunication = 'communication_matrix'; $component = 'core_course'; $instancetype = 'coursecommunication'; // Load the communication api. $communication = \core_communication\api::load_by_instance( context: \core\context\course::instance($course->id), component: $component, instancetype: $instancetype, instanceid: $course->id, provider: $selectedcommunication, ); $communication->create_and_configure_room($communicationroomname); $communication->add_members_to_room([$user1, $user2]); // Now remove user1 from the room. $communication->remove_members_from_room([$user1]); // Test against the object. $communicationprocessor = processor::load_by_instance( context: \core\context\course::instance($course->id), component: $component, instancetype: $instancetype, instanceid: $course->id, ); $this->assertEquals([$user1], $communicationprocessor->get_all_delete_flagged_userids()); } } PK q�/[?I/�) ) # tests/behat/behat_communication.phpnu &1i� <?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/>. // phpcs:disable PSR1.Classes.ClassDeclaration.MissingNamespace require_once(__DIR__ . '/../../../lib/behat/behat_base.php'); require_once(__DIR__ . '/../../tests/communication_test_helper_trait.php'); /** * Class behat_communication for behat custom steps and configuration for communication api. * * @package core_communication * @category test * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class behat_communication extends \behat_base { use \core_communication\communication_test_helper_trait; /** * Configure and enable communication experimental feature. * * @Given /^I enable communication experimental feature$/ */ public function enable_communication_experimental_feature(): void { $this->setup_communication_configs(); } /** * Disable communication experimental feature. * * @Given /^I disable communication experimental feature$/ */ public function disable_communication_experimental_feature(): void { $this->disable_communication_configs(); } } PK q�/[*���� � / tests/behat/communication_configuration.featurenu &1i� @communication Feature: Access the communication configuration page As an editing teacher See dynamic form fields based on selected provider Background: Set up teachers and course for the communication confifiguration page Given I enable communication experimental feature And the following "users" exist: | username | firstname | lastname | email | | teacher1 | Teacher | 1 | teacher1@example.com | | teacher2 | Teacher | 2 | teacher2@example.com | And the following "courses" exist: | fullname | shortname | category | selectedcommunication | | Test course | Test course | 0 | none | And the following "course enrolments" exist: | user | course | role | | teacher1 | Test course | editingteacher | | teacher2 | Test course | teacher | Scenario: A teacher with the correct capability can access the communication configuration page Given I am on the "Test course" "Course" page logged in as "teacher1" When I navigate to "Communication" in current page administration Then I should see "Communication" Scenario: A teacher without the correct capability cannot access the communication configuration page Given I am on the "Test course" "Course" page logged in as "teacher2" Then "Communication" "link" should not exist in current page administration Scenario: I cannot see the communication link when communication provider is disabled Given I disable communication experimental feature And I am on the "Test course" "Course" page logged in as "teacher1" Then "Communication" "link" should not exist in current page administration @javascript Scenario: The communication form fields toggle dynamically when valid provider is set Given a Matrix mock server is configured And I am on the "Test course" "Course" page logged in as "teacher1" When I navigate to "Communication" in current page administration And I set the following fields to these values: | selectedcommunication | communication_matrix | Then I should see "Room name" And I should see "Room topic" PK q�/[x_�� � ) tests/communication_test_helper_trait.phpnu &1i� <?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/>. namespace core_communication; /** * Trait communication_test_helper_trait to generate initial setup for communication providers. * * @package core_communication * @category test * @copyright 2023 Safat Shahin <safat.shahin@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ trait communication_test_helper_trait { /** * Setup necessary configs for communication subsystem. * * @return void */ protected function setup_communication_configs(): void { set_config('enablecommunicationsubsystem', 1); } /** * Disable configs for communication subsystem. * * @return void */ protected function disable_communication_configs(): void { set_config('enablecommunicationsubsystem', 0); } /** * Get or create course if it does not exist * * @param string $roomname The room name for the communication api * @param string $provider The selected provider * @return \stdClass */ protected function get_course( string $roomname = 'Sampleroom', string $provider = 'communication_matrix' ): \stdClass { $this->setup_communication_configs(); $records = [ 'selectedcommunication' => $provider, 'communicationroomname' => $roomname, ]; return $this->getDataGenerator()->create_course($records); } /** * Get or create user if it does not exist. * * @param string $firstname The user's firstname for the communication api * @param string $lastname The user's lastname for the communication api * @param string $username The user's username for the communication api * @return \stdClass */ protected function get_user( string $firstname = 'Samplefn', string $lastname = 'Sampleln', string $username = 'sampleun' ): \stdClass { $this->setup_communication_configs(); $records = [ 'firstname' => $firstname, 'lastname' => $lastname, 'username' => $username, ]; return $this->getDataGenerator()->create_user($records); } /** * Create a stored_file in a draft file area from a fixture file. * * @param string $filename The file name within the communication/tests/fixtures folder. * @param string $storedname The name to use in the database. * @return \stored_file */ protected function create_communication_file( string $filename, string $storedname, ): \stored_file { global $CFG; $fs = get_file_storage(); $itemid = file_get_unused_draft_itemid(); return $fs->create_file_from_pathname((object) [ 'contextid' => \context_system::instance()->id, 'component' => 'user', 'filearea' => 'draftfile', 'itemid' => $itemid, 'filepath' => '/', 'filename' => $storedname, ], "{$CFG->dirroot}/communication/tests/fixtures/{$filename}"); } } PK q�/[)DD�x+ x+ tests/fixtures/moodle_logo.jpgnu &1i� ��� JFIF ` ` �� C �� C�� &�" �� �� � } !1AQa"q2���#B��R��$3br� %&'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz������������������������������������������������������������������������ �� � w !1AQaq"2�B���� #3R�br� $4�%�&'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz����������������������������������������������������������������������� ? ��(�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� �f�_�w?����<-_��_�Q/�;�� ���?�W���k�5�Nlj��_qw�������� � ���Pe�EW�'�EP�+�B� ?� �� J|k_���� �� ��Ǐ��9� ҟ���� E/�1 � _x�� Z�� ���}x��p���!�s� n� �����>,� Ӯ�_����� n� �����>,� Ӯ�_���x}&� �� ��e ��d��g� ��?���E�Q_���Q@ �<��� e����%[���~� �_�� �a�g� ���_��� A��%���_������ӏ�J~� �i� � AEW�I�2QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE 3?�Q/�;�� ���?�W���k�(�������� ��� Wĵ���� 'c��/��� W����MG��@�2�+��@��(�C� � !_� ��s� �>5�� �O� �E�W���� � �O�k�¿������ � ��M� �fx��J��>�i� ^�g� YL��9� �����c�ş��I��Z�z� �����c�ş��I��Z� <>��|�� ��2��g2s� �3� ɍ� �Ϳ����(���݂�(�a��?� � ���� SM����H?g��/� �3� ��D��~������y� c��� U�O�w�� %?؇4� Յ ��+��� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (��?���(�������� ��� Wĵ��K�N��z�� U煫�Z� |`� ���o���]� ��y��xC� &��?� xC� TxQE�� QE�!� �� ��Ǐ��9� ҟ��~'� �"��+��� �Ƶ�a_�?�K�LG� ��&� ֳ<?��_��^4� �\3� ��H~ � �[��r�1� bϋ?����-~��[��r�1� bϋ?����-� I��>|� a�G���9���� ��������gEW���EP��� �_�� �a�g� ���_�$ ���� ���X~� �i�W��_�?�c�In<� ��W� ����� ���?�C��QE�� �Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@ ��K�N��z�� U煫�Z�k� %� 'w�C��|� �����-��0���7���.� �<� q<!� �Q��<!� � �(����(�� ��� �E�W���� � �O�k�¿� �_��� `� �?�S�Z���� � &#�� ���Y� �ү�O�� �S$?���9|� �gş�u�k��^����9|� �gş�u�k������>?� �̣� Y̜� B��� �cx���o�h����+�s�`��(�g��/� �3� ��D��~����K� ��,? � �4�+�߯��1� $� � +� �uS��q� �O���!�?�aH(����?�B�(��(��(��(��(��(��(��(��(��(��(��(��(��(��(��(��(��(��(��(��(��(��+Ğ+�4���x�@�m�Ʊ�McNд�8-��CT�������/ ���7��o�?�W?�&���p�4���Oqi�\�IJ|Y�`�?��o«?_Gr��kg�YվV� +��g� �� ��_�!�^�����[[��7Ӽ;����_<U��Z��ߏA��r3m� �m�h�G� ����~~Ŭ��.�� � S�'��o � ����q� �x�3� � � �g��|/�:|-�m��}� �<G�ĭ��{����:Eĩ٣�g 4'� � B+��> �o� �? �~�^?�`�p[��/�>�xۤp]x �F���-�=�vo��#��[�Q|U3���><�D��㏋�<U�� y :�/���p##U�UB�(�b�u���g��)����?á &s㯈��/,e���4� ,(���z���_�XO�&'ÿ8x��� ~`��x���y;z���K�� <��Ú� ,RI$�I$�NI$�I'�'���O�'���� �������~蚄�~6�������a ���r��x�ŭk"Ka�ϩJg��զ��I'֭@?��m� �������}�v���)�8� �4�k:<��8�τ� � ���_��D��^&�ow} ��ͷ��m�P�G��_�'����c� �sx��'���#������|@����[K� ��Pc����tW��~[��K h-����Ƴs�kP˭\~�PEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEP�3� � ����� ^�� �y�j���� ����P� �_� ��|K_ᯌ �v<M� �����}�?�O��xg� d�/ (��9?D (��?d?�_��� `� �?�S�Z���� �$W��~<�?����ֿl+���)Ɉ�����g���� ��Ɵ�����ß�+w��_?�Y�g��t����ׯ�+w��_?�Y�g��t�������7� 'Ϗ� �3(� �s'?п�?���� �<� Z,�(��� ��(�� � ��K� ��,? � �4�+�߯�x� �� �7���?�M4J���'� �-ǟ�?� �]T� 7~��S�'��sO�XR (���Oᐢ�( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��;j �*���! GN��F�'� ;͎o�����?�4�� i���� �7��e*�9<_7��r3%�k�<?��� xwj?�3�ʖ >�����uD��1����h���'�I��(�0���9�� ����o,� � ho�_ �"�N�/�|q�Xx��2���"����Wb�8�K��$)������� �� ��~�&���_�� ��1��26�_�)�Iᥲ�;�۵�$z6��� �t^*�u�$Ye�Q�d�]]_\�^���yyw4�WwSIqssq3�%��yY�i]��Fgw%��$���r� ��� �? M��� �?�&����~�g�!>�h�6�k��3� fR��z����Le]� >4��ߴ�ݧ�o��� »w���[�OůA !.���� �+{���U�Ŗ����N��?T�0�l� �_M�^ ��>!xKN�ޱ� "�~�i �6��4�x�t �%�5�뢧k\2�Ϳ�B��}U�߈~8��u� �5���Z�F��C���:���o��1�y95�Q@Q@Q@9U��Y��*����� ��%�� $�W�~�߳�Ưڛ�v��w� ���O� ɛ]B�S��rE ��/���i�h�R��� &�d�\ݣ����� �� �|��Sÿ�h!�|t��-��Rӧ�ͯ~|!�T,ѯ��N�7��,g�/�X�wi46�x[E����_�` �� �J�7[� � �G>:��~!�M�V�� �6��C���6���_X��:�J�$����?�}����O�����c���oxs���w��� ��� �t�m'F���a ��(���g��ᦾԯ���������y;�( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��( ��(��� ����P� �_� ��|K_m�D���(ׯ�� �^xZ�%�����; &� �}���ǟ�'�?�j<3� ��?�A��Q_���Q@ � �H�� �x� �ß�)�~�W��+�B� ?� �� J|k_������p_�}�o�k3�~�U� ��O���?��d�����G/� �,��� N�M~B�����G/� �,��� N�M~B��� ��� ���9���_џ�Lo � � m� �pQE~~�QE {�� %� �o�� ���h��o��A�<��� e����%[����?��� ������N?�)���9���)Q_�'��QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE|s�Y�߿�G�E��~� �/�B��K����>��#���3���{�K�Y�Z�bk_�O"i�0��@>Ư"������� |v���O����k~:�&��{ˈ��6L7��w��.�����jwN� ���:��0?m/�:?�7��V��I���࿆�3Z��_�m����7p��;���ڇ�< >-Y�#3�Ya��o�?�ߋ��0���� ��|o�WƗ��o���z����iE���R��4�2b��V���m�Aa���T � �u� K~��:��c߅~ ������ ~ �� �_ !�dC��@~!���2��R��v�$�Q�.������ �Po��Zoį��!�u/67�]�g�/�M��f�i�Ya����x�E!��q�Ƣ� �E QE QE QE QE W�?��I� �Fu�Oi���(����D�x�㗉�䱾6�yw� �]I,��߉#d������ޅ,n���i|l��G�?��w�9�`�|�4�ڳ�sx������oَ�g�ޛ�-`�m��y�/������H�� 4&�A�Z�����׆�u�>_�\��<=�G- � �i�� �g�hz&�a [X�N��Coc�i�v��v�CoH����@ )~ş�w���1����x4aw ��1�ְ`�>"|D�mce][�~'�5��̏-Ě~�c�� \�Š��l3̒}�E QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE QE�� �D���(ׯ�� �^xZ�%����_�w?����<-_�k�������_c�� �5 � �� ���(��O��(���$W��~<�?����ֿl+�?� � !_� ��s� �>5�� � a��_�b8/���7����?}*� ��z�e2C�� � #����|Y� �]&�!k�� � #����|Y� �]&�!k��M� ��� � �?�����/�� &7��6� 8 (��?v (��=��x� �� �7���?�M4J��� ��?� � ���� SM���� I�� �Kq��WU?�ߧ ��� � b � V��(��d(�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (�� (��y���j���C� �į�3ⷅ~�Y�`���I�����1,�W�|/��y�O��6YL��� 7��I2 } _�� �PO�/���$?�o���z�ݜ�� ����$ |Z�]# �6��kW��'� ]��N�͍â�ޟ��Q�}� �ο>$�k���+�{��� ��X��ƶz^��k[�;�y�1��mO¿��#2��Ş#1���߅���Z�g�o|F�F��o�>+�'�|e�+��5� ��[ԼG�=j�@�j�֯sw���2���uq+�U@B���(�� �sG�)�� ���=� ����ϳ ;Ԏ��?���Ά�߅~ }�!�?o�x�O�R�L��6���~-�W��E�x��&��|Y��I�k�'�V�����:���oumkV���u�07�]��3�ns�\� QE QE QE QE QE QE QE������m3^�5MGC�4[�=WFִ{3V�uM>�;� KL�l������(�l�-f����8�D����� n� ���>+I�_�o���-���6Sg�|3��5I-�� � �e��៊���A������~0Ŷ���-5����ʾ�W��E ��T� � � ����x+�)��<[6���� |���+ƚ��ד4v:'�?�:��4�~ ���Ӽ � �Z��ӵ����/�e��|5�����V���0# �8 �A K�_��$�o��i;of�I�t����vm���ڳj�]&�].��EAssoeo=�������quus*Aomo 4�O<�E 1F�$��ʑ��;���� 9�?�'���M.��7�-�Ky|W,�x�� RlE�éx��uei-'Ҵ���Z��d�|W x��� �5� � �Q�ΰ�ysW�3 �K��/���T��Rt�:49�<MZ4�9����������2LVkZ�#��"�C/��͵��¼��p����8T���N8zU����~�~ ��x��ρtk�rD�[x��Y��v���y� ?�˨�^+�����S|z��-���6�6�p\ h��H�;a}G�%��ƧbO�-��R|˙����1⯧%(U�C�x&U�E�K2�lw�s���(�9�b�O�c����]���T�*U�U�Qur���U ����>E)/���~T����/^� ���ʺ;:X��ľ'(H��n%r:�à+s�l�n��H'�/૿!f[ |[���yt�Y�� �Ā���k�� ��"�2�c�Iʃ�\�-� GV�b�'������?\��< �G��3�J���t��O�k.�` ��~�� ��>g�I�Ľ�� � � nc>ۿײ� ��|��o��j�=^=#�7�/��8%��������/�k����d��� �?�Q�ҟ�M3����i��9VwE����%�WV��^G��I� eM]�o�S�_ � g]�n�*�=���וFx-��(&����-�Ǐ>��� F�r:t�!�ҵi�pz>�%���$��$�@�侊� ���.pY� �oA5�ZY�S��꽿��? �5�����g Bo�P�ɸ��2��>_�U�3\$ G�>�����<v���Օ�YHe`YHee#!���9pG"���߇ ~3�'��}�'�~ ���.��-�짃?�u/�hW8��i�`9�$�9� X�줵Ҿ8x.�[��E'�|��j�/ ��ۏ�FBIi_N�44�XL�����^� J8N&��|��� o��m����E�8*T�t�'�\NU��S��V�"��ƟC��z�l_ c2�5��R���_)Μ#����mZ�Z���K ��1iƝ I�K�������|iЇ�>��K�5�b1{mo#A�i2� K}cF�X5=.f��X���.4��4X��}W�ٖ_���U��fY~.����`1qxLM't�P�P�J5`�k���kt��,�.�2�n#.�08��0�Tt�X ~�����:�z�Z��i��vi��Q]�QE QE QE Q^��?�N�_�O[��s@�����~+Քd)���^yZ5�u9t�(H r_#�O��o�*ŏ=ޗ�H��e�9x�����>2���<�>���:2I��M�����o��A!�o�o |6����g���3�G�p�If9����SUiar�dԡ������jT�D~��ׁ $x���r ��2Y˕�u9��E��� ����f �8�7 �T�j�l���M�� i��)��_ i0� ���V�G��-���B{{t8� k��@� e�<�� �ϊ�,�z6������[� �1S ��������~6�7ּk�x�V��u��ҫ�� R�O;C8 ;!�UQUTb��8����ؚ�)pwd�V �0�g،Vo��zUX|L� ��� N�S ��� }xk N�^0��5�YJx\���0��ZO��i��ӽ� y x �ZЅ���� � -�dž>x�YU$#뚎��=qc?��T����9�oச�����ۦ~_��C��b; �m��' 7 ���E~C��Wx猜�O��e��o��x{�c�F�++�bl�^�}�?\��<��*� W�&���;�x��ʞ3���v�AyYh~������y�[Ì��O�h���$ ��t�g��2ʺ��E��>��d`;��d@���Ϩ���+��ҏ�jR\wV�OXW�x^�$�>|��~�d�4vW�/�^./�iSv�t3�(�(�� �&� Ĥ��@�� ����8|G�O�����q����zlY�KMc�E�6?鞐䁜g寪� �^�͟�<5�w}9U�L��Ԥ���� ?���LF�!r�gO�� )�W��K�,�p�w�p���^������Kg���1��o[�嵕�d����C �NY.aļ;�i�%OC4�E��� 0�KQ.�����|���I��Ȫ�Ȍ WFRU���VRAH4�J~��_�M |=��� �'t).��<57͗�sU[� ��(ӥ�wJ�|��l0�Q�!� R�,�O�> �R��uy�n8_;W���\�Q���\iz�I+b "�!� Pp��^+�C�p��6gY� Y����RVJΰ��: �r��`r�4"���1q�� Ď�[ ó�q�[IJn9]9��S�ۜ�\EJ���K-�f��ڂJ��-�xG�^��g���H�>��.�MWE����B �!w���s !.m'X����W�"������qXZ�q8lE8V���ԅj�Ԋ�:�jӔ�ԧ8�(N�e�[L�W�a�J��ت�=Iѯ��R��jӓ�JU�T�jS� '�q��$Ԓh(����(�� (�� (�� (��� �H�/��\x���4� hV�S{�܈��m���O�A%�}"��4�{��B�.��>/����V ��ӕlN/^� ��yկ��(R�N YT�8�+V�ф�b�,��b�Ǝ ��W��V��)P�F3�V�ޑ�N���6v��յ���w�ZZ����\�� �D�/$�J� Q���UG$��`�� T����~�J8��_��$�uS>��ki�! m�ֵ}1u`.�(��˟� �-�]�{���?�'�U����o� �L��c�!k�� �<�3��p1��ǟLo�f�l aq�q�Rr�����̊3��+4�ѭ_g�j`��N�St�Vi��� x�Ĵ��x������ d g��r�R���U�Cx���s 6*���aSM/�#�?������Y����F��t� ���7U�y<3m��Z̤�{wj�Y[��wğ�U��Z{I�|�Ď�����A�,&�1J�ƥ~���Xp��-�Ǟ�4<V̧5��8g�(]�/�e�s db�������U��h`(E���1�} �*ˡ�b�����{_�f4��$���� � ��Ӌ�<}i+�3�sR� ���Y�H��'lڗ�Vvaص����}@��s� ���_�� ����P���4e ���_�tW��P��^nr����H�ȸ^���<�7������>�у��0P�Q��r���=i�6�gR�ݲ�)a� t���>Y΄��a�{VQ�#��e�c�eO��z��� /4�G�_��I��� �?��� ó�V1��c��NJ��� ���,ӫŘl� ���{�� ����px�~���f�? �R�; F� b���[�`8��9לi�s,f 5� ^-�3��O��,�����}��� /�j^X�c n��['��9f��H�`'�'Y�5�5M U�u�2�n��t��]F���圳[�9 �#k�Ѯ� |��R��|e�Oj���@կ4� �;�x%[k�F���� +�Ê�����Y� ��q�e���jc8w��1P�Z�R�*f8|MK˸��m�J �? ⟡C^�J��9�]]'*x>"�a�<5I�ܾ�]_ N�T� 4�q����*�� �/� M����~5�r��zH1�/��9 ����t�:b�<;�8 ��8�,�]�p�� ���_ �c��5�m��!�7Դ�-e� �� �����Ǚ�8�Oat�����1�� cxu㇇>'��o<�<�Χfю]��Q�4��u'K q֭\���I5�*E� ����Jux�#�L�MB�eR�a�Tr��=�*�!W*�|��fx|j��Μ֧�QE��(QE QE QE QE Q\G��$��g���O�/� ���l�nDos0R��N��I}�_:���i��W��Lp0 ����$�Ѿx:6�K¾5��N|�J� �\Fȿ����XԋT]�hCE_�q� �� �gC��8� ��Ο����T���*/�<��Z�*�8���� �8�Bi���K��'��Og��1M`r\,���S1�rQ�V�jS��>���jK$�~ϳ*+;�TPY��UUQ�fc� �I� ��~�?�π X|S�Wv�u����@��f�t�MN&�Y-�� 3��hO�_e��!|G�6�i3:1�m;ñ��> Җ�C���ޖVUP��f�j������W�T��|MRM�,��)�_e��r���s������� }i�:uxύ�:�/k��c=9�<�5Suz��R����*�����)챥������'h� ��I1��[Aq���=�\T��U��� jxS� ��O�=T��'�Q� 5ڿ�*+�O�/�:�s���`���,6GZp��x��R�5�ߝ�?U�} � � ��V6IY���ta9y��˰����Dz� �i�`�6?t�q��<-�H��W��7��olxg�����P��o�^�H���`�6��/$e�y���������Pe^�@�?�ۗ}4�X�T��� �R��l�0�Uq�����j0��Jtj�#8� ���K�Y�eul�%G4�bi)t���My�+�+Ro����xg�^����S����S�� �zn�h7��nt˛�A`pN�����m_�|3����oZռ?�[ �ڦ���iZ��d �{c41 �9IW�a_}�� ��|v�y-���m>,�j2�,^ e��T �?��\K՚M~�Z�C� �e�ۂ��\'�գ��n �8bsq��2��<�"�q8uC �a�/��P�*i��~�B�+�)V��O`8�R�r�ʊ�39%�,>!��帚�O_+����]E|�����?�DY�^�l<Q }K�� �'�T �5���[}b�2Ak�"��U���i�:��ȸ�$�|� ��i��r�\y���OBm[�PmӭM�Z�*�V�;8M8�� �g3���A��|� .Z� �S^ �Q�J��ޣ^���j�*��R��K�N��z�� U煫�Z�k� %� 'w�C��|� �����-��0���7���.� �<� k|!� �Q��<!� � �(����(�� ��� �E�W���� � �O�k�¿� �_��� `� �?�S�Z���� � &#�� ���Y� �ү�O�� �S$?���9|� �gş�u�k��^����9|� �gş�u�k������>?� �̣� Y̜� B��� �cx���o�h����+�s�`��(�g��/� �3� ��D��~����K� ��,? � �4�+�߯��1� $� � +� �uS��q� �O���!�?�aH(����?�B�(��+�~(�f�c�cD���� '�n�;{�Z}[U�!��Gѭ}WT�r�E���a ᢏ.8� �/�pX��5�a2ܿ M��c���8L& ��ԯ��N�PM��9�]�{�ve�va�c0�vW���Y�.�����0ձx�EG�:z�V��M��vM����u�IQY�܅DE�������H I�~&|c� ����2]i_��j � ��t�y�ȼ����gO�6Lږ�����O���~i�G����ܲ��/��)� ��\�3j/e��i��B�=�t����1��� L� �r�l' �3.6��n>�l�%玎 �x�U1Ul�����8i��y.W/�� � x��T����V ����2��u�+5/��Xa�{�ʖ/4�bi�ЩB/���b��Q�:�>ib�O� Z�[���f��$�`e��>M_R��[Ts����_�TٛFgM,|A�iRBK��V 8$=�>'�=:!�M�p?�<W�E8�M��Ӝr\��r<;o�� ��q�]��m $��e���C�/$�xk��%�g|S�b\��U��������w}��i�������fG�/_ 'cj:���3ۖ� `)�� ���� ��顿w����$[���"A� �~5��E|-o����d�-��xk���#*�O�>��C��Q��x�K�z�Iı�� 5������ ���i� � �:���x�O�a녛Úx>�uϨ�D� �?�#�<�;Bw 4�i� լ�/$>$�� �=>By�w�������,ԫ�^b�����ܞ��y~;?��/]9q�D��Pq��f�skJ�>"�'8���b����BxC���d�Ck�[KЮ� o����Ǜ�k� �ɪ:� f��&�� ����4i��Դ=J�V���wya=Ż�A�d<z�5��_�}I5�x�� �c*WP�h�d!�G�O���H�!���n����0?�p�ӏ��T�O��/'̨��S��fS��z�Xl|�z8��zk����tұ�g}�v�*T�.3�2��9S��L m���S��9Mj�� \ⷄާ�7E=_�_<��ċ-/⮃H为H|=��aPa�t�S�^Жa�h�7wN�$��,� ׯ���?�8m<!�A�x��2O��:O��(��6P����6�y�c�]�� ���ÿ�'�>$Ύ (ΞY�V����[�U�� �Z� ƣ|�R�c15�b�:4�%���~�7�zu���J�<����s̲�p[���R��˩��:�� A�J�T���Q_���Q@Q@Q@Q@Q@ ��_�i�π/|O���4˝CB�>;|I�/� �����^��� jQ�k~&���dXu�ǡ趷�� �^�:L����� i_ �~<�K�o�? jĭψ<[�ͨMmj$yb��{1���h�8��t+-;E�ьV6����T?��c���m|J���>�� ������!�C�/Zx�� լ-|Gm����U����z�����1�J��� �% >��c/�o� �L �C�f��<c�? ��_�|W㟃�<Y�m[�g⿏u 8�Z���R�l��� 6�\�J-t�;;86[[� �m��r~������b��*\��?g ������� � ���a��ϫ~� �� � ��@ ��E�d��M��'���?a?��ͿP�q�9H� g� � �tK�߰��3� <� |0���2��(���m�� m� ߗ�~�_����+�H�N� ? �� y� ���?�k��?dO�^ �τ> x�]5����F���v��ږ�}eg֗v�-��y�?�2�(��(��(��(��(��(��+����Y� h������ �5u�1��V����4~Ѧa�McQ� |ɹ4{ ��i���/�(�|��r ˉx�O/�2�<��D����J� |V&��C ��z��ԅ8')#��~θ�>�xo��U1��k�� B �W��ׯR�40�jJu�X���B�9ԛQ�>�� �p~�Rk��_��t�4-�h> ����j� �]��d�k�h -t���\\��͢'��r�ƿ����J�u�V���? g� ?U�2��?ò���|˝G�� � ��u���A� J����4]'�z>��O��t]��LҴ�(�6�6P���F�,pĊ�����,ē�_�W�!��3�J��y>a_(���p9VN�J�_O�hU���َ J4���nS��|��:��8Ia�K * �� �-���mO��ͳ�Ӎ §֥U�2�K����Ta�� a�p�®*5� B� m�k^��j � ���{M�k}�����=��^5mk&M�A.��I�6�� V'��5����E�oq�q� 㸛��1��6nɹG ��)I�`(9J8\Iƍ7��Z��^�Z��C�8/����<5�8 x �v�^'�q�����Q��X�K��j��J�iЧJ� (��T����( ��( ��( ��(��O��c���V>,�/��O ��N}�ڞ�r��l,�%��4�S�U�������?�\��*y� d_�( ��1ͦ�=��4� |L�ʴ�uX���ύ�8m��#E��T�5��pq�� ��=��vFWFdt`��J����+ e A��~��O��c�.k NI��/%�Z2kVo+�i�N�}� �f �*9� �\a ��a���?%�W���g*�;�C�P�(�\K��Mf�}M]8T����;n�_���(�r�� �p��>��+`�:��]���o�z����e�� �[�s?��Kͥ�SHs?��X�t�$˭��=�u��G�J�������J�|p�wS�N�' W�c2�}(���u8�J�'��t�Q� M T�ץR_�7� � q>?�����0�U��is< g��䰹���S �P��*�kB��)�(U��(��>((���:���a{�귶�n���\_j�����X�ZD��]���� ���(��4�������q�Nr�!��sj1�b���&Ҍb�m��I��T#:��!Ns��!�Jr�J1�RnR�i$�m���<��k�73Eomo��\O"ED�If�Y �QF��H쨈��� ��ڳ� Q�.�� �����3-���Fhc����s �x.�t{}AѲ����-����^�%���7���6��Q�o���F�Ki;�j�y����a|��vOi��Oќ$��%���k[i�o��� =�+�x���� ,&��asN2�Jجl��*���\./�2��Ӊ����B�b� �?~�xL- x���+ V4�Y_bc|. )��q '�'%i,���h���q�<&S[�5�j���u]G\ֵK���umZ��P�o�d���.���yH o�F!@Q� �(�ີj֩R�j��Z��R�Z��J�*NNS�RrnS��ܥ)7)I��l��N�t�ѧ TiB�R�ӧN�8�8E(��Q�"�c�I ��* (�� (�� (�� (��=���o�� <D�"�q�[�%�x���LZ�ú� ����i [^&���r� F�I#�s7�?���g��}�F�à^<�F�ܽ�/.�Z�"��_�J�]�R��<�d�u}:1)�+�8�/�+Wt�GP�/�]&��L���/t�F��kK��i[{�K�w�{{�%E��t�7Ud`���� 8��\m*j�3��YK0�my�[�r�\FUZJ���sNR��c,6"V���NT� �{�^�gV�&�<�����q6 �V'��,>kF.�0*я%i,N )�OAJ�jftW�7�C�t[�^���_ŋ�[ �B!�u�Z��#ɆD]�Zx�8��5�K ����1�p�Y����| ǜ7�?`����������c!J�_��Ԧ��?<y��:uiʞ#V���?ɮ:�N$�눱|3�'���R�h9T�f89�J�a�b `�:���,jR��|E:8�5��(���#り(��+�c�����~|��d�[���E�? � w�2G�:�c�u%,� ;�m�k�l�/�x�� xeØ�%�|_��R~����<~k��e*8 ���k����)JP����1)P�9�����%�3���5�8Om����3[� �F5���x�^�K�F1�g[VP���կR~�W�� �/| ��q�XF�ɥ��� $�)���d��r$�öR�|��ZLr��s��?���?��%���O�x�V���-̞^��[;o6���J�R�=�,� �k��g����y�nf����Y'���G�y�̒�4��Ye���ٝ1$�QW�!�ߎ|g��a?�<L���Y�-�| j�/��/�U��J��L�-e��F��� ���M� �>� ���� �p���� ˊ1�`�J+��Ź��/r�� .z�P��|]X*�EW����EPEPEPEP]�|[�k� '�~��xk�\�k [G����ry����L����Q%��,�\E,.���� E|-z8�-j�lN �+P�P�:5�V�%:uhզ�R�JsJP�%FIJ-4��z1Tj�4ib0��s�_^�+Q�F�\*R�J��:��A����(���v?x?e �(���yt� |z�O��1Y�^>�c��ψ'8�8u�F� 곶�/c٠]���)��?�� �C+ U�� ���9pE���~�w��4��� �I���<:�|_{$��x ����5I���~�qH�<<�d�`�� @|�Wם|���U#ZT�O�q��Q�p�I=#8M�ν�S�,�Oi V�)x��S� �1�*r���ۃh)N��:؞ ���<�ބ�� ���p{訠��a���+�{��� �e�xeA$SC,e�H�FW�DfGF �� K_�Ji��M4�kT��4֍5�?Ϧ�m4�M��i��i��OtQE1Q@|�Y~����� �|v>6����L�������Eʹ�,��e�/���bK��*)m �Ͽn��h�$���G�Q��&_ځ�O۲J���� �������wY���-��^�˛&�������{��溻��[����d����wig�y�f�i���Ie���vgv,I�� �O�~\%���/�����:<�|���U�,�S���)�U�Ʀ -��*u�ʪ�m} >�q��> �|B�Z�U��d|<�L=|����?1�\+a��hS�<FeWu(�}���~,|B���Y�Y����uyK��M�:e��� ���d"; &�N����7|�(�w�W�(��c ��f��Nc�c1Y�?VU�x�mz��^&���V�"��V�I=�9JO����p,����� /�`�F���K ��Q��)P�ь)R��!�v (�����( ��( ��(GH�5mS�ִ-J� G�4���4�SL���P����Esiyl��o<l2�E"����v� b��� �S� ~4�Zi�>�ʱ�njYa��|g6E�jѠ��M�D�i,+��J~� Vz���� ������G$l���U�ԆWFRYX� �A�~��_�|W�6{O5�q3��W�MgY"�� �s�4]�����Ӈ7�3 P��i�?m��|5o�S�|XȪey�4s�<�?�҇��Q���eJo��0u'������& ���&�� �Q/�;�� ���?�W���k��ߏ|Q�+�Rx��Z��ψn4� K��g �W�{E��4���2M���m�����\ .�-<�;q��<w�ḣ����pT�Q�����!EW���3,N6�*��Zt�F9'(s��)+7�� ��xc��G��(��p� dy.*� �Ы����6 �Jq��*�(Jt���5���QE|��AEP�+�B� ?� �� J|k_���� �� ��Ǐ��9� ҟ���� E/�1 � _x�� Z�� ���}x��p���!�s� n� �����>,� Ӯ�_����� n� �����>,� Ӯ�_���x}&� �� ��e ��d��g� ��?���E�Q_���Q@ �<��� e����%[���~� �_�� �a�g� ���_��� A��%���_������ӏ�J~� �i� � AEW�I�2ב"G�WX�Y��"" ,���*��,�� �@SRԴ� O�յk�]7K�-./� F�x�l�l�"y���gd����yf�WX�Y݂�k����� n�g� ֧���U���$��h��-_� F)#����,� ��'˸��?i֔,��v_�x�� xE�� jgsx���S�2 5HG �b)��Ӓ���h9A�1�a*t#(+�P�U�W�o�����/%��e�7J�w��i�X �Q�[���X��3X<9ƥyFS�<>�|M �j_�)F�� u/|:��I ��Q��r�{�q��O[ ��K�[q]Fb|? �E ��$?��0�> k��(�uox�P}�Z��y5�Ө,R�V+oi��v���x���UA�Q_俉�0q�����|I�N9u*��[�)T��e�wQ�X^w��O+q���ʶ.��UXQP����O8+¼�8N�a,ƭ(�1� li��s)+9{\W"���)C�� $Rt�Yδ�(��.?P (�� (�� (�� (�� ������ �;��.�f�����Y ����Đ��2K �H���+��e`���q��Ԣ�e�E��Ӻi�SOT֩�II8�)FI�Q���j�4�i�z4~�~��R�Zm;�?���(�1ZY|B�'��F���ѼE Je�.����Ƈ�0��,�ے�p�����/�4m7�> �l5� X���Kմ���,/�&����x�F���p��]YG�_h�� �'�f�~-'Q{�|(���A�S/�>�$�_x[�u��T�a��K�c�Eт�l�/������p��x�Fmõ%O ��Z�x��#��N9�O~�g��Nj�����g�� xj_� ;}��!��x��\ �����o �P��Yݓ��S�(噤��g��'e(akʦ"���Es~���}��>��5� ���=CJ�,��76�eHe`�Aq�%�ݤ� ͝�SZ�E�2F�%��|E ^ �+ Z�' ��O��P� �1+AT�Z�ZnT�ҫNQ�:���8IJ-���j�(W�W���Q����ԡ��ק:5�W�7N�Ԫ(ΕZU#(T�8�p�\d�MQ[�Q@Q@Q@ ��[-I���%�t�����N�s���|s�= ����O�q]��/M]+� ��Z�����Ա���پ�� k���vk��S?�?� ��� �k�q��e#� ��?�_��(�o�W�t��+��� � ť&�>( ��( �� �*œj �M�ۊ1�� /��Ι�[�I��m �~�W�?���'��?m"o�Z��hm6$��$�t6�� /��?�V�(��(��(��(��(��|QK4�� o4�:EQ#I$�H�8�AgwbAfb �W� �& �+�OJ��1�O|$��ֶ:֝�Oi���w�2�5�������|7�_�AsD���"D���Y ��8㎸kþ ��/c�-��4��ӕlV7R3� ���.H^4�εz�p��Շ�pGq/�y���[ �ٍx�� �8\����v"~� C�C�v�I�P�B�j�)R�ʿ����O�C�j�%χ� i7q���g, �vI&��,���u��eʍ��TR�y� �Y�_� G�� �K�w�t�#H�E��n ���n�Y��o���7������k�ݝ�6��xg�> �n��xcº=����,��'L�Kk;H'jF��Gg�y�/=��Iqq$��$��_䗍�:q�9�UH��xO.�9�? ��J� �9��hb�:�ܣ���Ҝ�Ey�q����Ox� �N����W�фs� �.V�x�;+��<&YJ�Ri�o���1n��a�Q_���Q@Q@�C�~-�i��sX�N�|Oٴ��{��E*$�D�Ak��w ��~�y�� � � �Z�{��7�/��9�Y�����n"km�]'� �eJ�f�ۄ�7�;�� � �3�T�����g ��['�fX�GF����S�>�-��<[�?�*����NQ�U�iG �ĩ��]�kG.ê�ԓN.�<4��{�\�#�B���?�H�o��>:iF|�?��;�<� �K��=�ϟ�{W��� w�@�b�{� �~ �� J̶f�q�k��;,��{M%�ډ�<��j�I]�q�} <n�p���>ͪR�\� ����%w˃�3 v.o���)>������k�� �UN��f8\�'�ݻ.lfo��p�W�S��۱��Et (𧉼��o���Op��F�as�_�[�v���9 3/� �CqY`�H�X�z�ժ�4j��*N�z�Εj5i�ƥ*��(ΝHI8���d��M �ЯGF�' Z�#^�+P�B�*ѭJ�T�եV��*S�Z�' 8�-8��QE��QE���z����+�: �Ε�蚅����Vnc���,'K�K� ��A<i"�%p��H?�W�������=� � �[(�/�4�s�i�+��uHQ71��%��4����MԭWiVL(5��� ���/�~/�_ ���4y�t� ϗ�|/���D����7p�3�iq �T`S}�I�po��N�b$�8�G(�Q������%��i��U��.���O �S�ᨨ� .}+�7��^ ⸏ ���"s|=hC���U��I%wJ�?ڐ���L�O�bk9@QE�G�4�-� ��&�ֵ�� �q��?��M��5��Ok�3 �4F{�� �=�LZ�� J��S�}� ��$�!�xS�� f���&�3J��M�^ ��(�]�>e��,ɥh��'[� i�yc?��$�y'�Oz��^��_/��)�[���a���,n ��ZXLM5S ��_4 2���,�僩��sN�+Iz�|��J *�65p�\EJ< ��S�W����x�p���g2��2�'��l P��+��?�0��( ��( ����2���;R:O������PO ��]�Ef�d$���Q�=6# h��� �d��'�_�L�ڋ_�9� /��� o+ľ-�Y���'��<L�� oS��p�|w���1� C��^3/ʱ��1�]�'�T�N�UԴzh��G� �qwd��5���J8�A���u^2pi��.:�uW����M� �R����^/� �� �)���7c��y|�����W��� � �Sx& ����U� �> մ��v��-)���Hh�z 1 �g��E b�� �ThB.u*a�F>4���B8�NZ�sQ�V�i Y�g���x�>!p���J4�b3Z T��0����U''�a)I�g�U�KLԴk�/W�ﴭN�S杩ZOc}i2�7V�Q�q��rƎ22*�~_8N��N�% ���8N.3���eFI8�2MJ-&�i����p�ԧ(Μ��p��' %(�2�q�e�d�M4ӰQE%Q@-.�.���nn,�l�!�����K{�K�ik{�k�Y%�� �%�h�d�DWFVPG�y� ���� x���������ˇ�� 6�� Z»T^�+�k�+hPC ���,V��ZY� 7u�|2�����;���/^=w�:�W�/�{�1_iwȌ�m;T��{ �C+=�ā 9H��� �g� P̡:؎̧G �Lq�`y� n �j 2�y�_?uԋ���HQ�U��k�����F�[8Q�� [ ؾ�g���r', z�9� gf\�������Gs�����Q^o���~2�9�ď ɝ/��lwMj�,�V�5���^ }�J�a�������ú bv� g��~5�`�<�K��8\>;��.z8�&*�+��җڧV��R�d�� ��ex�fY����~+���+ǒ���:�c�jR� Ӛ�ҋՅW�|w�à� �[⏉:�ɗF��},��ˮx��0h�4$e���Z�X�F�Ӣ��h�+Y+<�4�d�n?8�14�YnW����ͪx|&��;&څ8JV�r��b��OL�,��Y�(���1��i���08J*�1�]XСFi':��o&��I����?���x� �=� ��#����<����<��n�<_oGS�|C���-F&��k a�iF��y Wyew�I �I ����gwv%�ىff$�$�I���4� �_x�� -�$�<E�mN�U�o 4� ��o X[��B�ZX�F|�;( ��,P��V�ſ<Xͼ[�Nu��l>I��\' e���쳝Z�HE�<� � FaY99T�xxMh���g��^�d�h��gx���q.m��0��5�NrJk/�s���j*4��"pX�V&s(�����l(�� (���=]�>�m�xoEռA��g��u櫩]?�-�la��f�#�� �+JT�שN�u+V�8ӥJ�%R�J�j0�8A9Nr�J1�r�i$�jӡN�j�!F�(J�Z�gt�ӂr��NmF�Sr���Rm���+��� �<?j�ܾ����2���.}�� =t�95=n���� �� �ZO�%'� �oo� �Lg�:� ����%3���BG5��_�w����p� qW��T�,NW[ ���c���$ӌ�-b�?/�<o�,�,6/�NU�'� �Q�(I;8�x�� E�(�IŦ��M ��W�*� �l~Ծ�Y�<=�G,�¾+�3^KEm�8�;s9�H��IߢD��|i� �����'��'� �����:M�<ѩ �l/!�n��#eͳKo *�#+~c����A)�G �EFRP�'2ʱ�l I�)cgIaj� f�i?-O���>�/n 1�y{Z1s�-�0x�e8-\���W�t��کF+��袊�낊(��(��o�'_�6�{�~�5C&�}"Y�0����i�� C�ۉO:}� �yu��"y���l6 �U�a�,�K ��$3C"K�;G,R��9�I�du!�� ������~E�/o��� ���}Z�Ƌ⭃��V��E|T(͎��6�ګ��D_+�xx�[��V̲�,�p�;>j�ܳ lFIRr|�+�b�ܥ,��>He�O��o� �/xc�幎*�����,g��. :��Zt3:�X|zJ1�c:�<� ���j(�����p��� l��j�p�g%֗-��� �+��l�%�h5^۾D�v� �ȱ:2^�w}���溚�u]SO��KZ�����"��T���[˷���-亼��� ��RM+ # ���� �_���yv�Ţ N���.b�S�M>i���%c��2M��x,�t�����7�%�_�����>!S��)��%�Zu2�-8AfY�/I�i֧C{�bh�Q�O ^�wѫ�(x�ƟZ�0� p��� �MS̱U''���.tj��� ��*U14&xn��j:ޥ�k:�֧�j��:�����%����qwwuq)i&���G�i]�;�3MP��� g9Ԝ�T��T�)Ns���9ɹJs����)6�&�m�����(B�8F�:q�)ӄT!A(��R�c��)$�I$��(�((�� (�B�i���A�?�>ԼO��I���R�N�.�jڍ�Ea�X�����!XQ�g�6�q�I� ��!��Ծ6x�����$��Y�۾7y^%լ�.���l�e��XA}*���P� ���M��|F_N����cg �&�5���ؗ�kS�u0��Tԣ)PQi��� �^ �gNJ�8|¥5R�M����hK��p�S�ҩg��8�ap�q�cY�4~&Q_�W�a_�O�P�v�t]JE}ψ� {�SLë�j��ݲ�R xa ��+����f F���!��`T���4��# -֗%�� FY�� ��% �� �ré�� ��q���S:�IK�e�yM)yJQ�$��̵?�+}7|=�~J +�5��V��)�j��� fբ���^-�~Vݿ�+���� ��'�{{����Lj��]��^�ox`�7��X�:�n`M��B��IʪW�'Ǐ�_���|�4u�ˋ�#L��j>� ��B��g���i�ŵ���\�k ����"} �M�΅L~{�� ��v��d5���t��R�?eC ��یcW0�ah�r�:u%7�~������Z�#Χ�Ϊ���s�1�sJ�Wq¯k[�����G/��B�Iӌ1�Q_� ��Q@Q@Q@ � �H�� �x� �ß�)�~�W��+�B� ?� �� J|k_������p_�}�o�k3�~�U� ��O���?��d�����G/� �,��� N�M~B�����G/� �,��� N�M~B��� ��� ���9���_џ�Lo � � m� �pQE~~�QE {�� %� �o�� ���h��o��A�<��� e����%[����?��� ������N?�)���9���)W�w�?������h��K�m� �e�ݤw6Ҕ���6�Ƴ!�-�u&vѴy�����Z̗:J��8�(� �x�<���IW�84�b��i`�e- ' ��G G�܌��q��?Ȝ��� �NM�y%5<~q��RJN�ʮ3 ���a�XZuq5����)�T�#/�?� � ��C��}Q��M��u� � �u��{(���?�tK��ŵ����D����K�O�z(��;�<�H�NJ����� p�hJO �`)�_T�p0��� 4��VUqU�LEz�'���d> p�]¼=AS�`��bqS�V+3�Ԍ~�����V*qM��B�iah(a�Q��(��>�(�� (�L�K�ǿ|ec���,���w��ܴ^��#�\j��G�O�mL�$���W��� ��{i�� g��'��V�ϋ,,�'�AE�i���G?��1�w×>u�b a�5D��L����M5d6����7� o��y���R�8 [��x�3U!��V<��N�]l�II�åF�ౘ�*�I���u� (B�qZ�g��^�Ùc�<}JN��mJ�Tr� ��c_�Z�TxL6)Ҫ��5�������� ��k�|��u��ts�5�S�:3 �E�@����� ��X�B���Lb3�_x�¯0�f:v�>�i�Jj����UPUTaUT` 0���2���l<y�Y�c9R�S<�(��]e -L�4�C]���,���.�>�~ �qy �U�rn�<t3L��S�S�2�<��� ���������/r� �X���x{ľզ�g �ì��1#8�ɓ�R�[�> ���&�g��OUP���#� 𪝦D��m��,�l�� ����-�x?��?��o��z%�>f��鶺��r�DЭ�n��1�0��4W0>$�X�C+����/_ R| ��[�Qr�G�i`�\I��ӕ\*��'��ɍ�/uF��z�5����p��� ��J�?W�ci��z��?��3��Ty�Q������tQ_���� �6M*�Q���o5 ku��P�c�\=� ( �| ��3\j&4M U�]F`�,�K�-��x�������� �n�f�����'����h��xdU���Z9b�U�udu ���1� �u�qnX��<c���e9�m)V���N^h:�z���é����/�_|M� ��~̖%R�?.�Ea�\��D�h�')ʟ7,�,E)��9*}[YS��4QE~~}�QE�� �-�\]��~ �|#�}�i����'�u���C�{5$�vb8<Gm̖i��s��{�����)�9�4��u�)��C�,R!d�9���*�C) �_� ~��4iY<o�K��~/� �'�-���]�Ի���/��rZ[� �,0ۮ�ϡ�Y� B- �S���B� e 8��a1^֧�1xLTT�W�T�� w�ET�e�m{,Tk`��>���G�'�u��J�+p�S��](q� ,VN4p��i��ad���6���iR�O�ꘪ��U���� E��(�� (�� (�� ��� ���f� �L~�(�����9x���)�� ��ھ�� �_J&� �q��:�S�d\z���@�� �s�^-� ��:����ʷ ����B��3Ɨ���� ��-�ף� �%���� ��n�#��~ ��:^� �� 6�q����(�� (�� �>&xU|u���� +'�|� ��6���A��6x�E�<c�v��x�X� �w'�@���d� ٚm��Nx��9���֧��[U�ҡJ�j��N� �Q�f�(��ף����N�8��Vj_9I#�q%�X%� �x��G�X�R� ��I#u8*�)y�����+|��5����2�7�$� !�c��z��2��uw��2��jS�%����6<<n�W�>6� �S������ �u�/ ��t�?�ێO���t��� �,��2(����7���~�1� ��p�)�Tx� �l�I��#���)��[,�%��v��8��o�M*��+d�]�Wt� �1q]j�3ya�Z����-�{�?�+�ğ�K��Ji A� x���-����7�O2�VѠ����5I��é� O�����`� g��}ٴ�x&�\�>#7C�%�1�+�|�ƿ�hFx?�=s[��7=���_W���+����?̼�o*����� +|�dx��_�e��t-�Y�gǴW��.���l� �5��ȓG+� }�L�㺷t��7����D ��P��]G� ����.�G �H�v�S^�_<4�R��|J _��d1V�o ��D��K�M |J�MS���՛v���Xd��d�� �����?� � �kw�'�W�oᦇ�ї_Լa� �w����ko�i��g�]� �q-�WZΗ1���K4���3� C���g�~�_����2!I�<9�º�$ȸ&��[� ��m_R�b �=����$F"�p$���ṣ���>q��8L�*ź� ��+C��^�\-wB�6�Ս<E�e(9G���n��gY&où�#'�r�^S������g��ᾱ�����Ш�JR���J�a8�\�"�W?�$G��8Ѥ�FT�4R���*�*����*��@ �_���������&�u�s7�/�����Q��i�������ű3iw��o����I|Se �a��~��L�K�?k� �?���<?� ��^ �����x�Q�ˋO x��_��n ��Z�7�V��"�eQC yW�yg�o�����o����C��ǽ<E8���7M��MQ@7\|7�Z5ޅ�=� Z�k.��(Y����Y�m�� ǟ�> ��|w�/���"�Ox��� �<-�H�G�\��hY�/� 2I>ũ����M��^vo�e��Y�ɳ�3����p8�Q���P��(N٧iBqq�J�cR��R��r��3�s,q�c�9ni�W�'��T�,F �7x��F��JT�S��Ԍ��Q��_��%�?�� |[n��~�^�Yb�]B�DK�;V�gUg��l&���gU�C:�� �$i�G� c�_l��6��cl�ܽ����N��V��^��ɴ���$/+�g��!�S��_�o�<�4���J��U�`�0�e�j���1�i;%R� �o��j(�3�a�J1�ZK����W�> p�T�:x�fx\ލ%�N�o�՞ ��w���+R����� 6&�e)4�(����0(�� +��c�����yះ~�Z���(�m����� �=��|��i�U�7:���km)�9$�pu�;� ��[o/�,�����$��[|>��Ι�;46��%�p K$S�r�9c�� ^�X��_� /�C����R��qS���iR�Q�Ҟ30t��T�V�E�0�%F�E(�7O�_��>x{�\[S���a���hU֝l� V<� �R� Ֆ/MJ2�]FQ���W�?��> ���m�XE6�<0?��Yso�<Q�"~��q�ొF�i�DR�=6!�R�]��W�e�d�Wex,�$�a�̫.� 6 ���P�F �F+YNN�VnUkU��՜�NS�q��A�cs�� ���\Ƽ�8�v.��^�i�\��b� T��J�((B�#QE�a�� �5x���e�K8,<Meo;xGƖ��ڿ�u��S �%��s.��4y��.�&X �� ��������ᯌ�G�?Y ?�^�.4�N�%�2�CEsk!T��o��� ��.��-�l�k��ÿ�*���}7��>/����-��|K$i�eԴDK� �L@���ޗq��3�Z�q�� �ĿL? r�υg�fW���ϲ �:9�Z� f�..�, *���'[�b�a}�!��/�&�iN� �k��U���)����2�#!��c+dT�Ԕ�gXZ51�)ae6��2�Q�{\:|� =J1�\F%����+��?���( �B�M�Y� |O��� �>���ɶd��5+y� V�Ɋ�nm&Q��L둚��+���e�� c�����b��-U{��akB���w�Jq��[ �� 1�c2�]5W ���0X�Oj�|UЭM��ӧ9E�l�� $D�6W�EWGR]VV e �8 �Tw70Y��ww4Vֶ��qsq;�P�o4�M4�BGQ�<��*"�b &���~��&�1��29�moᧁ�I�q}�2��1��<�+� |� ��� �f��crm�ψW������m���'� �)�j�V��Ԗ�ȏ��g�e��81�R� `�p�R泮�b��HKok��:8ZOgR�{��C�������6���#�ʯ#j�X��b� ��aiB�*���*S�����A����Ɵx�噴G�:/��e���t�%���b~`��L���9!u=N�i�T�����\�9�8�9�3�ڼ�9�q��fX���18�ӯU�6�)�Mƕ4�i�Q���������^C�PXl�'�ar� �xl P���\� `�V�\�*9T�r�l��+�=@��( ��_�� �?Ļ /��ȯ�^,W��d2M�� .�` OV�C ֏�ە�Y�l��� ��n4�is���� �`���)�e� ?�? � \�ϨZ�FM��<N�\�~ p�d��Tע��Z��N�/'X�#��UUQQB�*�UUUU � ���/} 2�-�����_[ȣ^pἋ�|���_4�`����O���x�E*��FX:Q��� �O�!�����q� ����y/�d�4�Jf]=}�g^����#�� �#��q�gW��o x_��%��� �#�:��-4���N�����h�W�R7�q&�琙f�I��4Q_�E 0�ia��ia��) = p�F�*qQ�*T��ӧNJ0�"���I ��z��U��q5��1�J�z��N�j�fܧR�Z�S�RrnR���&�m�QEjdxƏ���/ǽM/� ��/o��L�E�Ea��J>���\�Ϛ�u��n )���(��d� ��� ���#��s$^C �i���eiWJ�b�ZE�����r]i�I���X� Q��D�}�_�~ �]2-[þ"�{;�we�� ��b�֚��r�^X^F<�k�b�s���}�� � +ex�f ��ޅO-��ҍ �U� ��s�J7���YR�&q���7�iJ�ka1?� ���f�\ '��8&�h�2�+Uu~�J��y���Y[��wU�*x<�KU� ^����'�/|7� 2u��o(������h��+ʃq��F�%��m}c��֬�ƫ��Ͳ��#�� �6��fy^3���+$�a�xZ��^���[�HI)E�V�%(���f�~y�e��U����3L ���m��a1T�Z�X�).zs�q�����2M"�(�<��(��o�%��)4��5��4�q�?$�|��+�m��0 /�ރjn�� ��$�o ��� ^��ƞ�΅!�Wx���dI'��"�����K[]FC,����#����$�<c�x�E���<Q�i>!��8&M?Y��Q�f�H`��x�;W���1�� �����x7N�\�I��!ͥZ�1漦��,e6��G��P�cB� ��/��d<k������,-Jy��B�Q�V�*Q���*�敹�b0���9�~� ? d�� ;�x_ß �[�m"|�}�}^�%���JK����ma� Ym}�۸���� �zwÿx�ǚ��� � "��pF�M*�{Ŵ��?���$��P <�F� 0� �'�u_��]�N�pך5�K]ծ�9��ukɯ�f�,@��yW'h!G�>�|}W&�,��0�<Objc�nIZq�2��gK4��1����2N҆Y��5�Q���/�*Y�g<u���a�S S�#x<�6�V51�jS�e�� 'g �Xz�|��X�QE��fQE Q^�>�?|T��Í ��Z��}� ]c�#�|3`Ѿ��ȧ�2E���R��U���i#�N��r��0�sL�%�p�1��k���0JJ�1�UXѣN7j1��4��F�����5��,�0�slU<Y����~.�j� ��*ժ���\���"�9�Єe9$��M��|_�K�R�Mq��Z-�� �yr�����f M��5�́�th%���g�[-:�� �I�7�w�� 4 ����8�(��5c�x�[�0 �ֵ����ݤ�"�3Gckk X���'��1���:���C�xsÖi�m� gbe�������n [��s5������,�O[_�/��pDŽ�F���\1#,ۈ�R�Z�kT��� �Տ6.�ۧ�N4�8�{lc���� ��<w��lM�qYWa��9OѪ�ӫJ�� u��U)r��Uyj:�|��7U���(�ޏ����_t� x��7��+�|�?Y���8�*Unm%`.,/c�/�f���o� �pu�V�. �����c0��r������a�f�:U�U��U�5��8�2Z4Ѿ���(�0X��L^�ka�XZ�0�����V�zR�JU!$�g FQz����~��O�S���+�!�<G���̺�4�מ!�M�%��L��k^�8����KI�c�l���VO̊��%�)� �hf��Qd�X�R�G$n <n������ ��� ��?~ ����&�?g���-�Bm�1�� �xd���� h� ��M֟�4yg���O} p<���a �g^� �����u�5#N�c��yC*�b'𭵀�գ�o�*����}>��1�O�:ŬGB����^X���᩺���S5�Є��ť|~ �o�� ����袊�"?�B�(������8M�㗅�Out�xSZ�|+㈋��<1ɨJ��m�,�� y���) u(o�h�k�3�˅�죈�Άe�f\�S^_m����T��YE��Ro�� �)M8ͧ�qC�qFE���oEW�s���c)���qT�IԦ�|��*�*�z�hS���~����C+ ��C+) �dA�#�9��/�5�RO� �w�5;ۓs��V�� ��Z��� ����Iy.o�;6����g�����}����c����|7�q.\� س����ڔ����_�Tj߽��r�Z6N5i�-&�?��'�1�)�y� f+��"�q�^"J.1�<"�oM;��a�ev�J�$�M3�C� s�O| Ӿh�f {��ֺ���f���#[��9(w��>���� ޟ&�-�E �u}�� ��� � i����G�~���� ��M�'��J �/5������\��U~'���!�58�Ş$�³����p�O'*q��j��V��G��v2IsR�J7��Y��} x"�xO�xy�T�<� '���j��g�V�Ѩ��`�Ł�Λv�Z5d�s�QE�I��QE W���?�?h� �6� ��6]����OKa�˱�dP�.��W���Ŗ9/�3�ocm}{i��f���Z~��ZO�j�֚n�cl�K���㵳���s$�7� H9i Trk����� g�#�u�O��B���N���>;�b�S�-�+� � �f��izJ �m�k։n��O�O���R�o�g��ԸC�� gV��Nx�Ք�����FҧW �U�"�6�CB��:x��g/��?��𛄡���T��!u�y��H`�J0��s��+ƥ<j҆ �D�_^�g �zx� ���o�� � g࿇�4zu�B9u-Fa �5�%�u�@G �����c������mig V���Q_�[��6 �e8,6]��(C �������P�� Th�Q�#�-[rw�m� ���e�g�^i��q9�c��<N3 ��<F'^���֭Q�s��މ(�E$�(��� ��oCѼK���t� oDխ����R��>��a�-�.Hf��� a�#R����֧R�jp�F�'J�*��Ju)ԋ��Ԅ���8��I�Qm4�.�Z�jS�F��U�8ԥV�� ��BJP�NqjP�$��(�(�&�h�~mO�6��� ~[^� |Ǹ>Z[�W�BFɸ�V2\j^Vm�l��}��E�d�����-gW�]�=������%�͵�I4L� �O ��� ��G$r+#�2��$W�y�� ��px��N� �s{?�l��J��׆ �ń��� y�6p�i�$m(�]� I�i���p~LJ*W��ÑP��*؊�� � ��+לiW�-2�)�?�_e�� J���H�Wԡ�� �S�/�{=�%�s�8znu2��m��� 0�Z��cB�E�^��q� ��QE��AEPEP�+�B� ?� �� J|k_���� �� ��Ǐ��9� ҟ���� E/�1 � _x�� Z�� ���}x��p���!�s� n� �����>,� Ӯ�_����� n� �����>,� Ӯ�_���x}&� �� ��e ��d��g� ��?���E�Q_���Q@ �<��� e����%[���~� �_�� �a�g� ���_��� A��%���_������ӏ�J~� �i� � E[��=2��R�."����n/���q �v���73HxH��7�G<*)'�_��� �P����_.�a�j��b�b����t+18�V�Q}~�>�y}8 �k��� )�JO� �v���\�}o�U����m��L��{�K�L�V7zD�� W�<����W�6���'7��pU���x� wKݫ�c\>U���O���'��,Ό�*j�g�(�*X|��<E�PO��%ù$� z�_��8��I���1��ay�R��+C��QE�w�Q@u��7�~%x����~�����M�æ開�O2M�5�̻X[X��$�ۏ.���{�q Lk��� �&���}���v ����s�x,\F<�3�6�&�Jp+�jv�ɷw�N�m%���V�W�S�� 1�+q�Y��V�],�?�RW�%�N�֪A�(�F&u(�pnQ�V/Fu"�B��-�Ĭ'�| ��=Xӯ�� �!��mG �b�S��$�'��B�lv1FP���ZЧ5Vt����:xC�o�i�M8o�A|�^x��o�}�=ec!�'2[��E�����ͨ]���E���y U�YF_��xvS���08<<yiѣM|�R�I9U�Z��Z�iԭZs�Rs�y��I���y���f٦&�/ ��K��j� ��N�8�ңF�aF�S�F�N�EW�yAEP_��P/���ǚ.��ធ���C���ƺ �_�L�[H��j���(x�I�C4����褄�ڍ��W?��W���Y�</�p���S ���E������x�Zx�4�ݓP�Q�\-u<=z�� ���e�S�؉S��*(Ⱂ��4��(�VY��t����)^�t+F�*��"���/诺?o��� ��=d-< �).�O��a�e���,�&�B�Ea}s�eH���zŅ�[�����+�xW4�(�S9��c�����)�u�T�b�sZO��ԣ��9%)P�M�&�_��NY��1�q^M7<�<�R�ь�u(NW�'_��X�*�x���*(�E&�(��h�@�@�W�^�I��_�7!M[Ŷ� %�8��F�u-&�-�=_M��M� �}��]�>�<����qyn7��+����>7��.Z�lV�+��җ٩F�!R���ˎ�as,3.�Ч����3 Z<Ա\U)��P� �N�)Μ�Xɣ��G�4_� ��9q���Z&��钜 >˨�Gr�ΪXEul]���'}��R��<lQ_�� �J�/��+�E�����4ּ<�?���<��uk�I�K� W�?��bQ��Պ� r|0�Z !� �}N53l����i�l� )��\4SnJ�,"4y�)P�U-i��=�;��{ǜK�5��O)�g j� '+�B̯&���W/�a�[��kN�� (���0��( ��(�� ����L�e5�k;q� �r�5ԩ O�gҭU�*��S���� w�yq�DS� �C�i�0� �V~��u�W��>���m���|%� � ���C��XN��U�y��Aq �&�G�G����?Ï�/�?4�ַ� ho�Z��[,� ߁~���k�;���õdǖc�M�;��� M��'�e�� �E�ٸ��C�G�������� X��О-b� Ïj �r�Z���� �OEPEP^S��V��w�i���)��*�4~� H� �j�O���B>5� �$��� �v�^ ��k�ZѬ�6i�k�i�� %.%��t�̥4���æ�h�F���� ��(�� (�� ��?�Z Z� � ����YL�`���� Z��OS��ͩ��<� �I�8�ϯ�&Z���zY�k�c����2}����� _��jxO�8�J*1� eؖ���1�x���j���g���&�/�/��nR��8dޯ�রtW�iP�R�]�(����B�(��?�z����@�xsS�n�k��J<W���Ю��^�J�^���W� �s(o�C�0a�4 1��O�n��A � -���jt�Q�L"�<W���� �?���N�?�Ӊ��� �5*�_���ܡ����]�r�> �(%�>�N���I�Q_��(QE W� ��b�d� ݪ�Ě����0^_�J�Mb:���l�O;B��W�I_�w�0�d� �!F�uF� �?�5�c��~����$�S����T���l�Ѻ�'[<�r��/e�)�}��]O㯦�&�/ � <�1\q���p��g�#�{_g?�S��}eEW����EP_�?�S]-_�]Ե�3�[ƾ�!|d�7W>f�� ���5� _� �CT7��`��I�6_c� '� �Ɉ�_�x͆���ĺUb��?�Rj� ��e�e�X֡NI�i3��50�-xkV�q���0ͭ?w���:��Tk�/�m ̝Q_���Q@Q@ տ�+�2�w9#�dž� �d� �5�_���VO =� ��_`��x[P�]�H�a��F��m��k[/ ���E�1 M_�߲�� �� �'���5�)�}���K�W|R�I��D��|7h�ȉt_ �6���瞧BR0ґ��_�^S*�3pf]N�S�l7�u�mJxl6K �o�}�U����D��g���v�i�In2�*SN 3��ҋj�'��$��O�f��÷�mY�|qEW���!EPS��\^����A-����[Z�$�ȱC Q�,��#�F� 3�P 5}w� �/��� �K��g���q�+.�T���!�^9|A �o"��Rf�a�¹#�����k�q�s���r�*R�1�p����QU Y�d� 6�M���~� �\Z���96e�Յ�]X�J��F/��J���s�RM���K�o�?c�/�ׂ� [�Դ�6;� ]D� hx�TU��Q���x���ܳ&�ecv {�W���e8 �)�2<��p�nQ��� <mjX\ a�B�.i*t��&�9^Rճ�'�3l~}�fY�i^X��6�b� v"W�\V2��ם�|�ԩ.X�hFю� ��+�<Т�( ��(� � ��b |%�>,閁�C��(5IbL�w��~�;���7���K�_A�1�Y��S|�Y����<y�+ �#���[O�o���]�]�\:Ɲq`�(�,q4N�x� �� �ƥ���:�����L����!=a���Kk���sF�}�� M^ ��q�G�:*�./�kQ�9"��o��6 x���K����i5y� V����} xξs���b�J�^��W�sɷ �>X���;�F�e�̪6�� ]*v�Q�*(�����ࢊ( ��K� ����� ������\�6d�-."�� �����e>_.�ʰ �m~��#�Jϧ�k�|�|�מ �%�Y���k�^� ^�v�������?�_D �yG��v_��G�r\�'���*_�� ����P�ӗĽ����I?� ��CO7�k1� �p�s��d����Ŭ��Sߑ���I�o�Fm~�5�7���O�Oٲ�����!��A�۪6�N�`� '�$��d�쬧���� �`RF����o��ď&��_��BY�.�%�@�#�7Z6�a#��#JԖ3� M���\�K|�yύY��·�.G��݊��3|DR��ͱ0�W(vH�%dPɼ�qj ��3γ�F���ק�a�'�K�� �3][ (�����`��( ��7� ��Z � ����Z�'�+�k e�Y�3D���M�7�kji�j�2K�?�YO��c���#�4oi��j:h����R�+T��O<k�'�a �Ν� �g��<b-+º���9�Ŗ�ao��d7�V��y,嘒I'�W�S�Ts�4ϸ�F5)p�]G ����9�{��_Y��i� ��1�d���Ҟ�D�-�i�|��2 ��t�qna[�rJ�YND�Ֆ �Z�bs,V�_��HY�#���+�;?̐��( ��( ���~Z|t�+�_ IRj�Zt����$ ��t�{�d���%�¶�{"��M�/c�HA��+�β|d��E�Ў'-�0�� BV��Bt+E6�,�&�&�4&�8�QL��\� ��Y�eu��̲�~2�� w��ׅz2i5� x%87i���d�a� ��Ko<RC<<3C*4r�,LRH���d�7R��+� G_S�������9�[E��C�jz�x�MT]����v�"�8���j:���"��-J �_,W�;Ĺ '�x�>��[��d9�e�ן/*�\�[ :�W~�GG�m8�4�i��� g�~&�܇���� ��noB7�p������NO�骼�Z5(��i���+�=���(�3� +㷋Y����y�G{�h�9���`E&�tt vU_�k��|:�@E�g ����(��<+�x�� �<|7�j���;�4}>�P��� ��w��:�� ��+����=��c��N��� ] �2����j�6 �$��[Q��~��> o ��_�%s��|� � ,�,<,ɜ�����x� �;��Ƴ��t�� �症�)�w�� �=%+ݺp�d�B�(R�kHY�� I^ ��NQ�ҧ� ?� S�?f��lv5p�gh�NYr�;j�S��;���Z��cV�u9L������ڄ�9��R����S�Nd�i �O<�Y�Q_�J�+T�V��R�YʥJ�nS�I��s�����ܤޭ���ӧ T�J�#N�(F�8Ar��Ta�h���Z$�AETQE ~��2�E�ߍ��>�mEƉ�K�V�&�d�v�� WVI���ֵx\�_���0���� ��x�5�8< ^�C��F�4IS��6�L0�h���Y��}+U� ����}x>��=�2�J�&�.*�jr�U���O.���i����j-T�R�� ��s��qo� M j�᪱�l��ۍ�.P�l� j��Lƣ�I�:pn^�0��+�� (�� (�� �o�_ 4�� �c��XH�|A�L�]쩸� � jеx���jq[�2�U�->�h��q"���\9�[��r�~Q�a�˳L '/�a�+��a1�g��Q��Z��J-�U�i �fe��� m��'��2�f ���v����+B� � �S�N2W���4ڮ��j����[Ig����^�i(Ķ��}Ė��� HAq�8��y����� ~՟4�X�8/<Ac�< L�-����ڽ�W,k� � ��$� q?����O ϳ|�uIԖW�b0.�����ͦ���p�w %� �(AS��e�i��N9�_��*j�qW�շ���Q^ �Q@ � �H�� �x� �ß�)�~�W��+�B� ?� �� J|k_������p_�}�o�k3�~�U� ��O���?��d�����G/� �,��� N�M~B�����G/� �,��� N�M~B��� ��� ���9���_џ�Lo � � m� �pQE~~�QE {�� %� �o�� ���h��o��A�<��� e����%[����?��� ������N?�)���9���) ���V >��?����f-k�?]���4o�uO�Om�J���i� ��2��P;�$���H�'��>-���ҵm/�vɜ�)���ZM�k�� k���Y��8 "W�o�9���sI�Ԋ�\�-����&�\�h� ��$�����C"�xI�Y*r|5��X���b�o9�)w�qX�����EW�G�EPk��:�ğ �3�:VV� � %�? � �U���E� ��-��A# ^>��/h^ЭV�E�摧hzM�cm���Y�cg ���K` ��Sg��W���~ ���xNO� �7m�g������5M.�I���$�5e� C����8��X�b�e������t� ��r-� ���� ����xi��6?�x��SĹ�g�����(�qӧ�e�hT��8��+�a�k ��ZJ��XL<�G݅����> x��^y�Xᚹ� �yf#S �"�B�u��eO a� �^��p8<���8'��B����*+� � ��� Ño� �= �]7��5�� ��a��&���/i� �=ſ����� ��� �胩� � �����o�k�9� ��� u��_�ȷ� � ���O� 轧� ��� ������ �胩� � �����o�k�9� ��� u��_�ȷ� � ���O� 轧� ��� ������ �胩� � �����o�k�9� ��� u��_�ȷ� � ���O� 轧� ��� ������ �胩� � �� '�/���o���{a.������:d���d�x� ����R�9I'ҭ ��WO殿d�M� W�<U�xcR� |�w��MWA�S�كYk}ҕ>�ăi89���� �Sqo�|w�/�yK8��ɞ_�*yvm��X���x M_�L֩��b���GڨS˩Ƣ��9� ����'� �u�y����᳥�d.�c�f �1å��R����Ua�x_��[�s��*:|���QE��NQ@ f~������;��#K�?ueݵf_��c$��/�m��Q�[#�t��GGկt _J�4�L���X����:�+�YF9�xcq� Eb>��<W�x��<|I�i��ͻ�X��o�`7�nS� ֿ�����|e�5�7���d�� :������N�#*�VQ�*��Ik9 ����a��N��4��c�\l���|�O��S�Z�|֥(�V��^���EW�I�2QE QE ��vW��/�:�ȟ ��m|+�����1�.<� 7��LW�f��h�s��l����=�3�p|a�aqpbӾ(~�:��o� ��?�����H b�� C �`�r$� ��b�_ۿ�\��~� ��ߴA��S���.��w|�j�O��g�O��Y��1Yx���o�u��:x����4�I� ]`�;�!@�A �EPEP^I�HGƿ�$�� ��k���>?��� d��?����x\Q� $�؋7� �~ �x_�Jn � ��Q� � 9��QE� �XQE QE� � �3?�ִ�� �a� ��W� ~~�3?�ִ�� �a� ��W� ��� ɠ���܇� P(��G���w�H� ��=� ��EW�G�EP� �'�������I4J�[�����?��~3� ؽ��I�W��_�Ӄ�NG ��� �z�B?�6�Q� e�'� T9QE�\f�Q@R ��������/�I��[������> � ؿ��M�W����NO��� �B}7?����o�P��QE���QE �o�3�M���� Օ��J�-� ��ɠ�Z� {���� _���� &���7�e� ��b~��'��_ � ��po��Yq���E���0QE QE�Y~�_�l� ��_� ��m�Hj/��� /ٷ �,�AX��;��T�� �xb_¿��� �M����� � D�f>4?�,���/�{��� F��'�9���Mi�� (+�T˰Ud�s��|�~�b*[՟�E�Q���8Wis��1�b��V�|�s^����� iEW�A��QE ��� �У����7Č��F�k�F�g�ox���;'��A �.��� ~� �"�j|xc�0X|9 뱮<ld�7,y�+��6�3�> �U'cs\R���0<=��h�U[�4��W�cS �w U�ڔ�YV�{�<o�:��T��?&�_EW�2��EPEPEP_���I�����7�n� �O�~,��00�[�ڵέH8�G �"�(�����ۀ ��~4��I,�����3I�����&�qa�ˀ�C��8��+j��lƭT�g, �� ��B MH��`�~ʿ�L�GS ��ԩ7棍�����Q_�A��Q@~��'u��_�M'v��mƢW<3�~,�Ͳ w*���z>��c_� �J���ў'��� �7� �� o�1�� ���Zt|i��pmI����.&�E�RI�3� (��_�8M],�uU� ��/ ^��S��� ���-w�D�n�w�� �'a5|ay#� ��Mn���ֿ4+�G� |[�u�t �%����q� ����usx�Zu�d� sm��9�%���4 �)�/$���B��� B ї �]��W��]J�oͅQ_���Q@ J~ǚ~#��� iҠ�!�֙��# � ��$BA���x���+��� �o���~��23���u��������� ���<7�bK�W�|No����r*���e,mf�۷S��n�O�~���� �b`�����s�UZ�w �����(����(�� (�� (�� � � ��hie��Z�Hk� t�g ���<I�8�V=��wv1w�µ�}_��VП� a�0�K�a�v b��ni1���e��H�5<'��!R����l6%����ܧ/�V~��^n]�g�9�r���x'�Z��G)�a�����J+�4�A/$��(��O��(��� d�E���g�m�6�/ğ i�����zC�� /�O�q_�� �R[����|_n������V?�����S � ���o�������C�ٝ��~� �u�3�c�lg<W���1����� �3� ���(� ���ox�����[� 5q_��2���S�}�?�|w�R��7��K�x�-�� c�X�(}�jɯ7���EW� ��QE QE V� �F�����:�4&�s��a� ~��VK� X��<���w,Ğk��?� g�(�~^<��T �c��Ctm��یW�W���zxN�L%$�,/ �xzIl������U���o�q1|_�X��ʮ'�3�EF�u+fx��o��M���+�� (�� (�� (��?���(�������� ��� Wĵ��K�N��z�� U煫�Z� |`� ���o���]� ��y��xC� &��?� xC� TxQE�� QE�!� �� ��Ǐ��9� ҟ��~'� �"��+��� �Ƶ�a_�?�K�LG� ��&� ֳ<?��_��^4� �\3� ��H~ � �[��r�1� bϋ?����-~��[��r�1� bϋ?����-� I��>|� a�G���9���� ��������gEW���EP��� �_�� �a�g� ���_�$ ���� ���X~� �i�W��_�?�c�In<� ��W� ����� ���?�C�����~ԛX���Tf�� ��nP�)|W�4*?�H�"�*�^G]��g��� �;��>-f�]�_� g�$� _�֞'?�1.�_8̫M����kNM��&�|=F8l�#��V� �-��P����� (��s� (�� (�� (�� (�� (�� (�� (�� (�� (�� ��b_���e���d{? ?��',��:���hc9�m�G�`?�̡ )��W�c� ���R��a�-�h ?�n��9�&M+]�=2��>8����fr���e�_��x;0�%�|N 3�14���C�q���w��� 驖G�vQ����*� �\��a�nm��.j� T�� ^���QE���nQE QE ��vë�_���Ũ�g��[��ʯ�oq�=s%Ҡ��5�~4�d�\������� _����� �Q�f��;�O��JI#�Z2;�#�k��r���/� �8u_�:U�\뿳����O-fK���|Ul�~���J�&��+o ���E ���_�>��ۋ�4��{ ڷ�w�F ko���H=�(�����( ��( �$��� $#�_��O�� ��k5�u� ��|k� �I� � P�f�.(� �g���E�� �{�/� %7� �(� Ն �F���� ��(�� (�� ����kZG��~0� ��+��??��kZG��~0� ��+������xm� dnC� �O�#��;�$�c�� �uP��+�#�ࢊ(�ۓ�MG�?���w���%-�H�ܟ�j?� �^ӿ�$�+�n��� '#�����=?ӿ� ��~(� ��� � �(���.?�B�(����k�MC���������-��H~�_�j �_Կ�&�+�C�?� ''�?���!?�����m�_��|7��s�� (����� (�� ��� � &��k��� ���u}�_� �C?��~-��?�Y^��|[� �U�g���2� �w1?B�N���p87� Z,��dh��� O�(�� (�� ���d/�6?�� �Ot/�k����t�ҿh �� �D ~!yc��_�[7��H�}k�K������ �=п�A�����Ï�ڻ��>YK}^� E� �ce�|7�jR/;u)o�c��s�� B��y|�x��i� �� �W�Y�:�o�\���9��G���^�#K�_r�I)c�� dә��]RK��s'+oʤ�����QE��� QE �� ��R� |>\ 5?i�&ydе岑���E'���_�����1�'���DWS,|ig�x�B�]f��z<8�1����[*��Jd���s�Y�^ �5��|E�˪T��a �l��rzF��朞��m�'�5\� ��r�u+. �f4��^S�KR�r���?�r�+YI��h��(��� m�H(�� (�� (�� +�@��u�� i?���N$�|H�F� ��^=Q�EGB8(˧��pP�85�M����|#���K��j X'� ���j7 1�{Enʃ�\� ��=5�V�]�MoP�Ϳ�5�V�^yy�\�ws'$��i��$��5�����C(�. �ӯ�̳l�4��K�����kt�O0�F�ٺ�_�?��KVy� q �� 6]�䔪4�R�;_ �� �ц_�uE^��gQE�r��QE W�g�wOi~7|B�v��_ �lp������3ز�2c�[,�� �[o�~/�3�i��q��h��OT�=�.�v�����ї/�e�R�[���5e���\�K�uiS���8���?I|�w�<wVM)bpyv_N=g<�:�p�1��N�J�$$� � R��������� |;p ���Ğ0���T������~iW�G��Ï�> x�#%/��r�P8��� S��Ϭ�Z�h�"n���~��|��|@�8��lچa ,� �,��Q��ڬ�I��gW��0�e� W����S_/�x�+���t��F��=yZ{4(��O��(��b�e4/ڟ��g�zh�����C��'�I54@;��S��q�7ė^ ��|_d ��4?� v�s��v�� 7be�Pn���������zޗ:�i�Νe���)�.,u h��'\g��h�^O +�%� �T��� ��:U�9�_�*m�ʖm��FS��Jɣ����<o�o�8�j��������8�0ɜҺ�\� ����G8g2pO�P��~I[F�(��\(�� (�� (�� �� ��kIw�Zn �� �s� %� 1����M������_�����㸾 ~�?�I��v��[�3O*��S�66�&��$<skv���2��������_��y�."�g� �5SW�� . �]�W�T�̡Z o ��p���W�?ۏrZ�=�? eu���)p�]��R�jT��/�:�f�N�\d��<ef֡EW���EPп�n�ڟ�/�6�T���_�u�t�N Y��L��W�sMk� �3Ǘ ���5�G%U�_��l��5.Oe�< ��� �u�q�A�Wx��d��Ο��]�d*��KL�����5m=��W���_������h�ף��U�����I�5��A�F�IA � ����G. ���7�ȣM�\�<[��+;Ԟ���8�~���5my��i��~�"���� ��u��O����})������ٗ�𰞻F�^��EW���AEPEP�s�%�)�~� ��p� ���ف��|=a ��R��i���r�� �:��9��߳rxa� {�����`f�*�����:�e��uKXrx62�Uk�V�� �\A�f���gu fG ��~��6�"��OC�7�_&���%��QV T���M4���b�5,� �� � ����kVQE� ��QE QE QE�� �D���(ׯ�� �^xZ�%������/�w�O�`�\>�����߅ !�]�>���5�M��/��X�1�u��q~��?ǧ���/�I� |4M4� � ѫ?�'��+��0��(�C� � !_� ��s� �>5�� �O� �E�W���� � �O�k�¿������ � ��M� �fx��J��>�i� ^�g� YL��9� �����c�ş��I��Z�z� �����c�ş��I��Z� <>��|�� ��2��g2s� �3� ɍ� �Ϳ����(���݂�(�a��?� � ���� SM����H?g��/� �3� ��D��~������y� c��� U�O�w�� %?؇4� Յ#� ��b�_�_�zk����N��.1���V��1ט�� �����?�/ƭ=�1���x�F0|Wce�q �������A����L�1�̲�\je�K��g��,&i���5ѧM�������8;��:o��c�Y:Z�G��q5Q0��+�O� (�� +���Xѿj=S�:5� ��|�; S���@�]:���q���0�Xҍ�Ӧ�NPW�c���W��o�?������� ��� �����| �[�� p� �̲\|�P�b�{�INx<U\ "3�csL>*��z"�Z0s��XsS�NR�o��~𫁳�g �G��s�p���VE����- f P���F�g��S�t�O�|��V�� ĺ+�� �� �u�?��Z�_G�:/E� ��ᾴ� 澾��%G�o�#h� �M¿������� ���+��*� ��qO� 9��z �tW�:/E� ��ᾴ� 澏�t^�� E�T� �}i� �} �*>;�G� n� ��oK��5��e_� �)� �7�oC�.���� �E��]uO�7֟��� ����o�?����%G�o�#h� �M¿�����s�&����,�� �5�?���~%�_��������� ��� ��?��z/�]S� ��� 5�Ĩ�� Dm �I�W� �_ս.��x� E��F��� ��սĺ+�� �� �u�?��Z�_G�:/E� ��ᾴ� 澏�� �荣� �7 � �������貯� ��� ����E~�â�_�.����O�k�?��z7�mO� � 64��T|w� �2��$�+� Ϡ� ���+��*��qW� 9O��+�� ��v� ��� �cG�:/F� �� ή� �Ə�� � 茣� �7 ��?�j� � �ʷ�#\U� �S�2�}���e��A��� �n��g�|'?��G�^y� �ѿ�j�om����� eOْ�_�|/i�����C �ח zZ2i��wٖ�MTL[ |�,D��n?�} ��[� 2�#���䴲�� ���;�q��`� <~����8���T�xєa~i��6� �Ex��_ �a��� � L�9���6Y&}�R� �'��~Y��E��*є�)I�����+�?� ��( ��(;2|-��� ��~ x���>���/|=� J�� � ��}5��U/-��{�)� ���6I#V ��'����K�|�š����o�OÿB�"D���~7�{D���.Ka|��N�]����[�����u�{�[b��?�{� ��S�WI� �K~ӿ�o��5��������w�-���(� �x���<�P�2��C���<�� �MQ@Q@y'��! � �|G� �;Y�[�$��� $#�_��O�� ��k5�qG��<E� b,� U�����)�w�ǹG��0��5EW��aEPEP�{� � �Z�?�s��_�u��� � �Z�?�s��_�u��x#� &��o�#r �@�� 6� ���#�� �� S��Q_� �Q@ (~ܟ�j?� �^ӿ�$�+�n��G�� �Q�� b��� �&�_�u� N�9 -� dF� W���� ���G�����P�AEW�q��QE �H~�_�j �_Կ�&�+�o��C�� �P�3� b��� �6�_� A� �9<Q� d>+� W� �e�� �o� �[�C��XQE�� � QE Wſ�P�4 �_�x� VW���*��� � &��k��� ���u~{����?���������u|3� ������e��#EW�b��EPEP�e�!ɱ�� �{��_�� �V/>��+��8a+k��j�D_��^���d��ݚ�O�%�1#̋Nm��2���!ɱ�� �{��^G� �Z� ?f��V6�}k���lDhL��i�Oe�X� XA�{�ʘ!�ҭ��� ��� ,����8 ���ǚn�G�`1ؘS��uk���jQ��)���_�%�S���\v&���̸߉�{ )>X*9�g����ROHR���bjJ^�aFNM$�jh��� #O��(�� +WBֵ/ �z7��{���� WOִ���ֺ��w ��� � �H=�VUt�ԣR�j3�*�� ��S���ԧ%(N�N3���d�i�Ӻ"�:u�ԣV�J�'N�9�J)ԋ��8��Q�[���M6������F��{ᧃ>$hl�a�^�i���?�t�Do�i2��>��C{��y[We%H'���S� ��N[xė |k�����m�-�����o�x��c��H�IXl�Q pGm���-�#/�\L��u��x-�^ �>�x��Z_��)S˸�<&w���d�/��\�� � ��#K�գZ0� |h���o f�?R�_�jf<7����/%�Ԝ��U_Lj��� n�� u}�ZR�EW�'�EPE��ƞ�u�={�/���<9�:mKT����b $0G���s�V�6q���x-`G�dS�'��a��]zX\&�\N'^�iP���BUkW�Vn0�J�8�u*M��r�I6m��b1��L% ��V*�,6 B����b+�4�УJ S�V�IF�:pNS��b�i ���S�� �կ� 6�'�>*^$qD����%Ž��p�Ih���.��F�K�9u�F&�E�粽����ۮ��?|E�YY-m�$]?�z3��&���t�)YNƘ,���2Lj�u[���4�cO��sǯ��^#f��u G��2^ �Ԣ� �p3�㊔%g �8�ج��q�JP�ӡR��x��ì�"�F ۘ��:�)��If��t����n� � G ���R�V��"��kQ_���Q@I?�M����f S���y� ���S+�%�<> � ��>��k� ;|�� �_�׃�-�x�Ş�n� �Y�V��xL� T��װ��m�1�0�y�(�9 ������|� �3FM�O��?��sNB��Ѵ�}>�� ��H��I[���I��p�Lo�G֤���d�ɰ���e�g5�Z��?�<6V�T�f�^�O�/��C�|1��j���3z��.w�˲j�N5c�a��c�T��Բ��?rG���S�?�� g�[xK�|<K"��I�~��� �,�k:U��}ճ�"� εa <a�/��|�[?xgX� f]� d�Q�����l.����# H��3]�u/ kzLJu�g��4 WP�u[9$�Դ���o��������k���u2�8��/�I�'d����]jdU\d�I|.�[��B�e����jQ��e<Â8��j�OÙ�� �v�y�%(�qn�T� >ue �TT�s��UQ_���QE W� �����K���З�� %����.��� �O� �%m����8�9y� �ڪW?��}?�#�З�����+�s���Q|?�6 �5LJ� �m���.��\�Z�� K<q]�,1�3=~��v�2��>$e��cY���ꌲ ��� ��J� 1�u�.�Q��+MFU ��'*���!�4��o��]�RUx�%� � �^�#��V��/Ms \F �\�O�S�Q�Һ��h��X�C���k���͍���jV2��w���ťݴ�J� �ȒF��: +J��zu)֧ �� ���5)ԧ%:u)�*P�'�8N-J2�q�Zi���:��N�XN�Zs�:��FP�N���8I)Bp�q�d��M4� (�����( ����.��9�o��RD/��.[O ��T� h��S�@�X�L���X�B+�Zm���R�>=���� �N �I< $�����Aj>6��x;P_ ~ �\�owo&�Ox����:�l�˟O��2�:�z� �Z����G���^)a|,� �2���x�6�_*�|/2��3*�e��ռ6QJ��kͯf�G ���SJ� ���~+�.=˲���. �j��x���e�*�,���'6��P�n��,N)BT��uus}ss{y4�7ws�uus3��\\\H��<�1,��+��;Y��rj (��nR������ܥ)6ܛwm��m��ճ���QJ1J1�Q�b����I-KD��QHaEP� �[��?�~,|J� E��?�t��r%�Z�:民�8{X�-���@2 W�~��Zkn����'��,n���OI�/`���#�$2� c_"��� _�g���{�cm�x�O�[FM� |K �h�J��Ė��6� 3�&+��R�r�� i� �� �~M�������s:U`����թ�K��V��l.&�����M��{��/\]� �8:�XLg �,�Jm�� *Ylqy�}�'����4� �#�6VK���/�� �7R 5 ��[����*M։�\�6��g\pU�� s5�� )�^���o<Sklb�~(�^(�tM�.�c z7��T��i�,����v������_�G� /[��ۊxV�'��X�;�U�ƴ�e؝u��`'���\*ŽO�ˀ8��pO �MF_�y.]B�R�J�a��ӛ ��' 4�S�$��(��>�(�� �!� �e|`��?�<�� }�Ι�nd}�����/�8���{oq������Z|{� ���34�J� F�t�_J���Sүmu-:���W6W�3�ugwo"� ��G4N9IXr+����� h-'���O�x�)-��f���<Ѣ*������n��%�K�� ښS��3K`ҽޟv�� � B�p���0�3�F���'9�Ԓ�ֲ�T��i���\�p8���8ޥJ8�EH������L� 1L�/�?,�Jx Ҏ'�IS�����a�r�u{+�X� )��V�N�NR���Q�ҴQEx �aEPEPT5]SO��KZ�����"��T���_˷���-亼��C�Coo�J�ǵ_���(��{ewk���? uD��0�⎿a0hW�Ҭ��+���.#Y<O$-�/*= �F}f� μQ�#%�3 '��ӕjt�C'�\�k�HK��;������RX\ :؉'��e�'�� �^(q~]�M*��R�+���� �(�R+��&�9���d��8���Ůw(�Y|k��/ŏ�_�"�I ^,�N���C/��m �m�KIy �i�Acm!�$ �袿� �0��َ?5�Uu�ٞ7�c+5gW��S���GR�I���[��r���`i*8,����tV��B|=4��Q���(���;B�(���$W��~<�?����ֿl+�?� � !_� ��s� �>5�� � a��_�b8/���7����?}*� ��z�e2C�� � #����|Y� �]&�!k�� � #����|Y� �]&�!k��M� ��� � �?�����/�� &7��6� 8 (��?v (��=��x� �� �7���?�M4J��� ��?� � ���� SM���� I�� �Kq��WU?�ߧ ��� � b � V��� ���;xo�QDV��^�ͷ]k��]�Ѽ�"�� � .�c��C� :�`�4�k�[s6���6�����_�F�� +D�#�@ݵ/_A�n |�����j�O�z��>��+S��e�J����c��| �eQfT��c+���1����r�Z� N}8���9�t�E<g ��8���˪*�|m�_���}9��t�QE��CQ@ ]~�� �5�C�CX����^)� �y�q 0i�"��l��v!"��5�] P�����m���v�CW�_�O� �K���u���E�,�� YZiZ�\I��x~%[]��&K�%�M�$ $��·�%��ѿ����'a�3_ �lDiK �����%W�! �*���$���f8ZQ�^�2�|�g� ����������a�V8,=,���J-�Xoo9e��Z��r�UY{��lR���袊� DO��(�� (�� (�� (�"������O �x��V�q��:���b�zu�uq��g{~��vMq䥶�p�\��Tn��_�v� ��~�k��^%�|��� �v���g�$����|EƜ3�fP�N���s���!J�r�RXz��UB�W4$�iGUt}�G�� �69�pggyl�T� ~Y�c�Iբ�jӎ"� Ҕ��ݜT���vgW�m� .��ק�<Z� �7U� ��� � 3��צ��7� w���� C�+�~7xA �I�ϖ�� I��mx'����~2��9��(���=[� q�//K� ?��q���\Uv� ��~�C��Bo�|'�ͬ-d�s�z;���?,� /�&l�x ��㋾y>*?�T�%E~s���f^�|H�|)`?�?-}c�3㧄?h/��� $��mu��&�.�m�Myyemgsu%�Vچ�&��_E�g���!U-��x{� 8�2YG q~G�fn�\B�e��bk� �ֳ��:|�R�i'(��I? �|0� ����/g�&Y���熡���{**Sj�*rI�)6�e+Z-�g��+�O� (�� (�� �<����巍,�����~�n�N�F�Z/���� gL��2�D�������d�� I�R'��@Q@Q@y'��! � �|G� �;Y�[�$��� $#�_��O�� ��k5�qG��<E� b,� U�����)�w�ǹG��0��5EW��aEPEP�{� � �Z�?�s��_�u��� � �Z�?�s��_�u��x#� &��o�#r �@�� 6� ���#�� �� S��Q_� �Q@ (~ܟ�j?� �^ӿ�$�+�n��G�� �Q�� b��� �&�_�u� N�9 -� dF� W���� ���G�����P�AEW�q��QE �H~�_�j �_Կ�&�+�o��C�� �P�3� b��� �6�_� A� �9<Q� d>+� W� �e�� �o� �[�C��XQE�� � QE Wſ�P�4 �_�x� VW���*��� � &��k��� ���u~{����?���������u|3� ������e��#EW�b��EPEP�e�!ɱ�� �{��_B_YZjVW�v�o冡kqe{i: �����6�^)�� �T�k�� �M����� � D�:��.�g�\ �J� ��$�FY6 J2��i��MY���ܥ;�)�R����C(�-�Q�s�c��%f��M4�Lh� ��� ~1�����Nt�?P{� ^L�K�5փx%?,ҥ� �B� �e}o�еxmE�Q?ٶ_� b���[s� �6�wb��-�~!�sf�X�cT e����֓]��Z��.�H�:��C���#��s<�� LJ�Z�s~�Y�R�15e'�S���k9`jſi*T�F0�R����7��<Q� -�*��*�,���]*���Ԣ�;�F�f�TqԤ���Y�0�����b�(��O��(�+22�3+�VRU���YX`�9�_�߱��+JԴ�'�o��e4�n�8t� |J�� �k6�+k^Hv�J8�Cr�c�F��y�5k�W�#� ���g�5���xk����HI�Q�҄�(դܥ��є1Y�|�t��(���� �[�l��|I���BS��f�^HfYF.qQ�l%Y�q�*�1�+ Z3��s�V�B� ��)b�(�H�h�Xf��H��E �Ȅ���C#�*�C) �RW��s�����684� x��@���|I�4������}�G��� �KyX��ؒO�~� ����C ^4�1��w@��� -����:�zf�����{#j�_���%���;��|G,׃�X�E f��=�Z�.;'��ե}LV_�����W3� ;���w�K���r9W��t+a1�L� ���9�# B�[j��q���֨�W����?��� 6������]>�ކx�=t�g��� g�x�� �_��&�� �� �E�2�����1��s�^�[��] �^��B���yC�}>i��?-�ʵ +�f�c(��;�"�����=������+��9_�S��5�W�RrQ�34�rHa�]ۚT�8�v6Q[�G WE�n��|B���o�^��� i��,���&�%��Y��M��Iy�j3o#O�� c��� ο�ex����c�48�<9�B�i�mgU�ׯ� ~ �(��r#wv� �[iQK!���\���G� �}i�C��ߋ�l:�>�v�Ae� ���>!��Z��� d�m--�|�-��_�~7}'���k��u�g���}n��F�o�FR�3:�s���(��YՄ�.lN/gN��ǂF,��,U $� ] &� QT� 2��dr�yg<��e�8Ɯ��,T)N�l6 ?iR�EW�LQE Q]��< �O��3��#bڏ��Q���i��p�^R^{��_��5��t�R�����H��0�\N;��`�U�c1���p�j�Z��N"�iP�F�S�J�j�4��)�S��M� V+ ���q���< جV&��J� ��*��֩6�N�*P�J��Q�"��H�$� �]|��?5��Z͡m ��Sh�yS1^x�Y�1�� ���: ̯2� �\B��m����_�h >xW᷇@��@�U�� B)��j�α�܀X�u �&�#g���g����h��Z� k|�� �y���H�y�e,ۈ�SjQ����M�iƤ}ڔ�4i����Z88V��I �Ǎ�#��C�,�麋(��p���T�\ �,4� kN�:�LFe^���[:<�4�¿��)�� <�z�➑fS�?a3_�HD>6Ҡ� Z� �u�g���0���E�lƿ�� �#ඍ��?�� �+{��� ��iP��Q���h��� �H���QH�%ƕyj��8a��φ��/�l� <��p�I��پ9p�r��3 -\N_)JJ�9bi�'`���G�O� 2��9����q8)K�q�)s�#w9�ؚX|�1�]J��T��n���]��-�x#ĺ�<O�O���Ú�ޑ�� �-�l�h�P�),.TKoq<6��I ��s��,ס_ ^�F� ��R�z�*u�֣7N�*���ԧ8����%$�G�?B� U 8�5Zx�>"�:�z�g�kQ�R�ZU �*S� Fp�[��%(��aEVF�EP���Y�q���Z�Z�Kyt�es�ޫ�;��K�]�� �}�\L�q�h�fx&i�-% �K� O�𧋼1�O�G���/Ğ �!Xj�E�W�s�ry�11\B���c���^ ��� ��S�_���Q�o��5�|-4Ώ{gk2\�ڙA���Я��"����,��O���\x'�μ:�ax_�px�&�L*� �� �Y�G�[a���N3 %���X��j�h� �a�R��'Ư��M�&;�'��p�b���kқ��C��� 3��c�?{��Q��$�W�OR�*_�m�?�+��.m�y���>.h£^�Z�����2�$�x�ŧ<�}���xXc װ'���� ��S� >?է���!��綁�����˾�~fx֩�rʮ*S�f9} E-�)ar�^rW�T1U�ӳj� f?E 0�F��̩�8��g� �U��a�̰��E�|-'彿`*����E�ީ��Y�e���wڎ�s ���� ^k����� x"@^Y��#�Af`k�ſ�V��,^�A�� rb��G�5/����iz�B��o�L������� �c�g�9 |D�ƥ�� (���x�Fn��������� �7���j k95�c����%��\+O4� ˖K X<NM����ⱙ� �SO����K����ϱ� �lj��*����W��o<^"Uq�l�4t�<��|�5��Ne�P��mr?�?�[� o�� [� ��Fo�G�m;� ��-�[�`�]h~,x�-��:�&� ��NA����%W���/� Q���.(�*��] �K.ʰJNP�e�yNn�$ەJ�'S���\Ej� 1���w�� xa��xw�0��AK��؇��k�qQ�7 �� �Ui(ӧS���KJ�5fQE�g݅Q@}!�'������^ ��I|7kr<G�Y�7�o�Mhf�!�E�'��{]�A� ީ �JF�|ࡘ�PY��UPIbN rI< 9&��/�#�m� ���k ��G���zψ��<]hZDq��>m�<S��q-�� �U���o5t�i+�o�ׅ��P�/��p� d5(g<MZQ~�xJT��[�\��o���5(���bi��� ��!<P�ᇇن+ �T��>�|���FV� ]z\���+�T�5G���2���`p�-������(aD�(�@�� j#�DEUTU ��E�IY$���$��[$���n�vޭ��o��w�;ट~j�hn|W�i�e�,Q����#��[�E��D�Ti�,Q�Kqw�Y��̧?ͅgΉ*<r"� ��$n���VGVYYIVVH �_��;�>�aԬ��7�� ����~�T?g���pڟ���h��w���q�y[H�H���˶U� ;��~Ն',�O*�JT+S��|S��c^����l��I���Y8�et�y��/�a�m)a�/ �LB�zU1� �I%�hԴ�\�j/�Z4��:���Օ�A �E��߁EP_@��ߴ7�g�v�2��CH�X� �bY�/h~n����ڝ���!����t�������+��3�ׇ3|�=�1����+�S�`q�yrա^��vi�p�\�֣R3�^��Q� ҩ8K���\����"��Ts �4�T�c�X��R�B��WMN��jQ�NP�B�!Z��V��/�<� 7�}�Ū�Wj��Z�H�]Q�q���K Jذ���# �V3��K����)��� �c�W�^�{R�q_A ۍ+Y�G/� kJ�YjV��[��[i�Y�mt�:~�|"� ��x#V��Ӿ4x?S�#��~��� �8}�D�.��!�-��x��3(m����U��)�ar�<�Q��%�!J�*����fUI�0�Ԫe���J�l�ӡF����� ��O�O�7�p% �a�s����Pt�e��ma���P��<NY��Yή ���E|�����c�L1Ϧ|n���*x�Z��S�ㇶ�R���7���?����[���� ���m��?��� ��,u;����� ��+�Z� p^'��?�# ���9�UW�k�hb�O���sX�k��<g��}S�<OC��j�kKͷ/��59�Ӗ�G�U[��-2��Qԯ-t�>��[��눭,��`F�{����8-��ZIf��8�K;��_�?�)�O[��x =o⦸��閗 ��N�o5�r�+� q�]+D�b�g�� ��ߵ��_�i,�U�&���Ki�_ y� C�]Ot�^�ב�GY�[��`�4�}��v��� �S�a���s<o���42�� �m:��e��a�tT�S���JIFXxF^�?�xs�Y�/��4+�9un �\�*��}�� �t����Ȧ�c�Vqi�X��0�6㉜���� �� �au5_���֣,v҉�� |Q�̂i�9�����M n7E'�� 3)vУ�}�Y��fvgvfvb��K33 �3 �ĒI'$�i�W���7��Y�{<��q��PS��e�u:Y^Q�������\��Թb�W�:��T�b+�p�/�c�φ|)�vE ���>�3p���X���o��\V'0���q撣B�)apќ㇡MN|�Q_���Q@Q@ � �H�� �x� �ß�)�~�W��+�B� ?� �� J|k_������p_�}�o�k3�~�U� ��O���?��d�����G/� �,��� N�M~B�����G/� �,��� N�M~B��� ��� ���9���_џ�Lo � � m� �pQE~~�QE {�� %� �o�� ���h��o��A�<��� e����%[����?��� ������N?�)���9���)^(��� ����mR�ukV��ӵk9�o# A����% k�*+�"����Z�C�'�? ��o� kW:r��i��䋍'W�"�W��ԭ����Wë�}W� ��p�������;6���x���<ͨ�9eymu�� K?�nf�폴��/&��T��Qk�>�>U�N��yN��x#�8ʴ�F���=�Py�(��ԩ��9�%&�0�sҌ����|O���o[�slB���հt�U�� Д��U������j�mW����%K� ��+��?�`��( �E�S�K� �w�|B�E���4;��\���T�� ����3Q�t0�I)sm,�[�E�TW^ ����L�.�W�f M f ��*X�.+R5hW�V JiT�g 'u$�ɏ���L/-�p�q� ~ ���Ӎ\>' ��*U�V�4�:ui�P�Z�M����Fx���D (��Y�6i ,����RD9�e�L�d�M'W�%���Ym���lm>������ �"�e��~ k�� ���TOnC�^�;#O��2��Դ���^E,,� ��<0� ���� $�]�"��@��� |lV8 P��O�A5���k�L� ii ��-���=v�Wؿ�?�_J��< !��n����)��?(a2<�I(F� L�p�naY� ��*kI<������ ����<G���f}��<gp�Iλ�a�S�dm�T+a���̰���;��ыY�({/�bJh��W�Z�����wkcwOi{eqե� ��os� �8�$��r���_ױ�g�R���e�FJ�d��i��vkT#�2�� �Q�d�(�8�2���(�5$�M5t�aE�I�I< RM2B��}_K�4�C[� ='Gҭ'��=F�+K +X�[�����"�cVy$��UFI���2�ڿ�� �h.��ci�@���C�R�x�X7 � ���q��[i�u�B��Dw�mr؍� ?i��G�w� <�=�/�� �r�Yx H��X� �ow�mL��ב0Y!�����$H�ӣ�G�����o� �i��a�f^&��p��S���Tqj/9�Quhe�i�έ���^� (�U���W�ˏ|I�aq5�W p�� ⸃6�Tú�{�%�`k*u�:�#uJ�# �O�b�%U4� m�ڄ�ѿ`�ïq�O��N�S,�I��ܼcT�Mݳ���͵�:m��%���ib������(��� %8����6�,ۊx����8�K���R��cJ�M�^� ��ӥ���擧��NRi� ��'��7p�S��VO�� 5*������*% k���*U�b���T�V��b��(����肊(� }BռQ�h��l��u�S�Ѵ�tך��s���`�n��h�!Wv�!A#�� �N�/� 4���}B�%*���t���`0� X����$�E�A��.?'�߳T���7��<�;Kk�#�\^ꌲYk^*Dp[鑴�6�(ޒjj�/�>�m#~��y�9� ��7�<� ��[F�$�V5p�5J�k}f�)G�kN�"i�`�X M98bZ?̏� �4x��0^ d��[,�*�19�JS楈�J�� �]7b�'W)E�C����EK ��(��C��(�� (�� (�� (�� (�� +�>?��� d��?����z�y'��! � �|G� �;Y� �?��/�f� ��� � � �Mÿ�=�?�a�?��(����� (�� (��?��&g��֑� c��?� ����&g��֑� c��?� ����� �4 ��� ��H�N�� �X��T(���H��(�� �C�� �Q�� b��� �&�_�uR?�'�������I4J�[����p���o�"0���O���G� &ߊ?�� �" (�����Т�( ��C�� �P�3� b��� �6�_�}R ��������/�I���� ���!�_���O�/��~� �� � � �(�� � 1�(��-� ��ɠ�Z� {���� _iWſ�P�4 �_�x� VW����� ��x�� f� �����Oм$� ���� � .?�(����� (�� (��?�/� �M����� � D�:�q������ �=п�A������ �!8+��. � �> � ���K�4� ���� �q� �}���� �Ey���u/�4�(s��͗(����d/�8�M�e} ���xf��k/[�t�i����z����\iڮ��@�6W�7q476�0H%�Xݕ��|�|�� ��.p�|�1q�fXiO�ʧ�[*̹9T���W��� � ��j<�!ɉ��R��<U�|$���\���q1�?��G Y�[��⛼ic��n�����槆�bh�4���/�& ꗞ6�E���{R���]�>���h����K�4� �5�f�V�Ǩ�y�?�� �˃8����o q>_S/��S٧,>/)IQ�`1P�`�*.Tk�GiS�u�ե�3��ˇ�� �q/ c��f6�G��F1u�8�s��p�J5�O�jS�J)U�EW� PQE QE QE QE QE QS[��^\Aii�WWSEommo�qqq;�P�1�I4�H� QF��;*"� SIɨ�9JM(�&�m�$����KV�ڊr�I$�m�$�m��Ij��lQK<��rM4�$P�4��,�8�w�܅DPY��PI��O� �E?�2~#��OU��� =;� /�<9q�u�9��H�7�j����0j^���7�� ¾m/��m2)|q�+��2�X� ��Z��`����6Gt~ Ȟ]��4o�� J>��Gj�9,/��w�ts���1��ڮOJ�-���њ�<ֵ)8��\�u)ʵx�|���m�'���8�8�x �dp��=�Խ,�����V��L��X�c1pn9�XF� <9� QE��Q@ ���P�� _�Z4�� ��~��x�E��7>3��%ʹ1��^#�`R-� ��J�>35Ն�i/� ���uz�_�?�?�6�6���~��jR��/ �>�`� io<I�[H���$;��4(Wu����b5��gy��;bsz��8*���*�Y�a);�>�{�Ђ�\b�o�a)�S���1�+�K���_�C��X/ 8� z�p�)�b�(����ȳ*�iR�9�e���C�*ӎ�V�M�����YJ���� ��8*���d %���-p��( ��( ��( ��( ��( ��( ���-��?a}S���7❅ޓ��h��&a-��� H�2$ �����樅&��=%�y�/��n�O8��\/��3 ���Z��/�FQ�l�1�(�8l I9�jS�7 zu�5hѩ� q�<9��c8�����0�q�J<��f�FN�_�aܣ,N3��)�S��|EJ8jU�S�?�߲�/մߏ_4��������� k�r��ė0ʿ>��\��4�S�!��$Z���U����,�4�6���O������;k;;;X� k[[hU!����(a�8�EDUU Z��O� �? �K �yM�8�����y�P�f�����M^N������)�8l<b��ש��[�r�_���~,�q m|6 �2\� L>Q�Br�,<$�U\EV�|n)�2��g'R� (�QE~�~f���/�� �_�W�����Z��W�� x�ɠ���)�v* ��^�����(c5�ĒD�y��Eyy�K�q Q��9��?*Ͱ��8�%d�+a��j�B�n�J�7�j�iN!/S$γ> ���&��f�N.�;���:8�S�i�5)��h�R�Z��J�'Nr��9�k���<�^���s��$��6��i��x��,R��Z]B�]��B�oyg4V�Iѻr��(~ڿ�֛�D�xx��q��|7d��7�yv־,�b�(�ֳp@X�WgmS�����K[�[ �&��qu�Z�w�Z]���hדi����[�k}ayn�&���UW�ՇYJ�FV?�_�~ g~q-Lx����cV�^ �\?w�ç��X�B*� ����h*�Q�Ђ�UF �w��2d�.��<e Q�q._J�.#Ȕ� y�ĵ��$f�J�V2i� Z�td儯7^��<�(��?f (�� (�� (�� (�� (�� )� �F�D��!h�P�ȡ��28ʲ�A"�M���i��V`��֩�֨(��@QE ~��"��+��� �Ƶ�a_�� �H�� �x� �ß�)�~�W��R� �����������W� '?�� � �)� �?�V� � س��:�5� _�_�V� � س��:�5� _��o�O� � �fQ� ��N�F�1�� `y���Y�QE�9��QE�?���� ���X~� �i�W��_��� %� �o�� ���h��o�O�� �[�?��� 꺩�n�8� ��O����յ��ŕ�7vwpKkuksMosmqE=��ȭ ���r�"�H���T�S�_� )'%(�5(�t�Vi��Mh�ѣ�iIũE��-8�6�i�4֩��kT������ g���<3gqq�����˵L�ԥ�qq� Fs����I6�q;o�4�(e��ӵ���x����=o� 5�-�� ���� �FT����L����u����㹳��+�$IcV �G�]�$x�j�3K��� 5��¾2Xr��SB��DV��J�N��5�"{�8)K� ?���J� q\ �c8ۄ0S���yV�`��s� �+��:qM��V_�X��� rX ��}N�'�K�6}!0�u��8+����}�c13Q���Bѩ �iK;�J?�v�Ll"��=���<7ȔQE ׁEPEP����_��}� �����e��u��]2�L�uޒ&m2���I�y�����(��i�°K��UTU�O�:I�� i�4K9%>�3I#ug5���'�<w�tV��ϊr\,v�ey�i��/����� �g��^ �/Vx� ��αR���9^7� �k������ާ� ��u�(�$�ih���_����:,�Z��ᢒ7� � |}���9m�m�O�>!��"]*��:�h���Ē�k}$dpv� �/@yy����ў ;�~-Ͱ�N3�f<E�b��/ _:}W���FS�� �c��8'��L�q9e8LLd�kC �] ���QE|i�!EPEP_Z~�߲�Jx�+I#��~ xr{k� ��5)�ط���]Z95�]Q���M6����A���ه�S���+�u�Ң�C�.�u���V��6��>��+lMW�������T�;�J[kw��-|.�_�σ� �<�=&=+A�"�|�^�7��f��]�G��/�Q%�ˀ8�#�� {x��~�G�w�َ�8� [ �x�:uc*5x�B�XK��eP� � *������E|��+� ���/�p� ���� AҩR��V� a���nh<�t�͗`ewK��dU����?�h��� �wN��4- O�Ҵ�2�?*��O��-�m�NN��E]�Y���fvf:�W��[����?c��� �y�&��2���6�7� ��x#�7��D��6�'�N�����V���N������NP2��{r?պT�P�N� t�ѣN�ѥӥJ�8�S�N��)� F�Q�R�RI#���V�z�+V�R�j�'V�Z��J�jԓ�J�*M�N��ܧ97)I��m�� ��%>$�ƿ�To�z~��|^��| �K�/$Ӵ�K�G��� ��~��E \�c�^x��]���v��[[I,� ���0Z�� �}?�~-дxS� �g�o ��N��4x{�G�A�hZ摨@�V�����Ο�i���Gqg}eq5��$������(��� 5� ���b ~�����M�O�G�a��O�~����Eү��SL�f���4�|Q�j�U���jW�t�w���Z����׳��)���� @ֿট~(������o� � Zh !Y:#�?ĺ$Z���I z����PM�jw�t����X|���. 1�~��P�\[�[�ww<6����qssq"Cooo 4�O<�2�1F�$�Hʑ��3����S���������υ � �? 4�x�O�y�x�/���-g�6Z��5}s�;ƺu�j������Vv6��\�I Q����E QE QE W�|~� ���'��C�����O���B>5� �$��� �v�^�3�_�"� �_�=�� ����{���#TQE����QE QE G��L�5�#��?�l�_���L�5�#��?�l�_�?�h<6� �7!� � '���o���?���:�QE���pQE��� &����;� RM���nO�5 �� �/i��h���W���� ����Da��}����Џ�M��o�� �DQE ١EP_ԇ�5� &��g��K� Rmr�����?a��5�?�/�_��k���� � ��� �C�}���_M�6�/� e�� T9�Q_��bQ@|[� � �A������ �ex:�ү��h?��� ���W�-� ɪ�3�� �;���xI� 'W�?�8 � �\24QE�'��QE QE V_��� �� �'���5�u|�!ɱ�� �{��_GW��?�BpW��\9� �|���<i� eg� ��QE}i�eK� V��L�,�u 7P��� O�������6�����t� �y�v�heG�Hّԩ"�j�&������g[W����{��/�b�=d�_]\9:��72�z�Q S �s�y��m���lj>���?�O�9��S�Y�� (f�Mj�)T�b�'���_ ^�x�X:�%:t�O�o �S� 3��^��R���2�1ju��ڍ7x���T�����Ύ3�5F�aR�*W��]�֛��]�ڍ�Ķ����Z^��@�9���n9��!�Y%�h�H�u ���U�w��~ ~Ж�M�?}�� ��� 0�~(��aK��&kmf��i�Z��eş�d4~6�f� �i|q�}%ޥ�i�g�Q��?�e]3Ŷ� �]xj����D�����66���GĿ��� W�ɰu8ۇ��:x��9�t)-R�28ʮ2�n�W����#�V�/f�ҟ ��� q�,>9�S�!��*`3�D!��~y(���Q�,z�b�7�J�d���9��]kB�7�\h�"ѵ]W�m�z^����z���6\Y_C�-��d�O�����:�jN�js�V�� ��BP�Nqv�' %(N-5(�&��W?��U�Z�+Q� ���5)ե(ԧRJQ�'�8I4�(��i��QE�Q@Q@�_��Q��~4�>� �f�V)�4�:S��;c �Z�Ǒ��hr?y��Z������C� Y4�z�ǯGen L��U��^IѾϬx�xM���m�KK�,lZ�\�� ��'� "x�^�8_��،�S:�Ӗ#��iʦg�P�Օ5�K�x�[��� m�� 5��<��IqG`p��G�6k ��m^�Y�s�R�G���X|"��A&������2x� �9�ơ�MZB�rm��U�����s�t�9 h��%����Mp�� �� x+���ŒYx�⿔ uv��B�Ș� �\��`1�_�� �,`���� �P\}�� ᷁>�z�¿|-��SB��}�K���B�F�C%��~ꪲ��77W��Q$���9���o�<7���#�G��%Z�E��%��%<� Ys�1t��<�Ջ�*a0� �R����/҇��G���8v�~� �ԫЅd�ꋺp�1t_& V? Y���5)���Ԝc�(��d(�� (�� (�� ���?���&��߆ �x/�t�e֣f� x����v�����:լ2C{1c�ZK4�� ���ߍ�����^?�֩�X���jp��K2�ycr�KMJ�r�m� �l� &���2��������ğ �&Ӈ�֒]F��zT�(V��{V�RҮHU-��>r/�p%��m���7�O�<@���.���N,��[O�Id�"Wr���Ќ�e�ʲ����T�Ƭ��bp8�EYb���_J�#� 8^ ��8�*�J p�X� o�x�F� ^Q��`�Gݥ��է*QP���a���E~�|m� �Xx�G��Y��h|Y���O��{]'Đ/%m�x%����xQO�� e��,ߘ�9�g�ᖦt� � �/��E��]��w���i�r�,����Osn㔕�5�tqDž xu��.+�����)洩<fK��� � �pnSV��R�<T��B����pG���& �S�2�~"P穕U��y���U�W��(��.�:U0�q��^�W3�袊�� (�� (�� (�� xS� 3�!�<#��s���<�/�U�� �]�ka�lRF� A�05� �U����j�1�thP�:��ԓ�aN�5)�rzF1��z$e^� 5��MjXz`�V�^�)Q�N*�J� aEj�)(��9���4=kĺ�����'Q�5�R�-4�'I���5�3� K;X帞B;c��P�p�H�#�/� ���G��~*�6_ �>�%�L o�����ؖ�������|�GR���B<�B� ~����| �~�����[��j^,�Jj~+Ք`����D�oo#*�i�\:~�$Q"X��s�C��?�N5���q |��q�LFmB_�x�Z7 G)S�Q�����< 8�^֔1\����|K�Wxy�t�. �C���*P�C)��I���S��q�L=XEݺYb�T���� ��c��)�6`�e�<�D[����b��~�$Wzu��D�M�K�ZKmNTl7�#�2K�|�5;�B9n4ȿa!�+x����#Ha�X��(�$qEH�""(TP@ ��� J�<�τ</�VK�yj�B�$�!ƾk�b)��b3 g$%VK�n� p���s�8\=�I� � !x���'gO:���eO� ��C*�hM��v�q�r�U�RUqx�K��(E��(��>(�� (�� +�_ڧ�4� �'���C�?��}�������<w�B���<Sk��4�V��H{9f�m��TW��G d g��8{���6m�c��[ ���g�<F � kaqT$��b��)ף?z�H��� qN����8k3��9�|�qXy/z�҆"�Ԩ�p��䯅�B� �jS�?���� >%� �,���ử �S�ꑆ��u�h� m�tAmVF� c��2$:�����Wɫ��| �@�7�x����f�g �@���۳:� �m�����ϙo<O��ɏ���J�K�o5���-M;y�e�G���{4<���x���Ȑ��Z�V7��C\눹a�o���:�� ���;�.-�/:��kԣC�04�~�){ &oGᩅ� Q�N9t�u%���_���> ���<C� �҅9f�i֯Ø�K�I�V�������#M'9f0MS���� g/�� d�x� ᷉�[(�k�Y [�n��z;_�eÈ��'U#̉@�:�@�2��#�T��0�1�]��<#���^� N�XꞮ}뼯8�s� <�%���Y^�7,�a��Z����F�ZRѧ���(���D(�� (���^�W���<!��:��vi� �5 f��;T��N���)?�P(�$� }�� ��A���_��C���?��c�@�62�����u�6�֣�H0rG˟��_�ۍ���|/��ϒU�X*�FWK��1���0��',V&�Sݟ!�> pWЖ#���'�҇<hc1��:�R��.]I��1r���\5i������-��?�,��y����冣��1�7��=��a�o D�(m��˺�|?r0���7��̫��R�uk/�߁_�g���SYkm�K�Ɩ�9��?�b�����0|����:[$�Ims<z��j�0�+�j����o ���T��qӡ8b0�!�Tu�N�Z�y�%b� /�e�,-W��N Up�� �s�,� ��<-�b�P�Я�م5C��8��y}�<,� �0�8�i)I���Ɩ& �G��z�M�D��4� H�> i�^�av�V �'����J���Gh�UT +�j�k� %� 'w�C��|� �����-x�R�WĚT� t���S�N�T!N�qф!��1J1�RQI$�G����*U��j�g:�*p' T�R��9Ԝ� �9�M�S����&ܛm��QE��QE�!� �� ��Ǐ��9� ҟ��~'� �"��+��� �Ƶ�a_�?�K�LG� ��&� ֳ<?��_��^4� �\3� ��H~ � �[��r�1� bϋ?����-~��[��r�1� bϋ?����-� I��>|� a�G���9���� ��������gEW���EP��� �_�� �a�g� ���_�$ ���� ���X~� �i�W��_�?�c�In<� ��W� ����� ���?�C��QE�� �`��� x[Ś6��k6�g����]Y�� �F��7T� �)=���qo$S� ��Ee^� M�|MX�=zs�^�zq�F��p�J�*�P�N�%(N���8�&�F�k��V���ի��P� �+ќ�V�Z���եV3�R�� �JP�R�M&~~Կ�N |?�Q��5x n� 7�x��1r���|S�B8��յ�x�iqi��W����9"�� 9cv�H�VI#� WGF�сVV ���E������n�m_G ��uf 7�[��W3��}zţm7�HE�[�U�Ak��'#�S�ߡ�4��ϼ,�a��UW:�O RT� �/�lu�,��ߓ��L��ib�zq���<$�bc2�X\�� >#5�RP�C���S4�N6� s��#��+{LvP�8Ú� ��:��y����� �>�� �t�~+�f� ���:�p �w�&w�~��$šɯ��*IQ���yq��vWzu��� ݍ���w��/ފ���#���DV �qWqwc^_Ŝ=�dX�iF�װ�� ˼�x�s���՟�px�����.�~�l�8S�r�� �T��&�a���3>Lf���X�*���TT��+叩 (�� (�� (�� +[D�u�jV�?�4][���m���M:�U�n[ m����fl�1 Ly��w� ���� �� ;? �9)G��к��灰si����}�x��KF��ᅬ���4�Z�� ��NuN�l&K����31��(��V&�uZꏐ��>���<g�&W�S�u)���b�.��q��h��&��m�&~v� ��I<�Ȑ� (��4�0H�4 �I#�DDR��*�H���0�7<_��t� �r�P�7� ����6�4�\:���o i��N�* b��L�-�!���#�8�#�[� �c`I�y���ćJ_&-?@��:�;k� o&�����5���/��/ʪ��qX|�Mµ ˧9e�&��lsT��N/��,4(���W�a�*o�Cş�.?5���/��2|%E:5��0�#�U�$�/� u)e�J���L�cy&�K��a���|3�Oi��~��xwú5���N�n����Y�j��i Muu;�uwq$�7SM<�H�W�E 0�(ᰴia��zT�a��) iEB�4��ӥJ�#S���Q�I$ W�_^�'Z�'��R�#^��W�Z���֭V��J�jNR�J���97)6�aEV�G� a� ɲ�� �]�G� �� Q���%������ �S�� ��@�� �;�M��X� ���?�W��~��/�� �������WZ -� �u,��~ԟ�t�^Y����r�����h�"X���D���Ox�F]�5�� ՚� y� ��kw� ~4k>%�U�a}+���o�V �����; ���:\�>�H�d�V�n��) �:�NW�;� �O��O�+ٿ�翁~"�[�K�I� ���0h�%�|3��,�(�_�| ��P�/��� m���]�Q��Vk#��~��s�j��eO�' ��[JԿ��u�� �> h��n��>%Z��x���T>}����ƚō�#}��e� �*��� ��7��5�5��C�� ��s::�C��x�H�c��|k� ��,&8��Q�N�o]�z�� ���{�� �f�� o��Ὲ< �� mt���_ j� t 7��=;P1F�>| ��K7�H� oZ����4�I<���t�����t-��KѴ_�z�I�4�(� =;L�~"������!����+x"@8�DP ���E QE QE TV��ַ6W��^Y^A5�ݥ�1�Z�Z�F��[\�̯�O�SC*4r�̎��A(�$��d��$�(�]I5f�z4֍= e(�(�E�FQm8��kT��5�g� ��G����Exo� ��¢�Q� D���^� �eW����� Л*� �v� ��/��?�s� �p� �� �E����"�7� ��?�Q|(� �a�� � � �(��� �M��� �|�� ۹�s_�8b� �p¢�Q� D���^� �e ��0�y� �W�� �YE`��&ʿ�݃� �>K����9�� 1���m D��� Ѵ� NI$�t�N��,�YH2ʶ�P� �R��{��X�Z�Q^�*T�Ӆ*4�J�8�S�J�N�"��J1�V�1I%�G�R�J�'V�IիRNu*T��Rs���9ɹJM��&�{���*� (��(�Zf����i�Ɲc�i�h#�ӵ+K{��WY.-.���dY$ ,l����¢�Q� D���^� �eW'-˱��Lf���F�' B��ܔ#*��%&�ʝ�۵�ۆ̳ %O���i�\�^�%6�\�S�\�c��쒽��T_ ?�|<� �+������& ?��� +(��� �r?�e_�n�� �%� ۹�s_�8b� �p¢�Q� D���^� �e ��0�y� �W�� �YE`��&ʿ�݃� �>K����9�� 1��?�Q|(� �a�� � � �]3K�t[}/GӬt�6�Y-4�2������FK{KXⷅZGyc�Awf#sJ+� ���)ʦ��T�y%<6� �O�R�Nq�b�[�❮�ω̳ d#O����\�'^�#4�T���T�e%̕�ڽ�/QE�qQ@gj�F��XO�k�^���w^W�t�Z��Q���&�� >��)���n!�x���˚(�L:+����XN�XB�:��:��EN!4�8NN2���e&��M4˧R�))ΝJs�Ju)�P�9��Bp�Z�g%(�-8��i��� �E����"�7� ��?�Q|(� �a�� � � �+��� �M��� �|��z_۹�s_�8b� �p¢�Q� D���^� �e ��0�y� �W�� �YE`��&ʿ�݃� �>K����9�� 1��?�Q|(� �a�� � � �T_ ?�|<� �+�����?�r?�e_�n�� �%���y� C�� ��\w}��em�iv6�n�e�gaam ���0��ZۤpA8�QG@*�W�ƜcF0�"�B*1�b��c��b�I$�I$�y���)Nr��99NrnR���)JN�R�m��m��B�(�$(�� (�� �c��?�<w�� �����Dӵu��W�k�y��`~e���GV ���i� ���V�M�h^&�%�Ĺ�� %�����c�h|Ie y�`��� ��d�$� ����O��ʜ���exJ��qJ�R�:_\����� ,����?�~��,��:\�O �昺:�n����S���hO]O��� �$v�+H��٪�&I��_�]���vY/��h�O���� �b��� -�.6a��X�5���k�+_�؎ۖ�0��lz�(��.:�:x5�F5�<O R�旲�8�4�{{��}��)�y �< ��0��cxΦ&�)F0��' J�� ���7�����/31?��bO�? �3����� �6�϶� ƺm3� #�)YF���6 �M�xSU��Z���t������|� J�7�=�9J�?ۼKN��oK8���g��G�>+����W����)a��K;^����?��~� �L|1�x�� �q� ��A�4? G) �?nOʱ�F (�nBʭ� T����|��Y|/�<E�BT���7�-iq��L��@GR7�H���ࢿ�� |#�®S� µ&�,F?�M)-�K���+Ө���*F{�ڳ��>��ž%��f�}�S�U5W�Ŭ� V/xU�d��*A� ϹӔ:�W�i�U�~�ci�XZ�"��������%� �� 0�;$h�; �E��cF0�cB*0�b��*ьb����I$����R��)�R��')JM�R���)IݹI��m���QED�Q@Q@Q@Q@Q@fj�.�� >}'_�t�sK�]�:n�ak�i� ����b��e��$l9�����֧:Ui*��*S�:u!%iBp�q�d�R��M;5b�ԩF�*Ҝ�U�(ΝJr�*S�]�8N-J2�I�Qi���ϑ�s�~�^9y� ��~���7���8���:42���y]�' w���?��C� ��0�ԒcOh:7� z}: o�v�ǩ����=�#��$�:����=�6�V�p�2:�$��J� l���>�%'7�G���/p�i��@� cO�4��X�y�qZ(S����iӦ���"���<�Q� �Ix�&a�|b��d�mG�zƔ�;n[k�`)�� ��� ��˻ �#�O��Po��x}��?��E1q ��`3 �0�+�F�����T��Ӛ�q9~'��x��?N�/���ISRr����]���O(�~�l��%>"��5?�~ �L��a�k���j�6������W�x{� !�h 6�g�j���xKN� z�wZ���@}�f=L}���E�o����2�c8*�&�.Go��-ZW{�a眺�T�%�~y�?H�pU����\5��~�%�ul�nZ�ɕzo]�R/�c�?�N�o�� �~�<oyR�>5� ��e�S.�� D� �;�2h��;�؞�o�|�.��� �{R�#N�捧�D��v�ӭ��y0NdugbIf$�J+� �8�8F<�1��E' YV�2� V-Y�l]*K]��n�Y��M� �<E�<eŲ��n)ϳ��sƎg�c1XjR[{ %J� A'�TiSI�k�%Q_V|�QE QE QE QE QE QE �X �2<A�8 ��������,�+�C�=J�rLڔ^ �ҵy�g&]cG��Ts�H�xpI#�E��y>Q���s�e��_�l�����G��U*��[����Y�f�-�d٦e��t� i�1ج} �ﰵiT��� �Ϛ�k�S�]���^"���N��z����v.�u��</� �1\<��J���V,�� ūpNvC�o ��`n<;����E~y��7��d�J��d��ղ|. 7/E�а�8�����G�~-�R���q���˽Ld��93KM� �^~��.�u7čeA�R�]�H��t�J����^��o�w�V��-����S�A2���X�r�����.��i���;4����h��r��*��F�_��ѭ�+��2�Uzmm*u�T+է/8N/���`�S7�*Y��\_Z�էB�a��Qv�C ^�*��p�>��<?��j�=/Ú&��2/�Zv����V1���XC�p �c V�W蔩R�NhӧF�8�S�J�N�"��J1�Z(�$���Z��N�j�+U�':�j�U*T��S�۔���6�VQEhfQ�L�ndi�4��ln�kKydm�*�w���Pd� �*/�]��:g� Z� �(�� ���m��t��oV�q�m��Uz�I*�RZ$�M$���OKY}�?�to��k� ƨ��ѿ����� ��_W� ϊ?�* ����_�V� ��� ?%��.�� @�3� -�� غ7�t� �� �TQG�� �� �� " X�� ?��� ����6�6V{ͥ����h��[���ۿ�Eݷsmݜd㩫TQZF1�Q�c�����vJ�s)JRnRnRv��m�++���$���6W�Z����! ż3��ʌT c8�b��� �?�� �QED�ѓr�R��R��M[M� #^�R�jՌVь��N�P��ѿ����� ��F� �N�� ���j�)}_� >(� ��#��#�� ��� �F� �N�� ���j��]��:g� Z� �(����G� C� ��b?�o�?�HriLn�G����+�����:����ee` � �5�Ep�)�B�z�����\�ԩR�s���9��ޗn�EU�QE QE �^=�E�⍷�~!x¾.UO.�kF���-�<5S�z{`������H݂rQ\��3�U�fX,&a���ka1�j8�5X��C ��/)�����e��Xܷ���_5 ^[ ��/�^��զ��4ω|o� ���|H�\x^�ƿ�\���H��[���zY���Tԝ���nL� |��_�$��`i�� 4 M &(<K�mGCd �K�/R����Y��BQ_�^ } |�ex��p U���\ОU_3�hFRz� �e� ����]?���� 4��O��Lf ��' ֆY�הU��ۛ`q��k����?��<�.���wA9Ν�x�BA�.|j����^{��3eԼ6̭���5B�� [GC�=(����-� �1�h`r�aJ3�Q��:���Kޭ��-���� .� �J�;0��eMJR���۶�����I� ����~T��V�M! ��ed��1����|!� ����x��e�� ;�Oŷ7k� ��x:_���9�ފ+��.�L�F�g�}f��(�{2�t�o� J]^��8�8�%�W���V�I�_Q�kY��LF�_�3� � �#�h��Ƭ� m��| �>�^���/�ݣ7��<� ���$�ϫh�&��D8��#�m|�տ��3�l�9��w��8��#uW�� G� �� �� ���(U��w�ϣ�7� ��уM' JqQz�&� _�y�3���u��ӫ:Q�R�Y ��ܲ���2��Mh��I�;6�o�� ���_�| �X�K_h�v� �:=��-�k�O%��iev%�ى'����� ��`�R���0�Z1P���ѧ��J hңJ0�N+�c���18�V6�LV3_��.z،Mj��՛�U+U��N_ޔ�� (��0 (�� (��?�_�;�M��X� ���?�W��~��/�� �������WZP�� [����I�[� ���M��V���B�����?��e���4_����/ �w1�ex��-���I�X�Y���d�� �g�9e>��F�J%1�E 5��j?���?ioڗXkk�k�ᯃ� �x�Yt�|y-ω|_���"��:��-M� $�{=O�v� xeO��g� y� 'y�6� ٷ� �;ƴQ@ ��PK q�/[ s`n( ( tests/fixtures/circle.pngnu &1i� �PNG IHDR s s �C=� '�IDATx������%�c����yropܳ��a�%B�0����[9�)̜XZZҤ�[&�5j��F��zk�s��_+� �� ����o߿�?�����mݕ�n�A��_v<2�=�]�]�Lf:�9��c�� �[�;g;}oy�-�b �\W���6�0����\�+�4���d�!Yk�U��b��RdG�$X慚�ׯ_畧��{��'��w�����s�ȭ=����r�+ĵn��a:�f�|��L=��wٹm[/���K[���n�է���J�6��m���i������ �UM�P)5M��b�Pi U�G���ϟ���=\�9�A -��T:lDP�I@� ��P;Bլ J�R�L���t�-� �(rY���*���?C���v�tҝ��p��6B � 9ͨN%�bhؠ@��DU�nҔ �MɌ�d��Xd R+e��c'������M �����t������6+ 8��B��PT;�VH��dD���V,m!f@� w�;���U xt��Fi<2@��c5�j� aıh���r,3y���NJ���'��G���g �ħ������I1�E��m*�`!)��$��2�,��}�}S�>���m���|����7I a��H�+1�j����\j�w !� o�}g'�y�9\sx| ��1p{#7?ʸ�%y_ Ǒu}�{�=��mٱ 0���$�1-3|������ �̼a�8��$�ږC�U��HY�I�4v�tϩ���6�}X]}gǎ (m�m�S9�e��v��7MLM^����H��$LD��Ȥ��!N�@S�A�!�8�2 �s��ҏ�_ ��9���{�}���DQ�R�W��8]/��� �U@c 0C5 ��V�a��������W��e���\^�z��7ƛ�oN� ��R@u�0PT B�AQ�0 �@�KW��(�@��yz�3.<#�_:�ʗ~��y��?�_��xM���<\�� g?�lx��m8�W$�}�7�r��W�]W�Z��.e�?���G��%��*�J���"#Y�^*�` ����.w�g� ��˕b%L7��ߵJ�}��y�qӛ�_�C5<���]bF"�B�`�tm�@>�m���vf�o�8� (�"*����U�d ��4o0�ԒbE�\�% ˬ_�0qd��v?���"Y�����߭�?��1� �DV$ !)B6����� ț~��O�}���Ww����J:%,T�� ���^� �z��� �h~���|Ʋ}�*B?�S�qQ�is�����������%/Sdu$� �D�VBd���{��2�qޤ��/>v�� z��;'�&FR� BBD TٌS!EL@Q� �fV� ʲDs�i��E��Qe��W�m��K�� �cۙ����@\�l���7��[ �훧��ݺm�= � H@ev���B+a(T�u�=��H_��!=�*�\"��y����_m�� M�~6�8 ��f�L`� r��'���{��3Q��:}��D�"$@�V~�#a4z*K!z$�${�u�� �K�K�=���~3�����q_���#���i#9��n8'2M����D�ӟ(����� _�:� 3�SWH%� ��U5 �t�P��-@��5kc�_\�L�g1��D6�y������:�!�T�:TUC� ������ء��v�e��_�p���O4� ʲ�B�|h5��Vr%H�B��L br|��Su������>2)�5���I{�7(F�(i�2"dc8��\�XC6��[f�w��p��_��>� [��z�BJ � �/��P1�����f~�c���o|�i^�[�����O4��IHG<zM�'��� ��kqs>�y_�7&�n�苊N�Ʃ��($ B��#YMT�J� . o�z�f������YA&��x#�|���O|��7E# ���� 1�Cr�T >��O��8��s�;�ķWn���z�A�ʗVfWH��! �SsJs�Xi�-��������Y25����z�+���l {�឴��"�T*�v�8�Y���=/c�����5�Y)ku_�x3C��f�ٜ��N�90��=�~�5�~�~��MԚB��k�Ob8a��9�:� ����O���^��X�͊��unEe��3������}�I�V ��5o�~��U�1:"j�F�� �K8�LdD���"{+��ۯz����;U�*�*A��(T�@1�$x�`,-��ox>�=�d�� ��76��)8 ��OS�C�CQu��N��~�ځ'��ms3 T����P��[U� ,�<� D(������X�9żq)_�[��� �G�OV��n̜�U!n$?jg?��߿s��}غm� �L��f��U PV� Ɛ91����U�� e2)���9�^�k�IRc����yM�oH�f#�8��$7V�`�<7�^�� ʕcw�n�9�*���?#)$ ! �Qj�~rv2,�-�Χ�|�b�����6}�E����%���'�R��43�q�K��AVc|��ߨ Z,�(�I *�) � �� kA�&��" [\ZtzTe�3��*��|�������^�8�ӐH�=Z���ɇW$��ZFH��9x�� ��߾}�MT!0(&TP@�� ��1 mm��V���te���YOk����W�p"ST6,�!�b>��A'� ���l� ^��Ԛ EU �q�)R��rUͅp tU�O�{T�9c����77��z2)h���b)FT�13Y�L��#� ��� ���7M��m������J����YP�C�V6�aن�N9�*O�����p�9������H�k��Q%7� �3�3�)_�ؗ 9|dX�Z���g� �y s�f ������s����� ����Y�d<z z����Hq r��q�Q� ��Z�����"A � T5u�P��H�)�˚��}]�6x��Ա� ��D�������YL͉5U��-��H<���%�B���}�\��"UB Q ���f�Ӑ ����:����y<d^��$|ŏ9��ћ�)����CH�����r��2�� ��o��w��m�D V�E!�.3�<�fS��h6*S{�dR��W;d�[�(!���O�hc:5� ي�����g��-�\YnM ��S��T� ��?����E}�9���IPf>����W�0:��2���C��r��U���[C�j�]��;��pF�bg�3Ju��:%��r�Y��~�x"d�6��ǟ(��aDa8�!lvu@�� �'e��E�;����}�ر�=�B�$�!E�RE�"�, ��2��� ��بd/�o}����%��c�m�$R�� �s`5 �=OF�[���5 �� *D E\�d �2��Pj�ecteJ}��S^�x�$���DJ|�>.�wDɍ�|��Z2������OIPH@(�:@]%`FQ��hY�<\;�*��<�[Bٻ |N."�-Z�xd��@b�0�A�g��%�������s�>@�V QqFqP�$� E�/�7N�O I�/��W��F'l�"z���=Ҋ�`*U���4.�ˋ�(� \=�H��P �� N@�$c�o^��͓�����}]�!2B��!�-NJ�T2��̣�v�/�8 �Nm ���ʒ����J&��"�B =��3��\��8��� i~2��}K�Ó4ܼ�b�`��u�غGWZݝX� ��RMD P�*����PA�$ӊ�L� M���H��# ! i��!�6�G1@,'��;�n����!i A�"UEH-�y�����|���5�� ��t�!�9Ʒ<�K%�k?�%�D��GJG*=�Te ͭ,L���5i�bUΩp*JY �p<z�(��)s�g;#5�OZ7�"&1�`�XQ3Nn2'��ɡ� �Ea2G��X���"$�( PDA�"̧�M�7�S&���H�J�'#��3�l>r[�LIK6<���^��^�l�T~� @ BEH�-�6fѯ9�c��&'�l�,'Q�:,�8��U 2�w���,��O�k��$X� �$�|`�����7�Lۺ�vr��K/ M��i6\�f�ɀ�\W����5oP'bFaE��`P@DDD�̤��i`~>S\vFغ����Ɇyi����ٍ���b�Li4�K~d����C���S �F���<m E@�k[�A@ �tWa�|�]���ܞ�ȸߋwCb���'�;#i&�|�w�a}·Z�)�� $�\+P�" ˱��n�g�/��Z8ɋ�0<U���H�!�T���*�X�K�� �d+�R�7� WT\�HI�� ��/=?]���G�)ST�(���X,�X�4������ VD N �:�Q���ʦ�'@!HHPH�"���"`�>����OA:�';i݅!�a5�f�,N _]@n| #>φ�#fy�� rOw�y-+�v��lP�a���Ҧ�̃�)3�lN7���%��6kqs �-|6K(�qT?9�i- �e��b�GT�a0��� ��a�9nG� �M��ޯC�BRj7�BZ>���ky�W�'��x�:��eE�s ���* ��ԊA�3S�YYڤ�nޤ2m�p-�'�p3�p"c���w"Ʉ�#�5�ʊؙNj�}�2s������&��Q� C0�ҰP,l��. x�� Ԛ��'ӣш�E�� }�k��W&��b*� QeE��3; )Y:�]� � ����~H� 0� ����JA�L��l���� '�c��k�ue����E � jj � ����2��/z|�m�LQ=��;#� �Oƃ�ћ�\ �m��{"���f�������()���H��̼��ЇV�m~�A{����D�i{�l 6V O^�� �X�5/��rL���D�� >��v���+e�fV�a^���yf.�NΆ�X�͇7E����B8��#_�A�~ ��c�L��d��{ߍh6�z��" a�A���J��:BXl-��{��$���#�eJ0!;<�qrcy��sΡ����x�'z.ޔ @ﺴ;7�. ���ǚ����0o>xuY��Y� ̍��,��)W�WQ_�K7{ɦr��`�'0�\'8x����g츎Vc M ̠d�J�XJY��r��1m��p0 e�z��:C1̿EΏ�H$2L옐��ETE 6Z� Q���^��'��K7i�kR�����"��m��~��F0�ո�V��x�քnH��>鰄��#�5Ww���y@6�'d�Ŷ�\J �.���J+I+�J!���all,���� 2BBe��F^�z ���� ���l��� *A�Lx l� 7�!0�k�S�]K��E��2��B���0��� ��>w�Hfvm�^���^��o!��G���ʶHG�LX�kk%�� �C��S,�m���v (a �}E�+dO`EM�t��G���Qf�U}����ci�A\��x�/�E�%Tu�7X�Ϧ����`4rI���sco� JWGuM O��Y���^Yz�C��]��f��ifD ����?h��N�ٜj*G\���+��;"����V-����r�x����C��w CWhE�{ ��łF �`u l6�?,��k���)ۃFQe��6����H. p�����*��+��{�N! �A�np� JG�� B�����c㾇^h h�(dr�63��Ƿ͈^���Ϳ�E�Xd{еy�*?[7�s��� �qt�ݻ���@�H\_�!=-���SX����J��[g���F"� �J3���o����,o��^��w�H��ca��Y��d��?����6�[9\�$P� �wᾭ��^�� ��G!]��(+"%t�±���qA"���]��INS#C���#�q�^�R'%�a��}Z�������n$��� ���?e���G\�F2�'���� t��7� S?]N�Q������jb�>2�`��D�h� R����t;�5 ���`"c��ɓ�F <n �XC{������|(�������V�>��;nU��c�>���U�g$e:qF���C�)�@E^snz_ W�� SZ��V ����%WzR �ՈF�W�Y�~����fk�:60��ڊ�+Q �P��G���7k���0�2q���!"� #�> _0h�l���2���?���W��U���7ď���ԕ�l&��+#�/��_�f�;/y�Yo�HE�TD�Ah�X誕}U����D�� �� ����G"��L3�pu @�JG��/'g'ov�v��۫KKl���[h�ÿrW���im�hk+]��{x�{C~�5G�yɾ� |��BTL *"Q*��¯8���ʞ��n�0��+���́����Ǡ�ofq��l� �ۿ�?{Y �VZ%�'��a��)ē��Q�>{�M����~��O��X�7�' $Y�WZ�P(BGZ}"�R']��E����"�� Qs5�Z7t���b@ B��q������*��ͭ�OF6}Hv���\G�}k�p�����33� ��=����+�u�WUI Z��eWR��z��%� �_�Z����Bc�P �8�8=�1�}�-��_�%mNƉ�mvk����D��'rc��Y������j�ӮS��k���@��� ���$�d��ʲ% ݚ�b,�����M`< ��VXQ!�r�3oQ i?�(���e��nΜz�=�5i��t�:�J�"��IE6�7���I��sw_ +�*k��xE�U~ҷ ����dD;S�fcyy�������6�A:���ec���gVX0 ��!,0 BIe�v�Ԭ�|���'��# ��(�ib����j����嗺���.~�Y�\+��V�A�X��d(W��e�_��� ��呃G�;�\�y�lc9V�� ���9����sk��r-�t����]�삯Ȑ7 q�� !�w]�!�����_i�?���O| ��Y_m�*���ΰjZ3��T7k��jZ+ , �?��?��� �~�vHO$��r@��)�"QUɲ���l��u��_�ߏǙ��0���>�d�%�����b�A����xԺ�s����n 찵 QR ��B�;�&�\�� ڒXo%����@azzڪ��Nf;��Pc�l��� ��:�Z�$�X�x6'''.�.-�^\�/��)� �2���t"i�3n��%BdD�Kxс��o8�K��Ζ���I �jE�Za�"r5Y����t8>Bo9˵]˵8r� ��F�id&��~�v�-�w=��jN1#��V�"ujj�n+{����/�ҡ�>�A4ݼ��� ���f��F�@"�� >�짞���O� �� �3�uCP8��̬X�X.fk��N�=�� �~~�7~��*"SA�����(TE�L����hN��n�8�WI��[��>��{��/����:.z!nf?��;H�$���1�U�ӳ���};��v��g^F ��j>0�$� J�u �J�rɅޢc8��T��x��ؿ�?�ӯ�S�&�8<��'bz�4� :�2����Bu�*J"Jfy����x[�^����#�ٕ��̮ [�$���x��D� W�oɏ�}����]��r����P#� v��y���i�?F �÷2�n{�]�y�nD�dĉ�;�vP�U�qP�p�����32R��J�PThf""<p��.��6�k6|�O6p�� ;���vB�/��wx�.?�tW\xΩo���<�T% �}�G��&3��2�d�˙�ᘓ��V���z�K�K���ۇ�^ ;2q���yt�('� ��z�1S �(���L�:�TD�z 8�����{�+�{���y�X��� î �L7��D!��.�k^_L����m���m[�A%�"n�Pa�L�*�w��s ��C��!,g}���+|Q, [ ��d2�K�~ �?]*MQ ₅L�)�Uu @"U�A�Bo!�g���/�M�y��<G�y_��K �ߣ�<1?��̕�=�@Ｔ�f����>m�?v���^@)J���BH�IP�� � �Ba�����}"���Ŝ��Z����5'���q��\<�dV � �����Sd���{�\-��BF��� U�" �P�f�*���]8���j_Q�]��" ��:�= hL���ٚ �|�.`�U&w~�k�c2��o�:Y��=�nkt�TH�+Q�@���*�P��V�3���aY�XV�m�N5�^�c"R@�Ɍ�9H)�Xi�I���T��Ȍ`G�QԉRP�,�ĮA�����C��<��ݗw:����� l?ۅ���[x|`u������D�]`�(�Z ZGW�\9 d�P�F���z��-��~��;4�lm�P*!"�fJ�{w�#�ru��s#��zx����$���7���:,����7`f� �����e+�njW�ܟ���H"�:e Q��`�ei��U�Y w��� ���Ny(��˫$�� 3�߽���/fP�,0X� �� �j�)� � yiIьX�Y�&���q�V����㗒�&�/L�S��)��y��\]yv-!����gZ�چ_D�N~ ����t���{_(W� )jy�au�aJ��ʂ'�G#z�|����"�>���Aޏ�����jƃei��a�f��n��m�Z7t��@"�=xtW'Y���Q2P�hsZB�1�(-����:��Ti��ۋ��~w���_�v���G�-.o,1�AJ�A�A�e"/��-锖;9u�<��n#}KKߛ��l�W�4��N����ȏ=朥������ݪ�U\Y�̌���!���ke�٪3�I��J �e�μSjS ����A��m�"�lЦ�e� ����If���Q��WHc:b���@��4 ��κ����8f�O � <ei-���� ���' n�pDТ��"h X͚V�$��,-j����g 'i�c�9C��vly�� /J��BC���e�P���}T>X�J D?�}� ���:K� �i 4��K�O �M>�ǩ���G��e3C�Q��Hc���P��2�V` ���4�غ�P[ 9D�d� ��%�� Zm[h�D��7H�;7I�I�h���}� y:v���BJ�:Mg���eY��c.�.���� hsicC� 2�\��2#/V��� ���RTP�B��MXF�Z�V(2.�5d���D�l���%&� �)�����)��#9�A��&Ʋ�zc}#��~�x;?|��b��s����K��tvv��!���T��#X���Hk巕^� �Qf�Y�SEm���HAV��R�� ��+�$9���䜉�L� >����3O��Êap G�Lv�R���_��D�k��S��<����� n}��ӝ,��Y�g�� P�X��� S J-c� ��4�����D�� �\F� I��R�;i�B|�8r$}$| �Ɂ�1G���X��T�k}�O+�2^�� o㏿�#m0�u���h)Kam��43+�� �ʰ����&YmѲ����bG� ��N�E:�����@�L`��$�h����˶0�)`JLL�b 0�zM+����2X�3~��{puiŭm����J� �![`P�\XV`�E�*��D�զTkTb堻d�Ӥ�D�$NfH��}r1m�L�T'N����T�8�/�R?�|�/�2����M�b����933�(1D\�K��`rPǙ C� @�K�Ixv�]� 0��cfBdv0ENY�lk��n��zU�%P�����Nj�c.A��m�W��ͭ r�����fC���i��YEc��=e�H�H'L%��brA�U���X����裇1�U��G�#�.y�� �����o{��c�s�W^}���▬ݤ ��� &N<>?�,.L�ΠN ������ cDA�cF�D�}�tL�C����1{ɾ~ӣ<7�<���� ��s��dm��D.�=� ۸�v� ��0��^��O���E��Z \y:dy�K�����瘯��F�����?�/o�% N��9��v�� ��~(�|[�� IEND�B`�PK q�/[�a*�u u upgrade.txtnu &1i� PK q�/[Q���[ [ � configure.phpnu &1i� PK q�/[�b��� � 8 H provider/customlink/lang/en/communication_customlink.phpnu &1i� PK q�/[L�7$F F 0 h provider/customlink/classes/privacy/provider.phpnu &1i� PK q�/[� �w� � 5 provider/customlink/classes/communication_feature.phpnu &1i� PK q�/[�Ӵv v ! [1 provider/customlink/db/caches.phpnu &1i� PK q�/[�\ӑG G " "6 provider/customlink/db/install.xmlnu &1i� PK q�/[8ʮ�t t B �: provider/customlink/tests/behat/fixtures/custom_link_test_page.phpnu &1i� PK q�/[ 1�8 8 3 �A provider/customlink/tests/behat/custom_link.featurenu &1i� PK q�/[P���� � 8 <U provider/customlink/tests/communication_feature_test.phpnu &1i� PK q�/[����W W �h provider/customlink/version.phpnu &1i� PK q�/[�w��� � ' 3m provider/matrix/classes/matrix_room.phpnu &1i� PK q�/[?�63R R , P| provider/matrix/classes/privacy/provider.phpnu &1i� PK q�/[�*83� � , �� provider/matrix/classes/matrix_constants.phpnu &1i� PK q�/[Z�N�,h ,h 1 �� provider/matrix/classes/communication_feature.phpnu &1i� PK q�/[�í"X X + �� provider/matrix/classes/local/spec/v1p2.phpnu &1i� PK q�/[4qX X + =� provider/matrix/classes/local/spec/v1p5.phpnu &1i� PK q�/[ �A�X X + � provider/matrix/classes/local/spec/v1p4.phpnu &1i� PK q�/[�eg>X X + �� provider/matrix/classes/local/spec/v1p3.phpnu &1i� PK q�/[*� k + V provider/matrix/classes/local/spec/v1p7.phpnu &1i� PK q�/[��'�o o P � provider/matrix/classes/local/spec/features/synapse/invite_member_to_room_v1.phpnu &1i� PK q�/[0�5� � F � provider/matrix/classes/local/spec/features/synapse/create_user_v2.phpnu &1i� PK q�/[±��� � H � provider/matrix/classes/local/spec/features/synapse/get_user_info_v2.phpnu &1i� PK q�/[~�1� � H �! provider/matrix/classes/local/spec/features/synapse/get_room_info_v1.phpnu &1i� PK q�/[��Tà � H ) provider/matrix/classes/local/spec/features/matrix/upload_content_v3.phpnu &1i� PK q�/[q`g� � L '5 provider/matrix/classes/local/spec/features/matrix/update_room_avatar_v3.phpnu &1i� PK q�/[�lv�q q Q ^= provider/matrix/classes/local/spec/features/matrix/remove_member_from_room_v3.phpnu &1i� PK q�/[H��$ $ J PE provider/matrix/classes/local/spec/features/matrix/update_room_name_v3.phpnu &1i� PK q�/[��- - K �L provider/matrix/classes/local/spec/features/matrix/update_room_topic_v3.phpnu &1i� PK q�/[���`v v R �T provider/matrix/classes/local/spec/features/matrix/update_room_power_levels_v3.phpnu &1i� PK q�/[>9� F �` provider/matrix/classes/local/spec/features/matrix/media_create_v1.phpnu &1i� PK q�/[��c� � E g provider/matrix/classes/local/spec/features/matrix/create_room_v3.phpnu &1i� PK q�/['қՍ � X =q provider/matrix/classes/local/spec/features/matrix/get_room_powerlevels_from_sync_v3.phpnu &1i� PK q�/[�x�� � J R~ provider/matrix/classes/local/spec/features/matrix/get_room_members_v3.phpnu &1i� PK q�/[_�ԽX X + �� provider/matrix/classes/local/spec/v1p6.phpnu &1i� PK q�/[�PT� � + k� provider/matrix/classes/local/spec/v1p1.phpnu &1i� PK q�/[L�4 4 ) X� provider/matrix/classes/local/command.phpnu &1i� PK q�/[�c�� / � provider/matrix/classes/matrix_user_manager.phpnu &1i� PK q�/[�+�b�* �* ) ^� provider/matrix/classes/matrix_client.phpnu &1i� PK q�/[� �n W� provider/matrix/db/upgrade.phpnu &1i� PK q�/[�q�b� � �� provider/matrix/db/caches.phpnu &1i� PK q�/[A��� � � provider/matrix/db/install.xmlnu &1i� PK q�/[��n�G G provider/matrix/db/access.phpnu &1i� PK q�/[���� � � provider/matrix/settings.phpnu &1i� PK q�/[#�rc� � * � provider/matrix/tests/matrix_room_test.phpnu &1i� PK q�/[�a�� 7 � provider/matrix/tests/fixtures/mocked_matrix_client.phpnu &1i� PK q�/[z갺;J ;J 4 }' provider/matrix/tests/communication_feature_test.phpnu &1i� PK q�/[���L.$ .$ 2 r provider/matrix/tests/matrix_test_helper_trait.phpnu &1i� PK q�/[ �}7J9 J9 , �� provider/matrix/tests/matrix_client_test.phpnu &1i� PK q�/[ �+�Q Q 2 R� provider/matrix/tests/matrix_user_manager_test.phpnu &1i� PK q�/[̬]"?1 ?1 , � provider/matrix/tests/local/command_test.phpnu &1i� PK q�/[��� � 6 � provider/matrix/tests/behat/matrix_room_banner.featurenu &1i� PK q�/[���! ! 6 �+ provider/matrix/tests/behat/matrix_form_fields.featurenu &1i� PK q�/[��b�� � : X5 provider/matrix/tests/behat/behat_communication_matrix.phpnu &1i� PK q�/[)/G 1 1 2 F? provider/matrix/tests/matrix_client_test_trait.phpnu &1i� PK q�/[���o o 0 �U provider/matrix/lang/en/communication_matrix.phpnu &1i� PK q�/[�k�:L L �] provider/matrix/version.phpnu &1i� PK q�/[ � �~ ~ ?b provider/upgrade.txtnu &1i� PK q�/[_��^[ [ c classes/room_chat_provider.phpnu &1i� PK q�/[��*G" " �i classes/room_user_provider.phpnu &1i� PK q�/[^ �� � p classes/form_provider.phpnu &1i� PK q�/[�2A� � Mw classes/user_provider.phpnu &1i� PK q�/[q�;z z ! | classes/task/update_room_task.phpnu &1i� PK q�/[����� � , � classes/task/update_room_membership_task.phpnu &1i� PK q�/[�e@i; ; / � classes/task/create_and_configure_room_task.phpnu &1i� PK q�/[�W�� � ) � classes/task/add_members_to_room_task.phpnu &1i� PK q�/[m`�] ! r� classes/task/delete_room_task.phpnu &1i� PK q�/[3/mHe e ) ˫ classes/task/remove_members_from_room.phpnu &1i� PK q�/[#��i> > 5 �� classes/admin/manage_communication_providers_page.phpnu &1i� PK q�/[�Y�u u ,� classes/privacy/provider.phpnu &1i� PK q�/[huR�' ' �� classes/form/configure_form.phpnu &1i� PK q�/[e�BK� � " c� classes/communication_provider.phpnu &1i� PK q�/[��r�N �N z� classes/processor.phpnu &1i� PK q�/[� m�UX UX y> classes/api.phpnu &1i� PK q�/[�Kn�` ` � lib.phpnu &1i� PK q�/[m��Gq q �� amd/build/providerchooser.min.jsnu &1i� PK q�/[�\� $ e� amd/build/providerchooser.min.js.mapnu &1i� PK q�/[O��� � ת amd/src/providerchooser.jsnu &1i� PK q�/[ �}��1 �1 � tests/api_test.phpnu &1i� PK q�/[ j���M �M � tests/processor_test.phpnu &1i� PK q�/[?I/�) ) # K1 tests/behat/behat_communication.phpnu &1i� PK q�/[*���� � / �8 tests/behat/communication_configuration.featurenu &1i� PK q�/[x_�� � ) �A tests/communication_test_helper_trait.phpnu &1i� PK q�/[)DD�x+ x+ �P tests/fixtures/moodle_logo.jpgnu &1i� PK q�/[ s`n( ( �| tests/fixtures/circle.pngnu &1i� PK U U �# ��
| ver. 1.4 |
Github
|
.
| PHP 8.1.33 | Генерация страницы: 0 |
proxy
|
phpinfo
|
Настройка
