Joomla! Documentation - User contributions [en]

Archived:Creating a simple module/Adding Form Fields

2016-08-12T10:50:22Z

Dieda2:

{{Chunk25:Creating a Simple Module for Joomla!2.5 - Contents}}

Form fields give a great deal of customisation in Joomla and for modules are the sole way of allowing the user to tweak the module to the needs of their site.

== What are Form Fields? ==
In {{JVer|1.5}} form fields were called parameters - and a comparison between form fields and parameters can be found on [[Standard_form_field_and_parameter_types|this page]]. A complete list of form fields can be found on [[Standard_form_field_types|this page]].

== Adding Form Fields to the module ==
In this case we are going to extend our previous example using the database to provide a list of languages for the user to select from. To allow this to happen we will use the SQL form field type (full details for this on the [[SQL_form_field_type|SQL Form Field]] docs page).

First of all we are going to add a form field into our xml file. Remember those config tags that we added in earlier? Well now inside these tags we are going to add the following code:

<source lang="xml">
<fields name="params">
<fieldset name="basic">
<field
name="lang"
type="sql"
default="1"
label="Select a language"
query="SELECT id AS value, lang FROM #__helloworld" />
</fieldset>
</fields>
</source>

This selects the languages from the database table and allows the user to choose which one from a select element.

