Details

Published: 10 March 2025 Hits: 19

• joomla
• composants
• component_builder

Joomla Builder

C'est un outil de génération de composants pour Joomla développé par Llewellyn van der Merwe.

Il permet sans quasiment écrire une ligne de code de générer l'arborescence de fichiers et le code du composant pour l'administration et le site.

L'outil est téléchargeable sur le JED Joomla ou directement sur son site github ici   pkg-component-builder/releases

 Une belle présentation est disponible ici sur le magazine Jooma january-2025/tools-to-build-a-component-7-joomla-component-builder

 

 

Création des champs associés au composant

On crée un champ ("Field") pour chaque ligne et chaque table reflétant la modélisation.

J'ai créé un type de champ ("Fieldtype") de nom "Revenu" pour indiquer les min et max de tous les champs de ce type

 

Nom	Type
tranche1 à tranche4	Revenu
coef1 à coef4	FLOAT
revenu	Revenu
deduction	Revenu
nom	STRING
nbparts	FLOAT
PEL	Revenu

 

Exemple pour le champ PEL on lui donne pour type Revenu

 

 

On précise le format dans la base de données

 

Pour le champ nombre de parts j'ai mis un step à 0.5 pour avoir les demi parts

 

 

Création des vues administrateur associées au composant

Ce sont les vues (admin views) qui déterminent l'association entre les listes de champs et les tables de la base de données, et la création des contrôleurs/modèles associés

L'association est faite au travers des "Linked Fields", pris par rapport aux "Fields" créés précédemment.

 Pour ma part 2 vues:

• la vue Année, (Year dans la configuration) associée aux 2 vues Years (pour la liste d'éléments) et Year pour chaque élément

Impôt - read/write

Edit View: impot
List View: impots

 

Linked Fields 

Field	Admin Behaviour	Order in list views	Tab	Order in Edit
Name (Key - Required) [name - text]	Show in All List Views	1	Details	1
Tranche 1 [tranche1 - revenu]	Default	0	Details	2
Tranche 2 [tranche2 - revenu]	Default	0	Details	3
Tranche 3 [tranche3 - revenu]	Default	0	Details	4
Tranche 4 [tranche4 - revenu]	Default	0	Details	5
Taux tranche 1 [taux1 - taux]	Default	0	Details	6
Taux tranche 2 [taux2 - taux]	Default	0	Details	7
Taux tranche 3 [taux3 - taux]	Default	0	Details	8
Taux tranche 4 [taux4 - taux]	Default	0	Details	9

 

• la vue impots, associée aux 2 vues Impôts  (pour la liste d’éléments) et Impôt pour chaque élément

Year - read/write

Edit View: year
List View: years

 

Linked Fields 

Field	Admin Behaviour	Order in list views	Tab	Order in Edit
Name (not-required) [name - text]	Show in All List Views	1	Details	0
Year [year - sql]	Show in All List Views	2	Details	1
Revenu [revenu - revenu]	Show in All List Views	3	Details	2
Nombre de parts [nbparts - integer]	Show in All List Views	4	Details	3
Déduction [deduction - radio]	Show in All List Views	5	Details	4
PEL [pel - revenu]	Default	0	Details	6
Dons [dons - revenu]	Default	0	Details	7

 

Classes générées par Component Builder

 

Associer les vues au composant

C'est à fare dans l'edition du composant

J'ai coché les cases pour ajouter les liens au "dashboard" et au menu

 

Compiler le composant

 Cela permet de générer un package installable avec tous les sources associés

Aller dans le Menu Component Builder/Compile

 

Installer le composant

cliquer sur le bouton "Install com_jtax xxx"

 

Tester le dashboard

On obtient le "dashboard" suivant:

 

Et si on clique sur year add

 Et si on clique sur Impot add

 

---