Moodle PHP Documentation 4.2
Moodle 4.2.8 (Build: 20240610) (2d41ac46f45)
|
Base implementation for search areas working at module level. More...
Public Member Functions | |
attach_files ($document) | |
Files related to the current document are attached, to the document object ready for indexing by Global Search. | |
check_access ($id) | |
Can the current user see the document. | |
get_area_id () | |
Returns the area id. | |
get_category_names () | |
Returns a list of category names associated with the area. | |
get_component_name () | |
Returns the moodle component name. | |
get_component_type () | |
Returns the component type. | |
get_config () | |
Returns all the search area configuration. | |
get_config_var_name () | |
Returns the config var name. | |
get_context_url (\core_search\document $doc) | |
Returns a url to the document context. | |
get_contexts_to_reindex () | |
Gets a list of all contexts to reindex when reindexing this search area. | |
get_doc_icon (document $doc) | |
Returns an icon instance for the document. | |
get_doc_url (\core_search\document $doc) | |
Returns a url to the document, it might match self\get_context_url(). | |
get_document ($record, $options=array()) | |
Returns the document related with the provided record. | |
get_document_display_title (\core_search\document $doc) | |
Returns the document title to display. | |
get_document_recordset ($modifiedfrom=0, context $context=null) | |
Returns a recordset containing all items from this area, optionally within the given context, and including only items modifed from (>=) the specified time. | |
get_last_indexing_duration () | |
Gets the length of time spent indexing this area (the last time it was indexed). | |
get_recordset_by_timestamp ($modifiedfrom=0) | |
Returns a recordset ordered by modification date ASC. | |
get_search_fileareas () | |
Return the context info required to index files for this search area. | |
get_visible_name ($lazyload=false) | |
Returns the area visible name. | |
is_enabled () | |
Is the search component enabled by the system administrator? | |
restrict_cm_access_by_group (\cm_info $cm) | |
Checks whether the content of this search area should be restricted by group for a specific module. | |
set_enabled ($isenabled) | |
supports_get_document_recordset () | |
Checks if get_document_recordset is supported for this search area. | |
supports_group_restriction () | |
Indicates whether this search area may restrict access by group. | |
uses_file_indexing () | |
Returns true if this area uses file indexing. | |
Static Public Member Functions | |
static | get_levels () |
Returns context levels property. | |
static | get_settingnames () |
Return a list of all required setting names. | |
Public Attributes | |
string | $areaid |
An area id from the componentname and the area name. | |
Protected Member Functions | |
get_cm ($modulename, $instanceid, $courseid) | |
Gets the course module for the required instanceid + modulename. | |
get_context_restriction_sql (?\context $context, $modname, $modtable, $paramtype=SQL_PARAMS_QM) | |
Helper function that gets SQL useful for restricting a search query given a passed-in context. | |
get_contexts_to_reindex_extra_sql () | |
This can be used in subclasses to change ordering within the get_contexts_to_reindex function. | |
get_course_level_context_restriction_sql (?\context $context, $coursetable, $paramtype=SQL_PARAMS_QM) | |
Helper function that gets SQL useful for restricting a search query given a passed-in context, for data stored at course level. | |
get_module_name () | |
Returns the module name. | |
Static Protected Attributes | |
static array | $levels = [CONTEXT_MODULE] |
The context levels the search area is working on. | |
Base implementation for search areas working at module level.
Even if the search area works at multiple levels, if module is one of these levels it should extend this class, as this class provides helper methods for module level search management.
|
inherited |
Files related to the current document are attached, to the document object ready for indexing by Global Search.
The default implementation retrieves all files for the file areas returned by get_search_fileareas(). If you need to filter files to specific items per file area, you will need to override this method and explicitly provide the items.
document | $document | The current document |
void |
Reimplemented in block_html\search\content, core_search\base_activity, mod_data\search\entry, and mod_forum\search\post.
|
abstractinherited |
Can the current user see the document.
int | $id | The internal search area entity id. |
int | manager:ACCESS_xx constant |
Reimplemented in core_course\search\course, core_course\search\customfield, core_course\search\section, core_message\search\message_received, core_message\search\message_sent, core_search\base_activity, core_search\base_block, core_user\search\course_teacher, core_user\search\user, mod_book\search\chapter, mod_data\search\entry, mod_forum\search\post, mod_glossary\search\entry, and mod_wiki\search\collaborative_page.
|
inherited |
Returns the area id.
string |
core_search\base_mod::get_category_names | ( | ) |
Returns a list of category names associated with the area.
array |
Reimplemented from core_search\base.
|
protected |
Gets the course module for the required instanceid + modulename.
The returned data depends on the logged user, when calling this through self\get_document the admin user is used so everything would be returned.
No need more internal caching here, modinfo is already cached.
dml_missing_record_exception |
string | $modulename | The module name |
int | $instanceid | Module instance id (depends on the module) |
int | $courseid | Helps speeding up things |
cm_info |
|
inherited |
Returns the moodle component name.
It might be the plugin name (whole frankenstyle name) or the core subsystem name.
string |
Reimplemented in core_course\search\course, core_course\search\customfield, core_course\search\section, core_user\search\course_teacher, and core_user\search\user.
|
inherited |
Returns the component type.
It might be a plugintype or 'core' for core subsystems.
string |
|
inherited |
Returns all the search area configuration.
array |
|
inherited |
Returns the config var name.
It depends on whether it is a moodle subsystem or a plugin as plugin-related config should remain in their own scope.
string | Config var path including the plugin (or component) and the varname |
|
protected |
Helper function that gets SQL useful for restricting a search query given a passed-in context.
The SQL returned will be zero or more JOIN statements, surrounded by whitespace, which act as restrictions on the query based on the rows in a module table.
You can pass in a null or system context, which will both return an empty string and no params.
Returns an array with two nulls if there can be no results for the activity within this context (e.g. it is a block context).
If named parameters are used, these will be named gcrs0, gcrs1, etc. The table aliases used in SQL also all begin with gcrs, to avoid conflicts.
context | null | $context | Context to restrict the query |
string | $modname | Name of module e.g. 'forum' |
string | $modtable | Alias of table containing module id |
int | $paramtype | Type of SQL parameters to use (default question mark) |
array | Array with SQL and parameters; both null if no need to query |
coding_exception | If called with invalid params |
|
abstractinherited |
Returns a url to the document context.
core_search\document | $doc |
moodle_url |
Reimplemented in core_search\base_activity, and core_search\base_block.
core_search\base_mod::get_contexts_to_reindex | ( | ) |
Gets a list of all contexts to reindex when reindexing this search area.
For modules, the default is to return all contexts for modules of that type, in order of time added (most recent first).
Iterator | Iterator of contexts to reindex |
moodle_exception | If any DB error |
Reimplemented from core_search\base.
|
protected |
This can be used in subclasses to change ordering within the get_contexts_to_reindex function.
It returns 2 values:
Note the query already includes a GROUP BY on the context fields, so if your joins result in multiple rows, you can use aggregate functions in the ORDER BY. See forum for an example.
string[] | Array with 2 elements; extra joins for the query, and ORDER BY value |
Reimplemented in mod_forum\search\post.
|
protectedinherited |
Helper function that gets SQL useful for restricting a search query given a passed-in context, for data stored at course level.
The SQL returned will be zero or more JOIN statements, surrounded by whitespace, which act as restrictions on the query based on the rows in a module table.
You can pass in a null or system context, which will both return an empty string and no params.
Returns an array with two nulls if there can be no results for a course within this context.
If named parameters are used, these will be named gclcrs0, gclcrs1, etc. The table aliases used in SQL also all begin with gclcrs, to avoid conflicts.
context | null | $context | Context to restrict the query |
string | $coursetable | Name of alias for course table e.g. 'c' |
int | $paramtype | Type of SQL parameters to use (default question mark) |
array | Array with SQL and parameters; both null if no need to query |
coding_exception | If called with invalid params |
core_search\base_mod::get_doc_icon | ( | document | $doc | ) |
Returns an icon instance for the document.
core_search\document | $doc |
core_search\document_icon |
Reimplemented from core_search\base.
|
abstractinherited |
Returns a url to the document, it might match self\get_context_url().
core_search\document | $doc |
moodle_url |
Reimplemented in core_search\base_activity, and core_search\base_block.
|
abstractinherited |
Returns the document related with the provided record.
This method receives a record with the document id and other info returned by get_recordset_by_timestamp or get_recordset_by_contexts that might be useful here. The idea is to restrict database queries to minimum as this function will be called for each document to index. As an alternative, use cached data.
Internally it should use core_search\document to standarise the documents before sending them to the search engine.
Search areas should send plain text to the search engine, use the following function to convert any user input data to plain text: content_to_text
Valid keys for the options array are: indexfiles => File indexing is enabled if true. lastindexedtime => The last time this area was indexed. 0 if never indexed.
The lastindexedtime value is not set if indexing a specific context rather than the whole system.
stdClass | $record | A record containing, at least, the indexed document id and a modified timestamp |
array | $options | Options for document creation |
core_search\document |
Reimplemented in block_html\search\content, core_course\search\course, core_course\search\customfield, core_course\search\section, core_message\search\base_message, core_message\search\message_received, core_message\search\message_sent, core_search\base_activity, core_user\search\course_teacher, core_user\search\user, mod_bigbluebuttonbn\search\tags, mod_book\search\chapter, mod_data\search\entry, mod_forum\search\post, mod_glossary\search\entry, mod_page\search\activity, mod_url\search\activity, and mod_wiki\search\collaborative_page.
|
inherited |
Returns the document title to display.
Allow to customize the document title string to display.
core_search\document | $doc |
string | Document title to display in the search results page |
|
inherited |
Returns a recordset containing all items from this area, optionally within the given context, and including only items modifed from (>=) the specified time.
The recordset must be ordered in ascending order of modified time.
Each record can include any data self\get_document might need. It must include an 'id' field,a unique identifier (in this area's scope) of a document to index in the search engine. If the indexed content field can contain embedded files, the 'id' value should match the filearea itemid.
The return value can be a recordset, null (if this area does not provide any results in the given context and there is no need to do a database query to find out), or false (if this facility is not currently supported by this search area).
If this function returns false, then:
The default implementation returns false, indicating that this facility is not supported and the older get_recordset_by_timestamp function should be used.
This function must accept all possible values for the $context parameter. For example, if you are implementing this function for the forum module, it should still operate correctly if called with the context for a glossary module, or for the HTML block. (In these cases where it will not return any data, it may return null.)
The $context parameter can also be null or the system context; both of these indicate that all data, without context restriction, should be returned.
int | $modifiedfrom | Return only records modified after this date |
context | null | $context | Context (null means no context restriction) |
moodle_recordset|null|false | Recordset / null if no results / false if not supported |
Reimplemented in core_course\search\course, core_course\search\customfield, core_course\search\section, core_message\search\message_received, core_message\search\message_sent, core_search\base_activity, core_search\base_block, core_user\search\course_teacher, core_user\search\user, mod_bigbluebuttonbn\search\tags, mod_book\search\chapter, mod_data\search\entry, mod_forum\search\post, mod_glossary\search\entry, mod_survey\search\activity, and mod_wiki\search\collaborative_page.
|
inherited |
Gets the length of time spent indexing this area (the last time it was indexed).
int|bool | Time in seconds spent indexing this area last time, false if never indexed |
|
staticinherited |
Returns context levels property.
int |
|
protected |
Returns the module name.
string |
|
inherited |
Returns a recordset ordered by modification date ASC.
Each record can include any data self\get_document might need but it must:
Since Moodle 3.4, subclasses should instead implement get_document_recordset, which has an additional context parameter. This function continues to work for implementations which haven't been updated, or where the context parameter is not required.
int | $modifiedfrom |
moodle_recordset |
|
inherited |
Return the context info required to index files for this search area.
Should be onerridden by each search area.
array |
Reimplemented in core_course\search\course, core_course\search\section, core_search\base_activity, core_user\search\user, mod_assign\search\activity, mod_book\search\chapter, mod_folder\search\activity, mod_forum\search\post, mod_glossary\search\entry, mod_lesson\search\activity, mod_page\search\activity, mod_resource\search\activity, mod_scorm\search\activity, mod_wiki\search\collaborative_page, and mod_workshop\search\activity.
|
staticinherited |
Return a list of all required setting names.
array |
|
inherited |
Returns the area visible name.
bool | $lazyload | Usually false, unless when in admin settings. |
string |
|
inherited |
Is the search component enabled by the system administrator?
bool |
core_search\base_mod::restrict_cm_access_by_group | ( | \cm_info | $cm | ) |
Checks whether the content of this search area should be restricted by group for a specific module.
Called at query time.
The default behaviour simply checks if the effective group mode is SEPARATEGROUPS, which is probably correct for most cases.
If restricted by group, the search query will (where supported by the engine) filter out results for groups the user does not belong to, unless the user has 'access all groups' for the activity. This affects only documents which set the 'groupid' field; results with no groupid will not be restricted.
Even if you return true to this function, you may still need to do group access checks in check_access, because the search engine may not support group restrictions.
cm_info | $cm |
bool | True to restrict by group |
|
inherited |
Checks if get_document_recordset is supported for this search area.
For many uses you can simply call get_document_recordset and see if it returns false, but this function is useful when you don't want to actually call the function right away.
core_search\base_mod::supports_group_restriction | ( | ) |
Indicates whether this search area may restrict access by group.
This should return true if the search area (sometimes) sets the 'groupid' schema field, and false if it never sets that field.
(If this function returns false, but the field is set, then results may be restricted unintentionally.)
If this returns true, the search engine will automatically apply group restrictions in some cases (by default, where a module is configured to use separate groups). See function restrict_cm_access_by_group().
bool |
Reimplemented in mod_data\search\entry, mod_forum\search\post, and mod_wiki\search\collaborative_page.
|
inherited |
Returns true if this area uses file indexing.
bool |
Reimplemented in block_html\search\content, core_course\search\course, core_course\search\section, core_user\search\user, mod_assign\search\activity, mod_bigbluebuttonbn\search\activity, mod_bigbluebuttonbn\search\tags, mod_book\search\activity, mod_book\search\chapter, mod_chat\search\activity, mod_choice\search\activity, mod_data\search\activity, mod_data\search\entry, mod_feedback\search\activity, mod_folder\search\activity, mod_forum\search\activity, mod_forum\search\post, mod_glossary\search\activity, mod_glossary\search\entry, mod_h5pactivity\search\activity, mod_imscp\search\activity, mod_label\search\activity, mod_lesson\search\activity, mod_lti\search\activity, mod_page\search\activity, mod_quiz\search\activity, mod_resource\search\activity, mod_scorm\search\activity, mod_survey\search\activity, mod_url\search\activity, mod_wiki\search\activity, mod_wiki\search\collaborative_page, and mod_workshop\search\activity.
|
staticprotected |
The context levels the search area is working on.
This can be overwriten by the search area if it works at multiple levels.