Champ SQL

Objectif

Le champ SQL fournit une liste déroulante d'entrées obtenues à partir d'une requête de base de données. Pour utiliser ce champ, vous devez savoir comment construire une requête et vous devriez la tester dans phpMyAdmin.

Création du champ

Les paramètres spécifiques à ce champ sont :

• Multiple Permet de sélectionner plusieurs valeurs. Si réglé sur Oui, la liste affiche 4 éléments. Sinon elle affiche 1 élément. Dans les deux cas, il y a une longue liste à parcourir pour faire des sélections - si activée.
• Requête La requête SQL qui fournira les données pour la liste déroulante. La requête doit retourner deux colonnes ; l'une appelée 'value' qui contiendra les valeurs des éléments de la liste ; l'autre appelée 'text' contenant le texte affiché dans la liste déroulante.

Dans cet exemple, une table contenant une liste de noms de pays est utilisée. Voici la requête :

SELECT `id` AS value, `title` AS text
FROM `#__countrybase_countries`
WHERE `state` = 1
ORDER BY `title` ASC

Remarque : dans cet exemple, l'inclusion du type de champ dans le titre est uniquement à des fins de démonstration. Ne le faites pas dans vos propres titres de champs.

Saisie des données

Simple - sélectionner dans la liste.

Affichage des données

La capture d'écran suivante du Site montre le champ affiché dans un article. Le paramètre Affichage automatique est responsable de la position du champ et votre template est responsable de la présentation du champ.

Le résultat est un élément unique ou une liste d'éléments séparés par des virgules (noms de pays) suivant le libellé du champ (Pays d'origine).