J3.x

Creating a simple module/Adding Form Fields/ru: Difference between revisions

From Joomla! Documentation

< J3.x:Creating a simple module
← Older edit
Created page with "ru"
FuzzyBot (talk | contribs)
Bots
226,300 edits
Updating to match new version of source page
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
<noinclude><languages /></noinclude>
<noinclude><languages /></noinclude>
{{J3.x:Creating_a_simple_module/ru}}
{{J3.x:Creating_a_simple_module/ru}}
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.
Поля формы дают много возможностей по настройке в Joomla и для модулей являются единственным способом, позволяющим пользователю настроить их для нужд своего сайта.


== Adding Form Fields to the module ==
<div class="mw-translate-fuzzy">
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 [[S:MyLanguage/SQL_form_field_type|SQL Form Field]] docs page).
== Добавление полей формы к модулю ==
</div>
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. (The full details for this is on the [[S:MyLanguage/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:
First of all we are going to add a form field into our ''.xml'' file. Remember those config tags that we added in earlier? Now inside these tags we are going to add the following code:


<source lang="xml">
<source lang="xml">
Line 21: Line 23:
</source>
</source>


This selects the languages from the database table and allows the user to choose which one from a select element.
This selects the languages from the database table and allows the user to choose 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).
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 has 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.
''Note:'' The form field parameters are stored for each module in the ''#__modules'' table under the ''params'' field as JSON-encoded string.


Now lets make the form field do something!
Now let's 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.
Go into the ''mod_helloworld.php'' file and retrieve the parameter. (Note that you '''cannot''' retrieve the parameter in the helper.) Then pass it into the helper function.


<source lang="php">
<source lang="php">
/**
/**
   * This retrieves the lang parameter we stored earlier. Note the second part
   * 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
   * which assigns the default value of 1 if the parameter cannot be
   * retrieved for some reason
   * retrieved for some reason.
**/
**/
$language = $params->get('lang', '1');
$language = $params->get('lang', '1');
Line 41: Line 43:
</source>
</source>


Now lets edit our database query in the helper file to reflect our parameter choice.
Now let's edit our database query in the helper file to reflect our parameter choice.


<source lang="php">
<source lang="php">
// Obtain a database connection
// Obtain a database connection.
$db = JFactory::getDbo();
$db = JFactory::getDbo();
// Retrieve the shout - note we are now retrieving the id not the lang field.
// Retrieve the shout. Note that we are now retrieving the id not the lang field.
$query = $db->getQuery(true)
$query = $db->getQuery(true)
             ->select($db->quoteName('hello'))
             ->select($db->quoteName('hello'))
Line 55: Line 57:
// Load the row.
// Load the row.
$result = $db->loadResult();
$result = $db->loadResult();
// Return the Hello
// Return the Hello.
return $result;
return $result;
</source>
</source>


== Conclusion ==
== 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.
Form fields give the user an easy way to customise the module to their site's settings. This allows the module's scope to be increased as well for many languages and applications.


<div class="row">  
<div class="row">  

Latest revision as of 13:41, 1 April 2020

Other languages:
Joomla! 
3.x
Урок
Создание простого модуля

Материалы в этой серии

Данная серия материалов написана о том, как разработать какой-либо модуль для Joomla! в версии Joomla 3.x. Вы можете пройтись по материалам этой серии с помощью выпадающего навигационного меню.

Начните со вступления и пройдитесь по материалам этой серии с помощью либо расположенной внизу навигационной кнопки, либо расположенного справа навигационного текстового блока (Материалы в этой серии).




Поля формы дают много возможностей по настройке в Joomla и для модулей являются единственным способом, позволяющим пользователю настроить их для нужд своего сайта.

Добавление полей формы к модулю

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. (The full details for this is on the 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? Now inside these tags we are going to add the following code: 

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

This selects the languages from the database table and allows the user to choose 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 has 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.

Now let's make the form field do something!

Go into the mod_helloworld.php file and retrieve the parameter. (Note that you cannot retrieve the parameter in the helper.) Then pass it into the helper function. 

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

Now let's edit our database query in the helper file to reflect our parameter choice. 

// Obtain a database connection.
$db = JFactory::getDbo();
// Retrieve the shout. Note that we are now retrieving the id not the lang field.
$query = $db->getQuery(true)
            ->select($db->quoteName('hello'))
            ->from($db->quoteName('#__helloworld'))
            ->where('id = '. $db->Quote($params));
// Prepare the query
$db->setQuery($query);
// Load the row.
$result = $db->loadResult();
// Return the Hello.
return $result;

Conclusion

Form fields give the user an easy way to customise the module to their site's settings. This allows the module's scope to be increased as well for many languages and applications.

Prev: Using the Database
Next: Adding Auto Update
Retrieved from "https://docs.sandbox.joomla.org/index.php?title=J3.x:Creating_a_simple_module/Adding_Form_Fields/ru&oldid=655304"