Guide Joomla v1.2.0

Publiez vos modèles et scènes 3D dans Joomla : glTF, FBX et OBJ, animations Mixamo, matériaux PBR, 3 modules de site et une API REST JSON:API.

Présentation

Publiez vos modèles et scènes 3D dans Joomla : glTF, FBX et OBJ, animations Mixamo, matériaux PBR, 3 modules de site et une API REST JSON:API.

Prérequis

  • Joomla 4.4, 5 ou 6 selon la version du paquet.
  • PHP 8.1 ou version ultérieure recommandée.
  • Une sauvegarde récente avant toute installation ou mise à jour.

Installation

  1. Téléchargez le paquet ZIP sans le décompresser.
  2. Dans Joomla, ouvrez Système → Installation → Extensions.
  3. Déposez le fichier ZIP dans la zone d’installation, puis attendez le message de confirmation.
  4. Ouvrez le composant depuis le menu Composants. Si le paquet contient un plugin, vérifiez son état dans Système → Gestion → Plugins.
  5. Contrôlez les autorisations du composant avant de l’ouvrir aux équipes.

Configuration initiale

  1. Ouvrez le tableau de bord de l’extension.
  2. Accédez aux Options pour définir les réglages globaux.
  3. Attribuez les droits Créer, Modifier, Supprimer et Administrer aux groupes concernés.
  4. Créez un premier élément de test et vérifiez son affichage côté site lorsqu’une vue publique est fournie.
  5. Activez les tâches planifiées ou plugins du paquet uniquement lorsqu’ils sont nécessaires.

Fonctionnalités

Modèles glTF, FBX et OBJ

Le moteur charge trois familles de formats : glTF et sa variante binaire GLB, FBX, et OBJ avec ses matériaux MTL. Chaque modèle porte sa position, sa rotation et son échelle, avec centrage et mise à l'échelle automatiques si besoin.

Scènes multi-modèles

Une scène assemble plusieurs modèles, chacun avec son nom d'instance, sa transformation, sa visibilité et son comportement d'ombre — projetée, reçue ou les deux — et son propre rang d'affichage.

Éclairage et environnement

Quatre familles de lumières — ambiante, directionnelle, ponctuelle et spot — avec ombres et brouillard optionnels. Le fond accepte une couleur unie, une skybox, une carte HDRI ou la transparence pure.

Animations et retargeting Mixamo

Le chargeur Mixamo embarque une table de 23 os de squelette humanoïde, complétée par 40 os de doigts, pour rejouer une animation FBX sur un modèle dont les os ne portent pas le préfixe mixamorig:. Boucle simple, répétée ou aller-retour, fondus et vitesse ajustables.

Trois schémas de caméra

Orbite pour un produit que l'on tourne, première personne pour parcourir un intérieur, vol libre pour survoler une maquette. Caméra en perspective ou en orthographique, champ de vision et plans de coupe configurables.

Objets cliquables

Un gestionnaire d'événements projette un rayon depuis le curseur et émet des événements de clic, survol, double-clic, glisser et sélection, sur les objets comme sur les surfaces. Molette, pincement et clavier inclus.

Matériaux PBR réutilisables

Une bibliothèque partagée couvre six types de rendu — standard, physique, Phong, Lambert, toon et personnalisé — avec métallicité, rugosité, vernis et neuf canaux de textures, de la diffuse à la carte d'environnement.

Publication façon Joomla

Modèles et scènes sont des contenus Joomla à part entière : catégories natives, état de publication, niveau d'accès, langue, dates de début et de fin de publication, verrouillage en édition et champs personnalisés.

Premiers usages

  1. Commencez avec un cas simple et des données non sensibles.
  2. Validez le résultat avec l’équipe qui utilisera l’extension.
  3. Documentez les choix propres au site : rôles, automatisations, modèles et intégrations.
  4. Déployez progressivement, puis surveillez les journaux et retours utilisateurs.

Captures d’écran

Interface de 3D Viewer
Vue de l’interface d’administration de l’extension.
Installation de 3D Viewer
Écran standard d’installation d’une extension Joomla.

Dépannage

L’extension n’apparaît pas après installation
Vérifiez le message d’installation, l’état du composant et des plugins, puis videz le cache Joomla/WordPress.
Une action est refusée
Contrôlez les droits du groupe utilisateur, le jeton de session et les éventuelles restrictions de sécurité.
Le rendu ne correspond pas au site
Testez avec le cache désactivé, inspectez les substitutions de template et recherchez un conflit CSS ou JavaScript.
Une intégration externe échoue
Vérifiez l’URL, les identifiants, les quotas et les journaux sans copier de secret dans une demande d’assistance.

Mise à jour et désinstallation

Avant une mise à jour, sauvegardez les fichiers et la base de données, lisez les changements de version, puis testez sur une copie du site. Pour désinstaller, exportez d’abord les données utiles. La suppression d’un paquet peut retirer plusieurs composants, modules ou plugins associés.