Moodle APIs  3.8
Moodle 3.8.6 (Build: 20201109)
Public Member Functions | Static Public Member Functions | Public Attributes | Protected Member Functions | Protected Attributes | Static Protected Attributes | List of all members
core_search\base_activity Class Reference

Base implementation for activity modules. More...

Inheritance diagram for core_search\base_activity:
core_search\base_mod core_search\base mod_assign\search\activity mod_book\search\activity mod_chat\search\activity mod_choice\search\activity mod_data\search\activity mod_feedback\search\activity mod_folder\search\activity mod_forum\search\activity mod_glossary\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_workshop\search\activity

Public Member Functions

 attach_files ($document)
 Files related to the current document are attached, to the document object ready for indexing by Global Search. More...
 
 check_access ($id)
 Whether the user can access the document or not. More...
 
 get_area_id ()
 Returns the area id. More...
 
 get_category_names ()
 Returns a list of category names associated with the area. More...
 
 get_component_name ()
 Returns the moodle component name. More...
 
 get_component_type ()
 Returns the component type. More...
 
 get_config ()
 Returns all the search area configuration. More...
 
 get_config_var_name ()
 Returns the config var name. More...
 
 get_context_url (\core_search\document $doc)
 Link to the module instance. More...
 
 get_contexts_to_reindex ()
 Gets a list of all contexts to reindex when reindexing this search area. More...
 
 get_doc_icon (document $doc)
 Returns an icon instance for the document. More...
 
 get_doc_url (\core_search\document $doc)
 Link to the module instance. More...
 
 get_document ($record, $options=array())
 Returns the document associated with this activity. More...
 
 get_document_display_title (\core_search\document $doc)
 Returns the document title to display. More...
 
 get_document_recordset ($modifiedfrom=0, context $context=null)
 Returns recordset containing all activities within the given context. More...
 
 get_last_indexing_duration ()
 Gets the length of time spent indexing this area (the last time it was indexed). More...
 
 get_recordset_by_timestamp ($modifiedfrom=0)
 Returns a recordset ordered by modification date ASC. More...
 
 get_search_fileareas ()
 Return the context info required to index files for this search area. More...
 
 get_visible_name ($lazyload=false)
 Returns the area visible name. More...
 
 is_enabled ()
 Is the search component enabled by the system administrator? More...
 
 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. More...
 
 set_enabled ($isenabled)
 
 supports_get_document_recordset ()
 Checks if get_document_recordset is supported for this search area. More...
 
 supports_group_restriction ()
 Indicates whether this search area may restrict access by group. More...
 
 uses_file_indexing ()
 Returns true if this area uses file indexing. More...
 

Static Public Member Functions

static get_levels ()
 Returns context levels property. More...
 
static get_settingnames ()
 Return a list of all required setting names. More...
 

Public Attributes

const CREATED_FIELD_NAME = ''
 Activities with a time created field can overwrite this constant.
 
string const MODIFIED_FIELD_NAME = 'timemodified'
 The time modified field name. More...
 

