admin_setting_configtext Class Reference

The most flexible setting, the user enters text. More...

Inheritance diagram for admin_setting_configtext:

Public Member Functions
	__construct ($name, $visiblename, $description, $defaultsetting, $paramtype=PARAM_RAW, $size=null)
	Config text constructor.
	add_dependent_on ($dependenton)
	Add a setting to the list of those that could cause this one to be hidden.
	config_read ($name)
	Returns the config if possible.
	config_write ($name, $value)
	Used to set a config pair and log change.
	get_defaultsetting ()
	Returns default setting if exists.
	get_dependent_on ()
	Get a list of the settings that could cause this one to be hidden.
	get_force_ltr ()
	Get whether this should be displayed in LTR mode.
	get_full_name ()
	Returns the fullname prefixed by the plugin.
	get_id ()
	Returns the ID string based on plugin and name.
	get_setting ()
	Return the setting.
	get_setting_flag_defaults (& $defaults)
	Get the list of defaults for the flags on this setting.
	get_setting_flag_value (admin_setting_flag $flag)
	Get the currently saved value for a setting flag.
	has_custom_form_control ()
	Whether this setting uses a custom form control.
	is_forceable ()
	Whether the setting can be overridden in config.php.
	is_readonly ()
	Is this option forced in config.php?
	is_related ($query)
	Is setting related to query text - used when searching.
	output_html ($data, $query='')
	Return an XHTML string for the setting.
	output_setting_flags ()
	Output the input fields for the advanced and locked flags on this setting.
	post_write_settings ($original)
	Execute postupdatecallback if necessary.
	set_advanced_flag_options ($enabled, $default)
	Set the advanced options flag on this admin setting.
	set_affects_modinfo ($affectsmodinfo)
	set_enabled_flag_options ($enabled, $default)
	Set the enabled options flag on this admin setting.
	set_force_ltr ($value)
	Set whether to force LTR or not.
	set_locked_flag_options ($enabled, $default)
	Set the locked options flag on this admin setting.
	set_required_flag_options ($enabled, $default)
	Set the required options flag on this admin setting.
	set_updatedcallback ($functionname)
	Function called if setting updated - cleanup, cache reset, etc.
	validate ($data)
	Validate data before storage.
	write_setting ($data)
	Store new setting.
	write_setting_flags ($data)
	Write the values of the flags for this admin setting.

Public Attributes
bool	$affectsmodinfo = false
	if set, indicates that a change to this setting requires rebuild course cache
mixed	$defaultsetting
	Can be string or array of string.
string	$description
	localised long description in Markdown format
string	$name
	unique ascii name, either 'mysetting' for settings that in config, or 'myplugin/mysetting' for ones in config_plugins.
bool	$nosave = false
	true indicates this setting does not actually save anything, just information
mixed	$paramtype
	int means PARAM_XXX type, string is a allowed format in regex
mixed	$plugin
	can be String or Null.
int	$size
	default field size
string	$updatedcallback
lang_string string	$visiblename
	localised name

Protected Member Functions
	add_to_config_log ($name, $oldvalue, $value)
	Log config changes if necessary.
	set_flag_options ($enabled, $default, $shortname, $displayname)
	Generic function to add a flag to this admin setting.

Protected Attributes
bool	$customcontrol = false
	Whether this setting uses a custom form control.

Detailed Description

The most flexible setting, the user enters text.

This type of field should be used for config settings which are using English words and are not localised (passwords, database name, list of values, ...).

License

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

Constructor & Destructor Documentation

__construct()

admin_setting_configtext::__construct	(		$name,
			$visiblename,
			$description,
			$defaultsetting,
			$paramtype = PARAM_RAW,
			$size = null )

Config text constructor.

Parameters

string	$name	unique ascii name, either 'mysetting' for settings that in config, or 'myplugin/mysetting' for ones in config_plugins.
string	$visiblename	localised
string	$description	long localised info
string	$defaultsetting
mixed	$paramtype	int means PARAM_XXX type, string is a allowed format in regex
int	$size	default field size

Reimplemented in admin_setting_configtext_trim_lower, admin_setting_configtext_with_advanced, admin_setting_special_gradepointdefault, and admin_setting_special_gradepointmax.

Member Function Documentation

add_dependent_on()

admin_setting::add_dependent_on ( $dependenton )

inherited

Add a setting to the list of those that could cause this one to be hidden.

Parameters

string

$dependenton

add_to_config_log()

admin_setting::add_to_config_log ( $name, $oldvalue, $value )

protectedinherited

Log config changes if necessary.

Parameters

string	$name
string	$oldvalue
string	$value

Reimplemented in admin_setting_configpasswordunmask.

config_read()

admin_setting::config_read ( $name )

inherited

Returns the config if possible.

Return values

mixed

returns config if successful else null

Reimplemented in enrol_flatfile_role_setting.

config_write()

admin_setting::config_write ( $name, $value )

inherited

