1fbe958cfcaaba5af5688466b47dd96b3c7d6059
[moodle.git] / admin / tool / policy / lib.php
1 <?php
2 // This file is part of Moodle - http://moodle.org/
3 //
4 // Moodle is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
8 //
9 // Moodle is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 // GNU General Public License for more details.
13 //
14 // You should have received a copy of the GNU General Public License
15 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
17 /**
18  * Plugin version and other meta-data are defined here.
19  *
20  * @package     tool_policy
21  * @copyright   2018 David Mudr├ík <david@moodle.com>
22  * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
23  */
25 defined('MOODLE_INTERNAL') || die();
27 use core_user\output\myprofile\tree;
28 use tool_policy\api;
29 use tool_policy\policy_version;
31 /**
32  * Add nodes to myprofile page.
33  *
34  * @param tree $tree Tree object
35  * @param stdClass $user User object
36  * @param bool $iscurrentuser
37  * @param stdClass $course Course object
38  * @return bool
39  * @throws coding_exception
40  * @throws dml_exception
41  * @throws moodle_exception
42  */
43 function tool_policy_myprofile_navigation(tree $tree, $user, $iscurrentuser, $course) {
44     global $CFG;
46     // Do nothing if we are not set as the site policies handler.
47     if (empty($CFG->sitepolicyhandler) || $CFG->sitepolicyhandler !== 'tool_policy') {
48         return;
49     }
51     // Get the Privacy and policies category.
52     if (!array_key_exists('privacyandpolicies', $tree->__get('categories'))) {
53         // Create the category.
54         $categoryname = get_string('privacyandpolicies', 'admin');
55         $category = new core_user\output\myprofile\category('privacyandpolicies', $categoryname, 'contact');
56         $tree->add_category($category);
57     } else {
58         // Get the existing category.
59         $category = $tree->__get('categories')['privacyandpolicies'];
60     }
62     // Add "Policies and agreements" node only for current user or users who can accept on behalf of current user.
63     $usercontext = \context_user::instance($user->id);
64     if ($iscurrentuser || has_capability('tool/policy:acceptbehalf', $usercontext)) {
65         $url = new moodle_url('/admin/tool/policy/user.php', ['userid' => $user->id]);
66         $node = new core_user\output\myprofile\node('privacyandpolicies', 'tool_policy',
67             get_string('policiesagreements', 'tool_policy'), null, $url);
68         $category->add_node($node);
69     }
71     return true;
72 }
74 /**
75  * Load policy message for guests.
76  *
77  * @return string The HTML code to insert before the head.
78  */
79 function tool_policy_before_standard_html_head() {
80     global $CFG, $PAGE, $USER;
82     $message = null;
83     if (!empty($CFG->sitepolicyhandler)
84             && $CFG->sitepolicyhandler == 'tool_policy'
85             && empty($USER->policyagreed)
86             && (isguestuser() || !isloggedin())) {
87         $output = $PAGE->get_renderer('tool_policy');
88         $page = new \tool_policy\output\guestconsent();
90         $message = $output->render($page);
91     }
93     return $message;
94 }
96 /**
97  * Callback to add footer elements.
98  *
99  * @return str valid html footer content
100  */
101 function tool_policy_standard_footer_html() {
102     global $CFG;
104     $output = '';
105     if (!empty($CFG->sitepolicyhandler)
106             && $CFG->sitepolicyhandler == 'tool_policy') {
107         $url = (new moodle_url('/admin/tool/policy/viewall.php'))->out();
108         $output .= html_writer::link($url, get_string('userpolicysettings', 'tool_policy'));
109         $output = html_writer::div($output, 'policiesfooter');
110     }
112     return $output;
115 /**
116  * Hooks redirection to policy acceptance pages before sign up.
117  */
118 function tool_policy_pre_signup_requests() {
119     global $CFG;
121     // Do nothing if we are not set as the site policies handler.
122     if (empty($CFG->sitepolicyhandler) || $CFG->sitepolicyhandler !== 'tool_policy') {
123         return;
124     }
126     $policies = api::get_current_versions_ids(policy_version::AUDIENCE_LOGGEDIN);
127     $userpolicyagreed = cache::make('core', 'presignup')->get('tool_policy_userpolicyagreed');
128     if (!empty($policies) && !$userpolicyagreed) {
129         // Redirect to "Policy" pages for consenting before creating the user.
130         cache::make('core', 'presignup')->set('tool_policy_issignup', 1);
131         redirect(new \moodle_url('/admin/tool/policy/index.php'));
132     }
135 /**
136  * Serve the embedded files.
137  *
138  * @param stdClass $course the course object
139  * @param stdClass $cm the course module object
140  * @param stdClass $context the context
141  * @param string $filearea the name of the file area
142  * @param array $args extra arguments (itemid, path)
143  * @param bool $forcedownload whether or not force download
144  * @param array $options additional options affecting the file serving
145  * @return bool false if the file not found, just send the file otherwise and do not return anything
146  */
147 function tool_policy_pluginfile($course, $cm, $context, $filearea, $args, $forcedownload, array $options=array()) {
148     global $CFG, $PAGE;
150     // Do not allow access to files if we are not set as the site policy handler.
151     if (empty($CFG->sitepolicyhandler) || $CFG->sitepolicyhandler !== 'tool_policy') {
152         return false;
153     }
155     if ($context->contextlevel != CONTEXT_SYSTEM) {
156         return false;
157     }
159     $PAGE->set_context($context);
161     if ($filearea !== 'policydocumentsummary' && $filearea !== 'policydocumentcontent') {
162         return false;
163     }
165     $itemid = array_shift($args);
167     $policy = api::get_policy_version($itemid);
169     if ($policy->status != policy_version::STATUS_ACTIVE) {
170         require_login();
171     }
173     if (!api::can_user_view_policy_version($policy)) {
174         return false;
175     }
177     $filename = array_pop($args);
179     if (!$args) {
180         $filepath = '/';
181     } else {
182         $filepath = '/'.implode('/', $args).'/';
183     }
185     $fs = get_file_storage();
186     $file = $fs->get_file($context->id, 'tool_policy', $filearea, $itemid, $filepath, $filename);
188     if (!$file) {
189         return false;
190     }
192     send_stored_file($file, null, 0, $forcedownload, $options);
195 /**
196  * Map icons for font-awesome themes.
197  */
198 function tool_policy_get_fontawesome_icon_map() {
199     return [
200         'tool_policy:agreedno' => 'fa-times text-danger',
201         'tool_policy:agreedyes' => 'fa-check text-success',
202         'tool_policy:agreedyesonbehalf' => 'fa-check text-info',
203         'tool_policy:level' => 'fa-level-up fa-rotate-90 text-muted',
204     ];
207 /**
208  * Serve the new group form as a fragment.
209  *
210  * @param array $args List of named arguments for the fragment loader.
211  * @return string
212  */
213 function tool_policy_output_fragment_accept_on_behalf($args) {
214     $args = (object) $args;
216     $data = [];
217     if (!empty($args->jsonformdata)) {
218         $serialiseddata = json_decode($args->jsonformdata);
219         parse_str($serialiseddata, $data);
220     }
222     $mform = new \tool_policy\form\accept_policy(null, $data);
224     if (!empty($args->jsonformdata)) {
225         // If we were passed non-empty form data we want the mform to call validation functions and show errors.
226         $mform->is_validated();
227     }
229     return $mform->render();