Broken/Patching forms tutorial - Versionshistorik

Jeffjeff: overflowing lines in pre block

2009-04-03T06:56:53Z

overflowing lines in pre block

← Äldre version		Versionen från 3 april 2009 kl. 06.56
Rad 7:		Rad 7:
	'''Warning'''		'''Warning'''
	Making custom changes to the PHP scripting code in Moodle should be done carefully.		Making custom changes to the PHP scripting code in Moodle should be done carefully.
	You should always test your code before using it on your production site and should backup the original scripts.		You should always test your code before using it on your production site and should
			backup the original scripts.
	You should always comment your code so you know what has been changed.		You should always comment your code so you know what has been changed.
	Care should also be taken during upgrades in the code to make sure things are not broken (like conflicts during a CVS update).		Care should also be taken during upgrades in the code to make sure things are not
			broken (like conflicts during a CVS update).

	Having said that, these patches are among the simplest and the recovery from an error is easy: simply replace the file with original from the core distribution.		Having said that, these patches are among the simplest and the recovery from an error is easy: simply replace the file with original from the core distribution.

Jeffjeff: /* Setting fields to "Advanced" */

2009-04-03T06:24:19Z

Setting fields to "Advanced"

← Äldre version		Versionen från 3 april 2009 kl. 06.24
Rad 65:		Rad 65:
	For elements that are infrequently used in your institution, you can still simplify the interface while making options still available to your 'Power Users' by marking elements as "advanced".		For elements that are infrequently used in your institution, you can still simplify the interface while making options still available to your 'Power Users' by marking elements as "advanced".

	These elements only appear to the user when ~~the~~ click the "Set Advanced" button.		These elements only appear to the user when they click the "Set Advanced" button.

	To identify the element as advanced, call the '''setAdvanced''' method after the element has been created.		To identify the element as advanced, call the '''setAdvanced''' method after the element has been created.

Jeffjeff: and to end eisting existing

2009-04-03T06:20:09Z

and to end eisting existing

← Äldre version		Versionen från 3 april 2009 kl. 06.20
Rad 27:		Rad 27:
	While forms can be produced in any scripting page which outputs code, you will often find code for printing out forms in a file like mod_form.php or in index.php of the affected component. The examine the URL of the page being viewed as a starting point for finding the file to be changed.		While forms can be produced in any scripting page which outputs code, you will often find code for printing out forms in a file like mod_form.php or in index.php of the affected component. The examine the URL of the page being viewed as a starting point for finding the file to be changed.

	Always comment your code so you can change or remove it later.. For single line modifications, considering putting in your new code, and then ~~and~~ it with //<yourusername> <date> <the old code>. This allows for retention of ~~eisting~~ line numbers.		Always comment your code so you can change or remove it later.. For single line modifications, considering putting in your new code, and then end it with //<yourusername> <date> <the old code>. This allows for retention of existing line numbers.

	==Changing defaults==		==Changing defaults==

Jeffjeff: my to by

2009-04-03T06:17:24Z

my to by

← Äldre version		Versionen från 3 april 2009 kl. 06.17
Rad 17:		Rad 17:
	Rather than placing HTML form elements directly on the page, most well-written Moodle code will use the Forms Library. This allows a standard way to create user input elements and also centralizes code making it easier to override certain behaviors creating a greater consistency.		Rather than placing HTML form elements directly on the page, most well-written Moodle code will use the Forms Library. This allows a standard way to create user input elements and also centralizes code making it easier to override certain behaviors creating a greater consistency.

	An entire form is an "object" with methods and attributes. In many places in the Moodle code, the instance of the object is identified my the variable $mform, but you can use any variable.		An entire form is an "object" with methods and attributes. In many places in the Moodle code, the instance of the object is identified by the variable $mform, but you can use any variable.

	Common methods of the form object look like:		Common methods of the form object look like:

Nakohdo: /* Set a standard start date and number of weeks for courses */ added Category:Tutorial

2009-01-27T15:55:59Z

Set a standard start date and number of weeks for courses: added Category:Tutorial

← Äldre version		Versionen från 27 januari 2009 kl. 15.55
Rad 107:		Rad 107:
	//GVA 20080618 Set default course start date. Always start on a Monday to have weeks work right		//GVA 20080618 Set default course start date. Always start on a Monday to have weeks work right
	$mform->setDefault('startdate', strtotime("1 Sep 2008"));		$mform->setDefault('startdate', strtotime("1 Sep 2008"));

			[[Category:Tutorial]]

Dougiamas: Patching forms tutorial moved to Development:Patching forms tutorial: It really belongs in the developer namespace

2008-11-10T09:18:55Z

Patching forms tutorial moved to Development:Patching forms tutorial: It really belongs in the developer namespace

← Äldre version	Versionen från 10 november 2008 kl. 09.18
(Ingen skillnad)

Ganderson: /* Changing the default course start date and duration */

2008-06-18T18:51:10Z

Changing the default course start date and duration

← Äldre version		Versionen från 18 juni 2008 kl. 18.51
Rad 87:		Rad 87:
	Here are some other example of making simple changes to forms		Here are some other example of making simple changes to forms
	===Change the maximum allowed grade===		===Change the maximum allowed grade===
	The maximum grade for a module is set in the standard form to 100. To change this to a different value (such as 200) in version 1.9, make this change in the file /lib/form/modgrade.php		The maximum grade for a module is set in the standard form to 100. To change this to a different value (such as 200) in version 1.9, make this change in the file '''/lib/form/modgrade.php'''

	Find:		Find:
