MDL-24316 ajax course edit now works with orphaned activities
[moodle.git] / lib / ajax / ajaxlib.php
1 <?php
3 // This file is part of Moodle - http://moodle.org/
4 //
5 // Moodle is free software: you can redistribute it and/or modify
6 // it under the terms of the GNU General Public License as published by
7 // the Free Software Foundation, either version 3 of the License, or
8 // (at your option) any later version.
9 //
10 // Moodle is distributed in the hope that it will be useful,
11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 // GNU General Public License for more details.
14 //
15 // You should have received a copy of the GNU General Public License
16 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
19 /**
20  * Library functions to facilitate the use of ajax JavaScript in Moodle.
21  *
22  * @package   moodlecore
23  * @copyright 2009 Tim Hunt
24  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
25  */
27 /**
28  * You need to call this function if you wish to use the set_user_preference
29  * method in javascript_static.php, to white-list the preference you want to update
30  * from JavaScript, and to specify the type of cleaning you expect to be done on
31  * values.
32  *
33  * @param string $name the name of the user_perference we should allow to be
34  *      updated by remote calls.
35  * @param integer $paramtype one of the PARAM_{TYPE} constants, user to clean
36  *      submitted values before set_user_preference is called.
37  * @return void
38  */
39 function user_preference_allow_ajax_update($name, $paramtype) {
40     global $USER, $PAGE;
42     // Make sure that the required JavaScript libraries are loaded.
43     $PAGE->requires->yui2_lib('connection');
45     // Record in the session that this user_preference is allowed to updated remotely.
46     $USER->ajax_updatable_user_prefs[$name] = $paramtype;
47 }
49 /**
50  * Returns whether ajax is enabled/allowed or not.
51  * @param array $browsers optional list of alowed browsers, empty means use default list
52  * @return bool
53  */
54 function ajaxenabled(array $browsers = null) {
55     global $CFG, $USER;
57     if (!empty($browsers)) {
58         $valid = false;
59         foreach ($browsers as $brand => $version) {
60             if (check_browser_version($brand, $version)) {
61                 $valid = true;
62             }
63         }
65         if (!$valid) {
66             return false;
67         }
68     }
70     $ie = check_browser_version('MSIE', 6.0);
71     $ff = check_browser_version('Gecko', 20051106);
72     $op = check_browser_version('Opera', 9.0);
73     $sa = check_browser_version('Safari', 412);
75     if (!$ie && !$ff && !$op && !$sa) {
76         /** @see http://en.wikipedia.org/wiki/User_agent */
77         // Gecko build 20051107 is what is in Firefox 1.5.
78         // We still have issues with AJAX in other browsers.
79         return false;
80     }
82     if (!empty($CFG->enableajax) && (!empty($USER->ajax) || !isloggedin())) {
83         return true;
84     } else {
85         return false;
86     }
87 }
91 // ==============================================================================
92 // TODO: replace this with something more up-to-date with our coding standards
94 /**
95  * Used to create view of document to be passed to JavaScript on pageload.
96  * We use this class to pass data from PHP to JavaScript.
97  */
98 class jsportal {
100     var $currentblocksection = null;
101     var $blocks = array();
104     /**
105      * Takes id of block and adds it
106      */
107     function block_add($id, $hidden=false){
108         $hidden_binary = 0;
110         if ($hidden) {
111             $hidden_binary = 1;
112         }
113         $this->blocks[count($this->blocks)] = array($this->currentblocksection, $id, $hidden_binary);
114     }
117     /**
118      * Prints the JavaScript code needed to set up AJAX for the course.
119      */
120     function print_javascript($courseid, $return=false) {
121         global $CFG, $USER, $OUTPUT, $COURSE, $DB;
123         $blocksoutput = $output = '';
124         for ($i=0; $i<count($this->blocks); $i++) {
125             $blocksoutput .= "['".$this->blocks[$i][0]."',
126                              '".$this->blocks[$i][1]."',
127                              '".$this->blocks[$i][2]."']";
129             if ($i != (count($this->blocks) - 1)) {
130                 $blocksoutput .= ',';
131             }
132         }
133         $output .= "<script type=\"text/javascript\">\n";
134         $output .= "    main.portal.id = ".$courseid.";\n";
135         $output .= "    main.portal.blocks = new Array(".$blocksoutput.");\n";
136         $output .= "    main.portal.strings['courseformat']='".$COURSE->format."';\n";
137         $output .= "    main.portal.strings['wwwroot']='".$CFG->wwwroot."';\n";
138         $output .= "    main.portal.strings['marker']='".get_string('markthistopic', '', '_var_')."';\n";
139         $output .= "    main.portal.strings['marked']='".get_string('markedthistopic', '', '_var_')."';\n";
140         $output .= "    main.portal.numsections = ".$COURSE->numsections.";\n";
141         $output .= "    main.portal.lastsection = ".$DB->get_field_sql("SELECT MAX(section) FROM {course_sections} WHERE course = ?", array($courseid)).";\n"; // needed for orphaned activities in unavailable sections
142         $output .= "    main.portal.strings['hide']='".get_string('hide')."';\n";
143         $output .= "    main.portal.strings['hidesection']='".get_string('hidesection', '', '_var_')."';\n";
144         $output .= "    main.portal.strings['show']='".get_string('show')."';\n";
145         $output .= "    main.portal.strings['delete']='".get_string('delete')."';\n";
146         $output .= "    main.portal.strings['move']='".get_string('move')."';\n";
147         $output .= "    main.portal.strings['movesection']='".get_string('movesection', '', '_var_')."';\n";
148         $output .= "    main.portal.strings['moveleft']='".get_string('moveleft')."';\n";
149         $output .= "    main.portal.strings['moveright']='".get_string('moveright')."';\n";
150         $output .= "    main.portal.strings['update']='".get_string('update')."';\n";
151         $output .= "    main.portal.strings['groupsnone']='".get_string('groupsnone')."';\n";
152         $output .= "    main.portal.strings['groupsseparate']='".get_string('groupsseparate')."';\n";
153         $output .= "    main.portal.strings['groupsvisible']='".get_string('groupsvisible')."';\n";
154         $output .= "    main.portal.strings['clicktochange']='".get_string('clicktochange')."';\n";
155         $output .= "    main.portal.strings['deletecheck']='".get_string('deletecheck','','_var_')."';\n";
156         $output .= "    main.portal.strings['resource']='".get_string('resource')."';\n";
157         $output .= "    main.portal.strings['activity']='".get_string('activity')."';\n";
158         $output .= "    main.portal.strings['sesskey']='".sesskey()."';\n";
159         $output .= "    main.portal.icons['spacerimg']='".$OUTPUT->pix_url('spacer')."';\n";
160         $output .= "    main.portal.icons['marker']='".$OUTPUT->pix_url('i/marker')."';\n";
161         $output .= "    main.portal.icons['ihide']='".$OUTPUT->pix_url('i/hide')."';\n";
162         $output .= "    main.portal.icons['move_2d']='".$OUTPUT->pix_url('i/move_2d')."';\n";
163         $output .= "    main.portal.icons['show']='".$OUTPUT->pix_url('t/show')."';\n";
164         $output .= "    main.portal.icons['hide']='".$OUTPUT->pix_url('t/hide')."';\n";
165         $output .= "    main.portal.icons['delete']='".$OUTPUT->pix_url('t/delete')."';\n";
166         $output .= "    main.portal.icons['groupn']='".$OUTPUT->pix_url('t/groupn')."';\n";
167         $output .= "    main.portal.icons['groups']='".$OUTPUT->pix_url('t/groups')."';\n";
168         $output .= "    main.portal.icons['groupv']='".$OUTPUT->pix_url('t/groupv')."';\n";
169         if (right_to_left()) {
170             $output .= "    main.portal.icons['backwards']='".$OUTPUT->pix_url('t/right')."';\n";
171             $output .= "    main.portal.icons['forwards']='".$OUTPUT->pix_url('t/left')."';\n";
172         } else {
173             $output .= "    main.portal.icons['backwards']='".$OUTPUT->pix_url('t/left')."';\n";
174             $output .= "    main.portal.icons['forwards']='".$OUTPUT->pix_url('t/right')."';\n";
175         }
177         $output .= "    onloadobj.load();\n";
178         $output .= "    main.process_blocks();\n";
179         $output .= "</script>";
180         if ($return) {
181             return $output;
182         } else {
183             echo $output;
184         }
185     }