Used to set a config pair and log change.

Parameters

string	$name
mixed	$value	Gets converted to string if not null

Return values

bool	Write setting to config table

Reimplemented in enrol_flatfile_role_setting.

get_defaultsetting()

admin_setting::get_defaultsetting ( )

inherited

Returns default setting if exists.

Return values

mixed

array or string depending on instance; NULL means no default, user must supply

Reimplemented in admin_setting_description, admin_setting_heading, admin_setting_manage_plugins, admin_setting_manageantiviruses, admin_setting_manageauths, admin_setting_managecontentbankcontenttypes, admin_setting_managecustomfields, admin_setting_managedataformats, admin_setting_manageenrols, admin_setting_manageexternalservices, admin_setting_manageformats, admin_setting_managemediaplayers, admin_setting_managerepository, admin_setting_managewebserviceprotocols, admin_setting_php_extension_enabled, admin_setting_pickroles, admin_setting_searchsetupinfo, admin_setting_special_registerauth, admin_setting_users_with_capability, admin_setting_webservicesoverview, core_admin\admin\admin_setting_plugin_manager, core_question\admin\manage_qbank_plugins_page, editor_atto_subplugins_setting, enrol_lti\local\ltiadvantage\admin\admin_setting_registeredplatforms, mod_glossary_admin_setting_display_formats, and tool_log_setting_managestores.

get_dependent_on()

admin_setting::get_dependent_on ( )

inherited

Get a list of the settings that could cause this one to be hidden.

Return values

array

get_force_ltr()

admin_setting_configtext::get_force_ltr

(

)

Get whether this should be displayed in LTR mode.

Try to guess from the PARAM type unless specifically set.

Reimplemented from admin_setting.

Reimplemented in admin_setting_filetypes.

get_full_name()

admin_setting::get_full_name ( )

inherited

Returns the fullname prefixed by the plugin.

Return values

string

Reimplemented in admin_setting_managerepository.

get_id()

admin_setting::get_id ( )

inherited

Returns the ID string based on plugin and name.

Return values

string

get_setting()

admin_setting_configtext::get_setting

(

)

Return the setting.

Return values

mixed

returns config if successful else null

Reimplemented from admin_setting.

Reimplemented in admin_setting_configmixedhostiplist, admin_setting_sitesettext, and admin_setting_special_frontpagedesc.

get_setting_flag_defaults()

admin_setting::get_setting_flag_defaults ( & $defaults )

inherited

Get the list of defaults for the flags on this setting.

Parameters

array

of strings describing the defaults for this setting. This is appended to by this function.

get_setting_flag_value()

admin_setting::get_setting_flag_value ( admin_setting_flag $flag )

inherited

Get the currently saved value for a setting flag.

Parameters

admin_setting_flag

$flag

- One of the admin_setting_flag for this admin_setting.

Return values

bool

has_custom_form_control()

admin_setting::has_custom_form_control ( )

inherited

Whether this setting uses a custom form control.

This function is especially useful to decide if we should render a label element for this setting or not.

Return values

bool

is_forceable()

admin_setting::is_forceable ( )

inherited

Whether the setting can be overridden in config.php.

Returning true will allow the setting to be defined and overridden in config.php. Returning false will prevent the config setting from being overridden even when it gets defined in config.php.

Return values

bool

Reimplemented in admin_setting_sitesetcheckbox, admin_setting_sitesetselect, admin_setting_sitesettext, and admin_setting_special_frontpagedesc.

is_readonly()

admin_setting::is_readonly ( )

inherited

Is this option forced in config.php?

Return values

bool

is_related()

admin_setting::is_related ( $query )

inherited

Is setting related to query text - used when searching.

Parameters

string

$query

Return values

bool

Reimplemented in admin_setting_configmulticheckbox, admin_setting_configmultiselect, admin_setting_configselect, admin_setting_manage_plugins, admin_setting_manageantiviruses, admin_setting_manageauths, admin_setting_managecontentbankcontenttypes, admin_setting_managecustomfields, admin_setting_managedataformats, admin_setting_manageenrols, admin_setting_manageexternalservices, admin_setting_manageformats, admin_setting_managemediaplayers, admin_setting_managerepository, admin_setting_managewebserviceprotocols, core_admin\admin\admin_setting_plugin_manager, core_question\admin\manage_qbank_plugins_page, editor_atto_subplugins_setting, enrol_lti\local\ltiadvantage\admin\admin_setting_registeredplatforms, mod_glossary_admin_setting_display_formats, and tool_log_setting_managestores.

output_html()

admin_setting_configtext::output_html	(		$data,
			$query = '' )

Return an XHTML string for the setting.

Return values

string

Returns an XHTML string

Reimplemented from admin_setting.

Reimplemented in admin_setting_configdirectory, admin_setting_configempty, admin_setting_configexecutable, admin_setting_configfile, admin_setting_confightmleditor, admin_setting_configpasswordunmask, admin_setting_configtextarea, admin_setting_filetypes, and admin_setting_special_gradepointmax.

