MDL-60981 core_search: New indexpriority field in search index queue
[moodle.git] / search / upgrade.txt
CommitLineData
5f654ea2
DM
1This files describes API changes in /search/*,
2information provided here is intended especially for developers.
3
25564a78 4=== 3.5 ===
5
6* Search areas may now optionally implement the get_contexts_to_reindex function (for modules and
7 blocks, see also get_contexts_to_reindex_extra_sql). This allows a search area to customise the
8 order in which it is reindexed when doing a gradual reindex, so as to reindex the most important
9 contexts first.
10
67d64795 11=== 3.4 ===
12
13* Search indexing now supports time limits to make the scheduled task run more neatly. In order for
14 this to work, search engine plugins will need to implement the 'stopat' parameter if they
15 override the add_documents() function, and return an extra parameter from this function (see base
16 class in engine.php). Unmodified plugins will still work, but without supporting time limits.
427b7563 17* Search areas should now implement the get_document_recordset function instead of the old
18 get_recordset_by_timestamp API (implement both if the area should work in older Moodle versions
19 as well). The new function is the same as the old one, but has an additional context parameter.
20 There is a helper function get_context_restriction_sql to make this easy to implement; see code
21 in base_activity.php for an example of how to implement this in your search area. (The
22 change was required to make search work after restoring sites. It also allows more flexible
23 reindexing in other cases.)
67d64795 24
5f654ea2
DM
25=== 3.2 ===
26
27* Base search area classes have been renamed, please update your search areas to use the classes below:
28 - \core_search\area\base has been renamed to \core_search\base
29 - \core_search\area\base_mod has been renamed to \core_search\base_mod
30 - \core_search\area\base_activity has been renamed to \core_search\base_activity