Proyectos de Subversion Moodle

Rev

| Ultima modificación | Ver Log |

Rev Autor Línea Nro. Línea
1 efrain 1
// This file is part of Moodle - http://moodle.org/
2
//
3
// Moodle is free software: you can redistribute it and/or modify
4
// it under the terms of the GNU General Public License as published by
5
// the Free Software Foundation, either version 3 of the License, or
6
// (at your option) any later version.
7
//
8
// Moodle is distributed in the hope that it will be useful,
9
// but WITHOUT ANY WARRANTY; without even the implied warranty of
10
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
// GNU General Public License for more details.
12
//
13
// You should have received a copy of the GNU General Public License
14
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
15
 
16
/**
17
 * Module responsible for handling forum summary report filters.
18
 *
19
 * @module     forumreport_summary/filters
20
 * @copyright  2019 Michael Hawkins <michaelh@moodle.com>
21
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
22
 */
23
 
24
import $ from 'jquery';
25
import {createPopper} from 'core/popper2';
26
import CustomEvents from 'core/custom_interaction_events';
27
import Selectors from 'forumreport_summary/selectors';
28
import Ajax from 'core/ajax';
29
import KeyCodes from 'core/key_codes';
30
import * as FormChangeChecker from 'core_form/changechecker';
31
 