Rad 96:		Rad 96:

	for ($i=200; $i>=1; $i--) { // GVA 20080616 for ($i=100; $i>=1; $i--) {		for ($i=200; $i>=1; $i--) { // GVA 20080616 for ($i=100; $i>=1; $i--) {

			===Set a standard start date and number of weeks for courses===

			By default, Moodle starts courses on the day following course creation and gives them a duration of 10 weeks. As many institutions have standard terms, setting the default start date and duration will allow for more uniformity, fewer mistakes, and will ease course creation.

			In version 1.9, edit the file '''/course/edit_form.php'''. Insert the following lines after the affected fields are defined (perhaps on lines just before $this->add_action_buttons();)

			//GVA 20080618 Number of weeks for default course. Should go through final exam
			$mform->setDefault('numsections', 13);
			//GVA 20080618 Set default course start date. Always start on a Monday to have weeks work right
			$mform->setDefault('startdate', strtotime("1 Sep 2008"));

Ganderson: /* Change the maximum allowed grade to, for example, 200*/

2008-06-16T21:34:38Z

Change the maximum allowed grade to, for example, 200

← Äldre version		Versionen från 16 juni 2008 kl. 21.34
Rad 87:		Rad 87:
	Here are some other example of making simple changes to forms		Here are some other example of making simple changes to forms
	===Change the maximum allowed grade===		===Change the maximum allowed grade===
	The maximum grade for a module is set in the standard form to 100. To change this to a different value, change it in the file /lib/form/modgrade.php		The maximum grade for a module is set in the standard form to 100. To change this to a different value (such as 200) in version 1.9, make this change in the file /lib/form/modgrade.php

	Find:		Find:
Rad 95:		Rad 95:
	Change to:		Change to:

	for ($i=~~100~~; $i>=1; $i--) { // GVA 20080616 for ($i=100; $i>=1; $i--) {		for ($i=200; $i>=1; $i--) { // GVA 20080616 for ($i=100; $i>=1; $i--) {

Ganderson: Change maximum grade

2008-06-16T21:31:03Z

Change maximum grade

← Äldre version		Versionen från 16 juni 2008 kl. 21.31
Rad 5:		Rad 5:
	This tutorial will demonstrate how to do such modifications.		This tutorial will demonstrate how to do such modifications.

	~~===~~Warning~~===~~		'''Warning'''
	Making custom changes to the PHP scripting code in Moodle should be done carefully. You should always test your code before using it on your production site and should backup the original scripts. You should always comment your code so you know what has been changed. Care should also be taken during upgrades in the code to make sure things are not broken (like conflicts during a CVS update).		Making custom changes to the PHP scripting code in Moodle should be done carefully.
			You should always test your code before using it on your production site and should backup the original scripts.
			You should always comment your code so you know what has been changed.
			Care should also be taken during upgrades in the code to make sure things are not broken (like conflicts during a CVS update).

	Having said that, these patches are among the simplest and the recovery from an error is easy: simply replace the file with original from the core distribution.		Having said that, these patches are among the simplest and the recovery from an error is easy: simply replace the file with original from the core distribution.

	~~===~~Moodle Forms Overview~~===~~		'''Moodle Forms Overview'''

	Rather than placing HTML form elements directly on the page, most well-written Moodle code will use the Forms Library. This allows a standard way to create user input elements and also centralizes code making it easier to override certain behaviors creating a greater consistency.		Rather than placing HTML form elements directly on the page, most well-written Moodle code will use the Forms Library. This allows a standard way to create user input elements and also centralizes code making it easier to override certain behaviors creating a greater consistency.
Rad 80:		Rad 83:
	$mform->addElement('select', 'timezone', get_string('timezone'), $choices);		$mform->addElement('select', 'timezone', get_string('timezone'), $choices);
	$mform->setAdvanced('timezone');		$mform->setAdvanced('timezone');

			==Other Examples==
			Here are some other example of making simple changes to forms
			===Change the maximum allowed grade===
			The maximum grade for a module is set in the standard form to 100. To change this to a different value, change it in the file /lib/form/modgrade.php

			Find:

			for ($i=100; $i>=1; $i--) {

			Change to:

			for ($i=100; $i>=1; $i--) { // GVA 20080616 for ($i=100; $i>=1; $i--) {

Ganderson: /* Setting fields to "Advanced" */

2008-06-10T09:06:20Z

Setting fields to "Advanced"

← Äldre version		Versionen från 10 juni 2008 kl. 09.06
Rad 59:		Rad 59:

	==Setting fields to "Advanced"==		==Setting fields to "Advanced"==

			For elements that are infrequently used in your institution, you can still simplify the interface while making options still available to your 'Power Users' by marking elements as "advanced".

			These elements only appear to the user when the click the "Set Advanced" button.

			To identify the element as advanced, call the '''setAdvanced''' method after the element has been created.

			Example:

			Your typical user is local and hence it will be rare that they will use a different time zone. To clean up the interface, set the option to change the user time zone so that it is shown only when the user clicks "Set Advanced".

			Solution:

			In the file /user/editlib.php, find:

			$mform->addElement('select', 'timezone', get_string('timezone'), $choices);

			Set the field to advanced using the setAdvanced method

			$mform->addElement('select', 'timezone', get_string('timezone'), $choices);
			$mform->setAdvanced('timezone');