J3.x:Creating a simple module/Adding Form Fields/nl

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 formulierveld type (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>

Hiermee selecteert u de talen uit de database tabel en geeft de gebruiker de mogelijkheid er een te kiezen via een selectielijst.

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!

Ga naar het mod_helloworld.php bestand en haal de parameter op (let op: u kunt de parameter niet ophalen in de helper). Geef het daarna door aan de helper functie.

/**
  * 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 );

Bewerk nu onze database query in het helper bestand om de parameter keuze op te halen.

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

Conclusie

Formuliervelden bieden de gebruiker een makkelijke manier om de module aan te passen aan de site-instellingen. Dit geeft de mogelijkheid het bereik van de module uit te breiden tot veel talen en toepassingen.

Vorige: De database gebruiken

Volgende: Automatische update toevoegen