32
export const init = (root) => {
33
    let jqRoot = $(root);
34
 
35
    // Hide loading spinner and show report once page is ready.
36
    // This ensures filters can be applied when sorting by columns.
37
    $(document).ready(function() {
38
        $('.loading-icon').hide();
39
        $('#summaryreport').removeClass('hidden');
40
    });
41
 
42
    // Generic filter handlers.
43
 
44
    // Called to override click event to trigger a proper generate request with filtering.
45
    const generateWithFilters = (event, getparams) => {
46
        let currentLink = document.forms.filtersform.action,
47
            newLink;
48
 
49
        if (event) {
50
            event.preventDefault();
51
 
52
           let currentSplit = currentLink.split('?'),
53
               currentstring = currentSplit[1],
54
               newparamsarray = getparams.split('&'),
55
               paramsstring = '',
56
               paramkeys = [],
57
               paramvalues = [];
58
 
59
            // Separate out the existing action GET param string.
60
            currentstring.split('&').forEach(function(param) {
61
                let splitparam = param.split('=');
62
                paramkeys.push(splitparam[0]);
63
                paramvalues.push(splitparam[1]);
64
            });
65
 
66
            newparamsarray.forEach(function(paramstring) {
67
                let newparam = paramstring.split('='),
68
                    existingkey = paramkeys.indexOf(newparam[0]);
69
 
70
                // Overwrite value if existing, otherwise add new param.
71
                if (existingkey > -1) {
72
                    paramvalues[existingkey] = newparam[1];
73
                } else {
74
                    paramkeys.push(newparam[0]);
75
                    paramvalues.push(newparam[1]);
76
                }
77
            });
78
 
79
            // Build URL.
80
            paramkeys.forEach(function(name, key) {
81
                paramsstring += `&${name}=${paramvalues[key]}`;
82
            });
83
 
84
            newLink = currentSplit[0] + '?' + paramsstring.substr(1);
85
        } else {
86
            newLink = currentLink;
87
        }
88
 
89
        document.forms.filtersform.action = newLink;
90
        document.forms.filtersform.submit();
91
    };
92
 
93
    // Override 'reset table preferences' so it generates with filters.
94
    $('.resettable').on("click", "a", function(event) {
95
        generateWithFilters(event, event.target.search.substr(1));
96
    });
97
 
98
    // Override table heading sort links so they generate with filters.
99
    $('thead').on("click", "a", function(event) {
100
        generateWithFilters(event, event.target.search.substr(1));
101
    });
102
 
103
    // Override pagination page links so they generate with filters.
104
    $('.pagination').on("click", "a", function(event) {
105
        generateWithFilters(event, event.target.search.substr(1));
106
    });
107
 
108
    // Override rows per page submission so it generates with filters.
109
    if (document.forms.selectperpage) {
110
        document.forms.selectperpage.onsubmit = (event) => {
111
            let getparam = 'perpage=' + document.forms.selectperpage.elements.perpage.value;
112
            generateWithFilters(event, getparam);
113
        };
114
    }
115
 
116
    // Override download link so the file is generated with filters.
117
    const downloadForm = document.getElementById('summaryreport').querySelector('form.dataformatselector');
118
    if (downloadForm) {
119
        downloadForm.onsubmit = (event) => {
120
            const downloadType = downloadForm.querySelector('#downloadtype_download').value;
121
            const getParams = `download=${downloadType}`;
122
            const prevAction = document.forms.filtersform.action;
123
 
124
            generateWithFilters(event, getParams);
125
 
126
            // Revert action, so re-submitting the form via filter does not trigger a further download.
127
            document.forms.filtersform.action = prevAction;
128
        };
129
    }
130
 
131
    // Submit report via filter
132
    const submitWithFilter = (containerelement) => {
133
        // Disable the dates filter mform checker to prevent any changes triggering a warning to the user.
134
        FormChangeChecker.unWatchForm(document.forms.filtersform);
135
 
136
        // Close the container (eg popover).
137
        $(containerelement).addClass('hidden');
138
 
139
        // Submit the filter values and re-generate report.
140
        generateWithFilters(false);
141
    };
142
 
143
    // Use popper to override date mform calendar position.
144
    const updateCalendarPosition = (referenceid) => {
145
        let referenceElement = document.querySelector(referenceid),
146
            popperContent = document.querySelector(Selectors.filters.date.calendar);
147
 
148
        popperContent.style.removeProperty("z-index");
149
        createPopper(referenceElement, popperContent, {placement: 'bottom-end'});
150
    };
151
 
152
    // Close the relevant filter.
153
    const closeOpenFilters = (openFilterButton, openFilter) => {
154
        openFilter.classList.add('hidden');
155
        openFilter.setAttribute('data-openfilter', 'false');
156
 
157
        openFilterButton.classList.add('btn-primary');
158
        openFilterButton.classList.remove('btn-outline-primary');
159
        openFilterButton.setAttribute('aria-expanded', false);
160
    };
161
 
162
    // Groups filter specific handlers.
163
 
164
    // Event handler for clicking select all groups.
165
    jqRoot.on(CustomEvents.events.activate, Selectors.filters.group.selectall, function() {
166
        let deselected = root.querySelectorAll(Selectors.filters.group.checkbox + ':not(:checked)');
167
        deselected.forEach(function(checkbox) {
168
            checkbox.checked = true;
169
        });
170
    });
171
 
172
    // Event handler for clearing filter by clicking option.
173
    jqRoot.on(CustomEvents.events.activate, Selectors.filters.group.clear, function() {
174
        // Clear checkboxes.
175
        let selected = root.querySelectorAll(Selectors.filters.group.checkbox + ':checked');
176
        selected.forEach(function(checkbox) {
177
            checkbox.checked = false;
178
        });
179
    });
180
 
181
    // Event handler for showing groups filter popover.
182
    jqRoot.on(CustomEvents.events.activate, Selectors.filters.group.trigger, function() {
183
        // Create popover.
184
        let referenceElement = root.querySelector(Selectors.filters.group.trigger),
185
            popperContent = root.querySelector(Selectors.filters.group.popover);
186
 
187
        createPopper(referenceElement, popperContent, {placement: 'bottom-end'});
188
 
189
        // Show popover.
190
        popperContent.classList.remove('hidden');
191
        popperContent.setAttribute('data-openfilter', 'true');
192
 
193
        // Change to outlined button.
194
        referenceElement.classList.add('btn-outline-primary');
195
        referenceElement.classList.remove('btn-primary');
196
 
197
        // Let screen readers know that it's now expanded.
198
        referenceElement.setAttribute('aria-expanded', true);
199
 
200
        // Add listeners to handle closing filter.
201
        const closeListener = e => {
202
            if (e.target.id !== referenceElement.id && popperContent !== e.target.closest('[data-openfilter="true"]') &&
203
                    (typeof e.keyCode === 'undefined' || e.keyCode === KeyCodes.enter || e.keyCode === KeyCodes.space)) {
204
                closeOpenFilters(referenceElement, popperContent);
205
                document.removeEventListener('click', closeListener);
206
                document.removeEventListener('keyup', closeListener);
207
                document.removeEventListener('keyup', escCloseListener);
208
            }
209
        };
210
 
211
        document.addEventListener('click', closeListener);
212
        document.addEventListener('keyup', closeListener);
213
 
214
        const escCloseListener = e => {
215
            if (e.keyCode === KeyCodes.escape) {
216
                closeOpenFilters(referenceElement, popperContent);
217
                document.removeEventListener('keyup', escCloseListener);
218
                document.removeEventListener('click', closeListener);
219
            }
220
        };
221
 
222
        document.addEventListener('keyup', escCloseListener);
223
    });
224
 
225
    // Event handler to click save groups filter.
226
    jqRoot.on(CustomEvents.events.activate, Selectors.filters.group.save, function() {
227
        // Copy the saved values into the form before submitting.
228
        let popcheckboxes = root.querySelectorAll(Selectors.filters.group.checkbox);
229
 
230
        popcheckboxes.forEach(function(popcheckbox) {
231
            let filtersform = document.forms.filtersform,
232
                saveid = popcheckbox.getAttribute('data-saveid');
233
 
234
            filtersform.querySelector(`#${saveid}`).checked = popcheckbox.checked;
235
        });
236
 
237
        submitWithFilter('#filter-groups-popover');
238
    });
239
 
240
    // Listeners for export buttons.
241
    // These allow fetching of the relevant export URL, before submitting the request with
242
    // any POST data that is common to all of the export links. This allows filters to be
243
    // applied that contain potentially a lot of data (eg discussion IDs for groups filtering).
244
    document.querySelectorAll(Selectors.filters.exportlink.link).forEach(function(exportbutton) {
245
        exportbutton.addEventListener('click', function(event) {
246
            document.forms.exportlinkform.action = event.target.dataset.url;
247
            document.forms.exportlinkform.submit();
248
        });
249
    });
250
 
251
    // Dates filter specific handlers.
252
 
253
   // Event handler for showing dates filter popover.
254
    jqRoot.on(CustomEvents.events.activate, Selectors.filters.date.trigger, function() {
255
 
256
        // Create popover.
257
        let referenceElement = root.querySelector(Selectors.filters.date.trigger),
258
            popperContent = root.querySelector(Selectors.filters.date.popover);
259
 
260
        createPopper(referenceElement, popperContent, {placement: 'bottom-end'});
261
 
262
        // Show popover and move focus.
263
        popperContent.classList.remove('hidden');
264
        popperContent.setAttribute('data-openfilter', 'true');
265
        popperContent.querySelector('[name="filterdatefrompopover[enabled]"]').focus();
266
 
267
        // Change to outlined button.
268
        referenceElement.classList.add('btn-outline-primary');
269
        referenceElement.classList.remove('btn-primary');
270
 
271
        // Let screen readers know that it's now expanded.
272
        referenceElement.setAttribute('aria-expanded', true);
273
 
274
        // Add listener to handle closing filter.
275
        const closeListener = e => {
276
            if (e.target.id !== referenceElement.id && popperContent !== e.target.closest('[data-openfilter="true"]') &&
277
                    (typeof e.keyCode === 'undefined' || e.keyCode === KeyCodes.enter || e.keyCode === KeyCodes.space)) {
278
                closeOpenFilters(referenceElement, popperContent);
279
                document.removeEventListener('click', closeListener);
280
                document.removeEventListener('keyup', closeListener);
281
                document.removeEventListener('keyup', escCloseListener);
282
            }
283
        };
284
 
285
        document.addEventListener('click', closeListener);
286
        document.addEventListener('keyup', closeListener);
287
 
288
        const escCloseListener = e => {
289
            if (e.keyCode === KeyCodes.escape) {
290
                closeOpenFilters(referenceElement, popperContent);
291
                document.removeEventListener('keyup', escCloseListener);
292
                document.removeEventListener('click', closeListener);
293
            }
294
        };
295
 
296
        document.addEventListener('keyup', escCloseListener);
297
    });
298
 
299
    // Event handler to save dates filter.
300
    jqRoot.on(CustomEvents.events.activate, Selectors.filters.date.save, function() {
301
        // Populate the hidden form inputs to submit the data.
302
        let filtersForm = document.forms.filtersform;
303
        const datesPopover = root.querySelector(Selectors.filters.date.popover);
304
        const fromEnabled = datesPopover.querySelector('[name="filterdatefrompopover[enabled]"]').checked ? 1 : 0;
305
        const toEnabled = datesPopover.querySelector('[name="filterdatetopopover[enabled]"]').checked ? 1 : 0;
306
 
307
        if (!fromEnabled && !toEnabled) {
308
            // Update the elements in the filter form.
309
            filtersForm.elements['datefrom[timestamp]'].value = 0;
310
            filtersForm.elements['datefrom[enabled]'].value = fromEnabled;
311
            filtersForm.elements['dateto[timestamp]'].value = 0;
312
            filtersForm.elements['dateto[enabled]'].value = toEnabled;
313
 
314
            // Submit the filter values and re-generate report.
315
            submitWithFilter('#filter-dates-popover');
316
        } else {
317
            let args = {data: []};
318
 
319
            if (fromEnabled) {
320
                args.data.push({
321
                    'key': 'from',
322
                    'year': datesPopover.querySelector('[name="filterdatefrompopover[year]"]').value,
323
                    'month': datesPopover.querySelector('[name="filterdatefrompopover[month]"]').value,
324
                    'day': datesPopover.querySelector('[name="filterdatefrompopover[day]"]').value,
325
                    'hour': 0,
326
                    'minute': 0
327
                });
328
            }
329
 
330
            if (toEnabled) {
331
                args.data.push({
332
                    'key': 'to',
333
                    'year': datesPopover.querySelector('[name="filterdatetopopover[year]"]').value,
334
                    'month': datesPopover.querySelector('[name="filterdatetopopover[month]"]').value,
335
                    'day': datesPopover.querySelector('[name="filterdatetopopover[day]"]').value,
336
                    'hour': 23,
337
                    'minute': 59
338
                });
339
            }
340
 
341
            const request = {
342
                methodname: 'core_calendar_get_timestamps',
343
                args: args
344
            };
345
 
346
            Ajax.call([request])[0].done(function(result) {
347
                let fromTimestamp = 0,
348
                    toTimestamp = 0;
349
 
350
                result.timestamps.forEach(function(data) {
351
                    if (data.key === 'from') {
352
                        fromTimestamp = data.timestamp;
353
                    } else if (data.key === 'to') {
354
                        toTimestamp = data.timestamp;
355
                    }
356
                });
357
 
358
                // Display an error if the from date is later than the do date.
359
                if (toTimestamp > 0 && fromTimestamp > toTimestamp) {
360
                    const warningdiv = document.getElementById('dates-filter-warning');
361
                    warningdiv.classList.remove('hidden');
362
                    warningdiv.classList.add('d-block');
363
                } else {
364
                    filtersForm.elements['datefrom[timestamp]'].value = fromTimestamp;
365
                    filtersForm.elements['datefrom[enabled]'].value = fromEnabled;
366
                    filtersForm.elements['dateto[timestamp]'].value = toTimestamp;
367
                    filtersForm.elements['dateto[enabled]'].value = toEnabled;
368
 
369
                    // Submit the filter values and re-generate report.
370
                    submitWithFilter('#filter-dates-popover');
371
                }
372
            });
373
        }
374
    });
375
 
376
    jqRoot.on(CustomEvents.events.activate, Selectors.filters.date.calendariconfrom, function() {
377
        updateCalendarPosition(Selectors.filters.date.calendariconfrom);
378
    });
379
 
380
    jqRoot.on(CustomEvents.events.activate, Selectors.filters.date.calendariconto, function() {
381
        updateCalendarPosition(Selectors.filters.date.calendariconto);
382
    });
383
};