qbank_managecategories\helper Class Reference

Inheritance diagram for qbank_managecategories\helper:

Static Public Member Functions
static	add_indented_names (array $categories, int $nochildrenof=-1)
	Format categories into an indented list reflecting the tree structure.
static	combine_id_context (\stdClass $category)
	Combine id and context id for a question category.
static	flatten_category_tree (array &$categories, $id, int $depth=0, int $nochildrenof=-1)
	Only for the use of add_indented_names().
static	get_categories_for_contexts (string $contexts, string $sortorder='parent, sortorder, name ASC', bool $top=false, int $showallversions=0,)
	Get all the category objects, including a count of the number of questions in that category, for all the categories in the lists $contexts.
static	question_add_context_in_key (array $categories)
	Add context in categories key.
static	question_category_options (array $contexts, bool $top=false, int $currentcat=0, bool $popupform=false, int $nochildrenof=-1, bool $escapecontextnames=true,)
	Output an array of question categories.
static	question_category_select_menu (array $contexts, bool $top=false, int $currentcat=0, string $selected="", int $nochildrenof=-1, bool $return=false,)
	Output a select menu of question categories.
static	question_fix_top_names (array $categories, bool $escape=true)
	Finds top categories in the given categories hierarchy and replace their name with a proper localised string.
static	question_remove_stale_questions_from_category (int $categoryid)
	Remove stale questions from a category.

Public Attributes
	$manager = new category_manager()
since	__FUNCTION__
since	: 4.5
since	: 4.5
since	: 4.5
since	mdl: '<a class="el" href="https: )] public static function question_is_only_child_of_top_category_in_context(int $categoryid): bool { core\deprecation::emit_deprecation_if_present([__CLASS__
const	PLUGINNAME = 'qbank_managecategories'
	Name of this plugin.
since	reason: 'Moved to core namespace'

Member Function Documentation

add_indented_names()

static qbank_managecategories\helper::add_indented_names ( array $categories, int $nochildrenof = -1 )

static

Format categories into an indented list reflecting the tree structure.

Parameters

array	$categories	An array of category objects, for example from the.
int	$nochildrenof

Return values

array

The formatted list of categories.

combine_id_context()

static qbank_managecategories\helper::combine_id_context ( \stdClass $category )

static

Combine id and context id for a question category.

Parameters

stdClass

$category

a category to extract its id and context id

Return values

string

the combined string

flatten_category_tree()

static qbank_managecategories\helper::flatten_category_tree ( array & $categories, $id, int $depth = 0, int $nochildrenof = -1 )

static

Only for the use of add_indented_names().

Recursively adds an indentedname field to each category, starting with the category with id $id, and dealing with that category and all its children, and return a new array, with those categories in the right order.

Parameters

array	$categories	an array of categories which has had childids fields added by flatten_category_tree(). Passed by reference for performance only. It is not modfied.
int	$id	the category to start the indenting process from.
int	$depth	the indent depth. Used in recursive calls.
int	$nochildrenof

Return values

array

a new array of categories, in the right order for the tree.

get_categories_for_contexts()

static qbank_managecategories\helper::get_categories_for_contexts ( string $contexts, string $sortorder = 'parent, sortorder , name ASC' , bool $top = false, int $showallversions = 0 )

static

Get all the category objects, including a count of the number of questions in that category, for all the categories in the lists $contexts.

Parameters

string	$contexts	comma separated list of contextids
string	$sortorder	used as the ORDER BY clause in the select statement.
bool	$top	Whether to return the top categories or not.
int	$showallversions	1 to show all versions not only the latest.

Return values

array

of category objects.

Exceptions

dml_exception

question_add_context_in_key()

static qbank_managecategories\helper::question_add_context_in_key ( array $categories )

static

Add context in categories key.

Parameters

array

$categories

The list of categories.

Return values

array

question_category_options()

static qbank_managecategories\helper::question_category_options ( array $contexts, bool $top = false, int $currentcat = 0, bool $popupform = false, int $nochildrenof = -1, bool $escapecontextnames = true )

static

Output an array of question categories.

Parameters

array	$contexts	The list of contexts.
bool	$top	Whether to return the top categories or not.
int	$currentcat
bool	$popupform
int	$nochildrenof
bool	$escapecontextnames	Whether the returned name of the thing is to be HTML escaped or not.

Return values

array

Exceptions

coding_exception|dml_exception

Reimplemented in mod_quiz\question\bank\filter\custom_category_condition_helper.

question_category_select_menu()

static qbank_managecategories\helper::question_category_select_menu ( array $contexts, bool $top = false, int $currentcat = 0, string $selected = "", int $nochildrenof = -1, bool $return = false )

static

Output a select menu of question categories.

Categories from this course and (optionally) published categories from other courses are included. Optionally, only categories the current user may edit can be included.

Parameters

array	$contexts
bool	$top
int	$currentcat
string	$selected	optionally, the id of a category to be selected by default in the dropdown.
int	$nochildrenof
bool	$return	to return the string of the select menu or echo that from the method

Return values

?string

The HTML, or null if the $return is false.

Exceptions

coding_exception|dml_exception

question_fix_top_names()

static qbank_managecategories\helper::question_fix_top_names ( array $categories, bool $escape = true )

static

Finds top categories in the given categories hierarchy and replace their name with a proper localised string.

Parameters

array	$categories	An array of question categories.
bool	$escape	Whether the returned name of the thing is to be HTML escaped or not.

Return values

array

The same question category list given to the function, with the top category names being translated.

Exceptions

coding_exception

question_remove_stale_questions_from_category()

static qbank_managecategories\helper::question_remove_stale_questions_from_category ( int $categoryid )

static

Remove stale questions from a category.

This finds and removes any old-style random questions (qtype = random), or any questions that were deleted while they were in use by a quiz (status = hidden), but those usages have since been removed.

If a category only contains stale questions, the users are unable to delete the question category unless they move those stale questions to another one category, but to them the category may appear empty. The purpose of this function is to detect the questions that may have gone stale and remove them.

You will typically use this prior to checking if the category contains questions.

Parameters

int

$categoryid

The category ID.

Exceptions

dml_exception

---

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

• question/bank/managecategories/classes/helper.php