If you were to install the module as it is now you would see if you were to access the module in the backend of Joomla that a dropdown had appeared (although picking an option won't affect the module at the moment).

''Note:'' The form field parameters are stored for each module in the #__modules table under the params field as json encoded string.

Because of the Joomla! module rendering method, when we are inside the mod_helloworld.php program, we have the same variables in scope that we have in the renderModule() method of the JModuleHelper class (libraries/joomla/application/module/helper.php). Among these we have the $params variable defined as follows:

<source lang="php">
$params= new JRegistry;
$params->loadJSON($module->params);
</source>

Hence, we can always access the $params variable although it's never been defined in our code.

Now lets make the form field do something!

Lets go into the mod_helloworld.php and retrieve the parameter (note you '''cannot''' retrieve the parameter in the helper), and then pass it into the helper function.

<source lang="php">
/**
* This retrieves the lang parameter we stored earlier. Note the second part
* which states to use the default value of 1 if the parameter cannot be
* retrieved for some reason
**/
$language = $params->get('lang', '1');
$langid = $params->get('id', '1');
$hello = modHelloWorldHelper::getHello($langid);
</source>

Now lets edit our database query in the helper file to reflect our parameter choice

<source lang="php">
// Obtain a database connection
$db = JFactory::getDbo();
// Retrieve the shout - note we are now retrieving the id not the lang field.
$query = $db->getQuery(true)
->select($db->quoteName('hello'))
->from($db->quoteName('#__helloworld'))
->where('id = '. (int)$params); //here $params is the parameter passed to the helper getHello function
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
//Return the Hello
return $result;
</source>

== Conclusion ==
Form fields give the user an easy way to customise the module to their sites settings. This allows the modules scope to be increased as well for many languages and applications.

<noinclude>
[[Category:Module Development]]
</noinclude>

Archived:Creating a simple module/Adding Form Fields

2016-08-12T10:49:05Z

Dieda2:

{{Chunk25:Creating a Simple Module for Joomla!2.5 - Contents}}

Form fields give a great deal of customisation in Joomla and for modules are the sole way of allowing the user to tweak the module to the needs of their site.

== What are Form Fields? ==
In {{JVer|1.5}} form fields were called parameters - and a comparison between form fields and parameters can be found on [[Standard_form_field_and_parameter_types|this page]]. A complete list of form fields can be found on [[Standard_form_field_types|this page]].

== Adding Form Fields to the module ==
In this case we are going to extend our previous example using the database to provide a list of languages for the user to select from. To allow this to happen we will use the SQL form field type (full details for this on the [[SQL_form_field_type|SQL Form Field]] docs page).

First of all we are going to add a form field into our xml file. Remember those config tags that we added in earlier? Well now inside these tags we are going to add the following code:

<source lang="xml">
<fields name="params">
<fieldset name="basic">
<field
name="lang"
type="sql"
default="1"
label="Select a language"
query="SELECT id AS value, lang FROM #__helloworld" />
</fieldset>
</fields>
</source>

This selects the languages from the database table and allows the user to choose which one from a select element.

If you were to install the module as it is now you would see if you were to access the module in the backend of Joomla that a dropdown had appeared (although picking an option won't affect the module at the moment).

''Note:'' The form field parameters are stored for each module in the #__modules table under the params field as json encoded string.

Because of the Joomla! module rendering method, when we are inside the mod_helloworld.php program, we have the same variables in scope that we have in the renderModule() method of the JModuleHelper class (libraries/joomla/application/module/helper.php). Among these we have the $params variable defined as follows:

<source lang="php">
$params= new JRegistry;
$params->loadJSON($module->params);
</source>

Hence, we can always access the $params variable although it's never been defined in our code.

Now lets make the form field do something!

Lets go into the mod_helloworld.php and retrieve the parameter (note you '''cannot''' retrieve the parameter in the helper), and then pass it into the helper function.

<source lang="php">
/**
* This retrieves the lang parameter we stored earlier. Note the second part
* which states to use the default value of 1 if the parameter cannot be
* retrieved for some reason
**/
$language = $params->get('lang', '1');
$langid = $params->get('id', '1');
$hello = modHelloWorldHelper::getHello($langid);
</source>

Now lets edit our database query in the helper file to reflect our parameter choice

<source lang="php">
// Obtain a database connection
$db = JFactory::getDbo();
// Retrieve the shout - note we are now retrieving the id not the lang field.
$query = $db->getQuery(true)
->select($db->quoteName('hello'))
->from($db->quoteName('#__helloworld'))
->where('id = '. int($params)); //here $params is the parameter passed to the helper getHello function
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
//Return the Hello
return $result;
</source>

== Conclusion ==
Form fields give the user an easy way to customise the module to their sites settings. This allows the modules scope to be increased as well for many languages and applications.

<noinclude>
[[Category:Module Development]]
</noinclude>

Archived:Creating a simple module/Adding Form Fields

2016-08-12T10:47:29Z

Dieda2:

{{Chunk25:Creating a Simple Module for Joomla!2.5 - Contents}}

Form fields give a great deal of customisation in Joomla and for modules are the sole way of allowing the user to tweak the module to the needs of their site.

== What are Form Fields? ==
In {{JVer|1.5}} form fields were called parameters - and a comparison between form fields and parameters can be found on [[Standard_form_field_and_parameter_types|this page]]. A complete list of form fields can be found on [[Standard_form_field_types|this page]].

== Adding Form Fields to the module ==
In this case we are going to extend our previous example using the database to provide a list of languages for the user to select from. To allow this to happen we will use the SQL form field type (full details for this on the [[SQL_form_field_type|SQL Form Field]] docs page).

First of all we are going to add a form field into our xml file. Remember those config tags that we added in earlier? Well now inside these tags we are going to add the following code:

<source lang="xml">
<fields name="params">
<fieldset name="basic">
<field
name="lang"
type="sql"
default="1"
label="Select a language"
query="SELECT id AS value, lang FROM #__helloworld" />
</fieldset>
</fields>
</source>

This selects the languages from the database table and allows the user to choose which one from a select element.

If you were to install the module as it is now you would see if you were to access the module in the backend of Joomla that a dropdown had appeared (although picking an option won't affect the module at the moment).

''Note:'' The form field parameters are stored for each module in the #__modules table under the params field as json encoded string.

Because of the Joomla! module rendering method, when we are inside the mod_helloworld.php program, we have the same variables in scope that we have in the renderModule() method of the JModuleHelper class (libraries/joomla/application/module/helper.php). Among these we have the $params variable defined as follows:

<source lang="php">
$params= new JRegistry;
$params->loadJSON($module->params);
</source>

Hence, we can always access the $params variable although it's never been defined in our code.

Now lets make the form field do something!

Lets go into the mod_helloworld.php and retrieve the parameter (note you '''cannot''' retrieve the parameter in the helper), and then pass it into the helper function.

<source lang="php">
/**
* This retrieves the lang parameter we stored earlier. Note the second part
* which states to use the default value of 1 if the parameter cannot be
* retrieved for some reason
**/
$language = $params->get('lang', '1');
$langid = $params->get('id', '1');
$hello = modHelloWorldHelper::getHello($langid);
</source>

Now lets edit our database query in the helper file to reflect our parameter choice

<source lang="php">
// Obtain a database connection
$db = JFactory::getDbo();
// Retrieve the shout - note we are now retrieving the id not the lang field.
$query = $db->getQuery(true)
->select($db->quoteName('hello'))
->from($db->quoteName('#__helloworld'))
->where('id = '. int($params)); //here $params is the parameter passed to the helper function
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
//Return the Hello
return $result;
</source>

== Conclusion ==
Form fields give the user an easy way to customise the module to their sites settings. This allows the modules scope to be increased as well for many languages and applications.

<noinclude>
[[Category:Module Development]]
</noinclude>

Archived:Creating a simple module/Adding Form Fields

2016-08-12T10:46:39Z

Dieda2: I have added the explanation of why the $params variable appears as available inside mod_helloworld.php despite it's not been defined before inside the custom code. Also I have corrected the query inside the helper.php file and the function call.

{{Chunk25:Creating a Simple Module for Joomla!2.5 - Contents}}

Form fields give a great deal of customisation in Joomla and for modules are the sole way of allowing the user to tweak the module to the needs of their site.

== What are Form Fields? ==
In {{JVer|1.5}} form fields were called parameters - and a comparison between form fields and parameters can be found on [[Standard_form_field_and_parameter_types|this page]]. A complete list of form fields can be found on [[Standard_form_field_types|this page]].

== Adding Form Fields to the module ==
In this case we are going to extend our previous example using the database to provide a list of languages for the user to select from. To allow this to happen we will use the SQL form field type (full details for this on the [[SQL_form_field_type|SQL Form Field]] docs page).

First of all we are going to add a form field into our xml file. Remember those config tags that we added in earlier? Well now inside these tags we are going to add the following code:

<source lang="xml">
<fields name="params">
<fieldset name="basic">
<field
name="lang"
type="sql"
default="1"
label="Select a language"
query="SELECT id AS value, lang FROM #__helloworld" />
</fieldset>
</fields>
</source>

This selects the languages from the database table and allows the user to choose which one from a select element.

If you were to install the module as it is now you would see if you were to access the module in the backend of Joomla that a dropdown had appeared (although picking an option won't affect the module at the moment).

''Note:'' The form field parameters are stored for each module in the #__modules table under the params field as json encoded string.

Because of the Joomla! moudule rendering method, when we are inside the mod_helloworld.php program, we have the same variables in scope that we have in the renderModule() method of the JModuleHelper class (libraries/joomla/application/module/helper.php). Among these we have the $params variable defined as follows:

<source lang="php">
$params= new JRegistry;
$params->loadJSON($module->params);
</source>

Hence, we can always access the $params variable although it's never been defined in our code.

Now lets make the form field do something!

Lets go into the mod_helloworld.php and retrieve the parameter (note you '''cannot''' retrieve the parameter in the helper), and then pass it into the helper function.

<source lang="php">
/**
* This retrieves the lang parameter we stored earlier. Note the second part
* which states to use the default value of 1 if the parameter cannot be
* retrieved for some reason
**/
$language = $params->get('lang', '1');
$langid = $params->get('id', '1');
$hello = modHelloWorldHelper::getHello($langid);
</source>

Now lets edit our database query in the helper file to reflect our parameter choice

<source lang="php">
// Obtain a database connection
$db = JFactory::getDbo();
// Retrieve the shout - note we are now retrieving the id not the lang field.
$query = $db->getQuery(true)
->select($db->quoteName('hello'))
->from($db->quoteName('#__helloworld'))
->where('id = '. int($params)); //here $params is the parameter passed to the helper function
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
//Return the Hello
return $result;
</source>

== Conclusion ==
Form fields give the user an easy way to customise the module to their sites settings. This allows the modules scope to be increased as well for many languages and applications.

<noinclude>
[[Category:Module Development]]
</noinclude>