output_setting_flags()

admin_setting::output_setting_flags ( )

inherited

Output the input fields for the advanced and locked flags on this setting.

Parameters

bool	$adv	- The current value of the advanced flag.
bool	$locked	- The current value of the locked flag.

Return values

string\$output

- The html for the flags.

post_write_settings()

admin_setting::post_write_settings ( $original )

inherited

Execute postupdatecallback if necessary.

Parameters

mixed

$original

original value before write_setting()

Return values

bool	true if changed, false if not.

Reimplemented in admin_setting_configstoredfile.

set_advanced_flag_options()

admin_setting::set_advanced_flag_options ( $enabled, $default )

inherited

Set the advanced options flag on this admin setting.

Parameters

bool	$enabled	- One of self\OPTION_ENABLED or self\OPTION_DISABLED
bool	$default	- The default for the flag

set_affects_modinfo()

admin_setting::set_affects_modinfo ( $affectsmodinfo )

inherited

Parameters

bool

$affectsmodinfo

If true, changes to this setting will cause the course cache to be rebuilt

set_enabled_flag_options()

admin_setting::set_enabled_flag_options ( $enabled, $default )

inherited

Set the enabled options flag on this admin setting.

Parameters

bool	$enabled	- One of self\OPTION_ENABLED or self\OPTION_DISABLED
bool	$default	- The default for the flag

set_flag_options()

admin_setting::set_flag_options ( $enabled, $default, $shortname, $displayname )

protectedinherited

Generic function to add a flag to this admin setting.

Parameters

bool	$enabled	- One of self\OPTION_ENABLED or self\OPTION_DISABLED
bool	$default	- The default for the flag
string	$shortname	- The shortname for this flag. Used as a suffix for the setting name.
string	$displayname	- The display name for this flag. Used as a label next to the checkbox.

set_force_ltr()

admin_setting::set_force_ltr ( $value )

inherited

Set whether to force LTR or not.

Parameters

bool

$value

True when forced, false when not force, null when unknown.

set_locked_flag_options()

admin_setting::set_locked_flag_options ( $enabled, $default )

inherited

Set the locked options flag on this admin setting.

Parameters

bool	$enabled	- One of self\OPTION_ENABLED or self\OPTION_DISABLED
bool	$default	- The default for the flag

set_required_flag_options()

admin_setting::set_required_flag_options ( $enabled, $default )

inherited

Set the required options flag on this admin setting.

Parameters

bool	$enabled	- One of self\OPTION_ENABLED or self\OPTION_DISABLED.
bool	$default	- The default for the flag.

set_updatedcallback()

admin_setting::set_updatedcallback ( $functionname )

inherited

Function called if setting updated - cleanup, cache reset, etc.

Parameters

string

$functionname

Sets the function name

Return values

void

validate()

admin_setting_configtext::validate

(

$data

)

Validate data before storage.

Parameters

string

data

Return values

mixed

true if ok string if error found

Reimplemented in admin_setting_agedigitalconsentmap, admin_setting_configiplist, admin_setting_configmixedhostiplist, admin_setting_configportlist, admin_setting_configtext_with_maxlength, admin_setting_countrycodes, admin_setting_filetypes, admin_setting_langlist, admin_setting_requiredtext, admin_setting_scsscode, admin_setting_sitesettext, admin_setting_special_gradepointdefault, admin_setting_special_gradepointmax, antivirus_clamav_pathtounixsocket_setting, antivirus_clamav_tcpsockethost_setting, auth_ldap_admin_setting_special_ntlm_configtext, auth_shibboleth_admin_setting_convert_data, and editor_atto_toolbar_setting.

write_setting()

admin_setting_configtext::write_setting

(

$data

)

Store new setting.

Parameters

mixed

$data

string or array, must not be NULL

Return values

string

empty string if ok, string error message otherwise

Reimplemented from admin_setting.

Reimplemented in admin_setting_configfile, admin_setting_confightmleditor, admin_setting_configmixedhostiplist, admin_setting_configtext_trim_lower, admin_setting_filetypes, admin_setting_langlist, admin_setting_sitesettext, admin_setting_special_backup_auto_destination, admin_setting_special_frontpagedesc, admin_setting_special_gradepointmax, auth_db_admin_setting_special_auth_configtext, auth_ldap_admin_setting_special_contexts_configtext, auth_ldap_admin_setting_special_lowercase_configtext, and auth_shibboleth_admin_setting_special_idp_configtextarea.

write_setting_flags()

admin_setting::write_setting_flags ( $data )

inherited

Write the values of the flags for this admin setting.

Parameters

array

$data

- The data submitted from the form or null to set the default value for new installs.

Return values

bool	- true if successful.

Member Data Documentation

$plugin

mixed admin_setting::$plugin

inherited

can be String or Null.

Null means main config table

---

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

• lib/adminlib.php