Ce plugin ajoute un shortcode général [audio], utilisable dans les articles joomla classique ainsi que dans le module natif "contenu HTML personnalisé", et dans toutes les autres extensions joomla développé dans l'esprit Joomla!
Le shortcode affiche un lecteur audio classique, la syntaxe du shortcode est exactement la même que celle de Wordpress, c'est la raison pour laquelle ce plugin est fait pour vous si vous souhaitez importer des articles Wordpress sur Joomla par exemple.
Le lecteur audio est basé sur la librairie MediaElement.js
Utilisation du shortcode :
- Simple : [audio src="/source.mp3"]
- Avancée : [audio src="/source.mp3" loop="on" preload="auto" autoplay="on"]
Paramètre obligatoire :
- src : URL de votre fichier audio (le paramètre "mp3" existe aussi, en alias), attention a ne pas utiliser les caractères [ et ] dans le nom du fichier.
Paramètres optionnel :
- loop : on / off = lire le fichier en boucle
- autoplay : on / off = lire le fichier automatiquement
- preload : none / auto / metadata = Par défaut le fichier n'est pas pré-chargé, auto = Pré-chargement automatique du fichier, metadata = Pré-charge automatiquement seulement les métadata du fichier.
- style : code CSS qui sera appliqué à la balise audio
- background : couleur d’arrière plan du lecteur, peut être aux divers formats : #228CBF rgb(34, 140, 191) ou encore rgba(34, 140, 191, 0.50)
- hidden : on / off = cache le lecteur audio
- showvolume : on / off = permet de montrer ou non le groupe de volume
- txtcolor : modifie la couleur du texte, couleurs au format css classique : #f00, red, rgba (255,0,0,0.5) ..
- btcolor : change la couleur des boutons principaux : black, red, green, blue or white
Valeur souligné = valeur par défaut
Et si plusieurs lecteurs sont présent sur la même page ? L'autoplay se désactive, et il est impossible de jouer 2 musiques en même temps.
Questions / Réponses
Est-ce que ce plugin est compatible avec le module Joomla "Contenu personnalisé" ?
Oui : cependant, dans les paramètres du module, l'option "Plug-ins de contenu" doit être active
Est-ce que ce plugin est compatible avec les flux "live" .m3u8, .mwa ... ?
Pour le moment non
Est-ce que Flash est requis pour que ce plugin fonctionne ?
Non, adobe flash n'est pas et ne sera jamais nécessaire
Changelogs
Version 1.5 :
+ support de l'attribut : "showvolume"
+ support de l'attribut : "txtcolor"
+ support de l'attribut : "btcolor"
+ mise à jour de jQuery (3.2.1)
+ réécriture la façon de charger la bibliothèque principale (plus efficace maintenant)
+ CSS : suppression de 'box-shadow' sur les boutons
+ CSS : suppression de 'outline' sur les boutons qui ont le focus
Version 1.4 :
+ ajout du support des mises à jour automatique
+ correction d'un bug d'affichage avec certains thèmes
Version 1.3 :
+ ajout d'un paramètre global de configuration "largeur par défaut", permet de définir la largeur du lecteur si ce dernier est dans un tabs par exemple
Version 1.2 :
+ support de l'attribut "hidden"
Version 1.1 :
+ support de l'attribut "background"
+ correction de quelques bugs
Ce module vous plait mais vous souhaiteriez une option supplémentaire, des améliorations ou vous avez simplement une question ? N'hésitez pas !
