Joomla! Documentation™

Joomla! 

3.x

Handleiding

Een eenvoudige module maken

Artikelen in deze serie

• Inleiding
• Het ontwikkelen van een basis-module
• Het gebruiken van de database
• Toevoegen van formuliervelden
• Het toevoegen van automatische update
• Het toevoegen van een installatie/deïnstallatie/update script-bestand

Dit is een serie artikelen over het ontwikkelen van een module voor Joomla! versie . U kunt navigeren binnen de artikelen in deze serie met behulp van het navigatie drop-down menu.

Begin met de Introductie en navigeer door de artikelen van de serie door middel van de navigatieknop onderaan of het vak rechts (Artikelen in deze serie). Er zitten 2 video's bij deze handleiding die u hier kunt zien Basic Joomla Module Development video 1 en Basic Joomla Module Development video 2.

Formuliervelden creëren een grote mate van maatwerk in Joomla. Ze zijn de enige manier waarop gebruikers de module aan de eisen van hun site kunnen aanpassen.

Formuliervelden toevoegen aan de module

In dit geval gaan we ons eerdere voorbeeld met de database uitbreiden, om een lijst met talen aan de gebruiker te presenteren waar hij uit kan kiezen. Om dit mogelijk te maken gebruiken we het het SQL formulier veldtype (de details staan op de SQL Form Field documentatie pagina).

Allereerst voegen we een formulierveld toe aan ons xml-bestand. Weet u nog dat we in config tags hebben toegevoegd? In die tags voegen we de volgende code toe:

<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 which one from a select element.

Als u de module zou installeren zoals hij nu is en er in de Joomla backend naar kijkt, zou u zien dat er een dropdown verschijnt (hoewel een optie kiezen op dit moment nog geen effect heeft op de module).

Let op: De formulierveld parameters worden voor elke module opgeslagen als json-encoded string in de #__modules tabel, onder het params veld.

Nu gaan we het formulierveld iets laten doen!

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.

/**
  * 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');
$hello    = modHelloWorldHelper::getHello( $language );

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

// 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 = '. $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 sites settings. This allows the modules scope to be increased as well for many languages and applications.

Prev: Using the Database

Next: Adding Auto Update