Protected Member Functions

 get_activity ($instanceid)
 Returns an activity instance. More...
 
 get_cm ($modulename, $instanceid, $courseid)
 Gets the course module for the required instanceid + modulename. More...
 
 get_context_restriction_sql (\context $context=null, $modname, $modtable, $paramtype=SQL_PARAMS_QM)
 Helper function that gets SQL useful for restricting a search query given a passed-in context. More...
 
 get_contexts_to_reindex_extra_sql ()
 This can be used in subclasses to change ordering within the get_contexts_to_reindex function. More...
 
 get_course_level_context_restriction_sql (\context $context=null, $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. More...
 
 get_module_name ()
 Returns the module name. More...
 

Protected Attributes

string $areaname = null
 The area name as defined in the class name.
 
string $componentname = null
 The component frankenstyle name.
 
string $componenttype = null
 The component type (core or the plugin type).
 

Static Protected Attributes

static array $levels = [CONTEXT_MODULE]
 The context levels the search area is working on.
 

Detailed Description

Base implementation for activity modules.

License
http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Member Function Documentation

◆ attach_files()

core_search\base_activity::attach_files (   $document)

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.

Parameters
document$documentThe current document
Return values
void

Reimplemented from core_search\base.

◆ check_access()

core_search\base_activity::check_access (   $id)

Whether the user can access the document or not.

Exceptions
dml_missing_record_exception
dml_exception
Parameters
int$idThe activity instance id.
Return values
bool

Reimplemented from core_search\base.

◆ get_activity()

core_search\base_activity::get_activity (   $instanceid)
protected

Returns an activity instance.

Internally uses the class component to know which activity module should be retrieved.

Parameters
int$instanceid
Return values
stdClass

◆ get_area_id()

core_search\base::get_area_id ( )
inherited

Returns the area id.

Return values
string

◆ get_category_names()

core_search\base_mod::get_category_names ( )
inherited

Returns a list of category names associated with the area.

Return values
array

Reimplemented from core_search\base.

◆ get_cm()

core_search\base_mod::get_cm (   $modulename,
  $instanceid,
  $courseid 
)
protectedinherited

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.

Exceptions
dml_missing_record_exception
Parameters
string$modulenameThe module name
int$instanceidModule instance id (depends on the module)
int$courseidHelps speeding up things
Return values
cm_info

◆ get_component_name()

core_search\base::get_component_name ( )
inherited

Returns the moodle component name.

It might be the plugin name (whole frankenstyle name) or the core subsystem name.

Return values
string

Reimplemented in core_user\search\user, core_course\search\section, core_course\search\customfield, and core_course\search\course.

◆ get_component_type()

core_search\base::get_component_type ( )
inherited

Returns the component type.

It might be a plugintype or 'core' for core subsystems.

Return values
string

◆ get_config()

core_search\base::get_config ( )
inherited

Returns all the search area configuration.

Return values
array

◆ get_config_var_name()

core_search\base::get_config_var_name ( )
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.

Return values
stringConfig var path including the plugin (or component) and the varname

◆ get_context_restriction_sql()

core_search\base_mod::get_context_restriction_sql ( \context  $context = null,
  $modname,
  $modtable,
  $paramtype = SQL_PARAMS_QM 
)
protectedinherited

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.

Parameters
context | null$contextContext to restrict the query
string$modnameName of module e.g. 'forum'
string$modtableAlias of table containing module id
int$paramtypeType of SQL parameters to use (default question mark)
Return values
arrayArray with SQL and parameters; both null if no need to query
Exceptions
coding_exceptionIf called with invalid params

◆ get_context_url()

core_search\base_activity::get_context_url ( \core_search\document  $doc)

Link to the module instance.

Parameters
core_search\document$doc
Return values
moodle_url

Reimplemented from core_search\base.

◆ get_contexts_to_reindex()

core_search\base_mod::get_contexts_to_reindex ( )
inherited

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).

Return values
IteratorIterator of contexts to reindex
Exceptions
moodle_exceptionIf any DB error

Reimplemented from core_search\base.

◆ get_contexts_to_reindex_extra_sql()

core_search\base_mod::get_contexts_to_reindex_extra_sql ( )
protectedinherited

This can be used in subclasses to change ordering within the get_contexts_to_reindex function.

It returns 2 values:

  • Extra SQL joins (tables course_modules 'cm' and context 'x' already exist).
  • An ORDER BY value which must use aggregate functions, by default 'MAX(cm.added) DESC'.

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.

Return values
string[]Array with 2 elements; extra joins for the query, and ORDER BY value

Reimplemented in mod_forum\search\post.

◆ get_course_level_context_restriction_sql()

core_search\base::get_course_level_context_restriction_sql ( \context  $context = null,
  $coursetable,
  $paramtype = SQL_PARAMS_QM 
)
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.

Parameters
context | null$contextContext to restrict the query
string$coursetableName of alias for course table e.g. 'c'
int$paramtypeType of SQL parameters to use (default question mark)
Return values
arrayArray with SQL and parameters; both null if no need to query
Exceptions
coding_exceptionIf called with invalid params

◆ get_doc_icon()

core_search\base_mod::get_doc_icon ( document  $doc)
inherited

Returns an icon instance for the document.

Parameters
core_search\document$doc
Return values
core_search

Reimplemented from core_search\base.

◆ get_doc_url()

