ee5c1ebe4978134a1354109eec985846fb9127bc
[moodle.git] / mod / data / classes / search / entry.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  * Search area for mod_data activity entries.
19  *
20  * @package    mod_data
21  * @copyright  2016 Devang Gaur
22  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
23  */
25 namespace mod_data\search;
27 defined('MOODLE_INTERNAL') || die();
29 require_once($CFG->dirroot . '/mod/data/lib.php');
30 require_once($CFG->dirroot . '/lib/grouplib.php');
32 /**
33  * Search area for mod_data activity entries.
34  *
35  * @package    mod_data
36  * @copyright  2016 Devang Gaur
37  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
38  */
39 class entry extends \core_search\base_mod {
41     /**
42      * @var array Internal quick static cache.
43      */
44     protected $entriesdata = array();
46     /**
47      * Returns recordset containing required data for indexing database entries.
48      *
49      * @param int $modifiedfrom timestamp
50      * @return moodle_recordset
51      */
52     public function get_recordset_by_timestamp($modifiedfrom = 0) {
53         global $DB;
55         $sql = "SELECT dr.*, d.course
56                   FROM {data_records} dr
57                   JOIN {data} d ON d.id = dr.dataid
58                  WHERE dr.timemodified >= :timemodified";
59         return $DB->get_recordset_sql($sql, array('timemodified' => $modifiedfrom));
60     }
62     /**
63      * Returns the documents associated with this glossary entry id.
64      *
65      * @param stdClass $entry glossary entry.
66      * @param array    $options
67      * @return \core_search\document
68      */
69     public function get_document($entry, $options = array()) {
70         global $DB;
72         try {
73             $cm = $this->get_cm('data', $entry->dataid, $entry->course);
74             $context = \context_module::instance($cm->id);
75         } catch (\dml_missing_record_exception $ex) {
76             // Notify it as we run here as admin, we should see everything.
77             debugging('Error retrieving mod_data ' . $entry->id . ' document, not all required data is available: ' .
78                 $ex->getMessage(), DEBUG_DEVELOPER);
79             return false;
80         } catch (\dml_exception $ex) {
81             // Notify it as we run here as admin, we should see everything.
82             debugging('Error retrieving mod_data' . $entry->id . ' document: ' . $ex->getMessage(), DEBUG_DEVELOPER);
83             return false;
84         }
86         // Prepare associative array with data from DB.
87         $doc = \core_search\document_factory::instance($entry->id, $this->componentname, $this->areaname);
88         $doc->set('contextid', $context->id);
89         $doc->set('courseid', $entry->course);
90         $doc->set('userid', $entry->userid);
91         $doc->set('owneruserid', \core_search\manager::NO_OWNER_ID);
92         $doc->set('modified', $entry->timemodified);
94         $indexfields = $this->get_fields_for_entries($entry);
96         if (count($indexfields) < 2) {
97             return false;
98         }
100         $doc->set('title', $indexfields[0]);
101         $doc->set('content', $indexfields[1]);
103         if (isset($indexfields[2])) {
104             $doc->set('description1', $indexfields[2]);
105         }
107         if (isset($indexfields[3])) {
108             $doc->set('description2', $indexfields[3]);
109         }
111         return $doc;
112     }
114     /**
115      * Whether the user can access the document or not.
116      *
117      * @throws \dml_missing_record_exception
118      * @throws \dml_exception
119      * @param int $id Glossary entry id
120      * @return bool
121      */
122     public function check_access($id) {
123         global $DB, $USER;
125         if (isguestuser()) {
126             return \core_search\manager::ACCESS_DENIED;
127         }
129         $now = time();
131         $sql = "SELECT dr.*, d.*
132                   FROM {data_records} dr
133                   JOIN {data} d ON d.id = dr.dataid
134                  WHERE dr.id = ?";
136         $entry = $DB->get_record_sql($sql, array( $id ), IGNORE_MISSING);
138         if (!$entry) {
139             return \core_search\manager::ACCESS_DELETED;
140         }
142         if (($entry->timeviewfrom && $now < $entry->timeviewfrom) || ($entry->timeviewto && $now > $entry->timeviewto)) {
143             return \core_search\manager::ACCESS_DENIED;
144         }
146         $cm = $this->get_cm('data', $entry->dataid, $entry->course);
147         $context = \context_module::instance($cm->id);
149         $canmanageentries = has_capability('mod/data:manageentries', $context);
151         if (!has_capability('mod/data:viewentry', $context)) {
152             return \core_search\manager::ACCESS_DENIED;
153         }
155         $numberofentriesindb = $DB->count_records('data_records', array('dataid' => $entry->dataid));
156         $requiredentriestoview = $entry->requiredentriestoview;
158         if ($requiredentriestoview && ($requiredentriestoview > $numberofentriesindb) &&
159                 ($USER->id != $entry->userid) && !$canmanageentries) {
160             return \core_search\manager::ACCESS_DENIED;
161         }
163         if ($entry->approval && !$entry->approved && ($entry->userid != $USER->id) && !$canmanageentries) {
164             return \core_search\manager::ACCESS_DENIED;
165         }
167         $currentgroup = groups_get_activity_group($cm, true);
168         $groupmode = groups_get_activity_groupmode($cm);
170         if (($groupmode == 1) && ($entry->groupid != $currentgroup) && !$canmanageentries) {
171             return \core_search\manager::ACCESS_DENIED;
172         }
174         return \core_search\manager::ACCESS_GRANTED;
175     }
177     /**
178      * Link to database entry.
179      *
180      * @param \core_search\document $doc
181      * @return \moodle_url
182      */
183     public function get_doc_url(\core_search\document $doc) {
184         $entry = $this->get_entry($doc->get('itemid'));
185         return new \moodle_url('/mod/data/view.php', array( 'd' => $entry->dataid, 'rid' => $entry->id ));
186     }
188     /**
189      * Link to the database activity.
190      *
191      * @param \core_search\document $doc
192      * @return \moodle_url
193      */
194     public function get_context_url(\core_search\document $doc) {
195         $entry = $this->get_entry($doc->get('itemid'));
196         return new \moodle_url('/mod/data/view.php', array('d' => $entry->dataid));
197     }
199     /**
200      * Returns true if this area uses file indexing.
201      *
202      * @return bool
203      */
204     public function uses_file_indexing() {
205         return true;
206     }
208     /**
209      * Add the database entries attachments.
210      *
211      * @param \core_search\document $doc
212      * @return void
213      */
214     public function attach_files($doc) {
215         global $DB;
217         $entryid = $doc->get('itemid');
219         try {
220             $entry = $this->get_entry($entryid);
221         } catch (\dml_missing_record_exception $e) {
222             debugging('Could not get record to attach files to '.$doc->get('id'), DEBUG_DEVELOPER);
223             return;
224         }
226         $cm = $this->get_cm('data', $entry->dataid, $doc->get('courseid'));
227         $context = \context_module::instance($cm->id);
229         // Get the files and attach them.
230         $fs = get_file_storage();
231         $files = $fs->get_area_files($context->id, 'mod_data', 'content', $entryid, 'filename', false);
232         foreach ($files as $file) {
233             $doc->add_stored_file($file);
234         }
235     }
237     /**
238      * Get database entry data
239      *
240      * @throws \dml_exception
241      * @param int $entryid
242      * @return stdClass
243      */
244     protected function get_entry($entryid) {
245         global $DB;
247         if (empty($this->entriesdata[$entryid])) {
248             $this->entriesdata[$entryid] = $DB->get_record('data_records', array( 'id' => $entryid ), '*', MUST_EXIST);
249         }
251         return $this->entriesdata[$entryid];
252     }
254     /**
255      * get_fields_for_entries
256      *
257      * @param StdClass $entry
258      * @return array
259      */
260     protected function get_fields_for_entries($entry) {
261         global $DB;
263         $indexfields = array();
264         $validfieldtypes = array('text', 'textarea', 'menu', 'radiobutton', 'checkbox', 'multimenu', 'url');
266         $sql = "SELECT dc.id, dc.content, df.name AS fldname,
267                        df.type AS fieldtype, df.required
268                   FROM {data_content} dc, {data_fields} df
269                  WHERE dc.fieldid = df.id
270                        AND dc.recordid = :recordid";
272         $contents = $DB->get_records_sql($sql, array('recordid' => $entry->id));
273         $filteredcontents = array();
275         $template = $DB->get_record_sql('SELECT addtemplate FROM {data} WHERE id = ?', array($entry->dataid));
276         $template = $template->addtemplate;
278         // Filtering out the data_content records having invalid fieldtypes.
279         foreach ($contents as $content) {
280             if (in_array($content->fieldtype, $validfieldtypes)) {
281                 $filteredcontents[] = $content;
282             }
283         }
285         foreach ($filteredcontents as $content) {
286             $classname = $this->get_field_class_name($content->fieldtype);
287             $content->priority = $classname::get_priority();
288             $content->addtemplateposition = strpos($template, '[['.$content->fldname.']]');
289         }
291         $orderqueue = new \SPLPriorityQueue();
293         // Filtering out contents which belong to fields that aren't present in the addtemplate of the database activity instance.
294         foreach ($filteredcontents as $content) {
296             if ($content->addtemplateposition >= 0) {
297                 $orderqueue->insert($content, $content->addtemplateposition);
298             }
299         }
301         $filteredcontents = array();
303         while ($orderqueue->valid()) {
304             $filteredcontents[] = $orderqueue->extract();
305         }
307         // SPLPriorityQueue sorts according to descending order of the priority (here, addtemplateposition).
308         $filteredcontents = array_reverse($filteredcontents);
310         // Using a CUSTOM SPLPriorityQueure instance to sort out the filtered contents according to these rules :
311         // 1. Priorities in $fieldtypepriorities
312         // 2. Compulsory fieldtypes are to be given the top priority.
313         $contentqueue = new sortedcontentqueue($filteredcontents);
315         foreach ($filteredcontents as $key => $content) {
316             $contentqueue->insert($content, $key);
317         }
319         while ($contentqueue->valid()) {
321             $content = $contentqueue->extract();
322             $classname = $this->get_field_class_name($content->fieldtype);
324             $indexfields[] = $classname::get_content_value($content->content);
325         }
327         return $indexfields;
328     }
330     /**
331      * Returns the class name for that field type and includes it.
332      *
333      * @param string $fieldtype
334      * @return string
335      */
336     protected function get_field_class_name($fieldtype) {
337         global $CFG;
339         $fieldtype = trim($fieldtype);
340         require_once($CFG->dirroot . '/mod/data/field/' . $fieldtype . '/field.class.php');
341         return 'data_field_' . $fieldtype;
342     }