Base search implementation. More...

Inheritance diagram for core_search\base:

Public Member Functions
	__construct ()
	Constructor. More...

	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)
	Can the current user see the document. 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)
	Returns a url to the document context. 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)
	Returns a url to the document, it might match self::get_context_url(). More...

	get_document ($record, $options=array())
	Returns the document related with the provided record. 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 a recordset containing all items from this area, optionally within the given context, and including only items modifed from (>=) the specified time. 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...

	set_enabled ($isenabled)

	supports_get_document_recordset ()
	Checks if get_document_recordset is supported for this search area. 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...

Protected Member Functions
	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...

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_SYSTEM]
	The context levels the search implementation is working on.

Detailed Description

Base search implementation.

Components and plugins interested in filling the search engine with data should extend this class (or any extension of this class).

Copyright: 2015 David Monllao

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

Constructor & Destructor Documentation

◆ __construct()

core_search\base::__construct ( )

final

Constructor.

Exceptions

coding_exception

Return values

void

Member Function Documentation

◆ attach_files()

core_search\base::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 $document The current document

Return values

void

Reimplemented in mod_data\search\entry, block_html\search\content, mod_forum\search\post, and core_search\base_activity.

◆ check_access()

core_search\base::check_access ( $id )

abstract

Can the current user see the document.

Parameters

int $id The internal search area entity id.

Return values

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, mod_book\search\chapter, mod_data\search\entry, mod_forum\search\post, mod_glossary\search\entry, mod_wiki\search\collaborative_page, core_search\base_activity, core_search\base_block, and core_user\search\user.

◆ get_area_id()

core_search\base::get_area_id ( )

Returns the area id.

Return values

string

◆ get_category_names()

core_search\base::get_category_names ( )

Returns a list of category names associated with the area.

Return values

array

Reimplemented in core_course\search\course, core_course\search\customfield, core_course\search\section, core_message\search\base_message, core_search\base_block, core_search\base_mod, and core_user\search\user.

◆ get_component_name()

core_search\base::get_component_name ( )

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_course\search\course, core_course\search\customfield, core_course\search\section, and core_user\search\user.

◆ get_component_type()

core_search\base::get_component_type ( )

Returns the component type.

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

Return values

string

◆ get_config()

core_search\base::get_config ( )

Returns all the search area configuration.

Return values

array

◆ get_config_var_name()

core_search\base::get_config_var_name ( )

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

string Config var path including the plugin (or component) and the varname

◆ get_context_url()

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

abstract

Returns a url to the document context.

Parameters

core_search::document $doc

Return values

moodle_url

Reimplemented in core_search\base_activity, and core_search\base_block.

◆ get_contexts_to_reindex()

core_search\base::get_contexts_to_reindex ( )

Gets a list of all contexts to reindex when reindexing this search area.

The list should be returned in an order that is likely to be suitable when reindexing, for example with newer contexts first.

The default implementation simply returns the system context, which will result in reindexing everything in normal date order (oldest first).

Return values

Iterator Iterator of contexts to reindex

Reimplemented in core_search\base_block, and core_search\base_mod.

◆ get_course_level_context_restriction_sql()

core_search\base::get_course_level_context_restriction_sql	(	\context	$context = `null`,
			$coursetable,
			$paramtype = `SQL_PARAMS_QM`
	)

protected

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

Return values

array Array with SQL and parameters; both null if no need to query

Exceptions

coding_exception If called with invalid params

◆ get_doc_icon()

core_search\base::get_doc_icon ( document $doc )

Returns an icon instance for the document.

Parameters

core_search::document $doc

Return values

core_search::document_icon

Reimplemented in core_search\base_block, and core_search\base_mod.

◆ get_doc_url()

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

abstract

Returns a url to the document, it might match self::get_context_url().

Parameters

core_search::document $doc

Return values

moodle_url

Reimplemented in core_search\base_activity, and core_search\base_block.

◆ get_document()

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

abstract

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.

Parameters

stdClass	$record	A record containing, at least, the indexed document id and a modified timestamp
array	$options	Options for document creation

Return values

core_search::document

Reimplemented in mod_data\search\entry, mod_glossary\search\entry, 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, mod_book\search\chapter, mod_forum\search\post, mod_page\search\activity, mod_url\search\activity, mod_wiki\search\collaborative_page, core_search\base_activity, and core_user\search\user.

◆ get_document_display_title()

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

Returns the document title to display.

Allow to customize the document title string to display.

Parameters

core_search::document $doc

Return values

string Document title to display in the search results page

◆ get_document_recordset()

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

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:

If indexing the entire system (no context restriction) the search indexer will try get_recordset_by_timestamp instead
If trying to index a context (e.g. when restoring a course), the search indexer will not index this area, so that restored content may not be indexed.

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.

Parameters

int	$modifiedfrom	Return only records modified after this date
context \| null	$context	Context (null means no context restriction)

Return values

moodle_recordset|null|false Recordset / null if no results / false if not supported

Since: Moodle 3.4

Reimplemented in core_course\search\course, core_course\search\customfield, core_course\search\section, core_message\search\message_received, core_message\search\message_sent, mod_book\search\chapter, mod_data\search\entry, mod_forum\search\post, mod_glossary\search\entry, mod_survey\search\activity, mod_wiki\search\collaborative_page, core_search\base_activity, core_search\base_block, and core_user\search\user.

◆ get_last_indexing_duration()

core_search\base::get_last_indexing_duration ( )

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

Return values

int|bool Time in seconds spent indexing this area last time, false if never indexed

◆ get_levels()

static core_search\base::get_levels ( )

static

Returns context levels property.

Return values

int

◆ get_recordset_by_timestamp()

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

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::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 in core_course\search\course, core_course\search\section, 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_wiki\search\collaborative_page, mod_workshop\search\activity, core_search\base_activity, and core_user\search\user.

◆ get_settingnames()

static core_search\base::get_settingnames ( )

static

Return a list of all required setting names.

Return values

array

◆ get_visible_name()

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

Returns the area visible name.

Parameters

bool $lazyload Usually false, unless when in admin settings.

Return values

string

◆ is_enabled()

core_search\base::is_enabled ( )

Is the search component enabled by the system administrator?

Return values

bool

◆ supports_get_document_recordset()

core_search\base::supports_get_document_recordset ( )

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.

◆ uses_file_indexing()

core_search\base::uses_file_indexing ( )

Returns true if this area uses file indexing.

Return values

bool

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

search/classes/base.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ attach_files()

◆ check_access()

◆ get_area_id()

◆ get_category_names()

◆ get_component_name()

◆ get_component_type()

◆ get_config()

◆ get_config_var_name()

◆ get_context_url()

◆ get_contexts_to_reindex()

◆ get_course_level_context_restriction_sql()

◆ get_doc_icon()

◆ get_doc_url()

◆ get_document()

◆ get_document_display_title()

◆ get_document_recordset()

◆ get_last_indexing_duration()

◆ get_levels()

◆ get_recordset_by_timestamp()

◆ get_search_fileareas()

◆ get_settingnames()

◆ get_visible_name()

◆ is_enabled()

◆ supports_get_document_recordset()

◆ uses_file_indexing()