core_search\base_activity::get_doc_url ( \core_search\document  $doc)

Link to the module instance.

Parameters
core_search\document$doc
Return values
moodle_url

Reimplemented from core_search\base.

◆ get_document()

core_search\base_activity::get_document (   $record,
  $options = array() 
)

Returns the document associated with this activity.

This default implementation for activities sets the activity name to title and the activity intro to content. Any activity can overwrite this function if it is interested in setting other fields than the default ones, or to fill description optional fields with extra stuff.

Parameters
stdClass$record
array$options
Return values
core_search

Reimplemented from core_search\base.

Reimplemented in mod_url\search\activity, and mod_page\search\activity.

◆ get_document_display_title()

core_search\base::get_document_display_title ( \core_search\document  $doc)
inherited

Returns the document title to display.

Allow to customize the document title string to display.

Parameters
core_search\document$doc
Return values
stringDocument title to display in the search results page

◆ get_document_recordset()

core_search\base_activity::get_document_recordset (   $modifiedfrom = 0,
context  $context = null 
)

Returns recordset containing all activities within the given context.

Parameters
context | null$contextContext
int$modifiedfromReturn only records modified after this date
Return values
moodle_recordset|nullRecordset, or null if no possible activities in given context

Reimplemented from core_search\base.

Reimplemented in mod_survey\search\activity.

◆ get_last_indexing_duration()

core_search\base::get_last_indexing_duration ( )
inherited

Gets the length of time spent indexing this area (the last time it was indexed).

Return values
int|boolTime in seconds spent indexing this area last time, false if never indexed

◆ get_levels()

static core_search\base::get_levels ( )
staticinherited

Returns context levels property.

Return values
int

◆ get_module_name()

core_search\base_mod::get_module_name ( )
protectedinherited

Returns the module name.

Return values
string

◆ get_recordset_by_timestamp()

core_search\base::get_recordset_by_timestamp (   $modifiedfrom = 0)
inherited

Returns a recordset ordered by modification date ASC.

Each record can include any data self::get_document might need but it must:

  • Include an 'id' field: 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.
  • Only return data modified since $modifiedfrom, including $modifiedform to prevent some records from not being indexed (e.g. your-timemodified-fieldname >= $modifiedfrom)
  • Order the returned data by time modified in ascending order, as core_search::manager will need to store the modified time of the last indexed document.

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.

Parameters
int$modifiedfrom
Return values
moodle_recordset

◆ get_search_fileareas()

core_search\base_activity::get_search_fileareas ( )

Return the context info required to index files for this search area.

Should be onerridden by each search area.

Return values
array

Reimplemented from core_search\base.

Reimplemented in mod_workshop\search\activity, mod_resource\search\activity, mod_page\search\activity, mod_lesson\search\activity, mod_folder\search\activity, and mod_assign\search\activity.

◆ get_settingnames()

static core_search\base::get_settingnames ( )
staticinherited

Return a list of all required setting names.

Return values
array

◆ get_visible_name()

core_search\base::get_visible_name (   $lazyload = false)
inherited

Returns the area visible name.

Parameters
bool$lazyloadUsually false, unless when in admin settings.
Return values
string

◆ is_enabled()

core_search\base::is_enabled ( )
inherited

Is the search component enabled by the system administrator?

Return values
bool

◆ restrict_cm_access_by_group()

core_search\base_mod::restrict_cm_access_by_group ( \cm_info  $cm)
inherited

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.

Parameters
cm_info$cm
Return values
boolTrue to restrict by group

◆ supports_get_document_recordset()

core_search\base::supports_get_document_recordset ( )
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.

◆ supports_group_restriction()

core_search\base_mod::supports_group_restriction ( )
inherited

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().

Return values
bool

Reimplemented in mod_wiki\search\collaborative_page, mod_forum\search\post, and mod_data\search\entry.

◆ uses_file_indexing()

core_search\base::uses_file_indexing ( )
inherited

Member Data Documentation

◆ MODIFIED_FIELD_NAME

string const core_search\base_activity::MODIFIED_FIELD_NAME = 'timemodified'

The time modified field name.

Activities not using timemodified as field name can overwrite this constant.


The documentation for this class was generated from the following file: